DRAWITEMSTRUCT结构中各域的详解

typedef   struct   tagdrawitemstruct   {  
  uint       ctltype; //  
  uint       ctlid; //  
  uint       itemid; //  
  uint       itemaction; //  
  uint       itemstate; //  
  hwnd       hwnditem; //  
  hdc     hdc; //  
  rect       rcitem; //  
  dword     itemdata; //  
  }   drawitemstruct;  
 
  ctltype<----------------------------------  
  odt_button       owner-drawn   button  
  odt_combobox       owner-drawn   combo   box  
  odt_listbox       owner-drawn   list   box  
  odt_menu       owner-drawn   menu  
  odt_listview       list   view   control  
  odt_static       owner-drawn   static   control  
  odt_tab       tab   control    
   
  itemaction<-------------------------------  
  oda_drawentire  
  oda_focus  
  oda_select  
   
  itemstate<--------------------------------  
  ods_checked  
  ods_disabled  
  ods_focus  
  ods_grayed  
  ods_selected  
  ods_comboboxedit  
  ods_default  
 
typedef   struct   tagdrawitemstruct   {  
  uint       ctltype;//控件类型  
  uint       ctlid;      //控件id  
  uint       itemid;  //菜单项、列表框或组合框中某一项的索引值  
  uint       itemaction;//控件行为  
  uint       itemstate;    //控件状态  
  hwnd       hwnditem;    //父窗口句柄或菜单句柄  
  hdc     hdc;//控件对应的绘图设备句柄  
  rect       rcitem;  //控件所占据的矩形区域  
  dword     itemdata;      //列表框或组合框中某一项的值  
  }   drawitemstruct,   *pdrawitemstruct,   *lpdrawitemstruct;  
  下面详细解释各个变量或机构的含义：  
   
  drawitemstruct结构文档  
   
  drawitemstruct  
   
  drawitemstruct   为需要自绘的控件或者菜单项提供了必要的信息。在需要绘制的控件或者菜单项对应的wm_drawitem消息函数中得到一个指向该结构的指针。   drawitemstruct结构的定义如下：  
  typedef   struct   tagdrawitemstruct   {  
  uint   ctltype;  
  uint   ctlid;  
  uint   itemid;  
  uint   itemaction;  
  uint   itemstate;  
  hwnd   hwnditem;  
  hdc   hdc;  
  rect   rcitem;  
  ulong_ptr   itemdata;  
  }drawitemstruct;  
   
  结构成员：  
   
  ctltype  
  指定了控件的类型，其取值如下表所示。  
   
  取值  
  描述  
   
  odt_button  
  按钮控件  
   
  odt_combobox  
  组合框控件  
   
  odt_listbox  
  列表框控件  
   
  odt_listview  
  列表视图控件  
   
  odt_menu  
  菜单项  
   
  odt_static  
  静态文本控件  
   
  odt_tab  
  tab控件  
   
  ctlid  
   
  指定了自绘控件的id值，而对于菜单项则不需要使用该成员  
   
  itemid  
  表示菜单项id，也可以表示列表框或者组合框中某项的索引值。对于一个空的列表框或组合框，该成员的值为–1。这时应用程序只绘制焦点矩形虽然此时控件中没有需要显示的项，但是绘制焦点矩形还是很有必要的，因为这样做能够提示用户该控件是否具有输入焦点。当然也可以设置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中的坐标点指的就是控件的左上角。但是系统不裁剪菜单项，所以在绘制菜单项的时候，必须先通过一定的换算得到该菜单项的位置，以保证绘制操作在我们希望的区域中进行。  
   
  itemdata  
  对于菜单项，该成员的取值可以是由  
   
  cmenu::appendmenu、  
  cmenu::insertmenu或者  
  cmenu::modifymenu  
   
  等函数传递给菜单的值。  
   
  对于列表框或这组合框，该成员的值可以为由  
   
  combobox::addstring、  
  ccombobox::insertstring、  
  clistbox::addstring或者  
  clistbox::insertstring  
   
  等传递给控件的值。  
   
  如果ctltype   的取值是odt_button或者odt_static,   itemdata的取值为0。