getIconInfoExA 函式 (winuser.h)

擷取指定圖示或游標的相關信息。 GetIconInfoEx 會使用較新的 ICONINFOEX 結構來擴充 GetIconInfo。

語法

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

[in] hicon

類型： HICON

圖示或游標的句柄。

若要擷取標準圖示或游標的相關信息，請在此參數中指定開頭為 IDI_ 前置詞的標識碼或開頭為 IDC_ 前置詞的標識符。

[in, out] piconinfo

類型： PICONINFOEX

當這個方法傳回時，會包含 ICONINFOEX 結構的指標。函式會填入結構的成員。

類型： BOOL

TRUE 表示成功， FALSE 表示失敗。

GetIconInfoEx 會為 hbmMask 和 hbmColor 或 ICONINFOEX 的成員建立位圖。呼叫端應用程式必須管理這些點陣圖，並在不再需要時使用DeleteObject 呼叫加以刪除。

此 API 不會參與 DPI 虛擬化。傳回的輸出不會受到呼叫線程的 DPI 影響。

注意

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