DRAWITEMSTRUCT自绘控件结构体

DRAWITEMSTRUCT

  编辑

本词条缺少 名片图，补充相关内容使词条更完整，还能快速升级，赶紧来 编辑吧！

DRAWITEMSTRUCT结构 [1]   为需要自绘的控件或者菜单项提供了必要的信息。在需要绘制的控件或者菜单项对应的 WM_DRAWITEM消息函数中得到一个指向该结构的 指针。该结构是由收到的WM_DRAWITEM消息的 lParam参数提供的，这个参数是指向这个结构的指针。

外文名

DRAWITEMSTRUCT

目    的

提供了必要的信息

指    向

这个结构的指针

例    子

在VB中应用

目录

1. 1 例子：
2. 2 结构定义
3. ▪ 结构成员：
4. ▪ CtlType ：

1. ▪ CtlID：
2. ▪ itemID：
3. ▪ itemAction：
4. ▪ itemState：
5. ▪ hwndItem：

1. ▪ hDC：
2. ▪ rcItem：
3. ▪ itemData：

例子：

编辑

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

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

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

对于DRAWITEMSTRUCT结构 在VB中应用时，由于 lParam参数提供的是指向DRAWITEMSTRUCT结构的指针，因此，我们需要用 CopyMemory将指针复制到一个声明为DRAWITEMSTRUCT结构类型的变量中，详细请参见  [2]  

结构定义

编辑

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	4	按钮控件
ODT_COMBOBOX	3	组合框控件
ODT_LISTBOX	2	列表框控件
ODT_LISTVIEW	102	列表视图控件
ODT_MENU	1	菜单项
ODT_STATIC	5	静态文本控件
ODT_TAB	101	Tab控件

经实测这些常量值是十进制的。

CtlID：

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

itemID：

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

itemAction：

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

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

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

ODA_SELECT=H2

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

itemState：

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

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

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

ODS_DEFAULT=H20：默认值。

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

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

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

ODS_HOTLIGHT=H40：Windows 98/Me, Windows 2000/XP: 如果 鼠标指针位于控件之上，则设置该值，这时控件会显示高亮颜色。

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

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

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

ODS_SELECTED=H1：选中的菜单项。

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。

以上资料来源于百度百科。