NMTTDISPINFOA 结构 (commctrl.h)

包含用于处理 TTN_GETDISPINFO 通知代码的信息。 此结构取代了 TOOLTIPTEXT 结构。

语法

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

成员

hdr

类型:NMHDR

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

lpszText

类型:LPTSTR

指向以 null 结尾的字符串的指针,该字符串将显示为工具提示文本。 如果 指定实例句柄,则此成员必须是字符串资源的标识符。

szText[80]

类型:TCHAR

接收工具提示文本的缓冲区。 应用程序可以将文本复制到此缓冲区,而不是指定字符串地址或字符串资源。 有关超过 80 TCHAR的工具提示文本,请参阅本文档备注部分中的注释。

hinst

类型:HINSTANCE

包含要用作工具提示文本的字符串资源的实例的句柄。 如果 lpszText 是工具提示文本字符串的地址,则此成员必须 NULL

uFlags

类型:UINT

指示如何解释包含 NMHDR 结构的 idFrom 成员的标志。

价值 意义
TTF_IDISHWND
如果设置了此标志,idFrom 是该工具的句柄。 否则,它是工具的标识符。
TTF_RTLREADING
Windows 可以 镜像 来显示从右到左(RTL)的希伯来语或阿拉伯语等语言。 通常,工具提示文本的读取方向与父窗口中的文本方向相同。 若要让工具提示从其父窗口向相反的方向读取,请在处理通知时将TTF_RTLREADING标志添加到 uFlags 成员。
TTF_DI_SETITEM

版本 4.70。 如果将此标志添加到处理通知时 uFlags,则工具提示控件将保留所提供的信息,而不再次请求它。

lParam

类型:LPARAM

版本 4.70。 与该工具关联的应用程序定义数据。

言论

当工具提示中使用的文本超过 80 TCHAR长度时,需要将 lpszText 数组指向自己的专用缓冲区。 除非控件具有 TTS_NOPREFIX 样式,否则系统会自动从传递给工具提示控件的所有字符串 TCHARs 去除与(&)加速器。

注意

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

要求

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