TTM_SETTITLE消息

将标准图标和标题字符串添加到工具提示。

参数

wParam

wParam 设置为以下值之一,以指定要显示的图标。 自 Windows XP SP2 及更高版本起,此参数还可以包含 HICON 值。 任何大于TTI_ERROR的值都假定为 HICON

含义
TTI_NONE
无图标。
TTI_INFO
信息图标。
TTI_WARNING
警告图标
TTI_ERROR
错误图标
TTI_INFO_LARGE
大错误图标
TTI_WARNING_LARGE
大错误图标
TTI_ERROR_LARGE
大错误图标

lParam

指向标题字符串的指针。 必须将值分配给 lParam

返回值

如果成功,则返回 TRUE ,否则返回 FALSE

备注

工具提示的标题显示在文本上方,字体不同。 没有足够的标题;工具提示也必须包含文本,或者它未显示。

wParam 包含 HICON 时,工具提示窗口将创建图标的副本。

调用 TTM_SETTITLE时, lParam 指向的字符串长度不得超过 100 个 TCHAR ,包括终止 NULL

示例

以下示例演示如何向工具提示添加标题和系统图标。

// hwndTip is the handle of the tooltip window.
HICON hIcon = LoadIcon(NULL, IDI_INFORMATION);
SendMessage(hwndTip, TTM_SETTITLE, (WPARAM)hIcon, L"Title text");
DestroyIcon(hIcon);

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h
Unicode 和 ANSI 名称
TTM_SETTITLEW unicode ) (和TTM_SETTITLEA (ANSI)

另请参阅

关于工具提示控件