Estrutura TBBUTTONINFOW (commctrl.h)

  • Artigo

Contém ou recebem 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;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

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.

Valor Significado
TBIF_BYINDEX

Versão 5.80. O wParam enviado com uma mensagem de 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 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 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.

fsState

Tipo: BYTE

Sinalizadores de estado do botão. Esse pode ser um ou mais dos valores listados nos 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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