getIconInfoExW 函式 (winuser.h)
擷取指定圖示或游標的相關資訊。 GetIconInfoEx會使用較新的ICONINFOEX結構來擴充GetIconInfo。
語法
BOOL GetIconInfoExW(
[in] HICON hicon,
[in, out] PICONINFOEXW piconinfo
);
參數
[in] hicon
類型: HICON
圖示或游標的控制碼。
若要擷取標準圖示或游標的相關資訊,請在此參數中指定 開頭為 IDI_ 前置 詞的識別碼或開頭為 IDC_ 前置詞的識別碼 。
[in, out] piconinfo
類型: PICONINFOEX
當這個方法傳回時,會包含 ICONINFOEX 結構的指標。 函式會填入結構的成員。
傳回值
類型: BOOL
TRUE 表示成功, FALSE 表示失敗。
備註
GetIconInfoEx 會為 hbmMask 和 hbmColor 或 ICONINFOEX的成員建立點陣圖。 呼叫端應用程式必須管理這些點陣圖,並在不再需要 時使用 DeleteObject 呼叫加以刪除。
DPI 虛擬化
此 API 不會參與 DPI 虛擬化。 傳回的輸出不會受到呼叫執行緒的 DPI 影響。注意
winuser.h 標頭會將 GetIconInfoEx 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
另請參閱
概念