Estrutura MEASUREITEMSTRUCT (winuser.h)

Artigo
08/28/2023

Informa o sistema das dimensões de um controle ou item de menu desenhado pelo proprietário. Isso permite que o sistema processe a interação do usuário com o controle corretamente.

Sintaxe

typedef struct tagMEASUREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemWidth;
  UINT      itemHeight;
  ULONG_PTR itemData;
} MEASUREITEMSTRUCT, *PMEASUREITEMSTRUCT, *LPMEASUREITEMSTRUCT;

Membros

CtlType

Tipo: UINT

O tipo de controle. Esse membro pode ser um dos valores mostrados na tabela a seguir.

Valor	Significado
ODT_COMBOBOX	Caixa de combinação desenhada pelo proprietário
ODT_LISTBOX	Caixa de listagem desenhada pelo proprietário
ODT_LISTVIEW	Controle de exibição de lista de desenho do proprietário
ODT_MENU	Menu desenhado pelo proprietário

CtlID

Tipo: UINT

O identificador da caixa de combinação ou caixa de listagem. Esse membro não é usado para um menu.

itemID

Tipo: UINT

O identificador de um item de menu ou a posição de uma caixa de listagem ou item de caixa de combinação. Esse valor será especificado para uma caixa de listagem somente se ele tiver o estilo LBS_OWNERDRAWVARIABLE ; esse valor será especificado para uma caixa de combinação somente se ele tiver o estilo CBS_OWNERDRAWVARIABLE .

itemWidth

Tipo: UINT

A largura, em pixels, de um item de menu. Antes de retornar da mensagem, o proprietário do item de menu desenhado pelo proprietário deve preencher esse membro.

itemHeight

Tipo: UINT

A altura, em pixels, de um item individual em uma caixa de listagem ou um menu. Antes de retornar da mensagem, o proprietário da caixa de combinação, caixa de listagem ou item de menu desenhado pelo proprietário deve preencher esse membro.

itemData

Tipo: ULONG_PTR

O valor definido pelo aplicativo associado ao item de menu. Para um controle, esse membro especifica o valor atribuído pela última vez à caixa de listagem ou caixa de combinação pela mensagem LB_SETITEMDATA ou CB_SETITEMDATA . Se a caixa de listagem ou a caixa de combinação tiver o estilo LB_HASSTRINGS ou CB_HASSTRINGS, esse valor será inicialmente zero. Caso contrário, esse valor é inicialmente o valor passado para a caixa de listagem ou caixa de combinação no parâmetro lParam de uma das seguintes mensagens:

Comentários

A janela de proprietário de um controle desenhado pelo proprietário recebe um ponteiro para a estrutura MEASUREITEMSTRUCT como o parâmetro lParam de uma mensagem de WM_MEASUREITEM . O controle desenhado pelo proprietário envia essa mensagem para sua janela de proprietário quando o controle é criado. Em seguida, o proprietário preenche os membros apropriados na estrutura para o controle e retorna. Essa estrutura é comum a todos os controles desenhados pelo proprietário, exceto o controle de botão desenhado pelo proprietário cujo tamanho é predeterminado por sua janela.

Se um aplicativo não preencher os membros apropriados de MEASUREITEMSTRUCT, o controle ou item de menu poderá não ser desenhado corretamente.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winuser.h (inclua Windows.h)