DRAWITEMSTRUCT

DRAWITEMSTRUCT【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_BUTTON4按钮控制项ODT_COMBOBOX3组合框控制项ODT_LISTBOX2列表框控制项ODT_LISTVIEW102列表视图控制项ODT_MENU1选单项ODT_STATIC5静态文本控制项ODT_TAB101Tab控制项经实测这些常量值是十进制的 。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 。