在MFC程序中使用XML文件配置工具栏
作者：朱金灿
来源：http://www.cnblogs.com/clever101
现在我发现使用Visual Studio的资源编辑器进行编辑资源有着诸多的不便：首先是任何资源的变动一般变动代码，不利于系统维护，其次Visual Studio的资源编辑器的本身的功能有限，也不利于界面美化，三是不利于人员分工，开发人员既要忙实现功能，又要忙准备好的界面素材。对界面实现文件配置化正是解决上面问题的好方法。这次我实现了使用XML文件配置工具栏。这里所谓配置就是工具栏的界面信息如工具栏标题、按钮图片、是否为分隔符都在XML文件保存，程序通过解析XML文件来获取工具栏信息来创建工具栏。这样一旦发现界面不合适可以随时修改配置文件，同时利于人员分工。
具体的做法如下：
1. 在工程的输出目录下有一个SysConfig.xml，作为系统配置文件。其中关于工具栏的配置部分如下：
<AppToolbar valid="1" caption="基础工具">
<ToolButton file="Add.bmp" />
<ToolButton separator="true" />
<ToolButton file="Benchmark.bmp" />
<ToolButton file="Comment.bmp" />
<ToolButton file="Convert.bmp" />
<ToolButton file="Delete.bmp" />
<ToolButton file="Exit.bmp" />
</AppToolbar>
<ToolButton file="Add.bmp" />
<ToolButton separator="true" />
<ToolButton file="Benchmark.bmp" />
<ToolButton file="Comment.bmp" />
<ToolButton file="Convert.bmp" />
<ToolButton file="Delete.bmp" />
<ToolButton file="Exit.bmp" />
</AppToolbar>
简单解释一下上面的节点意义：valid表示工具栏是否有效，caption表示工具栏标题，file节点为工具栏按钮所贴图片，separator表示按钮是分隔符。
2. 通过解析XML文件获取工具栏信息来创建工具栏。首先在CMainFrame类添加两个数据成员：
/**
* \brief 工具栏对应的图像列表。
*/
CImageList m_imgToobar;
/**
* \brief 系统配置文件解析器，具体看我上传的代码。
*/
CXmlParse m_SysSetting;
* \brief 工具栏对应的图像列表。
*/
CImageList m_imgToobar;
/**
* \brief 系统配置文件解析器，具体看我上传的代码。
*/
CXmlParse m_SysSetting;
然后实现如下函数：
/*!
* \brief 获取exe所在的文件夹。
*
* \param [in][out]strBinPath exe程序所在的文件夹。
* \return 无。
*/
void CMainFrame::GetOutputPath(string &strBinPath)
{
TCHAR szModulePath[_MAX_PATH];
::GetModuleFileName(NULL,szModulePath,_MAX_PATH);
strBinPath = szModulePath;
strBinPath = strBinPath.substr(0,strBinPath.rfind('\\')+1);
}
/*!
* \brief 解析系统配置文件，获取工具栏信息。
*
* \param [in][out]MyToolbar 工具栏信息。
* \return 无。
*/
void CMainFrame::ParseXml(ToolBar &MyToolbar)
{
string strBinPath;
GetOutputPath(strBinPath);
string strXmlPath = strBinPath + string(_T("SysConfig.xml"));
m_SysSetting.OpenXml(strXmlPath);
m_SysSetting.GetToolbarInfo(MyToolbar);
}
/*!
* \brief 根据工具栏图片信息加载工具栏图像列表。
*
* \param [in]MyToolbar 工具栏信息。
* \return 是否成功。true为成功，false表示失败。
*/
BOOL CMainFrame::LoadImageList(ToolBar &MyToolbar)
{
// 获取按钮图片的个数
int nBmpNum = MyToolbar.m_MenuItemVec.size();
HBITMAP hBitmap = NULL;
// 打开所有位图，将其加进图像列表
for(int i=0; i<nBmpNum; ++i)
{
if (MyToolbar.m_MenuItemVec[i].m_bIsSeparator)
{
continue;
}
string strBinPath;
GetOutputPath(strBinPath);
string strBmpPath = strBinPath + string(_T("Toolbar\\"));
strBmpPath = strBmpPath + MyToolbar.m_MenuItemVec[i].m_strBmpName;
hBitmap = (HBITMAP)LoadImage(AfxGetResourceHandle(),strBmpPath.c_str(), IMAGE_BITMAP, 0, 0, LR_DEFAULTCOLOR|LR_LOADFROMFILE);
if (NULL==hBitmap)
{
return FALSE;
}
CBitmap bmp;
bmp.Attach(hBitmap);
m_imgToobar.Add(&bmp, RGB(0, 0, 0));
bmp.DeleteObject();
}
return TRUE;
}
/*!
* \brief 设置工具栏按钮风格。
*
* \param [in]MyToolbar 工具栏信息。
* \return 无。
*/
BOOL CMainFrame::SetStyleToolbar(ToolBar &MyToolbar)
{
CToolBarCtrl& tbc = m_wndToolBar.GetToolBarCtrl();
// 删除之前的按钮
while(tbc.DeleteButton(0));
// 设置当前图像列表
tbc.SetImageList(&m_imgToobar);
int i = 0;
int nBtnNum = MyToolbar.m_MenuItemVec.size();
UINT nBtnID = SYS_COMMAND_BEGIN;
int nImgIndex = 0;
// 根据按钮属性逐个添加按钮
for(i=0; i<nBtnNum; ++i)
{
if (MyToolbar.m_MenuItemVec[i].m_bIsSeparator)
{
TBBUTTON tb = {-1,0,TBSTATE_ENABLED,TBSTYLE_SEP,0,0};
tbc.AddButtons(1, &tb);
}
else
{
TBBUTTON tb = {nImgIndex,nBtnID,TBSTATE_ENABLED,TBSTYLE_BUTTON,0,0};
tbc.AddButtons(1, &tb);
nImgIndex++;
nBtnID++;
}
}
return TRUE;
}
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CFrameWnd::OnCreate(lpCreateStruct) == -1)
return -1;
/*
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
| CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
!m_wndToolBar.LoadToolBar(IDR_MAINFRAME))*/
// 解析系统配置文件，获取位图信息
ToolBar AppToolbar;
ParseXml(AppToolbar);
if(!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD|WS_VISIBLE|CBRS_TOP
|CBRS_GRIPPER|CBRS_TOOLTIPS|CBRS_FLYBY|CBRS_SIZE_DYNAMIC))
{
TRACE0("未能创建工具栏\n");
return -1; // 未能创建
}
m_wndToolBar.SetWindowText(AppToolbar.m_strCaption.c_str());
// 创建图像列表
m_imgToobar.Create(32, 32, ILC_COLOR32|ILC_MASK, 0, 0);
if(LoadImageList(AppToolbar))
{
// 添加工具栏按钮
SetStyleToolbar(AppToolbar);
}
// 设置工具栏按钮大小
m_wndToolBar.SetSizes(CSize(32+7, 32+6), CSize(32, 32));
if (!m_wndStatusBar.Create(this) ||
!m_wndStatusBar.SetIndicators(indicators,
sizeof(indicators)/sizeof(UINT)))
{
TRACE0("未能创建状态栏\n");
return -1; // 未能创建
}
// TODO: 如果不需要工具栏可停靠，则删除这三行
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);
return 0;
}
* \brief 获取exe所在的文件夹。
*
* \param [in][out]strBinPath exe程序所在的文件夹。
* \return 无。
*/
void CMainFrame::GetOutputPath(string &strBinPath)
{
TCHAR szModulePath[_MAX_PATH];
::GetModuleFileName(NULL,szModulePath,_MAX_PATH);
strBinPath = szModulePath;
strBinPath = strBinPath.substr(0,strBinPath.rfind('\\')+1);
}
/*!
* \brief 解析系统配置文件，获取工具栏信息。
*
* \param [in][out]MyToolbar 工具栏信息。
* \return 无。
*/
void CMainFrame::ParseXml(ToolBar &MyToolbar)
{
string strBinPath;
GetOutputPath(strBinPath);
string strXmlPath = strBinPath + string(_T("SysConfig.xml"));
m_SysSetting.OpenXml(strXmlPath);
m_SysSetting.GetToolbarInfo(MyToolbar);
}
/*!
* \brief 根据工具栏图片信息加载工具栏图像列表。
*
* \param [in]MyToolbar 工具栏信息。
* \return 是否成功。true为成功，false表示失败。
*/
BOOL CMainFrame::LoadImageList(ToolBar &MyToolbar)
{
// 获取按钮图片的个数
int nBmpNum = MyToolbar.m_MenuItemVec.size();
HBITMAP hBitmap = NULL;
// 打开所有位图，将其加进图像列表
for(int i=0; i<nBmpNum; ++i)
{
if (MyToolbar.m_MenuItemVec[i].m_bIsSeparator)
{
continue;
}
string strBinPath;
GetOutputPath(strBinPath);
string strBmpPath = strBinPath + string(_T("Toolbar\\"));
strBmpPath = strBmpPath + MyToolbar.m_MenuItemVec[i].m_strBmpName;
hBitmap = (HBITMAP)LoadImage(AfxGetResourceHandle(),strBmpPath.c_str(), IMAGE_BITMAP, 0, 0, LR_DEFAULTCOLOR|LR_LOADFROMFILE);
if (NULL==hBitmap)
{
return FALSE;
}
CBitmap bmp;
bmp.Attach(hBitmap);
m_imgToobar.Add(&bmp, RGB(0, 0, 0));
bmp.DeleteObject();
}
return TRUE;
}
/*!
* \brief 设置工具栏按钮风格。
*
* \param [in]MyToolbar 工具栏信息。
* \return 无。
*/
BOOL CMainFrame::SetStyleToolbar(ToolBar &MyToolbar)
{
CToolBarCtrl& tbc = m_wndToolBar.GetToolBarCtrl();
// 删除之前的按钮
while(tbc.DeleteButton(0));
// 设置当前图像列表
tbc.SetImageList(&m_imgToobar);
int i = 0;
int nBtnNum = MyToolbar.m_MenuItemVec.size();
UINT nBtnID = SYS_COMMAND_BEGIN;
int nImgIndex = 0;
// 根据按钮属性逐个添加按钮
for(i=0; i<nBtnNum; ++i)
{
if (MyToolbar.m_MenuItemVec[i].m_bIsSeparator)
{
TBBUTTON tb = {-1,0,TBSTATE_ENABLED,TBSTYLE_SEP,0,0};
tbc.AddButtons(1, &tb);
}
else
{
TBBUTTON tb = {nImgIndex,nBtnID,TBSTATE_ENABLED,TBSTYLE_BUTTON,0,0};
tbc.AddButtons(1, &tb);
nImgIndex++;
nBtnID++;
}
}
return TRUE;
}
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CFrameWnd::OnCreate(lpCreateStruct) == -1)
return -1;
/*
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
| CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
!m_wndToolBar.LoadToolBar(IDR_MAINFRAME))*/
// 解析系统配置文件，获取位图信息
ToolBar AppToolbar;
ParseXml(AppToolbar);
if(!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD|WS_VISIBLE|CBRS_TOP
|CBRS_GRIPPER|CBRS_TOOLTIPS|CBRS_FLYBY|CBRS_SIZE_DYNAMIC))
{
TRACE0("未能创建工具栏\n");
return -1; // 未能创建
}
m_wndToolBar.SetWindowText(AppToolbar.m_strCaption.c_str());
// 创建图像列表
m_imgToobar.Create(32, 32, ILC_COLOR32|ILC_MASK, 0, 0);
if(LoadImageList(AppToolbar))
{
// 添加工具栏按钮
SetStyleToolbar(AppToolbar);
}
// 设置工具栏按钮大小
m_wndToolBar.SetSizes(CSize(32+7, 32+6), CSize(32, 32));
if (!m_wndStatusBar.Create(this) ||
!m_wndStatusBar.SetIndicators(indicators,
sizeof(indicators)/sizeof(UINT)))
{
TRACE0("未能创建状态栏\n");
return -1; // 未能创建
}
// TODO: 如果不需要工具栏可停靠，则删除这三行
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);
return 0;
}
为使工具栏处于有效状态，还得添加一个简单的消息处理函数，简单如下：
/*!
* \brief 工具栏按钮响应事件。
*
* \param [in]nID 工具栏按钮ID。
* \return 无。
*/
void CMainFrame::OnButton(UINT nID)
{
switch (nID)
{
// SYS_COMMAND_BEGIN为工具栏按钮的起始ID值
case SYS_COMMAND_BEGIN:
AfxMessageBox(_T("你单击的是第一个按钮"));
break;
case SYS_COMMAND_BEGIN+1:
AfxMessageBox(_T("你单击的是第二个按钮"));
break;
case SYS_COMMAND_BEGIN+2:
AfxMessageBox(_T("你单击的是第三个按钮"));
break;
case SYS_COMMAND_BEGIN+3:
AfxMessageBox(_T("你单击的是第四个按钮"));
break;
case SYS_COMMAND_BEGIN+4:
AfxMessageBox(_T("你单击的是第五个按钮"));
break;
case SYS_COMMAND_BEGIN+5:
AfxMessageBox(_T("你单击的是第六个按钮"));
break;
default:
break;
}
}
* \brief 工具栏按钮响应事件。
*
* \param [in]nID 工具栏按钮ID。
* \return 无。
*/
void CMainFrame::OnButton(UINT nID)
{
switch (nID)
{
// SYS_COMMAND_BEGIN为工具栏按钮的起始ID值
case SYS_COMMAND_BEGIN:
AfxMessageBox(_T("你单击的是第一个按钮"));
break;
case SYS_COMMAND_BEGIN+1:
AfxMessageBox(_T("你单击的是第二个按钮"));
break;
case SYS_COMMAND_BEGIN+2:
AfxMessageBox(_T("你单击的是第三个按钮"));
break;
case SYS_COMMAND_BEGIN+3:
AfxMessageBox(_T("你单击的是第四个按钮"));
break;
case SYS_COMMAND_BEGIN+4:
AfxMessageBox(_T("你单击的是第五个按钮"));
break;
case SYS_COMMAND_BEGIN+5:
AfxMessageBox(_T("你单击的是第六个按钮"));
break;
default:
break;
}
}
开发环境为Visual C++ 2005 + sp1，Win XP + sp3。程序效果图如下：
工程源码已上传到联合程序开发网，链接为：
源码下载。
参考文献：
1. MFC实现 多风格真彩色大图标工具栏按钮 （感谢万连文大侠提供）
