Estrutura TBMETRICS (commctrl.h)

Define as métricas de uma barra de ferramentas que são usadas para reduzir ou expandir itens da barra de ferramentas.

Sintaxe

typedef struct {
  UINT  cbSize;
  DWORD dwMask;
  int   cxPad;
  int   cyPad;
  int   cxBarPad;
  int   cyBarPad;
  int   cxButtonSpacing;
  int   cyButtonSpacing;
} TBMETRICS, *LPTBMETRICS;

Membros

cbSize

Tipo: UINT

Tamanho da estrutura TBMETRICS .

dwMask

Tipo: DWORD

Máscara que determina a métrica a ser recuperada. Pode ser qualquer combinação do seguinte:

Valor	Significado
TBMF_PAD	Recupere os valores cxPad e cyPad .
TBMF_BARPAD	Recupere os valores cxBarPad e cyBarPad .
TBMF_BUTTONSPACING	Recupere os valores cxButtonSpacing e cyButtonSpacing .

cxPad

Tipo: int

Largura do preenchimento dentro dos botões da barra de ferramentas, entre o conteúdo e a borda do botão.

cyPad

Tipo: int

Altura do preenchimento dentro dos botões da barra de ferramentas, entre o conteúdo e a borda do botão.

cxBarPad

Tipo: int

Largura da barra de ferramentas. Não usado.

cyBarPad

Tipo: int

Altura da barra de ferramentas. Não usado.

cxButtonSpacing

Tipo: int

Largura do espaço entre botões da barra de ferramentas.

cyButtonSpacing

Tipo: int

Altura do espaço entre botões da barra de ferramentas.

Comentários

As métricas especificadas pela estrutura TBMETRICS são usadas para dimensionar os botões não animados em uma barra de ferramentas. O botão pode reduzir ou expandir para que todos os itens visíveis se ajustem na janela.

Os valores de preenchimento são usados para criar uma área em branco entre a borda do botão e a imagem e/ou texto do botão. Onde e quanto preenchimento é realmente aplicado depende do tipo do botão e se ele tem uma imagem. O preenchimento horizontal é aplicado à direita e à esquerda do botão e o preenchimento vertical é aplicado à parte superior e inferior do botão. O preenchimento só é aplicado a botões que têm o estilo TBSTYLE_AUTOSIZE .

Embora os valores para cxBarPad e cyBarPad possam ser definidos e recuperados, eles atualmente não têm efeito e não são usados.

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	commctrl.h