Share via


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

Header gwebypasscoredllthunk.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

GWES OS Functions
DrawIconEx
LoadImage