Estrutura TBBUTTON (commctrl.h)

Contém informações sobre um botão em uma barra de ferramentas.

Sintaxe

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

Membros

iBitmap

Tipo: int

Índice baseado em zero da 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á espaço para um bitmap, apenas texto.

Se o botão for um separador, ou seja, se fsStyle estiver definido como BTNS_SEP, iBitmap determinará a largura do separador, em pixels. Para obter informações sobre como selecionar imagens de botão em listas de imagens, consulte TB_SETIMAGELIST mensagem.

idCommand

Tipo: int

Identificador do comando associado ao botão. Esse identificador é usado em uma mensagem WM_COMMAND quando o botão é escolhido.

fsState

Tipo: BYTE

Sinalizadores de estado do botão. Esse membro pode ser uma combinação dos valores listados nos Estados de Botão da Barra de Ferramentas.

fsStyle

Tipo: BYTE

Estilo do botão. Esse membro pode ser uma combinação dos valores de estilo de botão listados em Controle da Barra de Ferramentas e Estilos de Botão.

bReserved[6]

Tipo: BYTE

Reservado.

bReserved[2]

Tipo: BYTE

Reservado.

dwData

Tipo: DWORD_PTR

Valor definido pelo aplicativo.

iString

Tipo: INT_PTR

Índice baseado em zero da cadeia de caracteres do botão ou um ponteiro para um buffer de cadeia de caracteres que contém texto para o botão.

Comentários

O membro iString pode retornar um ponteiro de cadeia de caracteres ou um índice. Você pode usar a macro IS_INTRESOURCE para determinar qual é retornado.

Requisitos

Requisito	Valor
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