NM_CUSTOMEDRAW,WM_DRAWITEM和DrawItem()的讨论

MFC自绘控件有很多函数

常见的有WM_DRAWITEM消息,DrawItem虚函数,还有一个NM_CUSTOMDRAW反射消息,NM_CUSTOMDRAW是通过WM_NOTIFY发送给父窗口的。我们可以在控件类里面反射调用次消息。

现在我们以CTListCtrl控件举例对比NM_CUSTOMDRAW和DrawItem。

1.使用DrawItem,你必须在创建CTListCtrl的时候指定OWNER_DRAW风格。同时必须在CTListCtrl重载DrawItem。

加入有3个Item,那么绘制一次CTListCtrl,虚函数DrawItem会被调用3次。这里你需要通过GetSubItemRect来具体绘制SubItem。

2.使用NM_CUSTOMDRAW请看MSDN VS2005版本:

ms-help://MS.MSDNQTR.v80.en/MS.MSDN.v80/MS.WIN32COM.v10.en/shellcc/platform/commctls/custdraw/custdraw.htm

NM_CUSTOMDRAW是使用一个paint cycle来绘制的,比如你有3行2列,那么该发射消息调用的结果为:

CDDS_PREPAINT
CDDS_ITEMPREPAINT
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=0, iSubItem=0
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=0, iSubItem=1
CDDS_ITEMPREPAINT
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=1, iSubItem=0
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=1, iSubItem=1
CDDS_ITEMPREPAINT
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=2, iSubItem=0
CDDS_SUBITEM | CDDS_ITEMPREPAINT iItem=2, iSubItem=1


//===================================================================================================//

以下是3篇好文章:

文章一:http://www.cnblogs.com/BeyondTechnology/archive/2011/03/25.html

common control 4.7版本介绍了一个新的特性叫做Custom Draw,这个名字显得模糊不清,让人有点摸不着头脑,而且MSDN里也只给出了一些如风的解释和例子,没有谁告诉你你想知道的,和究竟这个特性有什么好处。

Custom draw可以被想象成一个轻量级的,容易使用的重绘方法(重绘方法还有几种,例如Owner Draw等)。这种容易来自于我们只需要处理一个消息(NM_CUSTOMDRAW),就可以让Windows为你干活了,你就不用被逼去处理"重绘过程"中所有的脏活了。

这篇文章的焦点是如何在一个LISTCTRL控件上使用Custom Draw消息。究其原因,一部分是因为我已经在我的工作上使用了Custom Draw有一段时间了,我很熟悉它。另一个原因是这个机制确实是非常好用,你只需要写很少量的代码就可以达到很好的效果。使用 Custom draw 来对控件外观编程甚至可以代替很多的古老方法。

以下代码是在WIN98 和VC6 SP2的环境下写的,common controls DLL的版本是5.0。我已经对其在WinNT 4上进行了测试。系统要运行这些代码,它的common controls DLL的版本必须至少是4.71。但随着IE4 的发布,这已经不是问题了。(IE会夹带着这个DLL一起发布) 

Custom Draw 基础

我将会尽我所能把Custom Draw的处理描述清楚,而不是简单的引用MSDN的文档。这些例子都需要你的程序有一个ListCtrl在对话框上,并且这个ListCtrl处于Report和多列模式

Custom Draw 的消息映射入口
Custom draw 是一个类似于回调的处理过程,Windows在绘制List Ctrl的某个时间点上通过 Notification 消息通知你的程序,你可以选择忽略所有的通知(这样你就会看到标准的ListCtrl),或者处理某部分的绘制(实现简单的效果),甚至整个的控件都由你来绘制(就象使用Owner-Drawing一样)。这个机制的真正卖点是:你只需要实现一些你需要的,其余的可以让Windows为你代劳。
好了,现在你可以开始为你的ListCtrl添加Custom Draw去做一些个性化的事情了。你首先要有正确的Comm Ctrl Dll版本,然后Windows会为你发送NM_CUSTOMDRAW消息,你只需要添加一个处理函数以便开始使用Custom draw。首先添加一个消息映射,象下面一样:
ON_NOTIFY ( NM_CUSTOMDRAW, IDC_MY_LIST, OnCustomdrawMyList )处理函数的原形如下:
afx_msg void OnCustomdrawMyList ( NMHDR* pNMHDR, LRESULT* pResult );这就告诉MFC你要处理从你的ListCtrl控件发出的WM_NOTIFY消息,ID为IDC_MY_LIST,通知码为NM_CUSTOMDRAW,OnCustomdrawMyList就是你的处理函数。
如果你有一个从ClistCtr派生的类,你想为它添加custom draw,你就可以使用ON_NOTIFY_REFLECT来代替。如下:
ON_NOTIFY_REFLECT ( NM_CUSTOMDRAW, OnCustomdraw ) 
OnCustomdraw的原形和上面的函数一致,但它是声明在你的派生类里的。

Custom draw将控件的绘制分为两部分:擦除和绘画。Windows在每部分的开始和结束都会发送NM_CUSTOMDRAW消息。所以总共就有4个消息。但是实际上你的程序所收到消息可能就只有1个或者多于四个,这取决于你想要让WINDOWS怎么做。每次发送消息的时段被称作为一个“绘画段”。你必须紧紧抓住这个概念,因为它贯穿于整个“重绘”的过程。

所以,你将会在以下的时间点收到通知:

l 一个item被画之前——“绘画前”段
l 一个item被画之后——“绘画后”段
l 一个item被擦除之前——“擦除前”段
l 一个item被擦除之后——“擦除后”段

并不是所有的消息都是一样有用的,实际上,我不需要处理所有的消息,直到这篇文章完成之前,我还没使用过擦除前和擦除后的消息。所以,不要被这些消息吓到你。
NM_CUSTOMDRAW Messages提供给你的信息:

l NM_CUSTOMDRAW消息将会给你提供以下的信息:
l ListCtrl的句柄
l ListCtrl的ID
l 当前的“绘画段”
l 绘画的DC,让你可以用它来画画
l 正在被绘制的控件、item、subitem的RECT值
l 正在被绘制的Item的Index值
l 正在被绘制的SubItem的Index值
l 正被绘制的Item的状态值(selected, grayed, 等等)
l Item的LPARAM值,就是你使用CListCtrl::SetItemData所设的那个值

上述所有的信息对你来说可能都很重要,这取决于你想实现什么效果,但最经常用到的就是“绘画段”、“绘画DC”、“Item Index”、“LPARAM”这几个值。
一个简单的例子:
好了,经过上面的无聊的细节之后,我们是时候来看一些简单的代码了。第一个例子非常的简单,它只是改变了一下控件中文字的颜色
处理的代码如下:

void CPanel1::OnCustomdrawList(NMHDR* pNMHDR, LRESULT* pResult)
{
	NMLVCUSTOMDRAW* pLVCD = reinterpret_cast<NMLVCUSTOMDRAW*>(pNMHDR);

	// Take the default processing unless we set this to something else below.
	*pResult = 0;
	// First thing - check the draw stage. If it's the control's prepaint
	// stage, then tell Windows we want messages for every item.
	if (CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage) {
		*pResult = CDRF_NOTIFYITEMDRAW;
	} else if (CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage) {
		// This is the prepaint stage for an item. Here's where we set the
		// item's text color. Our return value will tell Windows to draw the
		// item itself, but it will use the new color we set here.
		// We'll cycle the colors through red, green, and light blue. COLORREF crText;
		if ((pLVCD->nmcd.dwItemSpec % 3) == 0) {
			crText = RGB(255,0,0);
		} else if ((pLVCD->nmcd.dwItemSpec % 3) == 1) {
			crText = RGB(0,255,0); 
		} else {
			crText = RGB(128,128,255);
		}
		// Store the color back in the NMLVCUSTOMDRAW struct.
		pLVCD->clrText = crText;
		// Tell Windows to paint the control itself.
		*pResult = CDRF_DODEFAULT;
	}
}

结果如下,你可以看到行和行间的颜色的交错显示,多酷,而这只需要两个if的判断就可以做到了。

有一件事情必须记住, 在做任何的绘画之前,你都要检查正处身的“绘画段”,因为你的处理函数会接收到非常多的消息,而“绘画段”将决定你代码的行为。
一个更小的简单例子:
下面的例子将演示怎么去处理subitem的绘画(其实subitem也就是列)
在ListCtrl控件绘画前处理NM_CUSTOMDRAW消息。 
告诉Windows我们想对每个Item处理NM_CUSTOMDRAW消息。 
当这些消息中的一个到来,告诉Windows我们想在每个SubItem的绘制前处理这个消息 
当这些消息到达,我们就为每个SubItem设置文字和背景的颜色。

void CMyDlg::OnCustomdrawMyList(NMHDR* pNMHDR, LRESULT* pResult)
{
	NMLVCUSTOMDRAW* pLVCD = reinterpret_cast<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 (CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage) {
		*pResult = CDRF_NOTIFYITEMDRAW;
	} else if (CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage) {
		// This is the notification message for an item. We'll request
		// notifications before each subitem's prepaint stage.

		*pResult = CDRF_NOTIFYSUBITEMDRAW;
	} else if ( CDDS_ITEMPREPAINT | CDDS_SUBITEM) == pLVCD->nmcd.dwDrawStage) {
		// This is the prepaint stage for a subitem. Here's where we set the
		// item's text and background colors. Our return value will tell 
		// Windows to draw the subitem itself, but it will use the new colors
		// we set here.
		// The text color will cycle through red, green, and light blue.
		// The background color will be light blue for column 0, red for
		// column 1, and black for column 2.

		COLORREF crText, crBkgnd;

		if (0 == pLVCD->iSubItem) {
			crText = RGB(255,0,0);
			crBkgnd = RGB(128,128,255);
		} else if (1 == pLVCD->iSubItem) {
			crText = RGB(0,255,0);
			crBkgnd = RGB(255,0,0);
		} else {
			crText = RGB(128,128,255);
			crBkgnd = RGB(0,0,0);
		}

		// Store the colors back in the NMLVCUSTOMDRAW struct.
		pLVCD->clrText = crText;
		pLVCD->clrTextBk = crBkgnd;

		// Tell Windows to paint the control itself.
		*pResult = CDRF_DODEFAULT;
	}
}

执行的结果如下:

这里需要注意两件事:
l clrTextBk的颜色只是针对每一列,在最后一列的右边那个区域颜色也还是和ListCtrl控件的背景颜色一致。
l 当我重新看文档的时候,我注意到有一篇题目是“NM_CUSTOMDRAW (list view)”的文章,它说你可以在最开始的custom draw消息中返回CDRF_NOTIFYSUBITEMDRAW就可以处理SubItem了,而不需要在CDDS_ITEMPREPAINT绘画段中去指定CDRF_NOTIFYSUBITEMDRAW。但是我试了一下,发现这种方法并不起作用,你还是需要处理CDDS_ITEMPREPAINT段。
处理“绘画之后”的段
 到现在为止的例子都是处理“绘画前”的段,当Windows绘制List Item之前就改变它的外观。然而,在“绘制前”,你的绘制行为时被限制的,你只能改变字体的颜色或者外观。如果你想改变图标的绘制,你可以在“绘画前”把整个 Item重画或者在“绘画后”去做这件事。当你做在绘画后去做“自定义绘画”是,你的“绘画处理函数”就会在Windows画完整个Item或者SubItem的时候被调用,你就可以随心所欲的乱画了!!
在这个例子里,我将创建一个ListCtrl,一般的ListCtrl的Item如果被选择了,则其Icon也会呈现出被选择的状态。而我创建的这个ListCtrl的Icon是不会呈现被选择的状态的。步骤如下:
对ListCtrl在“绘画前”处理NM_CUSTOMDRAW消息。 
告诉Windows我们想在每个Item被画的时候获得NM_CUSTOMDRAW消息。 
当这些消息来临,告诉Windows我们想在你画完的时候获取NM_CUSTOMDRAW消息。 
当这些消息来到的时候,我们就重新画每一个Item的图标。 

void CPanel3::OnCustomdrawList(NMHDR* pNMHDR, LRESULT* pResult)
{
	NMLVCUSTOMDRAW* pLVCD = reinterpret_cast<NMLVCUSTOMDRAW*>(pNMHDR);
	*pResult = 0;
	// If this is the beginning of the control's paint cycle, request
	// notifications for each item.
	if (CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage) {
		*pResult = CDRF_NOTIFYITEMDRAW;
	} else if (CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage) {
		// This is the pre-paint stage for an item. We need to make another
		// request to be notified during the post-paint stage.
		*pResult = CDRF_NOTIFYPOSTPAINT;
	} else if (CDDS_ITEMPOSTPAINT == pLVCD->nmcd.dwDrawStage) {
		// If this item is selected, re-draw the icon in its normal
		// color (not blended with the highlight color).
		LVITEM rItem;
		int nItem = static_cast<int>(pLVCD->nmcd.dwItemSpec);
		// Get the image index and state of this item. Note that we need to
		// check the selected state manually. The docs _say_ that the
		// item's state is in pLVCD->nmcd.uItemState, but during my testing
		// it was always equal to 0x0201, which doesn't make sense, since
		// the max CDIS_ constant in commctrl.h is 0x0100.
		ZeroMemory(&rItem, sizeof(LVITEM));
		rItem.mask = LVIF_IMAGE | LVIF_STATE;
		rItem.iItem = nItem;
		rItem.stateMask = LVIS_SELECTED;

		m_list.GetItem ( &rItem );
		// If this item is selected, redraw the icon with its normal colors.
		if (rItem.state & LVIS_SELECTED) {
			CDC* pDC = CDC::FromHandle(pLVCD->nmcd.hdc);
			CRect rcIcon;
			// Get the rect that holds the item's icon.
			m_list.GetItemRect(nItem, &rcIcon, LVIR_ICON);
			// Draw the icon.
			m_imglist.Draw(pDC, rItem.iImage, rcIcon.TopLeft(), ILD_TRANSPARENT);
			*pResult = CDRF_SKIPDEFAULT;
		}
	}
}

重复,custom draw让我们可以做尽可能少的工作,上面的例子就是让Windows帮我们做完全部的工作,然后我们就重新对选择状态的Item的图标做重画,那就是我们看到的那个图标。执行结果如下:唯一的不足是,这样的方法会让你感觉到一点闪烁。因为图标被画了两次(虽然很快)。 用Custom Draw代替Owner Draw另外一件优雅的事情就是你可以使用Custom Draw来代替Owner Draw。它们之间的不同在我看来就是:
l 写Custom Draw的代码比写Owner Draw的代码更容易。
如果你只需要改变某行的外观,你可以不用管其他的行的绘画,让WINDOWS去做就行了。但如果你使用
Owner Draw,你必须要对所有的行作处理。当你想对控件作所有的处理时,你可以在处理NM_CUSTOMDRAW
消息的最后返回CDRF_SKIPDEFAULT,这有点和我们到目前为止所做的有些不同。CDRF_SKIPDEFAULT
告诉Windows由我们来做所有的控件绘画,你不用管任何事。
我没有在这里包含这个例子的代码,因为它有点长,但是你可以一步步地在调试器中调试代码,你可以看到每一
步发生了什么。如果你把窗口摆放好,让你可以看到调试器和演示的程序,那在你一步步的调试中,你可以看到
控件每一步的绘制,这里的ListCtrl是很简单的,只有一列并且没有列头。

//=========================================================================================================//

文章二:http://blog.csdn.net/blz_wowar/article/details/2046886

最近在学习《WTL for MFC Programmer》系列文章的一些小结和感受
相同点:
1.都是通知消息,都可以被反射回控件类自行处理。
2.都和自定义控件的绘画有关。

区别:
MSDN对WM_DRAWITEM描述:
The WM_DRAWITEM message is sent to the parent window of an owner-drawn button, combo box, list box, or menu when a visual aspect of the button, combo box, list box, or menu has changed.

MSDN对NM_CUSTOMDRAW的描述:
Sent by some common controls to notify their parent windows about drawing operations. This notification is sent in the form of a WM_NOTIFY message.

1.可以看出,前者是对Owner-Draw风格的按钮,复选框,列表框和菜单有效的,树形控件并没在此列。所以在系列文章的第五篇中,自定义按钮是继承了COwnerDraw,树形控件是继承了CCustomDraw,MSDN中也列出了一些NM_CUSTOMDRAW有关的控件:
List view
    NMLVCUSTOMDRAW
ToolTip
    NMTTCUSTOMDRAW
Tree view
    NMTVCUSTOMDRAW
Toolbar
    NMTBCUSTOMDRAW
All other supported controls
    NMCUSTOMDRAW
2.前者若想进行一些gdi动作,那基本上就是整个区域需要绘画,gdi的一些操作比较多,后者使用更简单,一些属性(比如字体颜色)只需要设置一些变量即可。
3.前者是一个独立的消息,后者是被包含在WM_NOTIFY消息中被发送的。
4.NM_CUSTOMDRAW分好多个阶段,可以通过重载某些方法来改变行为,这些方法包括OnPrePaint, OnItemPrePaint等等(细节只能看wtl源代码了,MSDN中也稍有介绍)。

猜测:他们应用在不同的控件上,但是NM_CUSTOMDRAW貌似是WM_DRAWITEM的加强版,呵呵
欢迎大家多多批评指教~

以下是在MSDN上找到的一些解释,链接是相关的一篇文章地址

所有者绘制

控制控件绘制的另一种方法是利用所有者绘制。事实上,您也许听开发人员提到过所有者 绘制控件,因为它是用于开发自定义控件最普通的技术。该技术普遍使用的主要原因在于,Windows 可为您提供很多帮助。在呈现控件的那一刻,Windows 就已经创建并填写了设备上下文,决定了控件的大小和位置,并且向您传递信息以使您了解此刻绘制的需求。对于列表控件(例如,列表框和列表视图), Windows 将为列表中的每一项调用绘制代码,这意味着您只需绘制这些项,而无需考虑控件的其他方面。注意,所有者绘制可用于大多数控件。然而,它不能用于编辑控件; 并且考虑到列表控件,它只能用于报表视图样式。

自定义绘制

对于绘制自己的控件而言,这可能是最少 为人所知的技术。事实上,许多技术能力较高的开发人员也混淆了术语所有者绘制 (owner-draw) 和自定义绘制 (custom-draw)。关于自定义控件,首先需要了解,它仅针对于指定的公共控件:标头、列表视图、rebar、工具栏、工具提示、跟踪条和树视 图。此外,尽管所有者绘制只允许绘制报告视图风格的列表视图控件,而自定义绘制则使您能够处理列表视图控件所有视图风格的绘制。使用自定义绘制的另一个明 显优势是,您可以对希望绘制的内容进行严格挑选。实现方式是,在控件绘制的每个阶段由 Windows 向代码发送一个消息。这样,您可以决定在每个阶段是自己进行所有的绘制工作,增加默认的绘制,还是允许 Windows 为该阶段执行所有的绘制。(鉴于自定义绘制是本文的一个主题,因此您很快会看到它的工作方式。)

文章地址: http://msdn2.microsoft.com/zh-cn/library/ms364048(VS.80).aspx

//================================================================================//

文章三:http://blog.csdn.net/FlowShell/article/details/4648800

我在学习中经常遇到要重写DrawItem()的情况,但又有一个WM_DRAWITEM消息,它们是什么样的关系呢。

如果我们要重写一个CButton取名为CMyButton,我们可以重写CMyButton的DrawItem()函数来实现我们的

需求,但CMyButton::DrawItem()是在什么时候调用呢?它是在它的宿主类的OnDrawItem()中被调用,

OnDrawItem(int nIDCtl, LPDRAWITEMSTRUCT lpDrawItemStruct )正是对WM_DRAWiTEM的相应函数。

宿主类可以根据nIDCtl来判定是哪个子控件。其实我们可以在OnDrawItem函数里对子控件进行绘制,但是有很多

的子控件看起来不好,所以我们应该在子类的DrawItem对子类绘制,例如CMyButton::DrawItem。所以可以

这样理解,OnDrawItem是画窗口中的子控件的,因为它的入口参数LPDRAWITEMSTRUCT带入不同子控件的相

关参数,而且,你得把字控件设置成“自画”类型,才会调用到OnDrawItem。

    当自绘按钮(owner-draw button),下拉列表框(combo box),列表框(list box)视觉属性,或者菜单发生变化时,

框架为他们的owner调用OnDrawItem(发送WM_DRAWITEM),在宿主类调用子类的DrawItem(发送WM_DRAWITEM消息)。

我们可以重载子类的DrawItem可以绘制自己需要的控件,不是所有设置成自画类型的控件都会调用父窗口的OnDrawItem,

例如ListBox的自画,你就必须重载CListBox的DrawItem方法和MeasureItem方法才可以,但象菜单,按钮等的自画则会调用

OnDrawItem。在SDK中,子类是不可能受到WM_DRAWITEM,在MFC中可以,这是类的设计者设计的(反射),这的确不错。

    在学习中还有一个消息也是由宿主类被调用的,它就是WM_CTRCOLOR。这个消息是在子控件将要绘画时,向宿主

类发送,宿主类利用发射机制让子类自己又一个处理的机会。OnCtlColor (CDC* pDC, CWnd* pWnd,  UINT nCtlColor)

pDC,pWnd都是于子类相关的,在这里可以设置,前景颜色,背景颜色,画刷类型,字体等等,但不能改变元素的界面框架,

这是DrawItem 所能干的。

   如果同时有DrawItem(子类),OnDrawItem(宿主类),OnCtlColor(宿主类),它们的调用顺序是:

OnCtlColor,OnDrawItem,DrawItem。

    如果我们同时又相应的子类的WM_PAINT消息,这也许OnPaint在内部进行了一些处理,判断是否自绘来决定是否向宿主类

发送WM_DRAWITEM,所以如果响应了WM_PAINT子类就不会向宿主类发送WM_DRAWITEM消息,你要完成子类的全部绘

制工作,如果子类是一个列表框,就很麻烦。这时调用顺序是OnCtlColor,OnPaint。

  在发送一个WM_PAINT消息前,总会先发送一个WM_ERASEBACK消息,我们在这里在一个背景图片。

 

   对于我们平时对控件的绘制,上面介绍的差不多了,还有一个CView的问题,也就是OnPaint和Ondraw的关系,

其实这个很简单,CView::OnPaint()的源码如下:

  

view plain
  1. void CView::OnPaint()  
  2. {  
  3.      CPaintDC dc(this);        
  4.      OnPrepareDC(&dc);        
  5.      OnDraw(&dc)  
  6. }  

从代码中可以清楚的看出他们的关系。

 

以上是我自己的个人理解,当然这是通过跟踪得出的结论,可能结论中有错误,如果有,请指出。不胜感激。


你可能感兴趣的:(NM_CUSTOMEDRAW,WM_DRAWITEM和DrawItem()的讨论)