TTM_SETTOOLINFO message

Sets the information that a tooltip control maintains for a tool.

Parameters

wParam

Must be zero.

lParam

Pointer to a TOOLINFO structure that specifies the information to set. The cbSize member of this structure must be set before sending this message.

Return value

No return value.

Remarks

Some internal properties of a tool are established when the tool is created, and are not recomputed when a TTM_SETTOOLINFO message is sent. If you simply assign values to a TOOLINFO structure and pass it to the tooltip control with a TTM_SETTOOLINFO message, these properties may be lost. Instead, your application should first request the tool's current TOOLINFO structure by sending the tooltip control a TTM_GETTOOLINFO message. Then, modify the members of this structure as needed and pass it back to the tooltip control with TTM_SETTOOLINFO.

When calling TTM_SETTOOLINFO, the string pointed to by the lpszText member of the TOOLINFO structure must not exceed 80 TCHARs in length, including the terminating NULL.

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_SETTOOLINFOW (Unicode) and TTM_SETTOOLINFOA (ANSI)