DlgDirListW

リストボックスの内容を、指定したディレクトリ内のサブディレクトリおよびファイルの名前で置き換える。ファイル属性のセットを指定することで名前のリストをフィルタリングできる。リストにはマップされたドライブを含めることもできる。(Unicode)

DlgDirListW hDlg, lpPathSpec, nIDListBox, nIDStaticPath, uFileType

hDlg : [intptr] 型: HWND リストボックスを含むダイアログボックスへのハンドル。
lpPathSpec : [wstr] 型: LPTSTR 絶対パス、相対パス、またはファイル名を指定する NULL 終端文字列を含むバッファへのポインタ。絶対パスはドライブレターまたは UNC 名で始めることができる。関数は文字列をディレクトリとファイル名に分割する。ディレクトリ内でファイル名と一致する名前を検索する。文字列にディレクトリが指定されていない場合、関数は現在のディレクトリを検索する。文字列にファイル名が含まれている場合、ファイル名には少なくとも 1 つのワイルドカード (? または *) が含まれなければならない。ファイル名が含まれない場合、関数はアスタリスクワイルドカード (*) がファイル名として指定されたかのように動作する。指定したディレクトリ内でファイル名と一致し、uFileType パラメータで指定された属性を持つすべての名前がリストボックスに追加される。
nIDListBox : [int] 型: int hDlg ダイアログボックス内のリストボックスの識別子。このパラメータが 0 の場合、DlgDirList はリストボックスへの格納を試みない。
nIDStaticPath : [int] 型: int hDlg ダイアログボックス内の静的コントロールの識別子。DlgDirList はこのコントロールのテキストを設定し、現在のドライブおよびディレクトリを表示する。現在のドライブおよびディレクトリを表示したくない場合、このパラメータを 0 にすることができる。
uFileType : [int] 型: UINT

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

解説

リストボックスの内容を、指定したディレクトリ内のサブディレクトリおよびファイルの名前で置き換える。ファイル属性のセットを指定することで名前のリストをフィルタリングできる。リストにはマップされたドライブを含めることもできる。(Unicode)

[戻り値]
型: int 関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。例えば lpPathSpec
で指定された文字列が有効なパスでない場合、関数は失敗する。

[備考]
lpPathSpec がディレクトリを指定する場合、DlgDirListComboBox
はリストボックスを格納する前に現在のディレクトリを指定されたディレクトリに変更する。nIDStaticPath
パラメータで指定された静的コントロールのテキストは、新しい現在のディレクトリの名前に設定される。DlgDirList は
LB_RESETCONTENT および LB_DIR メッセージをリストボックスに送信する。

情報