共用方式為


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 會為 hbmMaskhbmColorICONINFOEX 的成員建立位圖。 呼叫端應用程式必須管理這些點陣圖,並在不再需要 時使用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

另請參閱

概念

點陣圖

圖示

DeleteObject

GetObject

點陣圖

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO