Estrutura DRAWITEMSTRUCT

A estrutura DRAWITEMSTRUCT tem a seguinte forma:

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

A estrutura DRAWITEMSTRUCT fornece informações a janela do proprietário devem ter para determinar como pintar um controle owner-drawn ou item de menu. A janela de proprietário de controle owner-drawn ou item de menu recebe um ponteiro para essa estrutura como o lParam parâmetro da mensagem WM_DRAWITEM.

Membros

CtlType

O tipo de controle. Os valores para tipos de controle são as seguintes:

• ODT_BUTTO&Nnbsp;  Botão Owner-drawn
  
  
• ODT_COMBOBOX   Caixa de combinação Owner-drawn
  
  
• ODT_LISTBOX   Caixa lista Owner-drawn
  
  
• ODT_ME&NUnbsp;  Menu de desenho proprietário
  
  
• ODT_LISTVIEW   Controle de exibição lista
  
  
• ODT_STATIC   Controle estático Owner-drawn
  
  
• ODT_TAB   Controlarar guia

CtlID

A identificação de Controlarar para uma caixa de combinação, caixa lista ou botão. Este membro não é usado para um menu.

itemID

A ID do item de menu para um menu ou o índice do item em uma caixa de listagem ou caixa de combinação. Para uma lista vazia caixa ou caixa de combinação, esse membro é um valor negativo, o que permite que o aplicativo desenhar somente o Retangular de foco nas coordenadas especificadas pelo rcItem membro, mesmo que não há itens no Controlarar. O usuário pode ser mostrado, assim, se a caixa de listagem ou caixa de combinação tem o foco de entrada. A configuração dos bits no membro itemAction determina se o Retangular é a serem desenhados como se a caixa de combinação ou caixa de listagem tem foco de entrada.

itemAction

Define a ação desenho necessária. Este será um ou mais dos seguintes bits:

• ODA_DRAWE&NTIREnbsp;  Este bit é definido quando todo o Controlarar precisa ser desenhado.
  
  
• ODA_FOCUS   Este bit é definido quando o Controlarar ganha ou perde o foco de entrada. O membro de itemState deve ser marcado para determinar se o Controlarar tem foco.
  
  
• ODA_SELECT   Este bit é definido quando apenas o status de seleção foi alterada. O membro de itemState deve ser marcado para determinar o novo Estado de seleção.

itemState

Especifica o estado visual do item após a atual desenho ação ocorre. Ou seja, se um item de menu é ser esmaecido, o sinalizador de estado ODS_GRAYED será definido. Os sinalizadores de estado são os seguintes:

• ODS_CHECKED   Esse bit será definido se o item de menu é para ser verificado. Este bit é usado somente em um menu.
  
  
• ODS_DISABLED   Esse bit será definido se o item é a serem desenhados como desativado.
  
  
• ODS_FOCUS   Esse bit será definido se o item tem o foco de entrada.
  
  
• ODS_GRAYED   Esse bit será definido se o item é para ser esmaecido. Este bit é usado somente em um menu.
  
  
• ODS_SELECTED   Esse bit será definido se o status do item é selecionado.
  
  
• ODS_COMBOBOXEDIT   O desenho tem lugar no campo de seleção (Controlarar de edição) de uma caixa de combinação ownerdrawn.
  
  
• ODS_DEFAULT   O item é o item padrão.

hwndItem

Especifica o identificador de janela do Controlarar para caixas de combinação, caixas de listagem e botões. Especifica o identificador do menu (HMENU) que contém o item para menus.

hDC

Identifica um contexto de dispositivo. Neste contexto de dispositivo deve ser usado quando executar operações de desenho sobre o controle.

rcItem

Um Retangular no contexto de dispositivo especificado pelo membro hDC que define os limites do controle a ser desenhado. Windows automaticamente clipes nada que o proprietário desenha no contexto de dispositivo para caixas de combinação, caixas de listagem e botões, mas ele não clip itens de menu. Ao desenhar itens de menu, o proprietário deve não desenhar fora dos limites do retângulo definido pela rcItem membro.

itemData

Para uma caixa de combinação ou caixa de listagem, esse membro contém o valor que foi passado para a caixa de listagem por um destes procedimentos:

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

  Para um menu, esse membro contém o valor que foi passado para o menu por um dos seguintes:

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

Co&nsulte tambémnbsp;CWnd:: OnDrawItem