共用方式為


GetIconInfo 函式 (winuser.h)

擷取指定之圖示或游標的相關信息。

語法

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

參數

[in] hIcon

類型: HICON

圖示或游標的句柄。

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

[out] piconinfo

類型: PICONINFO

ICONINFO 結構的指標。 函式會填入 結構的成員。

傳回值

類型: BOOL

如果函式成功,則傳回值為非零,且函式會填入指定 ICONINFO 結構的成員。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

GetIconInfo 會為 hbmMaskhbmColorICONINFO 的成員建立位圖。 呼叫端應用程式必須管理這些點陣圖,並在不再需要 時使用DeleteObject 呼叫加以刪除。

DPI 虛擬化

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

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-gui-l1-1-0 (於 Windows 8)

另請參閱

概念

點陣圖

圖示

DeleteObject

GetObject

點陣圖

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO