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 で導入)