Estrutura DRAWITEMSTRUCT

  • Artigo

O DRAWITEMSTRUCT estrutura fornece informações sobre a janela do proprietário deve ter para determinar como Pintar um item de menu ou controle desenhado pelo proprietário.

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

Parâmetros

  • CtlType
    O tipo de controle.Os valores para tipos de controle são da seguinte maneira:

    • ODT_BUTTON botão de desenho proprietário

    • ODT_COMBOBOX caixa de combinação do desenho proprietário

    • ODT_LISTBOX caixa de listagem de desenho proprietário

    • ODT_MENU menu de desenho proprietário

    • ODT_LISTVIEW controle de exibição de lista

    • ODT_STATIC desenhado proprietário controle estático

    • ODT_TAB controle guia

  • CtlID
    A ID de controle de botão, caixa de listagem ou caixa de combinação.Este membro não é usado em um menu.

  • itemID
    A identificação do item de menu de um menu ou o índice do item em uma caixa de listagem ou caixa de combinação.Para uma caixa de lista vazia ou caixa de combinação, esse membro é um valor negativo, o que permite que o aplicativo desenhar o retângulo de foco nas coordenadas especificadas pelo rcItem membro mesmo se não existem itens no controle.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 na itemAction membro determina se o retângulo será desenhado como se a caixa de listagem ou caixa de combinação tem entrada foco.

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

    • ODA_DRAWENTIRE esse bit é definido quando todo o controle precisa ser desenhado.

    • ODA_FOCUS esse bit é definido quando o controle obtém ou perde o foco de entrada.O itemState membro deve ser verificado para determinar se o controle tem foco.

    • ODA_SELECT esse bit é definido quando o status de seleção foi alterada.O itemState membro deve ser verificado para determinar o novo estado de seleção.

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

    • ODS_CHECKED esse bit será definido se o item de menu deve ser verificada.Este bit é usado somente em um menu.

    • ODS_DISABLED esse bit será definido se o item é para ser desenhadas como desativado.

    • ODS_FOCUS esse bit será definido se o item tem foco de entrada.

    • ODS_GRAYED esse bit será definido se o item é esmaecido.Este bit é usado somente em um menu.

    • ODS_SELECTED esse bit será definido se o status do item é selecionado.

    • ODS_COMBOBOXEDIT o desenho ocorre no campo de seleção (controle de edição) de uma caixa de combinação ownerdrawn.

    • ODS_DEFAULT o item é o padrão.

  • hwndItem
    Especifica o identificador de janela do controle 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 no controle.

  • rcItem
    Um retângulo no contexto de dispositivo especificado pelo hDC membro define os limites do controle para ser desenhada.Windows automaticamente clipes nada que 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 não deve desenhar fora dos limites do retângulo definido pelo rcItem membro.

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

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

Comentários

A janela do proprietário do item de menu ou controle de desenhado proprietário recebe um ponteiro para essa estrutura como o lParam parâmetro de WM_DRAWITEM mensagem.

Requisitos

Cabeçalho: WinUser. h

Consulte também

Referência

CWnd::OnDrawItem

Outros recursos

Estruturas, estilos, retornos de chamada e mapas de mensagem