读书笔记摘抄新闻资讯DRAWITEMSTRUCT
DRAWITEMSTRUCT结构为需要自绘的控制项或者选单项提供了必要的信息。在需要绘製的控制项或者选单项对应的WM_DRAWITEM讯息函式中得到一个指向该结构的指针。该结构是由收到的WM_DRAWITEM讯息的lParam参数提供的，这个参数是指向这个结构的指针。
基本介绍
- 外文名：DRAWITEMSTRUCT
- 目的：提供了必要的信息
- 指向：这个结构的指针
- 例子：在VB中套用
例子
virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct); //（.h中声明）
void CColorButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct) //（.cpp中定义）
这里LPDRAWITEMSTRUCT即指向DRAWITEMSTRUCT结构体的指针。
对于DRAWITEMSTRUCT结构在VB中套用时，由于lParam参数提供的是指向DRAWITEMSTRUCT结构的指针，因此，我们需要用CopyMemory将指针複製到一个声明为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 | 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。