DrawIconEx_I

  • Article

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

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 Values

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 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Gwebypasscoredllthunk.hpp.

See Also

DrawIconEx | LoadImage

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.