elva

本文討論的重點介于兩者之間 — 公共控件賦予您想要的大部分功能，但控件的外觀并不是您想要的。例如，列表視圖控件提供在許多視圖風格中顯示數據列表的方式 — 小圖標、大圖標、列表和詳細列表（報告）。然而，如果您想要一個網格控件，那結果怎樣呢？盡管公共控件庫里沒有特別包含網格，但是列表視圖控件與它較為接近，它以行和列顯示數據，并有一個相關的標頭控件。因此，許多人以一個標準的列表視圖控件為起點創建自己的網格控件，然后重寫該控件及其子項的呈現方式或繪制方式。

主宰繪圖操作
即使“只”進行繪制，您仍然有至少四種選項可用，它們都具有鮮明的優缺點：

• 處理 WM_PAINT

• 所有者繪制

• 自定義繪制

• 處理 WM_CTLCOLOR


處理 WM_PAINT

最極端的選擇是執行一個 WM_PAINT 處理程序，并且自己完成所有的繪制。這意味著，您的代碼將需要進行一些與呈現控件相關的瑣事 — 創建適當的設備上下文（一個或多個），決定控件的大小和位置，繪制控件等。在繪制過程中，很少需要這種級別的控件。

所有者繪制

控制控件繪制的另一種方法是利用所有者繪制。事實上，您也許聽開發人員提到過所有者繪制控件，因為它是用于開發自定義控件最普通的技術。該技術普遍使用的主要原因在于，Windows 可為您提供很多幫助。在呈現控件的那一刻，Windows 就已經創建并填寫了設備上下文，決定了控件的大小和位置，并且向您傳遞信息以使您了解此刻繪制的需求。對于列表控件（例如，列表框和列表視圖），Windows 將為列表中的每一項調用繪制代碼，這意味著您只需繪制這些項，而無需考慮控件的其他方面。注意，所有者繪制可用于大多數控件。然而，它不能用于編輯控件；并且考慮到列表控件，它只能用于報表視圖樣式。

自定義繪制

對于繪制自己的控件而言，這可能是最少為人所知的技術。事實上，許多技術能力較高的開發人員也混淆了術語所有者繪制 (owner-draw) 和自定義繪制 (custom-draw)。關于自定義控件，首先需要了解，它僅針對于指定的公共控件：標頭、列表視圖、rebar、工具欄、工具提示、跟蹤條和樹視圖。此外，盡管所有者繪制只允許繪制報告視圖風格的列表視圖控件，而自定義繪制則使您能夠處理列表視圖控件所有視圖風格的繪制。使用自定義繪制的另一個明顯優勢是，您可以對希望繪制的內容進行嚴格挑選。實現方式是，在控件繪制的每個階段由 Windows 向代碼發送一個消息。這樣，您可以決定在每個階段是自己進行所有的繪制工作，增加默認的繪制，還是允許 Windows 為該階段執行所有的繪制。（鑒于自定義繪制是本文的一個主題，因此您很快會看到它的工作方式。）

處理 WM_CTLCOLOR

這可能是幫助決定如何呈現控件最簡單的方式。正如消息名所指，當要繪制一個控件，并且它能讓您的代碼決定要使用的畫筆時，發送 WM_CTLCOLOR 消息。通常情況下，如果您只想更改控件的顏色，并且不提供除控件本身之外的更多功能，則使用該技術。此外，對于由 Internet Explorer 引入的公共控件（列表視圖、樹視圖、rebar 等），不發送該消息，并且它只與標準控件（編輯、列表框等）協同使用。

實現自定義繪制的三步曲
既然您已經了解了繪制控件可用的各種選項（包括使用自定義繪制的好處），那么，讓我們來看看實現一個自定義繪制控件需要的三個主要步驟。

• 執行一個 NM_CUSTOMDRAW 消息處理程序。

• 指定處理所需的繪制階段。

• 篩選特定的繪制階段（在這些階段中，您需要加入自己的特定于控件的繪制代碼）。


執行一個NM_CUSTOMDRAW 消息處理程序

當需要繪制一個公共控件時，MFC 會將控件的自定義繪制通知消息（最初發送到控件的父窗口）以 NM_CUSTOMDRAW 消息的形式反饋給控件。以下是一個 NM_CUSTOMDRAW 處理程序的示例。

void CMyCustomDrawControl::OnCustomDraw(NMHDR* pNMHDR,
                                        LRESULT* pResult)
{
  LPNMCUSTOMDRAW pNMCD = reinterpret_cast(pNMHDR);
  ...
}

正如您所見，NM_CUSTOMDRAW 處理程序將一個指針傳遞給 NMHDR 類型的結構。然而，該值不足以用于象 NMHDR 這樣只包含三個成員（hwndFrom、idFrom 和 code）的結構。

因此，您通常需要將該結構指針轉換為信息量更大的結構 — LPNMCUSTOMDRAW。LPNMCUSTOMDRAW 指向 NMCUSTOMDRAW，它包含諸如 dwDrawStage、dwItemSpec 和 uItemState 這樣的成員 — 它們是決定當前繪制階段及確切繪制（例如，控件本身、或控件的一個項目或子項）所必需的。

這里值得注意的是，還可以將 NMHDR 指針指向特定于正在繪制控件的類型的結構。表 1 顯示控件的一個列表及其相關的自定義繪制結構類型名。

表 1：控件及其相關的自定義繪制結構
控件 結構（在 commctrl.h 中定義）
Rebar、Trackbar、AuthTicket、My.Resources、My.Settings、My.User 和 My.WebServices。
NMCUSTOMDRAW

List-view
NMLVCUSTOMDRAW

Toolbar
NMTBCUSTOMDRAW

Tooltip
NMTTCUSTOMDRAW

Tree-view
NMTVCUSTOMDRAW


指定處理所需的繪制階段

正如我在前面提到的，繪制一個控件存在一些“階段”。特別是，您可以將繪制過程理解為一系列階段，其中控件通知其父窗口需要繪制的內容。事實上，控件甚至會在繪制控件及其各項前后發送一個通知，從而讓編程人員更好地控制該過程。

在所有情況下，單一的 NM_CUSTOMDRAW 處理程序在每個繪制階段都進行調用。然而，謹記：自定義繪制允許您在自己的繪制中合并默認的控件繪制，您需要指定您將處理哪個繪制階段。這通過設置 NM_CUSTOMDRAW 處理程序的第二個參數 (pResult) 完成。事實上，如果您從未設置該值，則用初始階段的 CDDS_PREPAINT 調用函數后，您的函數將不再被調用！

從技術上講，只有兩個階段指定需要的繪制階段（CDDS_PREPAINT 和 CDDS_ITEMPREPAINT），它們影響發送通知消息的內容。然而，通常只在處理程序的最后指定代碼將處理的繪制階段。表 2 列出用于指定所需繪制階段（代碼關注的）的值。

表 2：自定義繪制返回標志
自定義繪制返回標志 含義
CDRF_DEFAULT
指示控件自行繪制。該值為默認值，不應該將它與其他值組合在一起。

CDRF_SKIPDEFAULT
用于指定控件根本不進行任何繪制。

CDRF_NEWFONT
當代碼更改繪制項/子項的字體時使用。

CDRF_NOTIFYPOSTPAINT
使通知信息在控件或每個項/子項繪制后發送。

CDRF_NOTIFYITEMDRAW
指出項（或子項）將進行繪制。注意，它下面的值與 CDRF_NOTIFYSUBITEMDRAW 相同。

CDRF_NOTIFYSUBITEMDRAW
指出子項（或項）將進行繪制。注意，它下面的值與 CDRF_NOTIFYITEMDRAW 相同。

CDRF_NOTIFYPOSTERASE
當刪除控件后需要通知代碼時使用。


以下為一個示例，其中的代碼指定，當繪制控件的項 (CDRF_NOTIFYITEMDRAW) 及子項 (CDRF_NOTIFYPOSTPAINT)，以及繪制完成時，應該調用 NM_CUSTOMDRAW 處理程序。

void CListCtrlWithCustomDraw::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult)
{
  LPNMCUSTOMDRAW pNMCD = reinterpret_cast(pNMHDR);

  ...
  
  *pResult = 0; // Initialize value
  *pResult |= CDRF_NOTIFYITEMDRAW;
  *pResult |= CDRF_NOTIFYSUBITEMDRAW;
  *pResult |= CDRF_NOTIFYPOSTPAINT;
}

篩選指定的繪制階段

一旦指定要關注的階段后，您需要處理這些階段。因為繪制過程的每個階段只有一個消息要發送，慣例是執行一個 switch 語句以決定準確的繪制階段。不同的繪制階段由以下標志定義：

CDDS_PREPAINT
CDDS_ITEM
CDDS_ITEMPREPAINT
CDDS_ITEMPOSTPAINT
CDDS_ITEMPREERASE
CDDS_ITEMPOSTERASE
CDDS_SUBITEM
CDDS_POSTPAINT
CDDS_PREERASE
CDDS_POSTERASE

對于一個 CListCtrl 派生的類，有一個 NM_CUSTOMDRAW 處理程序的示例，其中您可以發現，代碼決定當前繪制階段的方式：

void CMyCustomDrawControl::OnCustomDraw(NMHDR* pNMHDR,
                                        LRESULT* pResult)
{
  LPNMCUSTOMDRAW pNMCD = reinterpret_cast(pNMHDR);
  switch(pNMCD->dwDrawStage)
  {
    case CDDS_PREPAINT:
      ...
    break;
   
    case CDDS_ITEMPREPAINT:
      ...
    break;

    case CDDS_ITEMPREPAINT | CDDS_SUBITEM:
      ...
    break;
   
    ...
  }

  *pResult = 0;
}

注意，為了決定子項（例如，列表視圖控件）繪制的階段，您必需使用按位 or 操作符，它有兩個值：其中一個為 CDDS_ITEMPREPAINT 或者 CDDS_ITEMPOSTPAINT，另一個為 CDDS_SUBITEM。

要說明它，我們假定您想在繪制列表視圖項之前進行一些處理。將編寫 switch 語句來處理 CDDS_ITEMPREPAINT。

case CDDS_ITEMPREPAINT:
...
break;

然而，如果是您所關注子項的預繪制階段，則將如下操作：

case CDDS_ITEMPREPAINT | CDDS_SUBITEM:
...
break;

示例：創建一個列表視圖控件自定義繪制控件
如前面提到的，您可以完全控制控件及其項的繪制，或者僅執行一小部分特定于應用程序的繪制，并讓控件繼續進行。本文的焦點更多地偏重于控件繪制技術而非高級的繪制技術，我們將演練一個簡單的示例，其中列表視圖控件是一個自定義的繪制，因此項的文本將在創建拼接外觀的交替單元中顯示為不同的顏色。

• 創建一個基于 Visual C++ 2005 對話框的項目，名為 ListCtrlColor。

• 從 Class View 中選擇 Project 菜單選項，并單擊 Add Class 調用 Add Class 對話框。

• 從分類列表中選擇 MFC，然后從模板列表中選擇 MFC Class。

• 單擊 Add 按鈕，調用 MFC Class Wizard 對話框。

• 對于 Class name，鍵入值 CListCtrlWithCustomDraw 并選擇 CListCtrl 的 Base class。

• 單擊 Finish 按鈕，生成類的標頭和執行文件。

• 對于 Class View，右鍵單擊 CListCtrlWithCustomDraw 類，并選擇 Properties 上下文菜單選項。

• 顯示 Properties 窗口時，單擊頂部的 Messages 按鈕，顯示一個兩列的消息列表，您可以為其實現處理程序。

• 在消息列表中單擊 NM_CUSTOMDRAW 項，然后下拉第二列的組合框箭頭，并選擇值 OnNMCustomdraw。

• 現在，處理繪制代碼。這里，我們只簡單處理項和子項預繪制階段，指定基于當前行（項）和列（子項）的文本和背景色。要進行此操作，按如下所示修改 OnNMCustomdraw 函數：

void CListCtrlWithCustomDraw::OnNMCustomdraw(NMHDR *pNMHDR, LRESULT *pResult)
{
  LPNMLVCUSTOMDRAW lpLVCustomDraw = reinterpret_cast(pNMHDR);

  switch(lpLVCustomDraw->nmcd.dwDrawStage)
  {
    case CDDS_ITEMPREPAINT:
    case CDDS_ITEMPREPAINT | CDDS_SUBITEM:
      if (0 == ((lpLVCustomDraw->nmcd.dwItemSpec + lpLVCustomDraw->iSubItem) % 2))
      {
        lpLVCustomDraw->clrText = RGB(255,255,255); // white text
        lpLVCustomDraw->clrTextBk = RGB(0,0,0); // black background
      }
      else
      {
        lpLVCustomDraw->clrText = CLR_DEFAULT;
        lpLVCustomDraw->clrTextBk = CLR_DEFAULT;
      }
    break;

    default: break;   
  }

  *pResult = 0;
  *pResult |= CDRF_NOTIFYPOSTPAINT;
  *pResult |= CDRF_NOTIFYITEMDRAW;
  *pResult |= CDRF_NOTIFYSUBITEMDRAW;
}



現在，我們來測試新控件。要進行此操作，您只需使用 CListCtrlWithCustomDraw 類將列表視圖控件放在對話框中，并對其進行子類派生。下面是完成該操作的步驟。

• 在 Resource 視圖中，打開應用程序的主對話框 (IDD_LISTCTRLCOLOR_DIALOG)。

• 從 Toolbox 中，將一個 List Control 拖放到該對話框。

• 右鍵單擊列表控件，并選擇 Properties 上下文菜單選項。

• 將 View 屬性設置為 Report。

• 右鍵單擊控件，并選擇 Add Variable 上下文菜單選項。

• 出現 Add Member Variable Wizard 對話框時，指定 m_lstBooks 的 Variable name，并單擊 Finish 按鈕。

• 這時，您就有了一個 CListCtrl 派生類 (m_lstBooks)，它將對話框上的列表視圖控件進行子類派生。然而，m_lstBooks 需要從最新創建的 CListCtrlWithCustomDraw 派生，以便于調用您的繪制代碼。因此，打開對話框的標題文件 (ListCtrlColorDlg.h)，將 m_lstBooks 更改為 CListCtrlWithCustomDraw 類型。

• 在 CListCtrlColorDlg 類開始之前，添加以下指令。

#include "ListCtrlWithCustomDraw.h"


• 將下面的代碼添加到對話框的 OnInitDialog 成員函數，這樣我們就能夠看到一些列表視圖行。

// Insert the columns
m_lstBooks.InsertColumn(0, _T("Author");
m_lstBooks.InsertColumn(1, _T("Book");

// Define the data
static struct
{
  TCHAR m_szAuthor[50];
  TCHAR m_szTitle[100];
} BOOK_INFO[] = {
_T("Tom Archer", _T("Visual C++.NET Bible",
_T("Tom Archer", _T("Extending MFC with the .NET Framework",
_T("Brian Johnson", _T("XBox 360 For Dummies"
};

// Insert the data
int idx;
for (int i = 0; i < sizeof BOOK_INFO / sizeof BOOK_INFO[0]; i++)
{
  idx = m_lstBooks.InsertItem(i, BOOK_INFO.m_szAuthor);
  m_lstBooks.SetItemText(i, 1, BOOK_INFO.m_szTitle);
}


• 現在，建立并運行應用程序。圖 1 為應用程序外觀的一個示例。



圖 1. 自定義繪制示例應用程序



小結
當 Windows 首次作為“下一代”操作系統引入到應用程序開發之中時，它作為新圖形用戶界面的一個主要論據就是其一致性。該論據的要點所在是其具有一個通用的外觀：統一的菜單項、通用控件等。這一通用性的感覺可能會一直延續，直到有第二家公司想設計其自己的應用程序。簡單說，提供外觀與其他應用程序雷同的應用程序，任何公司都不會逃離這一怪圈。

要建立一個唯一的且讓人過目難忘的用戶界面，其中一種方式是為應用程序設計并開發自定義的控件。希望本文能對您有所幫助，現在，您了解到一種非常強大的技術，它使您的應用程序能從眾多競爭對手的應用程序中脫穎而出。