DlgDirSelectExW

単一選択リストボックスから現在の選択を取得する。リストボックスが DlgDirList 関数によって格納されており、選択がドライブレター、ファイル名、またはディレクトリ名であることを前提とする。(Unicode)

DlgDirSelectExW hwndDlg, lpString, chCount, idListBox

hwndDlg : [intptr] 型: HWND リストボックスを含むダイアログボックスへのハンドル。
lpString : [wstr] 型: LPTSTR 選択されたパスを受け取るバッファへのポインタ。
chCount : [int] 型: int lpString が指すバッファの長さ (TCHAR 単位)。
idListBox : [int] 型: int ダイアログボックス内のリストボックスの識別子。

(プラグイン / モジュール : user32.dll)

解説

単一選択リストボックスから現在の選択を取得する。リストボックスが DlgDirList
関数によって格納されており、選択がドライブレター、ファイル名、またはディレクトリ名であることを前提とする。(Unicode)

[戻り値]
型: BOOL 現在の選択がディレクトリ名である場合、戻り値は 0 以外となる。現在の選択がディレクトリ名でない場合、戻り値は 0
となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
DlgDirSelectEx 関数は選択を lpString
パラメータで指定されたバッファにコピーする。現在の選択がディレクトリ名またはドライブレターの場合、DlgDirSelectEx
は囲んでいる角括弧 (およびドライブレターの場合はハイフン)
を取り除き、新しいパスに挿入できる状態にする。選択がない場合、lpString
は変更されない。文字列がバッファと同等以上の長さの場合、バッファには切り詰められた文字列と終端 NULL
文字が含まれる。DlgDirSelectEx は LB_GETCURSEL および LB_GETTEXT
メッセージをリストボックスに送信する。関数はリストボックスから複数のファイル名を返すことはできない。リストボックスは複数選択リストボックスであってはならない。複数選択の場合、この関数は
0 以外の値を返さず lpString も変更されない。

情報