DrawIconEx_I (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

BOOL WINAPI DrawIconEx_I(
  HDC hdc,
  int X,
  int Y,
  HICON hicon,
  int cx,
  int cy,
  UINT istepIfAniCur,
  HBRUSH hbrFlickerFreeDraw,
  UINT diFlags
);

Parameters

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

• X
  [in] Integer that specifies the logical x-coordinate of the upper-left corner of the icon.

• Y
  [in] Integer that specifies the logical y-coordinate of the upper-left corner of the icon.

• hicon
  [in] Handle to the icon that you want to draw. You must load the icon resource before calling DrawIconEx_I by calling the LoadImage function.

• cx
  [in] Integer that specifies the logical width of the icon. This parameter must be zero or the native width of the icon.

• cy
  [in] Integer that specifies the logical height of the icon. This parameter must be zero or the native height of the icon.

• istepIfAniCur
  [in] Not supported; set to zero.

• hbrFlickerFreeDraw
  [in] Handle to a brush that specifies that the system draws the icon directly into the device context; set to NULL.

• diFlags
  [in] Unsigned integer that specifies the following drawing flag.

  Value	Description
  DI_NORMAL	Draws the icon using the image and the mask.

Return Value

A nonzero value indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The DrawIconEx_I function places the upper-left corner of the icon at the location specified by the xLeft and yTop parameters.

Windows Embedded CE does not support the following:

• Stretching and compressing an icon. In other words, the icon resolution is fixed for a specified HICON and resizing an icon is not supported.
• Using mapping modes.
• Using DrawIconEx_I to draw cursors.

Requirements

See Also

Reference

GWES OS Functions
DrawIconEx
LoadImage