TTTOOLINFOA 结构 (commctrl.h)

  • 项目

TOOLINFO 结构包含有关工具提示控件中工具的信息。

语法

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

成员

cbSize

类型： UINT

此结构的大小（以字节为单位）。 必须指定此成员。

uFlags

类型： UINT

控制工具提示显示的标志。 此成员可以是以下值的组合：

值 含义
TTF_ABSOLUTE
 将工具提示窗口定位在 TTM_TRACKPOSITION提供的相同坐标处。 此标志必须与 TTF_TRACK 标志一起使用。
TTF_CENTERTIP
 工具提示窗口在 uId 成员指定的工具下方居中。
TTF_IDISHWND
 指示 uId 成员是工具的窗口句柄。 如果未设置此标志， 则 uId 是工具的标识符。
TTF_PARSELINKS

版本 6.0 及更高版本。 指示应分析工具提示文本中的链接。

请注意，Comctl32.dll 版本 6 不可再发行，但它包含在 Windows 或更高版本中。 若要使用 Comctl32.dll 版本 6，请在清单中指定它。 有关清单的详细信息，请参阅 启用视觉样式。
TTF_RTLREADING
 指示工具提示文本将以与父窗口中文本相反的方向显示。
TTF_SUBCLASS
 指示工具提示控件应将工具窗口子类化以截获消息，例如 WM_MOUSEMOVE。 如果未设置此标志，则必须使用 TTM_RELAYEVENT 消息将消息转发到工具提示控件。 有关工具提示控件处理的消息列表，请参阅TTM_RELAYEVENT。
TTF_TRACK
 将工具提示窗口放置在它所对应的工具旁边，并根据 TTM_TRACKPOSITION 消息提供的坐标移动窗口。 必须使用 TTM_TRACKACTIVATE 消息激活这种类型的工具。
TTF_TRANSPARENT
 使工具提示控件将鼠标事件消息转发到父窗口。 这仅限于在工具提示窗口边界内发生的鼠标事件。

hwnd

类型： HWND

包含该工具的窗口的句柄。 如果 lpszText 包含LPSTR_TEXTCALLBACK值，则此成员标识接收 TTN_GETDISPINFO 通知代码的窗口。

uId

类型： UINT_PTR

工具的应用程序定义的标识符。 如果 uFlags 包含TTF_IDISHWND标志， 则 uId 必须指定工具的窗口句柄。

rect

类型： RECT

工具的边框坐标。 坐标相对于 hwnd 标识的窗口工作区的左上角。 如果 uFlags 包含 TTF_IDISHWND 标志，则忽略此成员。

hinst

类型： HINSTANCE

包含工具的字符串资源的实例的句柄。 如果 lpszText 指定字符串资源的标识符，则使用此成员。

lpszText

类型： LPTSTR

指向包含工具文本的缓冲区的指针，或包含文本的字符串资源的标识符。 此成员有时用于返回值。 如果需要检查返回的值， 必须指向大小足够的有效缓冲区。 否则，可以将其设置为 NULL。 如果 lpszText 设置为 LPSTR_TEXTCALLBACK，则控件会将 TTN_GETDISPINFO 通知代码发送到所有者窗口以检索文本。

lParam

类型： LPARAM

版本 4.70 及更高版本。 与工具关联的 32 位应用程序定义值。

lpReserved

类型： void*

保留。 必须设置为 NULL。

注解

普通窗口从左到右显示文本 (LTR) 。 Windows 可以 镜像 以显示从右到左阅读 (RTL) 的语言，如希伯来语或阿拉伯语。 通常，工具提示文本的显示方向与其父窗口中的文本相同。 如果设置了TTF_RTLREADING，则工具提示文本将以与父窗口中文本相反的方向读取。

注意

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

要求

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