This documentation is archived and is not being maintained.


Draws an icon on the device represented by the current CDC object.

BOOL DrawIcon(
   int x,
   int y,
   HICON hIcon 
BOOL DrawIcon(
   POINT point,
   HICON hIcon 



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


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


Identifies the handle of the icon to be drawn.


Specifies the logical x- and y-coordinates of the upper-left corner of the icon. You can pass a POINT structure or a CPoint object for this parameter.

Nonzero if the function completed successfully; otherwise 0.

The function places the icon's upper-left corner at the location specified by x and y. The location is subject to the current mapping mode of the device context.

The icon resource must have been previously loaded by using the functions CWinApp::LoadIcon, CWinApp::LoadStandardIcon, or CWinApp::LoadOEMIcon. The MM_TEXT mapping mode must be selected prior to using this function.

See the example for CWnd::IsIconic.