Partilhar via


Estrutura DRAWITEMSTRUCT

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

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.sistema autônomo valores para sistema autônomo tipos de controle são:

    • ODT_BUTTON   Botão de desenho proprietário

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

    • ODT_listaBOX   Desenho proprietário lista caixa

    • ODT_MENU   Menu desenhados pelo proprietário

    • ODT_LISTVIEW   Controle de modo de exibição de lista

    • ODT_STATIC   Desenho proprietário controle estático

    • ODT_TAB   Controle guia

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

  • itemID
    A ID de item de menu para um menu ou o índice do item em um lista caixa de combinação ou caixa de listagem.Para um vazio lista caixa de combinação ou, esse membro é um valor negativo, que permite ao aplicativo desenhar o retângulo de foco nas coordenadas especificadas pelo rcItem membro mesmo que não há nenhum item no controle.O usuário, portanto, pode ser mostrado se o lista tem o foco de entrada de caixa de combinação ou caixa de listagem.A configuração dos bits no itemAction membro determina se o retângulo é a ser desenhada sistema autônomo se a caixa de listagem ou caixa de combinação possui entrada foco.

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

    • ODA_DRAWENTIRE   Este bit for conjunto quando todo o controle deve ser desenhado.

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

    • ODA_SELECT   Este bit for conjunto quando o status de seleção foi alterado.The itemState membro deve ser verificado para determinar o novo estado de seleção.

  • itemState
    Especifica o estado visual do item após ocorre a ação de desenho corrente.Ou seja, se um item de menu é estar esmaecidos, o estado do sinalizar ODS_GRAYED será conjunto.sistema autônomo sinalizadores de estado são:

    • ODS_CHECKED   Este bit for conjunto se o item de menu estiver a ser verificado.Esse bit é usado somente em um menu.

    • ODS_DISABLED   Este bit for conjunto se o item estiver a ser desenhada sistema autônomo desabilitado.

    • ODS_FOCUS   Este bit for conjunto se o item tiver foco de entrada.

    • ODS_GRAYED   Este bit for conjunto se o item estiver para ser esmaecido.Esse bit é usado somente em um menu.

    • ODS_SELECTED   Este bit for definido se status do item for selecionado.

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

    • ODS_DEFAULT   O item é o item padrão.

  • hwndItem
    Especifica o identificador da janela do controle para as caixas de combinação, lista caixas 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 a ser desenhada. Windows automaticamente clipees nada proprietário desenha no contexto de dispositivo para caixas de combinação lista caixas e botões, mas não clipe 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 foi passado para a caixa de listagem por um destes procedimentos:

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

Comentários

A janela do proprietário do controle desenhados pelo proprietário ou item de menu recebe um ponteiro para essa estrutura sistema autônomo a lParam parâmetro das 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