ICONINFOEX structure

Contains information about an icon or a cursor. Extends ICONINFO. Used by GetIconInfoEx.

Syntax

typedef struct _ICONINFOEX {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  TCHAR   szModName[MAX_PATH];
  TCHAR   szResName[MAX_PATH];
} ICONINFOEX;

Members

cbSize

Type: DWORD

The size, in bytes, of this structure.

fIcon

Type: BOOL

Specifies whether this structure defines an icon or a cursor. A value of TRUE specifies an icon; FALSE specifies a cursor.

xHotspot

Type: DWORD

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

Type: DWORD

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

Type: HBITMAP

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

Type: HBITMAP

A 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.

wResID

Type: WORD

The icon or cursor resource bits. These bits are typically loaded by calls to the LookupIconIdFromDirectoryEx and LoadResource functions.

szModName

Type: TCHAR[MAX_PATH]

The fully qualified path of the module.

szResName

Type: TCHAR[MAX_PATH]

The fully qualified path of the resource.

Requirements

See also

Reference

CreateIconIndirect

GetIconInfo

Conceptual

Icons