DrawIcon

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 LoadIcon or LoadImage functions.

Return Values

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

Remarks

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

DrawIcon places the icons 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

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.

See Also

DrawIconEx, GetLastError, LoadIcon, LoadImage

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.