TTM_SETTITLE消息

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

参数

wParam

将 wParam 设置为以下值之一以指定要显示的图标。 从 Windows Vista 及更高版本起，此参数还可以包含 HICON 值。 任何大于 TTI_ERROR_LARGE 的值都假定为 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)

另请参阅

关于工具提示控件