Handling Tool Tip Notifications
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at Handling Tool Tip Notifications.
When you specify the TBSTYLE_TOOLTIPS style, the toolbar creates and manages a tool tip control. A tool tip is a small pop-up window that contains a line of text describing a toolbar button. The tool tip is hidden, appearing only when the user puts the cursor on a toolbar button and leaves it there for approximately one-half second. The tool tip is displayed near the cursor.
Before the tool tip is displayed, the TTN_NEEDTEXT notification message is sent to the toolbar's owner window to retrieve the descriptive text for the button. If the toolbar's owner window is a CFrameWnd window, tool tips are displayed without any extra effort, because CFrameWnd has a default handler for the TTN_NEEDTEXT notification. If the toolbar's owner window is not derived from CFrameWnd, such as a dialog box or form view, you must add an entry to your owner window's message map and provide a notification handler in the message map. The entry to your owner window's message map is as follows:
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
Remarks
memberFxn
The member function to be called when text is needed for this button.
Note that the id of a tool tip is always 0.
In addition to the TTN_NEEDTEXT notification, a tool tip control can send the following notifications to a toolbar control:
| Notification | Meaning |
|---|---|
| TTN_NEEDTEXTA | Tool tip control requires ASCII text (Windows 95 only) |
| TTN_NEEDTEXTW | Tool tip control requires UNICODE text (Windows NT only) |
| TBN_HOTITEMCHANGE | Indicates that the hot (highlighted) item has changed. |
| NM_RCLICK | Indicates the user has right-clicked a button. |
| TBN_DRAGOUT | Indicates the user has clicked the button and dragged the pointer off the button. It allows an application to implement drag and drop from a toolbar button. When receiving this notification, the application will begin the drag and drop operation. |
| TBN_DROPDOWN | Indicates the user has clicked a button that uses the TBSTYLE_DROPDOWN style. |
| TBN_GETOBJECT | Indicates the user moved the pointer over a button that uses the TBSTYLE_DROPPABLE style. |
For an example handler function and more information about enabling tool tips, see Tool Tips.