【MFC】具有提示功能的工具栏

00. 目录

文章目录

00. 目录
01. 案例概述
02. 开发环境
03. 关键技术
04. 程序设计
05. 秘笈心法
06. 源码下载
07. 附录

01. 案例概述

在文档\视图结构的应用程序中，默认情况下，当鼠标在工具栏按钮上停留片刻，会出现一个工具提示条。那么在基于对话框的应用程序中能够实现该功能吗？运行本案例，将鼠标移至工具栏上的某一按钮上，即可看到该工具按钮的提示信息，效果如下图所示。

02. 开发环境

系统环境：Windows 10

开发环境：Visual Studio 2019

03. 关键技术

使工具栏具有提示功能，需要同时具备几个条件。一是工具栏具有CBRS_TOOLTIPS风格，二是工具栏的父窗口需要处理TTN_NEEDTEXT通知消息。在MFC类库中，CFrameWnd默认处理了TTN_NEEDTEXT通知消息，因此，在文档\视图结构的应用程序中，只要工具栏具有CBRS_TOOLTIPS风格，就能够显示提示信息。

如果在对话框中添加TTN_NEEDTEXT通知消息，需要在消息映射部分添加如下代码：

ON_NOTIFY_EX( TTN_NEEDTEXT, 0, OnToolTipNotify)

其中，OnToolTipNotify是处理TTN_NEEDTEXT消息的函数，函数原型如下：

OnToolTipNotify(UINT id, NMHDR *pNMHDR, LRESULT *pResult)

参数说明：

参数id是发送消息的控件ID，但此处没有用，因为控件ID可以来自于pNMHDR。

参数pNMHDR是一个NMHDR（实际应该是NMTTDISPINFO结构指针）结构指针，NMHDR结构记录了发送消息的控件ID、句柄等信息。

参数pResult表示结果代码指针，TTN_NEEDTEXT消息可以忽略该参数。

04. 程序设计

（1）新建一个基于对话框的工程。

（2）在对话框类中定义一个CToolBar变量m_ToolBar。在工作区的资源视图中创建一个工具栏资源。

（3）在对话框的OnInitDialog方法中创建工具栏。

（4）在对话框的消息映射部分添加TTN_NEEDTEXT消息映射宏。

（5）向对话框中添加OnToolTipNotify方法，代码如下：

头文件

// CMy4ToolDlg 对话框
class CMy4ToolDlg : public CDialogEx
{// 构造
public:CMy4ToolDlg(CWnd* pParent = nullptr);   // 标准构造函数CToolBar m_ToolBar;CString m_Str;// 对话框数据
#ifdef AFX_DESIGN_TIMEenum { IDD = IDD_MY4TOOL_DIALOG };
#endifprotected:virtual void DoDataExchange(CDataExchange* pDX);    // DDX/DDV 支持// 实现
protected:HICON m_hIcon;// 生成的消息映射函数virtual BOOL OnInitDialog();afx_msg void OnSysCommand(UINT nID, LPARAM lParam);afx_msg void OnPaint();afx_msg HCURSOR OnQueryDragIcon();afx_msg BOOL OnToolTipNotify(UINT id, NMHDR* pNMHDR, LRESULT* pResult);DECLARE_MESSAGE_MAP()
};

源文件

BEGIN_MESSAGE_MAP(CMy4ToolDlg, CDialogEx)ON_WM_SYSCOMMAND()ON_WM_PAINT()ON_WM_QUERYDRAGICON()ON_NOTIFY_EX(TTN_NEEDTEXT, 0, OnToolTipNotify)
END_MESSAGE_MAP()BOOL CMy4ToolDlg::OnInitDialog()
{CDialogEx::OnInitDialog();// 将“关于...”菜单项添加到系统菜单中。// IDM_ABOUTBOX 必须在系统命令范围内。ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);ASSERT(IDM_ABOUTBOX < 0xF000);CMenu* pSysMenu = GetSystemMenu(FALSE);if (pSysMenu != nullptr){BOOL bNameValid;CString strAboutMenu;bNameValid = strAboutMenu.LoadString(IDS_ABOUTBOX);ASSERT(bNameValid);if (!strAboutMenu.IsEmpty()){pSysMenu->AppendMenu(MF_SEPARATOR);pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);}}// 设置此对话框的图标。  当应用程序主窗口不是对话框时，框架将自动//  执行此操作SetIcon(m_hIcon, TRUE);            // 设置大图标SetIcon(m_hIcon, FALSE);        // 设置小图标// TODO: 在此添加额外的初始化代码UINT array[10];for (int i = 0; i < 10; i++){if (i == 3 || i == 7)array[i] = ID_SEPARATOR; //第4、8个按钮为分隔条elsearray[i] = i + 1001;}m_ToolBar.Create(this);m_ToolBar.SetButtons(array, 10);m_ToolBar.SetButtonText(0, TEXT("新建"));m_ToolBar.SetButtonText(1, TEXT("打开"));m_ToolBar.SetButtonText(2, TEXT("保存"));m_ToolBar.SetButtonText(4, TEXT("剪切"));m_ToolBar.SetButtonText(5, TEXT("复制"));m_ToolBar.SetButtonText(6, TEXT("粘贴"));m_ToolBar.SetButtonText(8, TEXT("打印"));m_ToolBar.SetButtonText(9, TEXT("帮助"));m_ToolBar.LoadBitmap(IDB_BITMAP1);            //加载位图m_ToolBar.SetSizes(CSize(36, 36), CSize(16, 16)); //设置按钮和按钮位图大小m_ToolBar.EnableToolTips(TRUE);RepositionBars(AFX_IDW_CONTROLBAR_FIRST, AFX_IDW_CONTROLBAR_LAST, 0); //显示工具栏return TRUE;  // 除非将焦点设置到控件，否则返回 TRUE
}BOOL CMy4ToolDlg::OnToolTipNotify(UINT id, NMHDR* pNMHDR, LRESULT* pResult)
{TOOLTIPTEXT* pTTT = (TOOLTIPTEXT*)pNMHDR;//获取工具栏按钮IDUINT nId = pNMHDR->idFrom;//根据ID获取按钮索引int index = m_ToolBar.GetToolBarCtrl().CommandToIndex(nId);//根据索引获取按钮文本m_ToolBar.GetButtonText(index, m_Str);//设置显示的提示信息pTTT->lpszText = m_Str.GetBuffer(0);pTTT->hinst = AfxGetResourceHandle();return TRUE;}

05. 秘笈心法

信息提示的实现

信息提示的方法有很多，实例中使用的是处理TTN_NEEDTEXT消息的方法，同样还可以使用ctooltip控件的方法来实现提示效果。

06. 源码下载

下载：【MFC】具有提示功能的工具栏.rar

07. 附录

参考：《Visual C++从入门到精通(项目案例版)》