NMTBDISPINFOA 结构 (commctrl.h)

包含和接收工具栏项的显示信息。 此结构与 TBN_GETDISPINFO 通知代码一起使用。

语法

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

成员

hdr

类型:NMHDR

NMHDR 结构,其中包含有关通知的其他信息。

dwMask

类型:DWORD

一组标志,用于指示请求此结构的成员。 这可以是以下一个或多个值。

价值 意义
TBNF_IMAGE
正在请求项的图像索引。 图像索引必须放置在 iImage 成员中。
TBNF_TEXT
当前未实现。
TBNF_DI_SETITEM
处理 TBN_GETDISPINFO时设置此标志;工具栏控件将保留所提供的信息,而不再次请求它。

idCommand

类型:int

要为其请求显示信息的项的命令标识符。 此成员在发送通知代码之前由控件填充。

lParam

类型:DWORD_PTR

与请求显示信息的项关联的应用程序定义值。 发送通知代码之前,此成员由控件填充。

iImage

类型:int

项的图像索引。

pszText

类型:LPTSTR

指向接收项文本的字符缓冲区的指针。

cchText

类型:int

pszText 缓冲区的大小(以字符为单位)。

言论

注意

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

要求

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