威胜电表通讯协议下载:VC美化原理补充

3.3.4 WM_DRAWITEM

OnCtlColor只能修改元素的颜色，但不能修改元素的界面框架，WM_DRAWITEM则可以。

当一个具有Owner draw风格的元素(包括按钮、组合框、列表框和菜单等)需要显示外观时，该元素会发送一条WM_DRAWITEM消息至它的隶属窗口(Owner)。

WM_DRAWITEM的映射函数原型如下：

afx_msg void OnDrawItem( int nIDCtl, LPDRAWITEMSTRUCT lpDrawItemStruct );

参数：

nIDCtl 该控件的ID，如果该元素为菜单，则nIDCtl为0

lpDrawItemStruct 指向DRAWITEMSTRUCT结构对象的指针，DRAWITEMSTRUCT的结构定义如下：

查看源代码拷贝至剪贴板打印代码

1. typedef struct tagDRAWITEMSTRUCT   
2. {   
3.     UINT    CtlType;   
4.     UINT    CtlID;   
5.     UINT    itemID;   
6.     UINT    itemAction;   
7.     UINT    itemState;   
8.     HWND    hwndItem;   
9.     HDC     hDC;   
10.      RECT    rcItem;   
11.     DWORD   itemData;   
12. }DRAWITEMSTRUCT;   

CtlType指定了控件的类型，其取值如表3所示：

类型值 含义

ODT_BUTTON 按钮控件

ODT_COMBOBOX 组合框控件

ODT_LISTBOX 列表框控件

ODT_LISTVIEW 列表视图

ODT_MENU 菜单项

ODT_STATIC 静态文本控件

ODT_TAB Tab控件

表3 CtlType的类型值与含义

CtlID 指定自绘控件的ID值，该成员不适用于菜单项

itemID表示菜单项ID，也可以表示列表框或者组合框中某项的索引值。对于一个空的列表框或组合框，该成员的值为?C1。这时应用程序只绘制焦点矩形(该矩形的坐标由rcItem 成员给出)虽然此时控件中没有需要显示的项，但是绘制焦点矩形还是很有必要的，因为这样做能够提示用户该控件是否具有输入焦点。当然也可以设置itemAction 成员为合适值，使得无需绘制焦点。

itemAction 指定绘制行为，其取值为表4中所示值的一个或者多个的联合：

类型值 含义

ODA_DRAWENTIRE 当整个控件都需要被绘制时，设置该值。

ODA_FOCUS 如果控件需要在获得或失去焦点时被绘制，则设置该值。此时应该检查itemState成员，以确定控件是否具有输入焦点。

ODA_SELECT 如果控件需要在选中状态改变时被绘制，则设置该值。此时应该检查itemState 成员，以确定控件是否处于选中状态。

表4 itemAction的类型值与含义

itemState 指定了当前绘制项的状态。例如，如果菜单项应该被灰色显示，则可以指定ODS_GRAYED状态标志。其取值为表5中所示值的一个或者多个的联合：

类型值 含义

ODS_CHECKED 标记状态，仅适用于菜单项。

ODS_DEFAULT 默认状态。

ODS_DISABLED 禁止状态。

ODS_FOCUS 焦点状态。

ODS_GRAYED 灰化状态，仅适用于菜单项。

ODS_SELECTED 选中状态。

ODS_HOTLIGHT 仅适用于Windows 98/Me/Windows 2000/XP，热点状态：如果鼠标指针位于控件之上，则设置该值，这时控件会显示高亮颜色。

ODS_INACTIVE 仅适用于Windows 98/Me/Windows 2000/XP，非激活状态。

ODS_NOACCEL 仅适用于Windows 2000/XP，控件是否有快速键。

ODS_COMBOBOXEDIT 在自绘组合框控件中只绘制选择区域。

ODS_NOFOCUSRECT 仅适用于Windows 2000/XP，不绘制捕获焦点的效果。

表5 itemState的类型值与含义

hwndItem 指定了组合框、列表框和按钮等自绘控件的窗口句柄；如果自绘的对象为菜单项，则表示包含该菜单项的菜单句柄。

hDC 指定了绘制操作所使用的设备环境。

rcItem 指定了将被绘制的矩形区域。这个矩形区域就是上面hDC的作用范围。系统会自动裁剪组合框、列表框或按钮等控件的自绘制区域以外的部分。也就是说rcItem中的坐标点(0，0)指的就是控件的左上角。但是系统不裁剪菜单项，所以在绘制菜单项的时候，必须先通过一定的换算得到该菜单项的位置，以保证绘制操作在我们希望的区域中进行。

itemData

对于菜单项，该成员的取值为由CMenu::AppendMenu、CMenu::InsertMenu、CMenu::ModifyMenu等函数传递给菜单的值。

对于列表框或这组合框，该成员的取值为由ComboBox::AddString、CComboBox::InsertString、CListBox::AddString或者CListBox::InsertString等函数传递给控件的值。

如果ctlType 的取值是ODT_BUTTON或者ODT_STATIC，itemData的取值为0。

图5是个相应的例子，它修改了按钮的界面：

图8 利用WM_DRAWITEM消息美化界面

实现代码如下：

查看源代码拷贝至剪贴板打印代码

1. BOOL CUi6Dlg::OnInitDialog()   
2. {   
3.     //…   
4.     //创建字体   
5.     //CFont CUi1View::m_Font   
6.      m_Font.CreatePointFont(120, "Impact");   
7.     //…   
8. }   
9.   
10. void CUi6Dlg::OnDrawItem(int nIDCtl, LPDRAWITEMSTRUCT lpDrawItemStruct)   
11. {   
12.     if(nIDCtl == IDC_HELLO_CFAN)   
13.      {   
14.         //绘制按钮框架   
15.   
16.         UINT uStyle = DFCS_BUTTONPUSH;   
17.         //是否按下去了？   
18.         if (lpDrawItemStruct->itemState & ODS_SELECTED)   
19.              uStyle |= DFCS_PUSHED;   
20.   
21.          CDC dc;   
22.          dc.Attach(lpDrawItemStruct->hDC);   
23.          dc.DrawFrameControl(&lpDrawItemStruct->rcItem, DFC_BUTTON, uStyle);   
24.   
25.         //输出文字   
26.          dc.SelectObject(&m_Font);   
27.          dc.SetTextColor(RGB(0, 0, 255));   
28.          dc.SetBkMode(TRANSPARENT);   
29.   
30.         CString sText;   
31.          m_HelloCFan.GetWindowText(sText);   
32.          dc.TextOut(lpDrawItemStruct->rcItem.left + 20, lpDrawItemStruct->rcItem.top + 20, sText);   
33.   
34.         //是否得到焦点   
35.         if(lpDrawItemStruct->itemState & ODS_FOCUS)   
36.          {   
37.             //画虚框   
38.              CRect rtFocus = lpDrawItemStruct->rcItem;   
39.              rtFocus.DeflateRect(3, 3);   
40.              dc.DrawFocusRect(&rtFocus);   
41.          }   
42.   
43.         return;   
44.      }   
45.      CDialog::OnDrawItem(nIDCtl, lpDrawItemStruct);   
46. }   

别忘了标记Owner draw属性：

图9 指定按钮的Owner draw属性

值得一提的是，CWnd内部截获了WM_DRAWITEM、WM_MEASUREITEM等消息，并映射成子元素的相应虚函数的调用，如CButton::DrawItem()。所以，以上例子也可以通过派生出一个CButton的派生类，并重载该类的DrawItem()函数来实现。使用虚函数机制实现界面美化参见3.4章节。

3.3.5 WM_MEASUREITEM

仅仅WM_DRAWITEM还是不够的，对于一些特殊的控件，如ListBox，系统在发送WM_DRAWITEM消息前，还发送WM_MEASUREITEM消息，需要你设置ListBox中每个项目的高度。

WM_DRAWITEM的映射函数原型如下：

afx_msg void OnMeasureItem( int nIDCtl, LPMEASUREITEMSTRUCT lpMeasureItemStruct );

nIDCtl 该控件的ID，如果该元素为菜单，则nIDCtl为0

lpMeasureItemStruct指向MEASUREITEMSTRUCT结构对象的指针，MEASUREITEMSTRUCT的结构定义如下：

查看源代码拷贝至剪贴板打印代码

1. typedef struct tagMEASUREITEMSTRUCT   
2. {   
3.     UINT    CtlType;   
4.     UINT    CtlID;   
5.     UINT    itemID;   
6.     UINT    itemWidth;   
7.     UINT    itemHeight;   
8.     DWORD   itemData   
9. } MEASUREITEMSTRUCT;   

CtlType指定了控件的类型，其取值如表6所示：

类型值 含义

ODT_COMBOBOX 组合框控件

ODT_LISTBOX 列表框控件

ODT_MENU 菜单项

表6 CtlType的类型值与含义

CtlID 指定自绘控件的ID值，该成员不适用于菜单项

itemID表示菜单项ID，也可以表示可变高度的列表框或组合框中某项的索引值。该成员不适用于固定高度的列表框或组合框。

itemWidth 指定菜单项的宽度

itemHeight指定菜单项或者列表框中某项的的高度，最大值为255

itemData

对于菜单项，该成员的取值为由CMenu::AppendMenu、CMenu::InsertMenu、CMenu::ModifyMenu等函数传递给菜单的值。

对于列表框或这组合框，该成员的取值为由ComboBox::AddString、CComboBox::InsertString、CListBox::AddString或者CListBox::InsertString等函数传递给控件的值。

图示出了OnMeasureItem的效果：

图10 利用WM_MEASUREITEM消息美化界面

相应的OnMeasureItem()实现如下：

查看源代码拷贝至剪贴板打印代码

1. void CUi7Dlg::OnMeasureItem(int nIDCtl, LPMEASUREITEMSTRUCT lpMeasureItemStruct)   
2. {   
3.     if(nIDCtl == IDC_COLOR_PICKER)   
4.      {   
5.         //设定高度为30   
6.          lpMeasureItemStruct->itemHeight = 30;   
7.         return;   
8.      }   
9.      CDialog::OnMeasureItem(nIDCtl, lpMeasureItemStruct);   
10. }   

同样别忘了指定列表框的Owner draw属性：

图11 指定下拉框的Owner draw属性

3.3.6 NM_CUSTOMDRAW

大家也许熟悉WM_NOTIFY，控件通过WM_NOTIFY向父窗口发送消息。在WM_NOTIFY消息体中，部分控件会发送NM_CUSTOMDRAW告诉父窗口自己需要绘图。

可以反射NM_CUSTOMDRAW消息，如：

ON_NOTIFY_REFLECT(NM_CUSTOMDRAW, OnCustomDraw)

afx_msg void OnCustomDraw(NMHDR *pNMHDR, LRESULT *pResult);

参数：

pNMHDR 说到底只是一个指针，大多数情况下它指向一个NMHDR结构对象，NMHDR结构如下：

查看源代码拷贝至剪贴板打印代码

1. typedef struct tagNMHDR   
2. {   
3.     HWND hwndFrom;   
4.     UINT idFrom;   
5.     UINT code;   
6. } NMHDR;   

其中：

hwndFrom 发送方控件的窗口句柄

idFrom 发送方控件的ID

code 通知代码

对于某些控件来说，pNMHDR则会解释成其它内容更丰富的结构对象的指针，如：对于列表控件来说，pNMHDR常常指向一个NMCUSTOMDRAW对象，NMCUSTOMDRAW结构如下：

查看源代码拷贝至剪贴板打印代码

1. typedef struct tagNMCUSTOMDRAWINFO   
2. {   
3.      NMHDR   hdr;   
4.     DWORD   dwDrawStage;   
5.     HDC     hdc;   
6.      RECT    rc;   
7.     DWORD   dwItemSpec;   
8.     UINT    uItemState;   
9.     LPARAM lItemlParam;   
10. } NMCUSTOMDRAW, FAR * LPNMCUSTOMDRAW;   

hdr NMHDR对象

dwDrawStage 当前绘制状态，其取值如表7所示：

类型值 含义

CDDS_POSTERASE 擦除循环结束

CDDS_POSTPAINT 绘制循环结束

CDDS_PREERASE 准备开始擦除循环

CDDS_PREPAINT 准备开始绘制循环

CDDS_ITEM 指定dwItemSpec, uItemState, lItemlParam参数有效

CDDS_ITEMPOSTERASE 列表项擦除结束

CDDS_ITEMPOSTPAINT 列表项绘制结束

CDDS_ITEMPREERASE 准备开始列表项擦除

CDDS_ITEMPREPAINT 准备开始列表项绘制

CDDS_SUBITEM 指定列表子项

表7 dwDrawStage的类型值与含义

hdc指定了绘制操作所使用的设备环境。

rc指定了将被绘制的矩形区域。

dwItemSpec 列表项的索引

uItemState 当前列表项的状态，其取值如表8所示：

类型值 含义

CDIS_CHECKED 标记状态。

CDIS_DEFAULT 默认状态。

CDIS_DISABLED 禁止状态。

CDIS_FOCUS 焦点状态。

CDIS_GRAYED 灰化状态。

CDIS_SELECTED 选中状态。

CDIS_HOTLIGHT 热点状态。

CDIS_INDETERMINATE 不定状态。

CDIS_MARKED 标注状态。

表8 uItemState的类型值与含义

lItemlParam 当前列表项的绑定数据

pResult 指向状态值的指针，指定系统后续操作，依赖于dwDrawStage：

当dwDrawStage为CDDS_PREPAINT，pResult含义如表9所示：

类型值 含义

CDRF_DODEFAULT 默认操作，即系统在列表项绘制循环过程不再发送NM_CUSTOMDRAW。

CDRF_NOTIFYITEMDRAW 指定列表项绘制前后发送消息。

CDRF_NOTIFYPOSTERASE 列表项擦除结束时发送消息。

CDRF_NOTIFYPOSTPAINT 列表项绘制结束时发送消息。

表9 pResult的类型值与含义(一)

当dwDrawStage为CDDS_ITEMPREPAINT，pResult含义如表10所示：

类型值 含义

CDRF_NEWFONT 指定后续操作采用应用中指定的新字体。

CDRF_NOTIFYSUBITEMDRAW 列表子项绘制时发送消息。

CDRF_SKIPDEFAULT 系统不必再绘制该子项。

表10 pResult的类型值与含义(二)

以下是一个利用NM_CUSTOMDRAW消息绘制出的多色列表框的例子：

图12 利用NM_CUSTOMDRAW消息美化界面

对应代码如下：

查看源代码拷贝至剪贴板打印代码

1. void CCoolList::OnCustomDraw(NMHDR *pNMHDR, LRESULT *pResult)   
2. {   
3.     //类型安全转换   
4.      NMLVCUSTOMDRAW* pLVCD = reinterpret_cast(pNMHDR);   
5.      *pResult = 0;   
6.        
7.     //指定列表项绘制前后发送消息   
8.     if(CDDS_PREPAINT == pLVCD->nmcd.dwDrawStage)   
9.      {   
10.          *pResult = CDRF_NOTIFYITEMDRAW;   
11.      }   
12.     else if(CDDS_ITEMPREPAINT == pLVCD->nmcd.dwDrawStage)   
13.      {   
14.         //奇数行   
15.         if(pLVCD->nmcd.dwItemSpec % 2)   
16.              pLVCD->clrTextBk = RGB(255, 255, 128);   
17.         //偶数行   
18.         else  
19.              pLVCD->clrTextBk = RGB(128, 255, 255);   
20.         //继续   
21.          *pResult = CDRF_DODEFAULT;   
22.      }   
23. }