TTM_ADDTOOL message

Registers a tool with a tooltip control.

Parameters

wParam

Must be zero.

lParam

Pointer to a TOOLINFO structure containing information that the tooltip control needs to display text for the tool. The cbSize member of this structure must be filled in before sending this message.

Return value

Returns TRUE if successful, or FALSE otherwise.

Remarks

Although the name of the message implicitly indicates the "addition of a tool", it must be made clear that this message merely records a set of specific settings for what is called "a tool", however a ToolTip can be displayed even when there is no "tool" itself (a visual control with a handle). For this reason, this message should be interpreted as "add a set of specific settings for the display of a ToolTip ". A ToolTip window can be displayed in several different ways and each of these ways can be registered via the TTM_ADDTOOL message.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h
Unicode and ANSI names
TTM_ADDTOOLW (Unicode) and TTM_ADDTOOLA (ANSI)

See also

Reference

TTM_DELTOOL

Conceptual

About Tooltip Controls