GetFileNameFromBrowse

GetFileNameFromBrowse 関数は、ユーザが開くファイルのドライブ、ディレクトリ、名前を指定できる「開く」ダイアログボックスを作成する。

GetFileNameFromBrowse hwnd, pszFilePath, cchFilePath, pszWorkingDir, pszDefExt, pszFilters, pszTitle

hwnd : [intptr] 型: HWND ダイアログボックスを所有するウィンドウへのハンドル。このメンバには有効なウィンドウハンドルを指定でき、ダイアログボックスにオーナーがない場合は NULL を指定できる。
pszFilePath : [wstr] 型: PWSTR ファイル名編集コントロールを初期化するために使うファイル名を含むヌル終端 Unicode 文字列。この文字列は OPENFILENAME 構造体の lpstrFile メンバに対応し、まったく同じように使われる。
cchFilePath : [int] 型: UINT pszFilePath の文字数（終端ヌル文字を含む）。
pszWorkingDir : [wstr] 型: PCWSTR 初期ディレクトリの完全修飾パス。この文字列は OPENFILENAME 構造体の lpstrInitialDir メンバに対応し、まったく同じように使われる。
pszDefExt : [wstr] 型: PCWSTR 既定のファイル名拡張子を含むヌル終端 Unicode 文字列。ユーザが拡張子を指定しない場合、この拡張子が pszFilePath に追加される。文字列に '.' を含めてはならない。この文字列が NULL でユーザが拡張子を入力しなかった場合、拡張子は付加されない。
pszFilters : [wstr] 型: PCWSTR フィルタを定義するヌル終端 Unicode 文字列。この文字列は OPENFILENAME 構造体の lpstrFilter メンバに対応し、まったく同じように使われる。
pszTitle : [wstr] 型: PCWSTR ダイアログボックスのタイトルバーに表示されるヌル終端 Unicode 文字列。この値が NULL の場合、システムは既定のタイトルを使用する。

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

解説

GetFileNameFromBrowse
関数は、ユーザが開くファイルのドライブ、ディレクトリ、名前を指定できる「開く」ダイアログボックスを作成する。

[戻り値]
型: BOOL ユーザがファイル名を指定して OK をクリックした場合、戻り値は TRUE となる。pszFilePath
が指すバッファには、ユーザが指定した完全なパスとファイル名が格納される。ユーザが「開く」ダイアログボックスをキャンセル/閉じた場合、またはエラーが発生した場合は
FALSE を返す。

情報