 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 structure contains information about an icon.
typedef
struct
_ICONINFO
{
BOOL
fIcon
;
DWORD
xHotspot
;
DWORD
yHotspot
;
HBITMAP
hbmMask
;
HBITMAP
hbmColor
;
}
ICONINFO;
Members
- fIcon
- Boolean that specifies whether this structure defines an icon or a cursor. A value of TRUE specifies an icon; a value of FALSE specifies a cursor.
- xHotspot
- Specifies the x-coordinate of a cursor's hot spot. If this structure defines an icon, the hot spot is always in the center of the icon, and this member is ignored.
- yHotspot
- Specifies the y-coordinate of the cursor's hot spot. If this structure defines an icon, the hot spot is always in the center of the icon, and this member is ignored.
- hbmMask
- Specifies the icon bitmask bitmap. If this structure defines a black and white icon, this bitmask is formatted so that the upper half is the icon AND bitmask and the lower half is the icon XOR bitmask. Under this condition, the height should be an even multiple of two. If this structure defines a color icon, this mask only defines the AND bitmask of the icon.
- hbmColor
- Handle to the icon color bitmap. This member can be optional if
this structure defines a black and white icon. The AND bitmask of
hbmMaskis applied with the SRCAND flag to the destination;
subsequently, the color bitmap is applied (using XOR) to the
destination by using the SRCINVERT flag.
Remarks
If you are not using the Iconcurs component, the fIconmember must be set to TRUE. The Windows CE Icon component does not support cursors. If you need mouse cursor support in your application, use the Windows CE Iconcurs component rather than the Windows CE Icon component.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Commctrl.h 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