DrawIcon
A version of this page is also available for
4/8/2010
This function draws an icon in the specified device context.
Syntax
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 LoadIcon or LoadImage functions.
Return Value
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
This function is implemented as a macro, defined as DrawIconEx(hdc, x, y, hicon, 0, 0, 0, NULL, DI_NORMAL).
DrawIcon places the icon's upper-left corner at the location specified by the X and Y parameters. The location is subject to the current mapping mode of the device context.
Requirements
| Header | pwinuser.h, winuser.h |
| Library | Icon.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile 6.5 and later, Windows Mobile Version 5.0 and later |