<Return[D]><Top>

DragQueryFile

Declare Function Api_DragQueryFile& Lib "shell32" Alias "DragQueryFileA" (ByVal hDrop&, ByVal iFile&, ByVal lpszFile$, ByVal cch&)

Declare Function DragQueryFile Lib "shell32" Alias "DragQueryFileA" (ByVal hDrop As Long, ByVal iFile As Long, ByVal lpszFile As String, ByVal cch As Long) As Long

ドラッグアンドドロップ操作が成功した場合、ドロップされたファイルの名前を取得する。

パラメータ
hDrop
    ドロップされた複数のファイルの名前を保持している、1 個の内部構造体のハンドルを指定する。
iFile
    問い合わせ対象のファイルのインデックス番号を指定する。0xFFFFFFFF(言い換えると -1)を指定すると、DragQueryFile

    は、ドロップされたファイルの総数を返す。0〜ドロップされたファイルの総数未満のいずれかの値を指定すると、DragQueryFile

    は、lpszFile パラメータが指すバッファに、その値に対応するファイルの名前を格納する。
lpszFile
    1 個のバッファへのポインタを指定する。関数から制御が返ると、このバッファに、ドロップされた特定のファイルの名前が格納される。

    NULL を指定すると、DragQueryFile は必要なバッファのサイズを文字単位で返す。
cch
    lpszFile が指すバッファのサイズを文字単位で指定する。


戻り値
    関数がバッファにファイル名を格納すると、格納した文字数が返る。終端の NULL 文字は、文字数に含まれない。
    iFile パラメータで 0xFFFFFFFF(-1)を指定した場合、ドラッグアンドドロップされたファイルの総数が返る。
    iFile パラメータで、0〜ドロップされたファイルの総数未満の値を指定し、さらに lpszFile パラメータで NULL を指定した場合、ファイル名を

    格納するために必要なバッファのサイズが文字単位で返る。終端の NULL 文字は、文字数に含まれない。