MFC小型工具通用界面框架CLIST控件+右键菜单功能
MFC-小型工具通用界面框架
0x1 场景
由于工作需要我会写代码开发工具给客户或者同事用。代码都能实现，但写个黑乎乎的命令行工具给别人用确实显得不够专业，用别人写好的成型工具又担心有后门。
所以掌握积累几个MFC的常用控件随时调用，代码量堆起来了就是不断反复利用的过程了。未来还是会把精力用在实现实际功能上，以成为界面工程师作为目标学习很容易找不到工作。
这篇文章主要分享给大家使用MFC做GUI的技巧，选用它是因为我更熟悉C++。而且VS是非常强大的调试器，除了下载就可以用之外，还能看反汇编、内存、堆栈。
环境：VS2017
效果
0x2 技术点
- CListCtrl，界面增加列名、跟随界面调整、增加内容
- 菜单使用，删除单条、删除多条
0x3 代码
1、CListCtrl控件
界面使用部分
1、【对话框编辑器】-【List Control】，增加一个List控件拖到指定位置
2、【属性】-【View】-【Report】，把显示方式改成报表形式
3、【类向导】-【成员变量】-【添加变量】-【m_List_xxx】，绑定一个操作的变量
代码部分
- 添加List控件的列表头，增加列 InsertColumn();
m_List_xxx.InsertColumn(i, // 插入的列
g_Column_Message_Data[i].title, // 插入的标题
LVCFMT_CENTER, // 插入的样式
g_Column_Message_Data[i].nWidth); // 插入的宽度
封装函数，定义结构体部分：
定义一个结构体，成员是标题【WCHAR *title】、宽度【int nWidth】。然后初始化每一列的列名占据叫什么名字，占据多宽。
/////////////////////////////////////////// 列表控件
typedef struct
{
WCHAR *title; //列表的名称
int nWidth; //列表的宽度
}COLUMNSTRUCT;
COLUMNSTRUCT g_Column_Message_Data[] =
{
{ _T("信息类型"), 80 },
{ _T("时间"), 100 },
{ _T("信息内容"), 300 }
};
//变量声明
int g_Column_Message_Count = 3; //列表的个数
int g_Column_Message_Width = 0; //列总宽度，初始化为0。在后面的函数中会赋值
新建一个函数【int GUI_InitList(void)】，在【OnInitDialog()】里调用。初始化List显示的列表名
int CAPTFilecheckDlg::GUI_InitList(void)
{
// init online list
m_CList_dirlist.SetExtendedStyle(LVS_EX_FULLROWSELECT);
for (int i = 0; i < g_Column_Online_Count; i++)
{
m_CList_dirlist.InsertColumn(i, g_Column_Online_Data[i].title, LVCFMT_CENTER, g_Column_Online_Data[i].nWidth);
g_Column_Online_Width += g_Column_Online_Data[i].nWidth; //得到总宽度
}
m_CList_MESSAGE.SetExtendedStyle(LVS_EX_FULLROWSELECT);
for (int i = 0; i < g_Column_Message_Count; i++)
{
m_CList_MESSAGE.InsertColumn(i, g_Column_Message_Data[i].title, LVCFMT_CENTER, g_Column_Message_Data[i].nWidth);
g_Column_Message_Width += g_Column_Message_Data[i].nWidth; //得到总宽度
}
return 0;;
}
- 跟随界面调整大小
最大化的时候界面跟着变大。
【类向导】-【消息】-【WM_SIZE】-【添加处理程序】，增加一个【OnSize】的消息函数
void CMFCClistDlg::OnSize(UINT nType, int cx, int cy)
{
CDialogEx::OnSize(nType, cx, cy);
// TODO: 在此处添加消息处理程序代码
// 命中目标
double dcx = cx; //对话框的总宽度
if (m_List_xxx.m_hWnd != NULL)
{
CRect rc;
rc.left = 1; //列表的左坐标
rc.top = 20; //列表的上坐标
rc.right = cx - 1; //列表的右坐标
rc.bottom = cy - 20; //列表的下坐标
m_List_xxx.MoveWindow(rc);
for (auto i = 0; i < g_Column_Message_Count; i++) { //遍历每一个列
double dd = g_Column_Message_Data[i].nWidth; //得到当前列的宽度
dd /= g_Column_Message_Width; //看一看当前宽度占总长度的几分之几
dd *= dcx; //用原来的长度乘以所占的几分之几得到当前的宽度
auto lenth = dd; //转换为int 类型
m_List_xxx.SetColumnWidth(i, (lenth)); //设置当前的宽度
}
}
}
- 增加列内容InsertItem()/SetItemText()
m_List_xxx.InsertItem(0, L"ok"); // 第一行的第一列内容
m_List_xxx.SetItemText(0, 1, L"2"); // 第一行的第二列内容
m_List_xxx.SetItemText(0, 2, L"hello world"); // 第一行的第三列内容
封装函数部分1：
void CAPTFilecheckDlg::GUI_ShowMessage(bool bIsOK, CString strMsg)
{
CString strIsOK, strTime;
CTime t = CTime::GetCurrentTime();
strTime = t.Format("%H:%M:%S");
if (bIsOK)
{
strIsOK = "执行成功";
}
else {
strIsOK = "执行失败";
}
m_CList_MESSAGE.InsertItem(0, strIsOK);
m_CList_MESSAGE.SetItemText(0, 1, strTime);
m_CList_MESSAGE.SetItemText(0, 2, strMsg);
}
调用方法：
GUI_ShowMessage(true, L"mesage");
GUI_ShowMessage(true, L"mesage1");
GUI_ShowMessage(true, L"mesage2");
2、菜单控件
-
新建菜单
【资源视图】-【添加资源】-【Menu】 -
控件增加右键的说明
【删除单条】
【删除全部】
【增加内容】 -
添加右键菜单
在【List Control】控件右键属性找到【NM_RCLICK】，双击绑定右键事件，根据需要再增加改动。
void CMFCClistDlg::OnNMRClickList1(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);
// TODO: 在此添加控件通知处理程序代码
CMenu popup;
popup.LoadMenu(IDR_MENU1);
CMenu* pM = popup.GetSubMenu(0);
CPoint p;
GetCursorPos(&p);
int count = pM->GetMenuItemCount();
//如果没有选中
if (m_List_xxx.GetSelectedCount() == 0)
{
for (int i = 2; i < count; i++)
{ //菜单全部变灰
pM->EnableMenuItem(i, MF_BYPOSITION | MF_DISABLED | MF_GRAYED);
}
}
pM->TrackPopupMenu(TPM_LEFTALIGN, p.x, p.y, this);
*pResult = 0;
}
- 绑定事件
在每个安全事件上添加事件处理程序，在消息类型【COMMAND】、类列表【xxxxDlg】，指定事件函数比如删除单条就绑定【GUI_Dir_Delete()】、删除全部就绑定【GUI_Dir_DeleteALL_Items()】。
-
- 右键删除单行功能实现，GetItemCount()/DeleteItem()：
删除单条要先获取选中的条目，然后遍历
void CMFCClistDlg::GUI_Dir_Delete()
{
// TODO: 在此添加命令处理程序代码
int i, iState;
// 当前选择的条目
int nItemSelected = m_List_xxx.GetSelectedCount();
// 检索在列表视图控件中的项的数目。
int nItemCount = m_List_xxx.GetItemCount();
// 如果没有选择值，就退出这个函数，不执行删除判断。
if (nItemSelected < 1)
return;
// 遍历当前所有的列，找到选中的那条删除。
for (i = nItemCount - 1; i >= 0; i--)
{
iState = m_List_xxx.GetItemState(i, LVIS_SELECTED); // 获取选择状态
if (iState != 0)
{
m_List_xxx.DeleteItem(i); // 删除
}
}
}
-
- 右键删除所有行功能实现，DeleteAllItems()/SetRedraw()/RedrawWindow();
// 删除所有特征
void CMFCClistDlg::GUI_Dir_DeleteALL_Items()
{
// TODO: 在此添加命令处理程序代码
m_CList_dirlist.DeleteAllItems();
m_CList_dirlist.SetRedraw(FALSE);
//do erase and insert operation
m_CList_dirlist.SetRedraw(TRUE);
m_CList_dirlist.RedrawWindow();
}
-
- 右键增加内容功能实现
结合前面增加内容的函数，可以绑定一个【增加内容】的函数，【GUI_Add_Check_Dir()】。
函数作用主要是打开文件浏览器，然后选中路径，增加到LIST控件中。
void CMFCClistDlg::GUI_Add_Check_Dir()
{
// TODO: 在此添加命令处理程序代码
CString m_strFileOut = _T("");
TCHAR servPath[MAX_PATH];//用来存放文件夹路径
BROWSEINFO bi;
LPITEMIDLIST pidl;
bi.hwndOwner = this->m_hWnd;
bi.pidlRoot = NULL;
bi.pszDisplayName = servPath;
bi.lpszTitle = _T("选择文件路径");
bi.ulFlags = BIF_RETURNONLYFSDIRS;
bi.lpfn = NULL;
bi.lParam = NULL;
bi.iImage = NULL;
if ((pidl = SHBrowseForFolder(&bi)) != NULL)
{
//得到文件夹的全路径，不要的话，只得本文件夹名
if (SHGetPathFromIDList(pidl, servPath))
{
// 增加内容
GUI_ShowMessage(true, servPath);
}
}
// 把变量内容更新到对话框
UpdateData(FALSE);
}
0x4 总结
界面功能并不会太复杂，知道怎么得到结果，怎么插入数据和扩展就足够了。
主要功能：
CListCtrl控件使用，右键菜单功能删除单行、删除全部、增加自定义内容。
扩展性：
主要考虑在右键菜单栏增加处理函数，实现主要功能，然后得到结果返回到界面上。
0x5 参考
MSDN VS2017
https://docs.microsoft.com/zh-cn/cpp/mfc/reference/clistctrl-class?f1url=https%3A%2F%2Fmsdn.microsoft.com%2Fquery%2Fdev15.query%3FappId%3DDev15IDEF1%26l%3DZH-CN%26k%3Dk(AFXCMN%2FCListCtrl%3A%3AInsertItem)%3Bk(CListCtrl%3A%3AInsertItem)%3Bk(InsertItem)%3Bk(DevLang-C%2B%2B)%3Bk(TargetOS-Windows)%26rd%3Dtrue&view=vs-2017#insertcolumn
VS2010/MFC编程入门之二十九（常用控件：列表视图控件List Control 下）
http://www.jizhuomi.com/software/197.html
