createIconFromResourceEx 函式 (winuser.h)

發行項
03/09/2024

從描述圖示的資源位建立圖示或游標。

語法

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

參數

[in] presbits

類型： PBYTE

DWORD 對齊緩衝區指標，其中包含 圖示 (RT_ICON) 或 游標 (RT_CURSOR) 資源位。這些位通常是透過呼叫 LookupIconIdFromDirectoryEx 和 LoadResource 函式來載入。

如需圖示和數據指標資源格式的詳細資訊，請參閱數據指標和圖示資源。

[in] dwResSize

類型： DWORD

pbIconBits 參數所指向之位集的大小，以位元組為單位。

[in] fIcon

類型： BOOL

指出要建立圖示或游標。如果此參數為 TRUE，則會建立圖示。如果是 FALSE，則會建立數據指標。

LOCALHEADER 結構會定義數據指標熱點，而且是從數據指標資源位讀取的第一個數據。

[in] dwVer

類型： DWORD

presbits 參數所指向之資源位的圖示或數據指標格式版本號碼。此值必須大於或等於 0x00020000，且小於或等於 0x00030000。此參數通常會設定為 0x00030000。

[in] cxDesired

類型： int

圖示或游標的寬度，以像素為單位。如果此參數為零且 Flags 參數 LR_DEFAULTSIZE，則函式會使用 SM_CXICON 或 SM_CXCURSOR 系統計量值來設定寬度。如果此參數為零且未使用 LR_DEFAULTSIZE ，則函式會使用實際的資源寬度。

[in] cyDesired

類型： int

圖示或游標的高度，以像素為單位。如果此參數為零且 Flags 參數 LR_DEFAULTSIZE，則函式會使用 SM_CYICON 或 SM_CYCURSOR 系統計量值來設定高度。如果此參數為零且未使用 LR_DEFAULTSIZE ，則函式會使用實際的資源高度。

[in] Flags

類型： UINT

下列值的組合。

值	意義
LR_DEFAULTCOLOR 0x00000000	使用預設色彩格式。
LR_DEFAULTSIZE 0x00000040	如果 cxDesired 或 cyDesired 值設定為零，則會使用系統計量值所指定的寬度或高度。如果未指定此旗標，而且 cxDesired 和 cyDesired 設定為零，則函式會使用實際的資源大小。
LR_MONOCHROME 0x00000001	建立單色圖示或游標。
LR_SHARED 0x00008000	如果圖示或游標建立多次，則共享圖示或游標句柄。如果未設定 LR_SHARED ，則相同資源對 CreateIconFromResourceEx 的第二次呼叫會再次建立圖示或游標，並傳回不同的句柄。當您使用此旗標時，系統會在不再需要資源時終結資源。請勿將 LR_SHARED 用於具有非標準大小的圖示或游標、可能會在載入之後變更，或是從檔案載入的游標。

傳回值

類型： HICON

如果函式成功，則傳回值是圖示或游標的句柄。

如果函式失敗，傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

CreateIconFromResource、CreateIconFromResourceEx、CreateIconIndirect、GetIconInfo 和 LookupIconIdFromDirectoryEx 函式可讓殼層應用程式和圖示瀏覽器檢查和使用整個系統的資源。

您應該針對以 CreateIconFromResourceEx 建立的數據指標呼叫 DestroyIcon 或 DestroyCursor。

範例

如需範例，請參閱共用圖示資源。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll