Estrutura TBBUTTONINFOA (commctrl.h)

Contém ou recebe informações para um botão específico em uma barra de ferramentas.

Sintaxe

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

Membros

cbSize

Tipo: UINT

Tamanho da estrutura, em bytes. Esse membro deve ser preenchido antes de enviar a mensagem associada.

dwMask

Tipo: DWORD

Conjunto de sinalizadores que indicam quais membros contêm informações válidas. Esse membro deve ser preenchido antes de enviar a mensagem associada. Isso pode ser um ou mais dos valores a seguir.

Valor	Significado
TBIF_BYINDEX	Versão 5.80. O wParam enviado com uma mensagem TB_GETBUTTONINFO ou TB_SETBUTTONINFO é um índice, não um identificador.
TBIF_COMMAND	O membro idCommand contém informações válidas ou está sendo solicitado.
TBIF_IMAGE	O membro do iImage contém informações válidas ou está sendo solicitado.
TBIF_LPARAM	O membro lParam contém informações válidas ou está sendo solicitado.
TBIF_SIZE	O membro cx contém informações válidas ou está sendo solicitado.
TBIF_STATE	O membro fsState contém informações válidas ou está sendo solicitado.
TBIF_STYLE	O membro fsStyle contém informações válidas ou está sendo solicitado.
TBIF_TEXT	O membro pszText contém informações válidas ou está sendo solicitado.

idCommand

Tipo: int

Identificador de comando do botão.

iImage

Tipo: int

Índice de imagem do botão. Defina esse membro como I_IMAGECALLBACK e a barra de ferramentas enviará o código de notificação TBN_GETDISPINFO para recuperar o índice de imagem quando necessário.

versão 5.81. Defina esse membro como I_IMAGENONE para indicar que o botão não tem uma imagem. O layout do botão não incluirá nenhum espaço para um bitmap, somente texto.

fsState

Tipo: BYTE

Sinalizadores de estado do botão. Esse pode ser um ou mais dos valores listados em estados de botão da barra de ferramentas.

fsStyle

Tipo: BYTE

Sinalizadores de estilo do botão. Esse pode ser um ou mais dos valores listados em controle da barra de ferramentas e estilos de botão.

cx

Tipo: WORD

Largura do botão, em pixels.

lParam

Tipo: DWORD_PTR

Valor definido pelo aplicativo associado ao botão.

pszText

Tipo: LPTSTR

Endereço de um buffer de caracteres que contém ou recebe o texto do botão.

cchText

Tipo: int

Tamanho do buffer em pszText. Se as informações do botão estiverem sendo definidas, esse membro será ignorado.

Observações

Nota

O cabeçalho commctrl.h define TBBUTTONINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h