DRAWITEMSTRUCT

9/9/2008

Essa estrutura fornece informações que o janela proprietária deve ter para determinar como controle tinta um Owner-drawn ou item de menu.

Syntax

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

Os membros

• CtlType
  Inteiro sem sinal que especifica o tipo controle. Ele pode ser uma do seguinte valores.

  Valor	Descrição
  ODT_BUTTON	Botão Owner-drawn
  ODT_LISTVIEW	Proprietário-controle exibição de lista desenhar
  ODT_MENU	Owner-drawn menu
  ODT_TAB	Controle guia

• CtlID
  Inteiro sem sinal que especifica o identificador da caixa de combinação, caixa lista ou botão. Este membro não é usado para um menu.

• itemID
  Inteiro sem sinal que especifica o identificador item menu para uma item de menu ou o índice do item em uma caixa lista ou caixa de combinação. Para um vazio caixa lista ou caixa de combinação, esse membro pode ser – 1. Este valor permite que o aplicativo para desenhar apenas a retângulo de foco nas coordenadas especificadas pelo rcItem membro, mesmo que o controle não contém nenhum item. Esta retângulo de foco indica para o usuário se a caixa de listagem ou caixa de combinação tem o foco. O valor da itemAction membro determina se o retângulo é para ser desenhadas à medida que a caixa de listagem ou caixa de combinação tenha o foco.

• itemAction
  Inteiro sem sinal que especifica o ação exigido de desenho. Esse membro pode ter um ou mais do seguinte valores.

  Valor	Descrição
  ODA_DRAWENTIRE	O controle inteira precisa ser desenhado.
  ODA_FOCUS	O controle tiver perdido ou obtido de foco do teclado. Você deve verificar o itemState membro para determinar se o controle tem o foco.
  ODA_SELECT	O status seleção foi alterada. Você deve verificar o itemState membro para determinar o estado nova seleção.

• itemState
  Inteiro sem sinal que especifica o estado visual do item após a atual desenho ação leva local. Ele pode ser uma combinação do seguinte valores.

  Valor	Descrição
  ODS_CHECKED	O item de menu deve ser verificada. Use este valor somente em um menu.
  ODS_COMBOBOXEDIT	O desenho leva local na controle de edição de um caixa de combinação Owner-drawn.
  ODS_DEFAULT	O item é o usar como padrão item.
  ODS_DISABLED	O item é para ser desenhadas como Desativado.
  ODS_FOCUS	O item tem o foco do teclado.
  ODS_GRAYED	O item é para ser acinzentado. Use este valor somente em um menu.
  ODS_SELECTED	O status do item de menu é selecionada.

• hwndItem
  Identificador para o controle para caixas de combinação, lista caixas, botões e controles estáticos. Para menus, esse membro é um identificador para o menu que contém o item.

• hDC
  Identificador para um contexto dispositivo. Você deve usar esse contexto dispositivo ao executar operações de desenho sobre o controle.

• rcItem
  RECT estrutura que especifica um retângulo que define os limites do controle a ser desenhado. Esse retângulo está no contexto de dispositivo que você especificou com o hDC membro. O OS automaticamente clipes nada que o janela proprietária desenha no contexto de dispositivo para caixas de combinação, lista caixas e botões, mas não itens menu juntar não. Ao desenhar itens menu, o janela proprietária deve não desenhar fora dos limites do retângulo definido pela rcItem membro.

• itemData
  Ponteiro para uma sem assinatura Long que especifica os 32 definido pelo aplicativo-valor bit associado com a item de menu. Para um controle, esse membro especifica o valor Última atribuída à caixa lista ou caixa de combinação pela LB_SETITEMDATA Ou CB_SETITEMDATA mensagem. Se a caixa lista ou caixa de combinação possui o estilo LB_HASSTRINGS ou CB_HASSTRINGS, esse valor é inicialmente zero. Caso contrário, esse valor é inicialmente o valor passado para a caixa lista ou caixa de combinação in a lParam parâmetro de Uma da seguinte mensagens:

  • CB_ADDSTRING
  • CB_INSERTSTRING
  • LB_ADDSTRING
  • LB_INSERTSTRING

  Se CtlTypeé ODT_BUTTON, itemData é zero.

Remarks

O janela proprietária do controle Owner-drawn ou item de menu recebe um ponteiro para essa estrutura como o lParam parâmetro da WM_DRAWITEM mensagem.

Requirements

Header	windows.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Combo Boxes Structures
CB_ADDSTRING
CB_INSERTSTRING
CB_SETITEMDATA
LB_ADDSTRING
LB_INSERTSTRING
LB_SETITEMDATA
WM_DRAWITEM