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.

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

 

Membros

CtlType

Especifica o tipo de controle. Esse membro pode ser uma dos seguinte valores:

Valor	Significado
ODT_BUTTON	Botão Owner-drawn
ODT_COMBOBOX	Caixa de combinação Owner-drawn
ODT_LISTBOX	Caixa lista Owner-drawn
ODT_LISTVIEW	Controle de exibição lista
ODT_MENU	Item de menu Owner-drawn
ODT_STATIC	Controle estático Owner-drawn
ODT_TAB	Controlarar guia

CtlID

Especifica o identificador da caixa de combinação, caixa de listagem, botão ou controle estático. Este membro não é usado para um item de menu.

itemID

Especifica o identificador do item de menu para um item de 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 pode ser – 1. Isso permite que o aplicativo desenhar somente o Retangular de foco nas coordenadas especificadas pelo rcItem membro, mesmo que não há itens no Controlarar. Isto indica ao utilizador se a caixa de listagem ou caixa de combinação tem o foco. Como os bits são definidos no membro itemAction determina se o Retangular é a serem desenhados como se a caixa de listagem ou caixa de combinação tem o foco.

itemAction

Especifica a ação desenho necessária. Esse membro pode ser um ou mais dos seguintes valores:

Valor	Significado
ODA_DRAWENTIRE	Todo o Controlarar precisa ser desenhado.
ODA_FOCUS	O Controlarar perdeu ou ganhou o foco do teclado. O membro de itemState deve ser marcado para determinar se o Controlarar tem o foco.
ODA_SELECT	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. Esse membro pode ser uma combinação dos seguintes valores:

Valor	Significado
ODS_CHECKED	O item de menu é para ser verificado. Este bit é usado somente em um menu.
ODS_COMBOBOXEDIT	O desenho tem lugar no campo de seleção (Controlarar de edição) de uma caixa de combinação owner-drawn.
ODS_DEFAULT	O item é o item padrão.
ODS_DISABLED	O item é a serem desenhados como desativado.
ODS_FOCUS	O item tem o foco do teclado.
ODS_GRAYED	O item deve ser cinza. Este bit é usado somente em um menu.
ODS_SELECTED	Status do item de menu é selecionado.

hwndItem

Identificador para o controle para caixas de combinação, caixas de listagem, botões e controles estáticos. Para menus, este membro identifica o menu que contém o item.

hDC

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

rcItem

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

itemData

Especifica o definido pelo aplicativo 32-bit valor associado com o item de menu. Para um controle, esse parâmetro especifica o valor última atribuído à caixa de listagem ou caixa de combinação pela LB_SETITEMDATA ou CB_SETITEMDATA mensagem. Se a caixa de listagem ou caixa de combinação tem o estilo LBS_HASSTRINGS ou CBS_HASSTRINGS, esse valor é inicialmente zero. Caso contrário, esse valor é inicialmente o valor que foi passado para a caixa de listagem ou caixa de combinação in a lParam parâmetro de uma das seguintes mensagens:

• CB_ADDSTRING
• CB_INSERTSTRING
• LB_ADDSTRING
• LB_INSERTSTRING

Se ctlType ODT_BUTTON ou ODT_STATIC, itemData é zero.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de combinação, estruturas de caixa de combinação, CB_ADDSTRING, CB_INSERTSTRING, CB_SETITEMDATA, LB_ADDSTRING, LB_INSERTSTRING, LB_SETITEMDATA, WM_DRAWITEM

Index