处理工具提示通知

指定 TBSTYLE_TOOLTIPS 样式时,工具栏将创建和管理工具提示控件。 工具提示是一个小弹出窗口,其中包含描述工具栏按钮的文本行。 工具提示处于隐藏状态,仅当用户将光标放在工具栏按钮上并留在那里大约一半秒时才会显示。 工具提示显示在光标附近。

在显示工具提示之前, TTN_NEEDTEXT 通知消息发送到工具栏的所有者窗口,以检索按钮的描述性文本。 如果工具栏的所有者窗口是窗口 CFrameWnd ,则会显示工具提示,无需任何额外的工作,因为 CFrameWnd 具有 TTN_NEEDTEXT 通知的默认处理程序。 如果工具栏的所有者窗口不是派生自 CFrameWnd对话框或窗体视图,则必须将条目添加到所有者窗口的邮件映射中,并在消息映射中提供通知处理程序。 所有者窗口消息映射的条目如下所示:

ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)

注解

memberFxn
此按钮需要文本时要调用的成员函数。

请注意,工具提示的 ID 始终为 0。

除了 TTN_NEEDTEXT 通知之外,工具提示控件还可以将以下通知发送到工具栏控件:

通知 含义
TTN_NEEDTEXTA 工具提示控件需要 ASCII 文本(仅限 Windows 95)
TTN_NEEDTEXTW 工具提示控件需要 UNICODE 文本(仅限 Windows NT)
TBN_HOTITEMCHANGE 指示热(突出显示)项已更改。
NM_RCLICK 指示用户已右键单击按钮。
TBN_DRAGOUT 指示用户已单击该按钮,并将指针拖离该按钮。 它允许应用程序实现从工具栏按钮拖放。 收到此通知时,应用程序将开始拖放作。
TBN_DROPDOWN 指示用户已单击使用 TBSTYLE_DROPDOWN 样式的按钮。
TBN_GETOBJECT 指示用户将指针移到使用 TBSTYLE_DROPPABLE 样式的按钮上。

有关示例处理程序函数以及有关启用工具提示的详细信息,请参阅 工具提示

另请参阅

使用 CToolBarCtrl
控件