共用方式為


ICONINFOEXW 結構 (winuser.h)

包含圖示或游標的相關資訊。 擴充 ICONINFO由 GetIconInfoEx 使用

語法

typedef struct _ICONINFOEXW {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  WCHAR   szModName[MAX_PATH];
  WCHAR   szResName[MAX_PATH];
} ICONINFOEXW, *PICONINFOEXW;

成員

cbSize

類型: DWORD

這個 結構的大小,以位元組為單位。

fIcon

類型: BOOL

指定這個結構是否定義圖示或游標。 TRUE的值會指定圖示;FALSE指定資料指標。

xHotspot

類型: DWORD

游標作用點的 X 座標。 如果此結構定義圖示,作用點一律位於圖示中央,而且會忽略此成員。

yHotspot

類型: DWORD

游標作用點的 Y 座標。 如果此結構定義圖示,作用點一律位於圖示中央,而且會忽略此成員。

hbmMask

類型: HBITMAP

圖示單色遮罩 點陣圖的控制碼。

hbmColor

類型: HBITMAP

圖示色彩 點陣圖的控制碼。

wResID

類型: WORD

szModName模組中資源的資源識別碼。 如果圖示或游標是以名稱載入, 則 wResID 為零, 而 szResName 包含資源名稱。

您可以使用 MAKEINTRESOURCE (wResID) 宏,將資源識別碼轉換成與 資源管理功能相容的資源名稱類型。

szModName[MAX_PATH]

類型: TCHAR[MAX_PATH]

載入圖示或游標的模組名稱。

您可以使用 GetModuleHandle 函式,將它轉換成與 資源管理功能相容的模組控制碼。

szResName[MAX_PATH]

類型: TCHAR[MAX_PATH]

szModName模組中資源的資源名稱。

備註

如果是單色圖示, hbmMask 是圖示高度的兩倍, (頂端有 AND 遮罩,而底部的 XOR 遮罩) 則為 Null, 而 hbmColorNull。 此外,在此情況下,高度應該是兩個的偶數倍數。

針對色彩圖示, hbmMaskhbmColor 點陣圖的大小相同,每個大小都是圖示的大小。

您可以使用GetObject函式來取得BITMAP結構中hbmMaskhbmColor的內容。 您可以透過呼叫這個結構中的點陣圖上的 GetDIBits 來 取得點陣圖位。

ICONINFOEX是一種擴充版本的ICONINFO結構,具有額外的szModNameszResName//wResID成員,可用來查詢圖示或資料指標資源位。 這些位通常是透過呼叫 FindResourceLoadResourceLockResourceLookupIconIdFromDirectoryEx 函 式來載入。

注意

winuser.h 標頭會將 ICONINFOEX 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 winuser.h (包含 Windows.h)

另請參閱

概念

CreateIconIndirect

GetIconInfo

圖示

點陣圖

GetObject

點陣圖

GetDIBits

參考