关于vs2008 SP1中CMFCToolBar的一些事儿

最新推荐文章于 2022-01-07 15:16:23 发布

zhongyu627

最新推荐文章于 2022-01-07 15:16:23 发布

阅读量1.8k

点赞数

分类专栏： MFC 文章标签：工具 wizard mfc menu 文档测试

MFC 专栏收录该内容

49 篇文章

订阅专栏

本文介绍了在MFC中创建和定制工具栏的过程，包括解决工具栏加载、图标显示等问题，并提供了一个可下载的示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

话说昨天解决了MFC跨线程操作控件的问题，我满以为今天可以free一回，玩玩Linux、学学Vim、再准备一下毕业论文的事情，但还是有事情要做，然后又是“被”MFC郁闷了一天。

先介绍一下总体的情况。我们项目客户端的开发环境是VS2008+SP1，用的是MFC类库，里面居然用到了CMFCToolBar、CMFCMenuBar以及Appearance变化等的SPI新特性。说“居然”是因为这些东西不是项目必要的，当时可能也以为只是名字变了用法没变，估计在工程创建的时候根本就没有考虑这些，直接按着单文档工程默认配置，next、next直接创建完的，囧！当时做的时候也只是当作测试Demo来用，也没太在意，毕竟我们项目的重点在服务器而非这个MFC客户端。

后来由于项目原因，甲方要求我们把这个客户端尽快修改成一个可以发布版本。不改不知道，一改吓一跳，当准备动手修改工具栏时才发现与以前惯的CToolBar真实差距甚大。CToolBar可以用CImageList把自定义的BMP图片放到工具栏的按钮，详细可看这里，CMFCToolBar根本就不是这样的一个玩法。直接放一个CToolBar上来，在DockControlBar()的时候会出现断言错误（缺少DockBar，貌似是这个名字，汗！）。定位代码到MainFrm的EnableDocking()，现在的MainFrm的继承关系是CMainFrm->CFrameWndEx->CFrameWnd，而以前是CMainFrm->CFrameWnd，CFrameWndEx::EnableDocking()是为DockPane()服务的，而DockControlBar()需要的DockBar并不会被初始化。调用基类的CFrameWnd::EnableDocking()后再DockControlBar()不会出现断言，但是那个工具栏没有显示。而且现在新特性下在工具栏位置能够按出右键菜单，但右键菜单中根本不可能有关于该CToolBar的信息，乍看起来很不和谐~

最后，求助本地MSDN无果，貌似SP1没有包含对MSDN文档的更新；求助MSDN官网，那个真是“言简意赅”。只能说，MS你这次真的“亮”了！

以下为google + vs2008 sp1 sample + 看代码的成果：

创建默认ToolBar外的第二个ToolBar

注意，Wizard生成的工具栏Create时没有带ID，但第二个工具栏Create时最好要带ID。加了ID之后，在工具栏右键菜单才会出现第二个工具栏的CheckBox。否则，不良后果有：1、右键菜单没有该工具栏Checkbox；2、把默认工具栏和该工具栏拖出来（浮动），可以看到名字都是一样的（英文版为Standard）；3、后面要提到的UserImage不能作为按钮图标显示。

加载工具栏资源

我们先来看看CMFCToolBar加载工具栏的函数原型：

1 virtual BOOL LoadToolBar(UINT uiResID, UINT uiColdResID = 0 , UINT uiMenuResID = 0 , BOOL bLocked = FALSE,
2 UINT uiDisabledResID = 0 , UINT uiMenuDisabledResID = 0 , UINT uiHotResID = 0 );

可以看出，uiResID代表要加载的工具栏资源，理论上只需要这一个参数就能完成工具栏的加载。但是VS的Toolbar Editor只能编辑4bit的工具栏图标，以前CToolBar是用CImagList来加载更多bits的图标的，现在应该怎么做呢？多亏了Explore sample的例子，我发现后面的几个UINT参数就是BMP的资源，最主要的是最后一个uiHotResID，即便其他用默认值，这项赋BMP ID就能按预期的图标显示。Cold、Disable表示的是不同状态下的图标样式，带Menu的是Menu有关的图标，具体可看SP1 Feature的sample。
我的Demo里自定义工具栏的总创建过程：

1     if ( ! m_mybar.CreateEx( this , TBSTYLE_FLAT,
2                             WS_CHILD | WS_VISIBLE | CBRS_TOP | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC,
3                             CRect( 1 , 1 , 1 , 1 ), ID_MYBAR) ||
4          ! m_mybar.LoadToolBar( IDR_TOOLBAR1, 0 , 0 , FALSE, 0 , 0 , theApp.m_bHiColorIcons ? IDB_BITMAP1: 0 ) )
5     {
6         TRACE0( " Failed to create toolbar\n " );
7         return - 1 ;       // fail to create
8     }
9     m_mybar.SetWindowText(_T( " abc " ));

最后的SetWindowText()设置工具栏的名称。
CMFCToolBar有LoadBitmap的方法，但是测试发现，用LoadToolBar只加载工具栏资源，再用LoadBitmap加载BMP资源，虽然返回值是TRUE，但显示图标为空白，没有实际效果。

工具栏停靠

1 // TODO: Delete these five lines if you don't want the toolbar and menubar to be dockable
2    m_wndMenuBar.EnableDocking(CBRS_ALIGN_ANY);
3    m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
4    m_mybar.EnableDocking(CBRS_ALIGN_ANY);
5    EnableDocking(CBRS_ALIGN_ANY);
6    DockPane( & m_wndMenuBar);
7    DockPane( & m_wndToolBar);
8    DockPane( &m_mybar);

与默认工具栏无异。

用户自定义图标

CMFCToolBar可以让用户自定义工具栏图标，使用静态成员函数SetUserImages()将一个CMFCToolBarImages对象设置进去，由所有CMFCToolBar对象共享。Wizard自动生成代码中有这样的例子：

1     if (CMFCToolBar::GetUserImages() == NULL)
2     {
3          // load user-defined toolbar images
4          if (m_UserImages.Load(_T( " .\\UserImages.bmp " )))
5         {
6             m_UserImages.SetImageSize(CSize( 16 , 16 ), FALSE);
7             CMFCToolBar::SetSizes(CSize( 16 , 16 ), CSize( 16 , 16 ));
8             CMFCToolBar::SetUserImages( & m_UserImages);
9         }
10     }

这个例子加载了工程路径下的一个BMP，其他方法可以查看MSDN，与CImageList有点点类似。
使用CMFCToolBar::ReplaceButton()可以替换已有的工具栏按钮，以下是我的Demo中的代码：

1 m_mybar.ReplaceButton( ID_QTLOGO, CMFCToolBarButton(ID_QTLOGO, 0 , _T( " 123 " ), TRUE) );

第一个参数ID_QTLOGO为自定义工具栏上的一个按钮，后面是一个 CMFCToolBarButton的临时对象。 CMFCToolBarButton构造函数第一个参数为替换后的ID，第三个参数为名称，第二个参数为图标的索引(zero-based)，第四个参数为m_bUserButton，指明第二个参数是索引工具栏已加载图标(LoadToolBar或LoadBitmap)还是用户自定义图标（SetuserImages），TRUE指用户自定义图标。这里的结果是将ID_QTLOGO上的图标替换为 UserImages.bmp上的第一个图标。

GetCmdMgr() -> GetCmdImage()可以根据工具栏上图标的ID获取出已加载图标的索引值：

这里将工具栏上ID_QTLOGO的图标替换为ID_PLUS按钮对应的图标。

特别地，如果在你将这些工具栏改来改去但显示结果却没有改变的时候，你可以尝试删除 HKEY_CURRENT_USER\Software\Local AppWizard-Generated Applications\$(你的程序名) 这个键值，当你重启程序后工具栏应该会按你的预想变化的。这是我在查资料时看到的，当时没注意但后来发现挺有用的，出处没有记录下来。

最后，ReplaceButton还可以将按钮替换为其他控件。

其他...

我在自定义工具栏上做了一个有效响应，里面使用静态成员函数CMFCToolBar::ResetAllImages()将所有图标都清空了，此时会发现默认工具栏、自定义工具栏的图标都为空。

1 void CMainFrame::OnQtLogo()
2 {
3     CMFCToolBar::ResetAllImages();
4
5      // CMFCToolBar::AddToolBarForImageCollection(IDR_MENU_IMAGES, theApp.m_bHiColorIcons ? IDB_MENU_IMAGES_24 : 0);
6
7     m_wndToolBar.LoadBitmap(IDB_BITMAP1);
8     m_mybar.LoadBitmap(IDR_MAINFRAME_256);
9     m_wndToolBar.RedrawWindow();
10     m_mybar.RedrawWindow();
11 }

更奇妙的是，后面我对两个工具栏重新加载了BMP，而且加载的BMP资源是反了的，此时默认工具栏上出现了原来自定义工具栏的4个图标，余下部分及自定义工具栏则为原来默认工具栏图标。可以想象，RestAllImages只是将图标资源都释放了，工具栏资源依然健在，重新加载BMP的时候，工具栏图标就像一个个顺序排好的空间，加载进来的BMP图标会出现从前往后补位的现象。
注意代码中，默认工具栏图标重新加载时使用的资源是IDR_MAINFRAME_256，是默认的工具栏资源。也就是说，这里用LoadBitmap加载工具栏资源也是有效果的。这样应该可以说明工具栏在创建时LoadToolBar、LoadBitmap分别成功地加载了工具栏、BMP资源，实际上是加载了两套图标资源，这两者是顺序而非重合的，所以只显示原来的工具栏资源。要想指定两者的重合关系，只有在LoadToolBar的时候同时传入工具栏资源及BMP资源的ID。

Demo下载

————————————————————————————————————————————————————————————————
好吧，终于写完了！写得很仓促，不足的地方也很多，欢迎指教！

转载：http://www.360doc.com/content/11/1115/16/7992306_164560548.shtml