ICONINFOEXA 結構 (winuser.h)

發行項
03/04/2024

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

語法

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

成員

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)