控件自绘DRAWITEMSTRUCT

Posted 2020-09-17 swsut_wjy

转载自：http://blog.sina.com.cn/s/blog_83b3bb460100t8w9.html

来由：DRAWITEMSTRUCT 为需要自绘的控件或者菜单项提供了必要的信息。在需要绘制的控件或者菜单项对应的WM_DRAWITEM消息函数中得到一个指向该结构的指针。　　

例子： 　　

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct); （.h中声明） 　　

void CColorButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct) （.cpp中定义）　　

这里LPDRAWITEMSTRUCT即指向DRAWITEMSTRUCT结构体的指针。　　

DRAWITEMSTRUCT结构的定义如下： 　　

typedef struct tagDRAWITEMSTRUCT

{ 　　

UINT CtlType; 　　

UINT CtlID; 　　

UINT itemID; 　　

UINT itemAction; 　　

UINT itemState; 　　

HWND hwndItem; 　　

HDC hDC; 　　

RECT rcItem; 　　

ULONG_PTR itemData; 　　

} DRAWITEMSTRUCT, NEAR *PDRAWITEMSTRUCT, FAR *LPDRAWITEMSTRUCT;

 

结构成员： 　　

成员： 　　

CtlType 　　

指定了控件的类型，其取值如下表所示。 　　

ODT_BUTTON：按钮控件 　　

ODT_COMBOBOX：组合框控件　　

ODT_LISTBOX：列表框控件 　　

ODT_LISTVIEW：列表视图控件 　　

ODT_MENU：菜单项　　

ODT_STATIC：静态文本控件 　　

ODT_TAB：Tab控件 　　

CtlID 　　

指定了自绘控件的ID值，而对于菜单项则不需要使用该成员 　　

itemID 　　

   表示菜单项ID，也可以表示列表框或者组合框中某项的索引值。对于一个空的列表框或组合框，该成员的

   值  为–1。这时应用程序只绘制焦点矩形（该矩形的坐标由rcItem 成员给出）虽然此时控件中没有需要显

   示的项，但是绘制焦点矩形还是很有必要的，因为这样做能够提示用户该控件是否具有输入焦点。

   当然也可以设置itemAction 成员为合适值，使得无需绘制焦点。 　　

itemAction 　　

   指定绘制行为，其取值可以为下表中所示值的一个或者多个的联合。 　　

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

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

   控件是否具有输入焦点。　　

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

   控件是否处于选中状态。 　　

itemState 　　

   指定了当前绘制操作完成后，所绘项的可见状态。

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

   ODS_CHECKED：如果菜单项将被选中，则可设置该值。该值只对菜单项有用。　　

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

   ODS_DEFAULT：默认值。　　

   ODS_DISABLED：如果控件将被禁止，则设置该值。 　　

   ODS_FOCUS：如果控件需要输入焦点，则设置该值。　　

   ODS_GRAYED：如果控件需要被灰色显示，则设置该值。该值只在绘制菜单时使用。 　　

   ODS_HOTLIGHT：Windows 98/Me, Windows 2000/XP: 如果鼠标指针位于控件之上，则设置该值，这时控件会

            显示高亮颜色。　　

    ODS_INACTIVE：Windows 98/Me, Windows 2000/XP: 表示没有激活的菜单项。　　

    ODS_NOACCEL：Windows 2000/XP: 控件是否有快速键盘。 　　

    ODS_NOFOCUSRECT：Windows 2000/XP: 不绘制捕获焦点的效果。 　　

    ODS_SELECTED：选中的菜单项。 　　

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。