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.
A version of this page is also available for
4/8/2010

This structure contains information about an icon.

Syntax

typedef struct _ICONINFO {
  BOOL 
fIcon;
  DWORD 
xHotspot;
  DWORD 
yHotspot;
  HBITMAP 
hbmMask;
  HBITMAP 
hbmColor;
} ICONINFO;

Members

fIcon

Boolean value 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 Mobile Icon component does not support cursors. If you need mouse cursor support in your application, use the Windows Mobile Iconcurs component rather than the Windows Mobile Icon component.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also