NM_CUSTOMDRAW消息解釋
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的IDl 當前的“繪畫段”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 = #ff0000;
else if ( (pLVCD->nmcd.dwItemSpec % 3) == 1 )
crText = #00ff00;
else
crText = #8080ff; // 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設置文字和背景的顏色。
這里需要注意兩件事:
l clrTextBk的顏色只是針對每一列,在最后一列的右邊那個區域顏色也還是和ListCtrl控件的背景顏色一致。l 當我重新看文檔的時候,我注意到有一篇題目是“NM_CUSTOMDRAW(list view)”的文章,它說你可以在最開始的custom draw消息中返回CDRF_NOTIFYSUBITEMDRAW就可以處理SubItem了,而不需要在CDDS_ITEMPREPAINT繪畫段中去指定CDRF_NOTIFYSUBITEMDRAW。但是我試了一下,發現這種方法并不起作用,你還是需要處理CDDS_ITEMPREPAINT段。