DrawIcon

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function draws an icon in the specified device context.

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

Parameters

hDC

[in] Handle to the device context for a window.

X

[in] Specifies the logical x-coordinate of the upper-left corner of the icon.

Y

[in] Specifies the logical y-coordinate of the upper-left corner of the icon.

hIcon

Handle to the icon to be drawn. The icon resource must have been previously loaded by using the LoadIconor LoadImagefunctions.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The DrawIconfunction is implemented as a macro, defined as DrawIconEx( hdc, x, y, hicon, 0, 0, 0, NULL, DI_NORMAL ).

DrawIconplaces the icon's upper-left corner at the location specified by the Xand Yparameters. The location is subject to the current mapping mode of the device context.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Winuser.h		Icon.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.