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.
A version of this page is also available for
4/8/2010

This function draws an icon in the specified device context, performing the raster operations as specified.

Syntax 

BOOL DrawIconEx(
  HDC 
hdc, 
  int 
xLeft, 
  int 
yTop, 
  HICON 
hIcon, 
  int 
cxWidth, 
  int 
cyWidth, 
  UINT 
istepIfAniCur, 
  HBRUSH 
hbrFlickerFreeDraw, 
  UINT 
diFlags
);

Parameters

hdc

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

xLeft

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

yTop

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

hIcon

[in] Handle to the icon to be drawn. The icon resource must have been previously loaded by using the LoadImagefunction.

cxWidth

[in] Specifies the logical width of the icon. This parameter must be zero or the native dimensions of the icon.

cyWidth

[in] Specifies the logical height of the icon. This parameter must be zero or the native dimensions of the icon.

istepIfAniCur

[in] Animated icons are not supported; set to zero.

hbrFlickerFreeDraw

[in] Specifies that the system draws the icon directly into the device context; set to NULL.

diFlags

[in] Specifies the following drawing flag.

Value Description

DI_NORMAL

Draws the icon using the image and the mask.

DI_IMAGE

Draws the icon or cursor using the image.

DI_MASK

Draws the icon or cursor using the mask.

Return Value

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

Remarks

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

Stretching and compressing the icon or cursor was not supported in earlier versions, but is supported in Windows CE 5.0.

The following list shows features that Windows Embedded CE does not support:

  • Mapping modes.

  • Using DrawIconExto draw cursors.

Requirements

Header winuser.h
Library Icon.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also