ICONINFOEXA 结构 (winuser.h)

包含有关图标或游标的信息。 扩展 ICONINFO由 GetIconInfoEx 使用。

语法

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

成员

cbSize

类型:DWORD

此结构的大小(以字节为单位)。

fIcon

类型: BOOL

指定此结构是定义图标还是游标。 TRUE 值指定图标;FALSE 指定游标。

xHotspot

类型:DWORD

光标热点的 x 坐标。 如果此结构定义了图标,则热点始终位于图标的中心,并且忽略此成员。

yHotspot

类型:DWORD

光标热点的 y 坐标。 如果此结构定义了图标,则热点始终位于图标的中心,并且忽略此成员。

hbmMask

类型: HBITMAP

图标位掩码位图。 如果此结构定义了黑白图标,则会设置此位掩码的格式,以便上半部分是图标 AND 位掩码,下半部分是图标 XOR 位掩码。 在这种情况下,高度应为两个的偶数倍。 如果此结构定义了颜色图标,则此掩码仅定义图标的 AND 位掩码。

hbmColor

类型: HBITMAP

图标颜色位图的句柄。 如果此结构定义了黑白图标,则此成员可以是可选的。 hbmMask 的 AND 位掩码将 SRCAND 标志应用于目标;随后,使用 XOR) 通过 SRCINVERT 标志将颜色位图应用到目标 (。

wResID

类型: WORD

图标或游标资源位。 通常通过调用 LookupIconIdFromDirectoryExLoadResource 函数来加载这些位。

szModName[MAX_PATH]

类型: TCHAR[MAX_PATH]

模块的完全限定路径。

szResName[MAX_PATH]

类型: TCHAR[MAX_PATH]

资源的完全限定路径。

注解

注意

winuser.h 标头将 ICONINFOEX 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非中性编码别名与非编码中性代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 winuser.h (包括 Windows.h)

另请参阅

概念性

CreateIconIndirect

GetIconInfo

图标

引用