ICONINFOEXW 結構 (winuser.h)

發行項
06/21/2023

包含圖示或游標的相關資訊。擴充 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， 而 hbmColor 為 Null。此外，在此情況下，高度應該是兩個的偶數倍數。

針對色彩圖示， hbmMask 和 hbmColor 點陣圖的大小相同，每個大小都是圖示的大小。

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

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

注意

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

規格需求


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