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

指示请求此结构的哪些成员的标志集。 这可以是以下一个或多个值。

Value 含义
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