DRAWITEMSTRUCT Structure

La structure DRAWITEMSTRUCT a la forme suivante:

typeDef struct tagDRAWITEMSTRUCT {
 nbsp ;  UI&NT CtlType ;
    UINT CtlID ;
    UINT itemID ;
    UINT itemAction ;
    UINT itemState ;
    HWND hwndItem ;
    HDC hDC ;
    RECT rcItem ;
    DWORD itemData ;
} DRAWITEMSTRUCT

La structure DRAWITEMSTRUCT fournit des informations de la fenêtre propriétaire doivent avoir pour déterminer la façon de peindre un élément de menu ou un contrôle owner-drawn. La fenêtre propriétaire du contrôle owner-drawn ou élément de menu reçoit un pointeur vers cette structure comme le paramètre lParam du message WM_DRAWITEM.

Membres

CtlType

Le type de contrôle. Voici les valeurs pour les types de contrôle:

• ODT_BUTTO&Nnbsp ;  Bouton owner-drawn
  
  
• ODT_COMBOBOX  ;  Zone de liste déroulante owner-drawn
  
  
• ODT_LISTBOX  ;  Zone de liste owner-drawn
  
  
• ODT_ME&NUnbsp ;  Menu owner-drawn
  
  
• ODT_LISTVIEW  ;  Contrôle list view
  
  
• ODT_STATIC  ;  Contrôle statique owner-drawn
  
  
• ODT_TAB  ;  Contrôle onglet

CtlID

L'ID de contrôle pour un bouton, zone de liste ou zone de liste déroulante. Ce membre n'est pas utilisé pour un menu.

itemID

L'ID de l'élément de menu pour un menu ou l'index de l'élément dans une zone de liste ou zone de liste déroulante. Pour une zone de liste vide ou zone de liste déroulante, ce membre est une valeur négative, ce qui permet à l'application dessiner le rectangle de focus uniquement aux coordonnées spécifiées par le membre rcItem , même s'il n'y a aucun élément dans le contrôle. L'utilisateur peut ainsi démontrer si la zone de liste ou zone de liste déroulante a le focus d'entrée. Le paramétrage des bits dans le membre itemAction détermine si le rectangle doit être dessiné comme si la zone de liste ou zone de liste déroulante a d'entrée de l'accent.

itemAction

Définit l'action de dessin nécessaire. Ce sera un ou plusieurs bits suivants:

• ODA_DRAWE&NTIREnbsp ;  Ce bit est défini lorsque le contrôle entier doit être dessiné.
  
  
• ODA_FOCUS  ;  Ce bit est défini lorsque le contrôle gagne ou perd le focus d'entrée. Le itemState membre doit être vérifié afin de déterminer si le contrôle a le focus.
  
  
• ODA_SELECT  ;  Ce bit est défini lorsque seul le statut de sélection a été modifiée. Le itemState membre doit être vérifié afin de déterminer l'état de sélection nouvelle.

itemState

Spécifie l'état visuel de l'élément après que l'action de dessin actuelle se déroule. C'est si un élément de menu est d'être estompé, le drapeau d'état ODS_GRAYED sera définie. Voici les drapeaux d'État:

• ODS_CHECKED  ;  Ce bit est défini si l'élément de menu doit être vérifiée. Ce bit est utilisé uniquement dans un menu.
  
  
• ODS_DISABLED  ;  Ce bit est défini si l'élément doit être tirée comme désactivé.
  
  
• ODS_FOCUS  ;  Ce bit est défini si l'élément a input focus.
  
  
• ODS_GRAYED  ;  Ce bit est défini si l'élément doit être estompé. Ce bit est utilisé uniquement dans un menu.
  
  
• ODS_SELECTED  ;  Ce bit est défini si l'état de l'élément est sélectionné.
  
  
• ODS_COMBOBOXEDIT  ;  Le dessin se déroule dans la zone de sélection (edit control) d'une zone de liste modifiable ownerdrawn.
  
  
• ODS_DEFAULT  ;  L'élément est l'élément par défaut.

hwndItem

Spécifie le handle de fenêtre du contrôle des zones de liste modifiable, zones de liste et boutons. Spécifie le handle du menu (HMENU) qui contient l'élément pour les menus.

hDC

Identifie un contexte de périphérique. Ce contexte de périphérique doit être utilisé lors de l'exécution des opérations de dessin sur le contrôle.

rcItem

Un rectangle dans le contexte de périphérique spécifié par le membre de hDC qui définit les limites du contrôle pour tirer. Windows automatiquement les vidéos quoi que ce soit que le propriétaire tire dans le contexte de périphérique pour les zones de liste modifiable, zones de liste et boutons, mais ce ne pas détourer des éléments de menu. Lors de l'élaboration des éléments de menu, le propriétaire ne doit pas dessiner en dehors des limites du rectangle défini par le membre rcItem.

itemData

Pour une zone de liste déroulante ou zone de liste, ce membre contient la valeur qui a été transmise à la zone de liste par l'un des éléments suivants:

• CComboBox::AddString
  
  
• CComboBox::InsertString
  
  
• CListBox::AddString
  
  
• CListBox::InsertString

  Pour un menu, ce membre contient la valeur qui a été adoptée pour le menu par l'un des éléments suivants:

• CMenu::AppendMenu
  
  
• CMenu::InsertMenu
  
  
• CMenu::ModifyMenu

Voir aussi  ;CWnd::OnDrawItem