简介：在Windows编程中， CListCtrl 是一个常用于展示数据列表的控件。本文将详细介绍如何通过 OnNMCustomdraw 消息和自绘（Custom Draw）机制，自定义 CListCtrl 的外观，包括字体颜色、大小、背景颜色，甚至图片的加载。首先解释 OnNMCustomdraw 消息的机制，然后展示如何覆盖 OnNMCustomdraw 成员函数并自定义绘制逻辑。同时，提供示例代码，展示如何改变字体颜色和大小，以及加载图片。掌握 CListCtrl 的自定义绘制，将有助于开发者创建更加个性化和美观的界面。 
1. CListCtrl控件介绍
CListCtrl是Windows应用程序中常用的控件之一，它属于MFC（Microsoft Foundation Classes）的一部分，用于创建可以显示数据的列表。CListCtrl能够处理多种格式的数据，并以不同的布局展现出来。该控件不仅可以显示文本和图标，还支持子项、状态提示、可复选框等多种特性，为开发者提供了一个灵活、强大的界面组件。
CListCtrl控件的基本功能包括： - 列表项的添加、删除和编辑 - 多列显示和列头的定制 - 子项的展开和折叠 - 演示不同的绘制样式，包括带图标的项和自定义绘制项
在MFC中，CListCtrl通过一系列的成员函数实现对列表的管理。开发者可以在对话框中直接使用它，或者将其作为自定义窗口类的成员来使用。理解CListCtrl的工作原理和使用方法，是创建功能丰富的用户界面的重要一步。在接下来的章节中，我们将深入探讨CListCtrl控件的高级功能，如自绘机制，以及如何处理NM_CUSTOMDRAW通知消息来实现自定义的列表绘制。
2. 自绘（Custom Draw）机制简介
2.1 自绘机制的基本概念
2.1.1 自绘机制的定义与用途
自绘机制（Custom Draw）是编程中的一种技术手段，允许开发者定义控件的外观和行为，而不是使用系统默认的方式。在CListCtrl控件中，自绘机制可以让我们自定义绘制列表项的内容，包括文字、图标和背景等。自绘机制在需要控件外观与应用程序的整体风格保持一致时非常有用，例如，我们可以设计一种特别的主题或者为用户界面加入特殊效果。
2.1.2 与标准绘制的区别与优势
标准绘制是由系统默认的控件外观和行为决定的，例如，Windows控件有默认的颜色、字体和图标。使用自绘机制允许开发者超越这些限制，提供更加丰富和个性化的用户体验。
自绘机制的优势在于： - 个性化 ：可以根据应用程序的需求设计定制化的控件外观。 - 一致性 ：可保证应用程序风格上的统一和一致性。 - 动态效果 ：可以轻松添加动态和交互式的视觉效果，增加用户体验。
2.2 自绘事件的触发与处理
2.2.1 MFC中的自绘事件类型
在使用MFC（Microsoft Foundation Classes）进行Windows编程时，CListCtrl控件处理自绘相关的消息主要是通过NM_CUSTOMDRAW通知消息。这个消息包含了多个阶段，允许开发者在不同的绘制阶段进行干预，比如背景绘制、子项绘制以及子项状态绘制等。
2.2.2 如何监听自绘事件
监听自绘事件首先需要了解NM_CUSTOMDRAW消息的各个阶段。这些阶段包括： - CDDS_PREPAINT ：准备绘制前的处理。 - CDDS_POSTPAINT ：绘制后的处理。 - CDDS_ITEMPREPAINT ：子项准备绘制前的处理。 - CDDS_ITEMPOSTPAINT ：子项绘制后的处理。
要监听这些事件，我们需要在类中响应 OnNMCustomdraw 函数，并根据不同的绘制阶段进行适当的处理。下面是一个基本的示例代码块，展示如何在MFC类中覆盖 OnNMCustomdraw 函数：
void CCustomDrawListCtrl::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult) {
LPNMLVCUSTOMDRAW pNMLVCUSTOMDRAW = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
switch (pNMLVCUSTOMDRAW->nmcd.dwDrawStage) {
case CDDS_PREPAINT:
// 准备绘制前的处理
*pResult = CDRF_NOTIFYITEMDRAW;
break;
case CDDS_ITEMPREPAINT:
// 子项准备绘制前的处理
*pResult = CDRF_NOTIFYSUBITEMDRAW;
break;
// 其他绘制阶段的处理
default:
*pResult = CDRF_DODEFAULT;
break;
}
}
在这个示例中，我们通过返回特定的值来告诉列表控件我们想要在特定的绘制阶段进行干预，然后在相应的分支中添加我们的自绘代码。
自绘机制的深入理解以及如何有效地应用它，将使得你的应用程序界面更加吸引用户，并且在功能上更加灵活。自绘事件的处理是实现个性化用户界面的关键，它要求开发者对控件的绘制过程有充分的认识和控制。
2.2.3 自绘自定义绘制的示例
为了更进一步说明如何利用自绘机制，我们来看看一个具体的应用示例。比如，我们需要在一个列表控件中展示自定义的图标，或者改变特定子项的背景色。这时，我们就需要监听 CDDS_ITEMPREPAINT 和 CDDS_ITEMPOSTPAINT 事件，并在这些事件中进行特定的绘制操作。
下面是一个简单的示例，展示了如何改变列表项的背景色：
void CCustomDrawListCtrl::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult) {
LPNMLVCUSTOMDRAW pNMLVCUSTOMDRAW = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
switch (pNMLVCUSTOMDRAW->nmcd.dwDrawStage) {
case CDDS_ITEMPREPAINT:
// 准备绘制子项前的处理
*pResult = CDRF_NOTIFYITEMDRAW;
break;
case CDDS_ITEMPOSTPAINT:
// 子项绘制后的处理
CDC* pDC = CDC::FromHandle(pNMLVCUSTOMDRAW->nmcd.hdc);
int nItem = pNMLVCUSTOMDRAW->nmcd.dwItemSpec;
CRect rcItem;
pNMLVCUSTOMDRAW->clrTextBk = RGB(255, 0, 0); // 设置背景颜色为红色
pNMLVCUSTOMDRAW->clrTextBk = RGB(255, 0, 0);
pNMLVCUSTOMDRAW->nmcd.rc = pNMLVCUSTOMDRAW->nmcd.rcItem;
*pResult = CDRF_NEWFONT;
break;
default:
*pResult = CDRF_DODEFAULT;
break;
}
}
这个代码示例中，我们在 CDDS_ITEMPOSTPAINT 阶段将子项的背景色设置为红色。实际项目中可能需要根据业务逻辑来判断背景色，这里仅作为一个技术示例。
通过对自绘事件的监听和处理，开发者能够实现丰富的自定义绘制功能，从而提供更加吸引人的用户界面和更好的用户体验。接下来的章节会详细介绍如何处理NM_CUSTOMDRAW消息，以及如何在MFC框架内覆盖OnNMCustomDraw成员函数来实现这些高级功能。
3. NM_CUSTOMDRAW通知消息处理
在这一章节，我们将深入探讨如何处理NM_CUSTOMDRAW通知消息，它是CListCtrl控件自绘制功能的关键所在。NM_CUSTOMDRAW消息是MFC框架中用于定制控件绘制的机制，它允许开发者拦截和修改控件的绘制过程，实现不同于默认的视觉效果。下面我们将从消息的作用和结构参数解析入手，进而详细说明处理这些消息时的策略。
3.1 NM_CUSTOMDRAW消息详解
3.1.1 NM_CUSTOMDRAW消息的作用
NM_CUSTOMDRAW消息使控件能够响应绘图事件，并提供自定义绘制的机会。这对于创建个性化的用户界面十分关键。消息的处理发生在控件的绘制过程中，允许开发者根据不同的绘制阶段来实现细节的定制。例如，在列表控件中，可以改变文本颜色、背景样式、添加特殊图标或者在特定子项上应用不同的颜色和字体。这为UI设计提供了丰富的可能性，使应用界面可以更好地适应品牌形象和用户体验需求。
3.1.2 消息的结构与参数解析
NM_CUSTOMDRAW消息包含两个重要的结构体：NMLVCUSTOMDRAW和NMTVCUSTOMDRAW。这些结构体为控件提供了关于绘制事件的详细信息，如绘制阶段、子项状态等，让我们可以进行精确的绘制定制。
typedef struct tagNMLVCUSTOMDRAW
{
NMCUSTOMDRAW nmcd;
int clrText;
int clrTextBk;
// 其他字段...
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;
typedef struct tagNMTVCUSTOMDRAW
{
NMCUSTOMDRAW nmcd;
int clrText;
int clrTextBk;
int clrBtnFace;
int clrBtnText;
// 其他字段...
} NMTVCUSTOMDRAW, *LPNMTVCUSTOMDRAW;
在这些结构体中， nmcd 是一个NMCUSTOMDRAW类型的成员，它提供了通用的绘制信息，如绘制阶段和绘图句柄（hdc）。 clrText 和 clrTextBk 则分别代表文本颜色和背景颜色。这些信息为控件的自定义绘制提供了依据。
3.2 处理NM_CUSTOMDRAW消息的策略
3.2.1 处理阶段与返回值的重要性
NM_CUSTOMDRAW消息在绘制过程中会被多次触发，包括绘制前和绘制后等不同阶段。在每个阶段，控件都会发送NM_CUSTOMDRAW消息，开发者可以根据不同的阶段来执行不同的绘制逻辑。返回值决定了控件绘制流程的下一步行为。例如，当返回CDRF_NOTIFYITEMDRAW，控件将针对每个子项发送NM_CUSTOMDRAW消息，允许开发者对每个子项进行特定的绘制操作。
3.2.2 如何实现基本的自绘逻辑
实现NM_CUSTOMDRAW消息的基本自绘逻辑涉及以下步骤：
- 接收NM_CUSTOMDRAW消息并根据其阶段处理绘制事件。
- 实现绘制逻辑，如改变文本颜色或背景色。
- 返回适当的值以指示控件如何继续绘制流程。
下面是一个简单的处理NM_CUSTOMDRAW消息的代码示例：
void CCustomListCtrl::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMLVCUSTOMDRAW pCustomDraw = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
switch(pCustomDraw->nmcd.dwDrawStage)
{
case CDDS_PREPAINT:
// 准备绘制前的初始化
*pResult = CDRF_NOTIFYITEMDRAW;
break;
case CDDS_ITEMPREPAINT:
// 子项绘制前的准备
*pResult = CDRF_NEWFONT;
break;
case CDDS_ITEMPOSTPAINT:
// 子项绘制后的后处理
break;
case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
// 子项中的子项的绘制前准备
*pResult = CDRF_DODEFAULT;
break;
// 其他绘制阶段的处理...
default:
*pResult = CDRF_DODEFAULT;
break;
}
}
在上述代码中，我们根据绘制阶段来改变返回值，控制自绘逻辑。例如，在 CDDS_ITEMPREPAINT 阶段，我们调用 CDRF_NEWFONT 来指示控件为当前子项使用新的字体。这样的处理方法为控件提供了丰富的自绘选项，并让开发者可以精确控制绘制过程。
3.2.3 代码逻辑逐行解读
-
NMHDR *pNMHDR, LRESULT *pResult：函数参数，分别用于接收消息头信息和定义返回值。 -
LPNMLVCUSTOMDRAW pCustomDraw = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);：将消息头转换为NMLVCUSTOMDRAW类型的指针，以便访问更详细的绘制信息。 -
pCustomDraw->nmcd.dwDrawStage：检查绘制阶段。 -
switch语句：根据不同的绘制阶段执行不同的代码块。 -
*pResult：返回值，控制绘制流程的后续步骤。
通过上述代码及逻辑解读，我们可以看到如何根据不同的绘制阶段来定制控件的绘制行为。这为创建个性化的用户界面提供了坚实的技术基础，并且可以应用于多种CListCtrl控件的自绘制场景中。接下来的章节将深入探讨如何覆盖 OnNMCustomDraw 成员函数，以及如何实现更高级的自绘功能。
4. OnNMCustomdraw成员函数覆盖方法
在讨论Windows编程中的MFC框架时，涉及到自绘（Custom Draw）机制， OnNMCustomDraw 函数是一个至关重要的成员函数，属于 CListCtrl 类。这一章节将深入探讨 OnNMCustomDraw 函数的作用、如何在类中进行覆盖，以及如何利用该函数实现高级自绘功能。
4.1 成员函数OnNMCustomDraw的作用
4.1.1 函数声明与实现的重要性
OnNMCustomDraw 是一个虚函数，它为开发者提供了强大的自定义绘制列表控件的能力。在MFC的消息处理架构中， OnNMCustomDraw 函数响应 NM_CUSTOMDRAW 通知消息，允许开发者在列表控件的绘制过程中插入自己的代码逻辑。
为了实现自绘效果，开发者必须在派生类中覆盖此虚函数，并且提供具体的绘制逻辑。不覆盖这个函数，列表控件就会使用默认的绘制机制，这意味着我们失去了对控件外观进行定制的全部可能。
4.1.2 如何在类中覆盖OnNMCustomDraw
在派生类中覆盖 OnNMCustomDraw 时，需要遵循以下步骤：
- 声明派生类，并继承
CListCtrl。 - 在派生类中重写
OnNMCustomDraw函数。 - 编写具体的绘制代码，并指定绘制的各个阶段。
举个例子：
class CMyListCtrl : public CListCtrl
{
public:
virtual void OnNMCustomDraw(NMHDR *pNMHDR, LRESULT *pResult);
};
void CMyListCtrl::OnNMCustomDraw(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMLVCUSTOMDRAW pCustomDraw = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
switch(pCustomDraw->nmcd.dwDrawStage)
{
case CDDS_PREPAINT:
*pResult = CDRF_NOTIFYITEMDRAW;
break;
case CDDS_ITEMPREPAINT:
*pResult = CDRF_NOTIFYSUBITEMDRAW;
break;
case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
// 自定义子项绘制逻辑
*pResult = CDRF_NEWFONT;
break;
}
}
这段代码展示了如何在列表控件的不同绘制阶段指定不同的返回值，以控制绘制行为。
4.2 实现高级自绘功能
4.2.1 子项绘制的自定义
子项绘制的自定义是自绘列表控件中最常见的需求之一。 OnNMCustomDraw 允许在每个子项绘制之前干预，此时可以修改绘制参数，甚至改变绘制方式。
case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
// 设置自定义字体
pCustomDraw->nmcd.lcd.pdc->SelectObject(&myCustomFont);
// 使用自定义颜色
pCustomDraw->nmcd.lcd.pdc->SetBkMode(TRANSPARENT);
pCustomDraw->nmcd.lcd.pdc->SetTextColor(RGB(0, 100, 200));
// 返回CDRF_NEWFONT以应用自定义字体
*pResult = CDRF_NEWFONT;
break;
4.2.2 高级绘制技巧与性能优化
在实现高级自绘功能时，我们还需要考虑性能优化。例如，可以使用双缓冲技术减少闪烁：
CDC memDC;
memDC.CreateCompatibleDC(pDC);
CBitmap memBitmap;
memBitmap.CreateCompatibleBitmap(pDC, width, height);
CBitmap* pOldBitmap = memDC.SelectObject(&memBitmap);
memDC.BitBlt(0, 0, width, height, pDC, 0, 0, SRCCOPY);
// 在memDC上进行绘制操作
pDC->BitBlt(0, 0, width, height, &memDC, 0, 0, SRCCOPY);
memDC.SelectObject(pOldBitmap);
或者使用GDI+进行更复杂的绘图操作，如渐变背景、透明度等。
性能优化的方法多样，关键在于减少控件的重绘次数，以及利用GDI对象的复用，例如重用设备上下文和位图对象。
本章节介绍了 OnNMCustomDraw 成员函数的作用，并详细探讨了如何在MFC中覆盖它来实现自定义列表控件的绘制。我们还讨论了实现高级自绘功能，包括子项绘制的自定义和一些性能优化技巧。这些内容对于任何希望将MFC列表控件提升到一个新的视觉水平的开发者来说都是必不可少的知识。
5. CListCtrl自定义绘制的实际应用案例
5.1 实现自定义字体和颜色
在CListCtrl中实现自定义字体和颜色是提高用户界面友好性的一个重要方面。通过自定义绘制，开发者能够为用户提供更加丰富和个性化的内容展示。
5.1.1 字体与颜色设置的方法
自定义字体和颜色通常是在处理NM_CUSTOMDRAW消息时进行的。以下是一个示例方法，展示如何在NM_CUSTOMDRAW消息的处理过程中设置字体和颜色：
void CMyListCtrl::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMLVCUSTOMDRAW pNMLVCUSTOMDRAW = reinterpret_cast<LPNMLVCUSTOMDRAW>(pNMHDR);
switch (pNMLVCUSTOMDRAW->nmcd.dwDrawStage)
{
case CDDS_PREPAINT:
// 准备绘制前的处理
*pResult = CDRF_NOTIFYITEMDRAW;
break;
case CDDS_ITEMPREPAINT:
// 准备每一项的绘制
*pResult = CDRF_NOTIFYSUBITEMDRAW;
break;
case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
// 在这里可以针对子项进行特定的绘制
// 例如，为偶数行设置不同的字体和颜色
if ((pNMLVCUSTOMDRAW->nmcd.dwItemSpec % 2) == 0)
{
// 为当前子项设置字体
CFont font;
font.CreatePointFont(120, _T("Arial"));
pNMLVCUSTOMDRAW->clrTextBk = RGB(255, 255, 255); // 白色背景
pNMLVCUSTOMDRAW->clrText = RGB(0, 0, 0); // 黑色文字
// 设置绘制DC的字体
CFont* pOldFont = pNMLVCUSTOMDRAW->nmcd.hdcDC->SelectObject(&font);
// 还原字体，避免内存泄漏
pNMLVCUSTOMDRAW->nmcd.hdcDC->SelectObject(pOldFont);
}
*pResult = CDRF_DODEFAULT;
break;
default:
*pResult = CDRF_DODEFAULT;
break;
}
}
5.1.2 字体和颜色自定义的实际效果
在上述代码中，我们通过判断绘制阶段以及项目和子项的索引来为特定的行设置不同的字体和颜色。这在视觉上区分了不同行的数据，使得界面更加直观易读。
5.2 加载并显示图片
在CListCtrl中，除了文本信息外，有时候还需要显示图片来丰富数据展示。使用NM_CUSTOMDRAW消息同样可以实现图片的加载和显示。
5.2.1 图片加载的技术细节
在MFC中加载图片通常使用GDI+函数，而CListCtrl的子项可以使用 SetItemData 来存储图片的句柄。以下是如何在列表控件中添加图片的示例代码：
void CMyListCtrl::AddImageToItem(int itemIndex, HBITMAP hBitmap)
{
LVITEM lvItem;
memset(&lvItem, 0, sizeof(lvItem));
lvItem.mask = LVIF_IMAGE | LVIF_PARAM;
lvItem.iItem = itemIndex;
lvItem.lParam = (LPARAM)hBitmap; // 存储图片句柄
SetItem(&lvItem);
}
// 调用此函数来添加图片到指定的项
// hBitmap 是通过GDI+创建的位图句柄
AddImageToItem(0, hBitmap);
5.2.2 图片与列表项的整合方式
要让图片和文本同时显示在一个列表项上，可以在 OnNMCustomdraw 函数中调整绘制参数，使图片作为子项的一部分显示出来。以下是如何在自定义绘制阶段整合图片和文本的代码片段：
case CDDS_ITEMPREPAINT:
case CDDS_SUBITEM | CDDS_ITEMPREPAINT:
// 判断是否需要绘制特定的子项
if (pNMLVCUSTOMDRAW->iSubItem == IMAGE_SUBITEM_INDEX) // 假设有一列专门用于显示图片
{
// 获取图片句柄
HBITMAP hBitmap = (HBITMAP)pNMLVCUSTOMDRAW->nmcd.lParam;
// 绘制图片
DrawBitmap(pNMLVCUSTOMDRAW->nmcd.hdcDC, hBitmap, rc, TRUE);
// 跳过标准绘制
*pResult = CDRF_SKIPDEFAULT;
break;
}
else if (pNMLVCUSTOMDRAW->iSubItem == TEXT_SUBITEM_INDEX) // 假设另一列用于显示文本
{
// 继续标准的文本绘制
*pResult = CDRF_DODEFAULT;
break;
}
5.3 综合应用案例分析
5.3.1 案例背景与需求分析
假设我们正在开发一个应用程序，用于展示员工信息。每个员工的信息包括姓名、职位、部门以及照片。这些信息需要被组织在一个列表控件中。员工的照片需要在列表项的特定列中显示。
5.3.2 完整代码示例与效果展示
为了实现这一功能，我们创建了一个员工信息列表类，继承自 CListCtrl ，并重写了 OnNMCustomdraw 函数来实现自定义绘制。
// MyEmployeeListCtrl.h
class CMyEmployeeListCtrl : public CListCtrl
{
// ... 其他成员函数 ...
void LoadEmployeeData();
// ... 其他成员函数 ...
};
// MyEmployeeListCtrl.cpp
void CMyEmployeeListCtrl::LoadEmployeeData()
{
// ... 假设从数据库或其他数据源加载员工信息 ...
// 添加员工信息和图片到列表控件
for (int i = 0; i < employees.size(); ++i)
{
LVITEM lvi = {0};
lvi.mask = LVIF_TEXT | LVIF_IMAGE | LVIF_PARAM;
lvi.iItem = i;
lvi.iSubItem = 0; // 列号
lvi.pszText = (LPTSTR)employees[i].name.c_str();
lvi.lParam = (LPARAM)employees[i].bitmap; // 保存位图句柄
InsertItem(&lvi);
// 可以添加更多列...
}
}
在实际运行程序时，您会看到一个包含员工姓名、职位、部门和照片的列表。每一项都使用自定义绘制来展示，包括文字的字体和颜色，以及图片的显示。
通过这个案例，我们可以看到CListCtrl的自定义绘制功能在实际应用中的强大作用，它可以显著提升应用程序的用户体验和界面吸引力。
简介：在Windows编程中， CListCtrl 是一个常用于展示数据列表的控件。本文将详细介绍如何通过 OnNMCustomdraw 消息和自绘（Custom Draw）机制，自定义 CListCtrl 的外观，包括字体颜色、大小、背景颜色，甚至图片的加载。首先解释 OnNMCustomdraw 消息的机制，然后展示如何覆盖 OnNMCustomdraw 成员函数并自定义绘制逻辑。同时，提供示例代码，展示如何改变字体颜色和大小，以及加载图片。掌握 CListCtrl 的自定义绘制，将有助于开发者创建更加个性化和美观的界面。
扫一扫
1474
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
