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 结尾的字符串的指针，该字符串将显示为工具提示文本。 如果 hinst 指定了实例句柄，则此成员必须是字符串资源的标识符。

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 数组指向你自己的专用缓冲区。 系统会自动从传递给工具提示控件的所有字符串中去除与号 (&) 加速器 TCHAR，除非该控件具有TTS_NOPREFIX样式。

注意

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

要求

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