通过

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