DrawIcon 函式 (winuser.h)

將圖示或游標繪製到指定的裝置內容中。

若要指定其他繪圖選項,請使用 DrawIconEx 函 式。

語法

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

參數

[in] hDC

類型: HDC

將繪製圖示或游標之裝置內容的句柄。

[in] X

類型: int

圖示左上角的邏輯 X 座標。

[in] Y

類型: int

圖示左上角的邏輯 Y 座標。

[in] hIcon

類型: HICON

要繪製之圖示的句柄。

傳回值

類型: BOOL

如果函式成功,則傳回非零的值。

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

備註

DrawIcon 會將圖示的左上角放在 XY 參數所指定的位置。 位置受限於裝置內容的目前對應模式。

DrawIcon 會使用圖示的系統計量值所指定的寬度和高度來繪製圖示或游標;如需詳細資訊,請參閱 GetSystemMetrics

DrawIcon 函式會呼叫 DrawIconEx 以旗標傳遞DI_NORMAL|DI_DEFAULTSIZE

範例

如需範例,請參閱 顯示圖示

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-gui-l1-3-1 (在 Windows 10 10.0.14393 版中引進)

另請參閱

概念

CreateIcon

DrawIconEx

圖示

LoadIcon

參考