共用方式為

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)
程式庫 Shell32.lib
Dll Shell32.dll (6.0 版或更新版本)
API 集合 ext-ms-win-shell32-l1-2-1 (於 Windows 10 10.0.10240 版)