PickIconDlg 関数 (shlobj_core.h)
[PickIconDlg は、[要件] セクションで指定したオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。
実行可能ファイルや DLL ファイルなどのリソースに埋め込まれている選択項目からアイコンを選択できるダイアログ ボックスを表示します。
構文
int PickIconDlg(
[in, optional] HWND hwnd,
[in, out] PWSTR pszIconPath,
UINT cchIconPath,
[in, out, optional] int *piIconIndex
);
パラメーター
[in, optional] hwnd
型: HWND
親ウィンドウのハンドル。 この値には NULL を指定できます。
[in, out] pszIconPath
種類: PWSTR
アイコンを含む既定のリソースの null で終わる完全修飾パスを含む文字列へのポインター。 ユーザーがダイアログで別のリソースを選択した場合、このバッファーには、関数が戻るときにそのファイルのパスが含まれます。 このバッファーの長さは、少なくともMAX_PATH文字にする必要があります。または、返されるパスが切り捨てられる可能性があります。 使用する前に、パスが有効であることを確認する必要があります。
cchIconPath
型: UINT
pszIconPath の文字数 (終端の NULL 文字を含む)。
[in, out, optional] piIconIndex
型: int*
エントリ上の整数へのポインターは、最初の選択のインデックスを指定し、この関数が正常に返されると、選択されたアイコンのインデックスを受け取ります。
戻り値
型: int
成功した場合は 1 を返します。それ以外の場合は 0。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | shlobj_core.h (Shlobj.h を含む) |
Library | Shell32.lib |
[DLL] | Shell32.dll (バージョン 6.0 以降) |
API セット | ext-ms-win-shell-shell32-l1-2-1 (Windows 10 バージョン 10.0.10240 で導入) |