ICONINFO

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 cursors 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 cursors 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 hbmMask is 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 fIcon member 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

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

CreateIconIndirect

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.