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)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-ntuser-gui-l1-3-1 ()

请参阅

概念性

CreateIcon

DrawIconEx

图标

LoadIcon

引用