一、说明
大家都知道在MFC中通过给CListCtrl设置LVS_EDITLABELS属性，并且在程序中响应控件的LVN_ENDLABELEDIT消息可以修改列表控件每一行的第一项，也就是主项(Item)。代码如下：
void CEditListCtrlSampleDlg::OnEndlabeleditList1(NMHDR* pNMHDR, LRESULT* pResult) { LV_DISPINFO* pDispInfo = (LV_DISPINFO*)pNMHDR; // TODO: Add your control notification handler code here *pResult = TRUE; //TRUE值表示可以修改主项，FALSE值表示不修改主项 }
但是让人郁闷的是，微软留了一手，CListCtrl不支持直接修改子项(SubItem)。无奈之下只好自力更生，对CListCtrl进行扩展。>_<!!!!
二、原理
通过在浩如烟海的互联网上查找资料（当然包括了大名鼎鼎的VCKBASE），发现现有的实现大都是对子项鼠标单击一次就可以编辑。但本人对CListCtrl的单击一次高亮文本，再单击一次才开始编辑的操作模式感觉比较喜欢，所以就有了这篇文章的诞生。
要想实现高亮文本也就是对文本进行着色处理，这可以通过对NM_CUSTOMDRAW消息进行处理实现，但是类向导中没有这个消息映射只能进行手工添加。
要想编辑文本则可以通过EditLabel(int nItem)成员函数以及对LVN_BEGINLABELEDIT和LVN_ENDLABELEDIT的消息处理实现。
三、实现
本文最终实现的CEditListCtrl扩展类在尽量符合CListCtrl操作步骤的情况下实现对主项及子项的可编辑。
成员变量说明：
int m_iItem; //主项标识符
int m_iSubItem; //子项标识符
BOOL m_bFocus； //是否绘制项文本焦点框
BOOL m_bHighLight; //是否高亮项文本
CItemEdit m_edtItemEdit; //用于子类化EditLabel函数返回的CEdit*指针
列表控件中所有项文本的绘制以及特效（焦点框、高亮）都在NM_CUSTOMDRAW消息处理中实现：
void CEditListCtrl::OnCustomDraw(NMHDR* pNMHDR, LRESULT* pResult) { NMLVCUSTOMDRAW* pNMLVCustomDraw = (NMLVCUSTOMDRAW*)pNMHDR; // Take the default processing unless we set this to something else below. *pResult = CDRF_DODEFAULT; // First thing - check the draw stage. If it's the control's prepaint // stage, then tell Windows we want messages for every item. if (pNMLVCustomDraw->nmcd.dwDrawStage == CDDS_PREPAINT) { *pResult = CDRF_NOTIFYITEMDRAW; } else if (pNMLVCustomDraw->nmcd.dwDrawStage == CDDS_ITEMPREPAINT) { // This is the notification message for an item. We'll request // notifications before each subitem's prepaint stage. *pResult = CDRF_NOTIFYSUBITEMDRAW; } else if (pNMLVCustomDraw->nmcd.dwDrawStage == (CDDS_ITEMPREPAINT | CDDS_SUBITEM)) { //当前要绘制的主项标识符和子项标识符 int iItem = (int)pNMLVCustomDraw->nmcd.dwItemSpec; int iSubItem = pNMLVCustomDraw->iSubItem; CDC* pDC = CDC::FromHandle(pNMLVCustomDraw->nmcd.hdc); CString strItemText = GetItemText(iItem, iSubItem); CRect rcItem, rcText; GetSubItemRect(iItem, iSubItem, LVIR_LABEL, rcItem); rcText = rcItem; CSize size = pDC->GetTextExtent(strItemText); if(strItemText == _T("")) { size.cx = 41; } //设置文本高亮矩形 rcText.left += 4; rcText.right = rcText.left + size.cx + 6; if(rcText.right > rcItem.right) { rcText.right = rcItem.right; } COLORREF crOldTextColor = pDC->GetTextColor(); //绘制项焦点/高亮效果 if(m_bFocus) { if((m_iItem == iItem) && (m_iSubItem == iSubItem)) { if(m_bHighLight) { pDC->SetTextColor(::GetSysColor(COLOR_HIGHLIGHTTEXT)); pDC->FillSolidRect(&rcText, ::GetSysColor(COLOR_HIGHLIGHT)); } pDC->DrawFocusRect(&rcText); } } //绘制项文本 rcItem.left += 6; pDC->DrawText(strItemText, &rcItem, DT_LEFT | DT_VCENTER | DT_SINGLELINE | DT_END_ELLIPSIS | DT_NOCLIP); pDC->SetTextColor(crOldTextColor); *pResult = CDRF_SKIPDEFAULT;// We've painted everything. } }
单击一次文本高亮，再单击一次文本开始编辑在WM_LBUTTONDOWN消息处理中实现：
void CEditListCtrl::OnLButtonDown(UINT nFlags, CPoint point) { m_bFocus = TRUE; LVHITTESTINFO lvhit; lvhit.pt = point; int item = SubItemHitTest(&lvhit); //if (over a item/subitem) if (item != -1 && (lvhit.flags & LVHT_ONITEM)) { CListCtrl::OnLButtonDown(nFlags, point); if(m_bHighLight && m_iItem == lvhit.iItem && m_iSubItem == lvhit.iSubItem) { //第二次单击 EditLabel(m_iItem); return; } else { //第一次单击 m_iItem = lvhit.iItem; m_iSubItem = lvhit.iSubItem; m_bHighLight = TRUE; } } else { if(m_edtItemEdit.m_hWnd == NULL) { //未出现文本编辑框时 m_bHighLight = FALSE; } CListCtrl::OnLButtonDown(nFlags, point); } Invalidate(); //强制重绘控件 }
关键的一步，对项文本进行编辑。在以上代码中当执行到EditLabel时将会产生一个编辑框，这时需要将它进行子类化处理，以控制它出现的位置。
void CEditListCtrl::OnBeginlabeledit(NMHDR* pNMHDR, LRESULT* pResult) { LV_DISPINFO* pDispInfo = (LV_DISPINFO*)pNMHDR; if (m_iSubItem >= 0) { ASSERT(m_iItem == pDispInfo->item.iItem); CRect rcSubItem; GetSubItemRect( pDispInfo->item.iItem, m_iSubItem, LVIR_BOUNDS, rcSubItem); //get edit control and subclass HWND hWnd= (HWND)SendMessage(LVM_GETEDITCONTROL); ASSERT(hWnd != NULL); VERIFY(m_edtItemEdit.SubclassWindow(hWnd)); //move edit control text 4 pixel to the right of org label, //as Windows does it...编辑框定位 m_edtItemEdit.m_iXPos = rcSubItem.left + 4; m_edtItemEdit.SetWindowText(GetItemText(pDispInfo->item.iItem, m_iSubItem)); } *pResult = 0; } void CEditListCtrl::OnEndlabeledit(NMHDR* pNMHDR, LRESULT* pResult) { LV_DISPINFO* pDispInfo = (LV_DISPINFO*)pNMHDR; LV_ITEM *plvItem = &pDispInfo->item; if (m_iSubItem >= 0) { if (plvItem->pszText != NULL ) { SetItemText(plvItem->iItem,m_iSubItem, plvItem->pszText); } VERIFY(m_edtItemEdit.UnsubclassWindow()!=NULL); *pResult = 0; } //编辑文本时对控件父窗口操作(如单击其它控件)引发"OnEndlabeledit"时刷新控件 CRect rect; GetWindowRect(&rect); CPoint point; ::GetCursorPos(&point); if(!rect.PtInRect(point)) { m_iItem = -1; m_iSubItem = -1; m_bFocus = FALSE; m_bHighLight = FALSE; } }
通过以上三个步骤大体实现了本文要达到的目的，但是还不能放松。接下来还要进行一些显示细节方面的处理。这包括对WM_PAINT、WM_SETFOCUS和WM_KILLFOCUS消息的处理，限于篇幅，就不进行细讲了，有兴趣的朋友可以查看本文提供的源代码。最后实现的效果如下图所示：
一、在资源编辑器中建立一个菜单资源 新建一个菜单资源，比如把菜单的ID号为IDC_POPMENU。此菜单有一项两层，即有一个可弹出的菜单项，而此菜单项的弹出内容即为将要建立的弹出式菜单的内容。至于每一个菜单项的消息映射，和一般的菜单相同。
例如：新建弹出菜单IDR_POPMENU
PopMenu-> Item1
-> Item2
-> Item3
在这里，真正在右键单击时，弹出的是 Item1 , Item2 , 和 Item3 ，最外层的 PopMenu 是不显示的，因此，弹出菜单至少要有这两层。
二、使用CMenu类对象 CMenu类的成员函数较多，但建立弹出式菜单只需用到其中几个成员函数。 1、LoadMenu函数 功能：从应用程式的可执行文档中加载菜单资源 原型：BOOL LoadMenu( UINT nIDResource ); 其中nIDResource是菜单资源的ID号，这里用的是刚建立的IDC_POPMENU。
2、GetSubMenu函数 功能：此函数用于得到子菜单的指针。 原型：CMenu* GetSubMenu( int nPos ) const; nPos为层数，0为第一层子菜单……以此类推。 由于我们需要的是“可弹出项”的第一层子菜单，因此用GetSubMenu(0)来得到第一层子菜单的类指针。
3、TrackPopupMenu函数 功能：在指定位置显示弹出菜单，并跟踪所选择的项 原型：BOOL TrackPopupMenu( UINT nFlags,int x,int y,CWnd* pWnd,LPCRECT lpRect = NULL ); 其中： nFlags为屏幕坐标属性和鼠标坐标属性 屏幕坐标属性： TPM_CENTERALIGN 横向将菜单以x居中 TPM_LEFTALIGN 横向将菜单以x左对齐 TPM_RIGHTALIGN 横向将菜单以x右对齐 鼠标按键属性（只在响应WM_CONTEXTMENU消息时有效）： TPM_LEFTBUTTON 连续按? 右键不会连续弹出菜单，鼠标右键不可用于选定菜单项 TPM_RIGHTBUTTON 连续按鼠标右键会连续弹出菜单，鼠标右键可用于选定菜单项 x，y均为屏幕坐标 lpRect 菜单所占的区域。假如为NULL，当用户在菜单以外的区域按鼠标键时，菜单会消失
三、具体实现方法 用ClassWizard中的“Add Windows Message Handler”功能添加对NM_RCLICKT消息的响应函数，函数中代码如下，注释很周详，在vc6+win2000环境下调试成功，大家感兴趣的话自己试试吧： void CMutiTalkingServerDlg::OnRClickListSessions(NMHDR* pNMHDR, LRESULT* pResult) { // TODO: Add your control notification handler code here NM_LISTVIEW* pNMListView = (NM_LISTVIEW*)pNMHDR; if(pNMListView->iItem != -1) { DWORD dwPos = GetMessagePos(); CPoint point( LOWORD(dwPos), HIWORD(dwPos) ); CMenu menu; VERIFY( menu.LoadMenu( IDR_POPUPMENU ) ); CMenu* popup = menu.GetSubMenu(0); ASSERT( popup != NULL ); popup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, this); } *pResult = 0; }
在使用CListCtrl时要为它添加一个右键菜单，步骤如下：
1. 响应CListCtrl的NM_RCLICK消息。
2. 添加一个菜单资源，在菜单资源中插入要添加到菜单内容。
3.在列表控件右击响应函数中添加代码
void CListCtrlDlg::OnRclickList1(NMHDR* pNMHDR, LRESULT* pResult)
{
CPoint point;
::GetCursorPos(&point);
CMenu menu;
VERIFY(menu.LoadMenu(IDR_MENU1)); //IDR_MENU_POPUP是新建菜单ID
CMenu* popup=menu.GetSubMenu(0);
ASSERT(popup!=NULL );
popup->TrackPopupMenu(TPM_LEFTALIGN|TPM_RIGHTBUTTON, point.x, point.y, this );
*pResult = 0;
}
显示效果如下：
很简单，几步就搞定。
TrackPopupMenu函数的使用：（翻译自MSDN）
BOOLTrackPopupMenu(UINTnFlags,intx,inty,CWnd*pWnd,LPCRECTlpRect=NULL);
返回值
如果函数成功返回非零，否则为0。
参数nFlags
指定屏幕位置标志和鼠标按钮标志。屏幕位置标志可以是下列之一：
TPM_CENTERALIGN：若设置此标志，函数将按参数x指定的坐标水平居中放置弹出式菜单。
TPM_LEFTALIGN：若设置此标志，函数使弹出式菜单的左边界与由参数X指定的坐标对齐。
TPM_RIGHTALIGN：若设置此标志，函数使弹出式菜单的右边界与由参数X指定的坐标对齐。
鼠标按钮标志可以是下列之一：
TPM_LEFTBUTTON表示鼠标左键跟踪弹出菜单。
TPM_RIGHTBUTTON表示鼠标右键跟踪弹出菜单。
X
指定弹出式菜单在屏幕上的水平位置坐标。根据该nFlags参数值，菜单可以是左对齐，右对齐，或相对于该中心的位置。
Ÿ
指定菜单的顶部在屏幕上的垂直位置坐标。
pWnd
标识拥有弹出式菜单的窗口。此窗口接收来自菜单的所有WM_COMMAND消息。在Windows版本3.1和更高版本，直到TrackPopupMenu返回，窗口才接收WM_COMMAND消息。在Windows 3.0，TrackPopupMenu返回之前窗口接收WM_COMMAND消息。
lpRect
指向一个RECT结构或CRect对象，Rect包含一个矩形的屏幕坐标，用户在这个矩形区域内点击鼠标，弹出式菜单不消息。如果这个参数为NULL，用户点击弹出式菜单以外的区域，菜单消失。Windows 3.0里面，这必须是空的。
对于Windows 3.1和更高版本，您可以使用下列常量
TPM_CENTERALIGN
TPM_LEFTALIGN
TPM_RIGHTALIGN
TPM_RIGHTBUTTON
备注：
在指定位置显示一个浮动的弹出式菜单并跟踪弹出式菜单项的选择。一个浮动的弹出菜单可以显示在屏幕上的任何地方。
在使用CListCtrl控件时，有时需要添加右键菜单来实现快捷操作，一般的步骤如下：
1. 在资源视图里添加一个菜单资源IDR_LIST_POPUPMENU，添加菜单项目，如下图所示
2. 响应CListCtrl的右键单击消息NM_RCLICK;
3. 在右键单击响应函数里添加以下代码，
void C××::OnNMRClickLstParatable(NMHDR *pNMHDR, LRESULT *pResult) { LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR); // TODO: 在此添加控件通知处理程序代码 POINT pt;
GetCursorPos(&pt);
CMenu menu; VERIFY(menu.LoadMenu(IDR_LIST_POPUPMENU));
CMenu* pPopup = menu.GetSubMenu(0); // 这个就是菜单在菜单资源条中的位置 ASSERT(pPopup != NULL);
// 控制菜单状态，单击空白处使菜单项变灰无效，当然也可以不显示菜单，看你的需要了 if(pNMItemActivate->iItem != -1) pPopup->EnableMenuItem(ID_DELETE, MF_ENABLED); else pPopup->EnableMenuItem(ID_DELETE, MF_GRAYED);
pPopup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON,pt.x,pt.y,this);
*pResult = 0; }
效果如下：
4. 最后就是添加右键菜单的响应函数就OK了。
