GetFileNameFromBrowse 関数 (shlobj.h)
[この機能は、Windows XP Service Pack 2 (SP2) と Windows Server 2003 を通じて使用できます。 それ以降のバージョンの Windows では、変更または使用できない可能性があります。
ユーザーが 開く ファイルのドライブ、ディレクトリ、名前を指定できるように、[開く] ダイアログ ボックスを作成します。
構文
BOOL GetFileNameFromBrowse(
[in, optional] HWND hwnd,
[in, out] PWSTR pszFilePath,
UINT cchFilePath,
[in, optional] PCWSTR pszWorkingDir,
[in] PCWSTR pszDefExt,
[in, optional] PCWSTR pszFilters,
[in, optional] PCWSTR pszTitle
);
パラメーター
[in, optional] hwnd
型: HWND
ダイアログ ボックスを所有するウィンドウへのハンドル。 このメンバーは、任意の有効なウィンドウ ハンドルにすることも、ダイアログ ボックスに所有者がいない場合は NULL にすることもできます。
[in, out] pszFilePath
種類: PWSTR
ファイル名編集コントロールの初期化に使用されるファイル名を含む null で終わる Unicode 文字列。 この文字列は OPENFILENAME 構造体の lpstrFile メンバーに対応しており、まったく同じ方法で使用されます。
cchFilePath
型: UINT
pszFilePath の文字数 (終端の null 文字を含む)。
[in, optional] pszWorkingDir
種類: PCWSTR
初期ディレクトリの完全修飾ファイル パス。 この文字列は 、OPENFILENAME 構造体の lpstrInitialDir メンバーに対応しており、まったく同じ方法で使用されます。
[in] pszDefExt
種類: PCWSTR
既定のファイル名拡張子を含む null で終わる Unicode 文字列。 ユーザーが拡張機能を指定していない場合、この拡張機能は pszFilePath に追加されます。 文字列に '.' 文字を含めてはなりません。 この文字列が NULL で、ユーザーが拡張機能の入力に失敗した場合、拡張子は追加されません。
[in, optional] pszFilters
種類: PCWSTR
フィルターを定義する null で終わる Unicode 文字列。 この文字列は 、OPENFILENAME 構造体の lpstrFilter メンバーに対応しており、まったく同じ方法で使用されます。
[in, optional] pszTitle
種類: PCWSTR
ダイアログ ボックスのタイトル バーに配置される null で終わる Unicode 文字列。 この値が NULL の場合、システムは既定のタイトルを使用します。
戻り値
種類: BOOL
ユーザーがファイル名を指定し、[ OK] をクリックすると、戻り値は TRUE になります。 pszFilePath が指すバッファーには、ユーザーが指定する完全なパスとファイル名が含まれています。 ユーザーが [ 開く ] ダイアログ ボックスをキャンセルまたは閉じるか、エラーが発生した場合、戻り値は FALSE になります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj.h (Shlobj.h を含む) |
| Library | Shell32.lib |
| [DLL] | Shell32.dll (バージョン 5.0 以降) |