TN014：自訂控制項

發行項
10/12/2023

本附註將描述自訂和自繪控制項的 MFC 支援。它也描述動態子類別化，並描述 CWnd 物件與 HWND s 之間的關聯性。

MFC 範例應用程式 CTRLTEST 將說明如何使用多種自訂控制項。請參閱 MFC 一般範例 CTRLTEST 和線上說明的原始程式碼。

主控描繪控制項/功能表

Windows 使用 Windows 訊息為主控描繪控制項和功能表提供支援。任何控制項或功能表的父視窗都會收到這些訊息，並呼叫函式予以回應。您可以覆寫這些函式以自訂您的主控描繪控制項或功能表的視覺外觀和行為。

MFC 可直接支援包含下列函式的主控描繪：

您可以在 CWnd 衍生類別中覆寫這些函式，以實作自訂繪製行為。

這個方法不會產生可重複使用的程式碼。如果兩個不同的 CWnd 類別中有兩個類似的控制項，您就必須在這兩個位置實作自訂控制項行為。 MFC 支援的自繪控制項架構可解決這個問題。

自繪控制項和功能表

MFC 提供標準擁有者繪製訊息的預設實作（在 CWnd 和 CMenu 類別中）。這個預設實作會將主控描繪參數解碼，並且將主控描繪訊息委派至控制項或功能表。這個過程稱為自繪 (Self-draw)，因為繪圖程式碼位於控制項或功能表的類別中，而不是主控視窗中。

使用自繪控制項就能建置可重複使用的控制項類別，這些類別會使用主控描繪語意顯示控制項。繪製控制項的程式碼位於控制項類別中，而非其父代中。這是一種物件導向的自訂控制項程式設計方法。將下列函式清單加入至自繪類別：

自繪按鈕：

CButton:DrawItem(LPDRAWITEMSTRUCT);
// insert code to draw this button

自繪功能表：

CMenu:MeasureItem(LPMEASUREITEMSTRUCT);
// insert code to measure the size of an item in this menu
CMenu:DrawItem(LPDRAWITEMSTRUCT);
// insert code to draw an item in this menu

自繪清單方塊：

CListBox:MeasureItem(LPMEASUREITEMSTRUCT);
// insert code to measure the size of an item in this list box
CListBox:DrawItem(LPDRAWITEMSTRUCT);
// insert code to draw an item in this list box

CListBox:CompareItem(LPCOMPAREITEMSTRUCT);
// insert code to compare two items in this list box if LBS_SORT
CListBox:DeleteItem(LPDELETEITEMSTRUCT);
// insert code to delete an item from this list box

自繪下拉式方塊：

CComboBox:MeasureItem(LPMEASUREITEMSTRUCT);
// insert code to measure the size of an item in this combo box
CComboBox:DrawItem(LPDRAWITEMSTRUCT);
// insert code to draw an item in this combo box

CComboBox:CompareItem(LPCOMPAREITEMSTRUCT);
// insert code to compare two items in this combo box if CBS_SORT
CComboBox:DeleteItem(LPDELETEITEMSTRUCT);
// insert code to delete an item from this combo box

如需擁有者繪製結構的詳細資料（DRAWITEMSTRUCT、MEASUREITEMSTRUCT 、 COMPAREITEMSTRUCT 和 DELETEITEMSTRUCT ），請參閱、和 CWnd::OnDeleteItem 的 MFC 檔 CWnd::OnMeasureItemCWnd::OnDrawItemCWnd::OnCompareItem 。

使用自繪控制項和功能表

若是自繪功能表，您必須同時覆寫 OnMeasureItem 和 OnDrawItem 方法。

若是自繪清單方塊和下拉式方塊，您必須覆寫 OnMeasureItem 和 OnDrawItem。您必須為對話方塊範本中的下拉式方塊指定LBS_OWNERDRAWVARIABLE樣式或下拉式方塊CBS_OWNERDRAWVARIABLE樣式。 OWNERDRAWFIXED 樣式不適用於自我繪製專案，因為固定專案高度是在自我繪製控制項附加至清單方塊之前決定的。（您可以使用方法 CListBox：：SetItemHeight 和 CComboBox：：SetItemHeight 克服這項限制。

切換至 OWNERDRAWVARIABLE 樣式會強制系統將 NOINTEGRALHEIGHT 樣式套用至控制項。因為控制項無法計算具有可變大小專案的整數高度，所以會忽略 INTEGRALHEIGHT 的預設樣式，而且控制項一律為 NOINTEGRALHEIGHT。如果您的項目高度固定，就可以藉由將控制項大小指定為項目大小的整數倍數防止繪製部分項目。

對於具有LBS_SORT或CBS_SORT樣式的自我繪製清單方塊和下拉式方塊，您必須覆寫 OnCompareItem 方法。

對於自繪清單方塊和下拉式方塊，通常不會覆寫 OnDeleteItem。如果您要執行任何特殊處理，可以覆寫 OnDeleteItem。適用的情況是，每個清單方塊或下拉式方塊項目都儲存了額外的記憶體或其他資源。

自繪控制項和功能表的範例

MFC 一般範例 CTRLTEST 提供自我繪製功能表和自我繪製清單方塊的範例。

最常見的自繪按鈕範例是點陣圖按鈕。點陣圖按鈕是指顯示一個、兩個或三個點陣圖影像代表不同狀態的按鈕。 MFC 類別 CBitmapButton 中提供了這個範例。

動態子類別化

有時候您會想要變更已存在物件的功能。先前的範例會要求您在建立控制項之前進行自訂。而動態子類別化可讓您自訂已建立的控制項。

子類別化是 Windows 詞彙，用來以自訂的取代 WndProc 視窗的，並針對預設功能呼叫舊的 WndProc 。 WndProc

子類別化不應與 C++ 類別衍生混淆。為了厘清，C++ 詞彙基類和 衍生類別 類似于 Windows 物件模型中的超級類別 和 子類別 。使用 MFC 的 C++ 衍生和 Windows 子類別化在功能上很類似，但 C++ 不支援動態子類別化。

CWnd 類別提供了 C++ 物件 (衍生自 CWnd) 與 Windows 視窗物件 (稱為 HWND) 之間的連接。

有三種在這些物件之間產生關聯的常見方式：

CWnd 會建立 HWND。您可以建立衍生自 CWnd 的類別，藉此修改衍生類別中的行為。 HWND會在您的應用程式呼叫 CWnd：：Create 時建立。
應用程式會將 CWnd 附加至現有的 HWND。現有視窗的行為則不會修改。這是委派的案例，而且可以藉由呼叫 CWnd：：Attach 至現有 HWNDCWnd 物件別名來達成。
CWnd 會附加至現有的 HWND，而您可以修改衍生類別中的行為。這稱為動態子類別化，因為我們會在執行階段變更 Windows 物件的行為，以因此變更了類別。

您可以使用 CWnd：：SubclassWindow 和 CWnd：：SubclassDlgItem 方法來達成動態子類別。

這兩種常式都會將 CWnd 物件附加至現有的 HWND。 SubclassWindow 是直接採用 HWND。 SubclassDlgItem 是採用控制項 ID 和父視窗的 Helper 函式。 SubclassDlgItem 的設計是將 C++ 物件附加至從對話方塊範本建立的對話方塊控制項。

如需使用 SubclassWindow 和 SubclassDlgItem 的幾個範例，請參閱 CTRLTEST 範例。

另請參閱

依編號顯示的技術提示
 依分類區分的技術提示

共用方式為