Estrutura TBBUTTONINFOA (commctrl.h)

Contém ou recebe informações de 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. Esse pode ser um ou mais dos valores a seguir.

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 for 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. 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. 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.

Comentários

Requisitos