ICONINFO

  • Article

This structure contains information about an icon.

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 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 Microsoft® Windows® CE .NET 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

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

CreateIconIndirect

 Last updated on Wednesday, April 14, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.