共用方式為


createIconFromResource 函式 (winuser.h)

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

若要指定所需的高度或寬度,請使用 CreateIconFromResourceEx 函 式。

語法

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

參數

[in] presbits

類型: PBYTE

包含圖示或游標資源位的 DWORD 對齊緩衝區指標。 這些位通常是透過呼叫 LookupIconIdFromDirectoryLookupIconIdFromDirectoryExLoadResource 函式來載入。

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

[in] dwResSize

類型: DWORD

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

[in] fIcon

類型: BOOL

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

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

[in] dwVer

類型: DWORD

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

傳回值

類型: HICON

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

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

備註

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

CreateIconFromResource 函式會呼叫 CreateIconFromResourceEx 以旗標傳遞LR_DEFAULTSIZE|LR_SHARED

您應該針對使用 CreateIconFromResource 所建立的數據指標呼叫 DestroyIconDestroyCursor

規格需求

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

另請參閱

概念

CreateIconFromResourceEx

CreateIconIndirect

GetIconInfo

圖示

LoadResource

LookupIconIdFromDirectory

LookupIconIdFromDirectoryEx

參考