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