CreateIconFromResourceEx 函式（winuser.h）

發行項
11/20/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

包含圖示（RT_ICON）或游標（RT_CURSOR）資源位的 DWORD 對齊緩衝區指標。這些位通常是透過呼叫 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 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winuser.h （包括 Windows.h）
連結庫	User32.lib
DLL	User32.dll