 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. |
This function draws an icon in the specified device context, performing the raster operations as specified.
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. Return Values
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
The DrawIconExfunction 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.
Windows CE does not support the following:
- Stretching and compressing; that is, the icon resolution is fixed for a specified HICON, and no icon resizing is supported.
- Mapping modes.
- Using DrawIconExto draw cursors.
- Animated cursors.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Winuser.h Icon.lib Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also