TB_SETTOOLTIPS

This message adds an array of ToolTip strings to a toolbar.

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later

Syntax

  1. TB_SETTOOLTIPS uNumToolTip = (UINT) wParam lpToolTips = (LPTSTR) lParam

Parameters

hwndToolTip

Handle to the ToolTip control.

Return Values

None.

Remarks

The TB_SETTOOLTIPS message in Windows CE is different from the TB_SETTOOLTIPS message in Windows 95 and Windows NT.

Windows CE does not support ToolTip controls, so instead of taking a handle to a ToolTip control as its sole parameter, the TB_SETTOOLTIPS message in Windows CE takes both a wParam and an lParam. The wParam represents the number of ToolTip strings to associate with the toolbar, and the lParam is the array of strings to be displayed as ToolTips.

In Windows CE, only toolbar buttons can have ToolTip strings; menus and combo boxes cannot.

The TB_SETTOOLTIPS message uses the memory address passed in the lpToolTips parameter. Do not release the memory allocated for the ToolTip string array until the program exits.