TTM_SETTITLE message

Adds a standard icon and title string to a tooltip.

Parameters

wParam

Set wParam to one of the following values to specify the icon to be displayed. As of Windows XP SP2 and later, this parameter can also contain an HICON value. Any value greater than TTI_ERROR is assumed to be an HICON.

ValueMeaning
TTI_NONE

No icon.

TTI_INFO

Info icon.

TTI_WARNING

Warning icon

TTI_ERROR

Error Icon

TTI_INFO_LARGE

Large error Icon

TTI_WARNING_LARGE

Large error Icon

TTI_ERROR_LARGE

Large error Icon

 

lParam

Pointer to the title string. You must assign a value to lParam.

Return value

Returns TRUE if successful, FALSE if not.

Remarks

The title of a tooltip appears above the text, in a different font. It is not sufficient to have a title; the tooltip must have text as well, or it is not displayed.

When wParam contains an HICON, a copy of the icon is created by the tooltip window.

When calling TTM_SETTITLE, the string pointed to by lParam must not exceed 100 TCHARs in length, including the terminating NULL.

Examples

The following example shows how to add a title and a system icon to a tooltip.


// 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);

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

TTM_SETTITLEW (Unicode) and TTM_SETTITLEA (ANSI)

See also

About Tooltip Controls

 

 

Community Additions

ADD
Show:
© 2014 Microsoft