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:

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