NMHDDISPINFOA 结构 (commctrl.h)

包含用于处理 HDN_GETDISPINFO 通知代码的信息。

语法

typedef struct tagNMHDDISPINFOA {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOA, *LPNMHDDISPINFOA;

成员

hdr

类型: NMHDR

包含有关此通知代码的信息的 NMHDR 结构。

iItem

类型: int

标头控件中项的从零开始的索引。

mask

类型: UINT

一组位标志,指定结构哪些成员必须由标头控件的所有者填充。 此值可以是以下值的组合:

含义
HDI_TEXT
必须填写 pszText 字段。
HDI_IMAGE

版本 4.70。 必须填写 iImage 字段。

HDI_LPARAM
必须填写 lParam 字段。
HDI_DI_SETITEM

版本 4.70。 返回值。 指示标头控件应存储项信息,而不是再次请求它。

pszText

类型: LPTSTR

指向以 null 结尾的字符串的指针,该字符串包含将为标头项显示的文本。

cchTextMax

类型: int

pszText 指向的缓冲区的大小。

iImage

类型: int

图像列表中图像的从零开始的索引。 指定的图像将随标题项一起显示,但它不会取代项的位图。 如果 iImage 设置为 I_IMAGECALLBACK,则控件通过使用 HDN_GETDISPINFO 通知代码请求此项的图像信息。

lParam

类型: LPARAM

要与项关联的应用程序定义的值。

备注

注意

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

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h