Compartilhar via


TB_GETBUTTONTEXT mensagem

Recupera o texto de exibição de um botão em uma barra de ferramentas.

Parâmetros

wParam

Identificador de comando do botão cujo texto deve ser recuperado.

lParam

Ponteiro para um buffer que recebe o texto do botão.

Valor retornado

Retorna o comprimento, em caracteres, da cadeia de caracteres apontada por lParam. O comprimento não inclui o caractere nulo de terminação. Se não tiver êxito, o valor retornado será -1.

Comentários

Aviso de segurança: Usar essa mensagem incorretamente pode comprometer a segurança do seu programa. Essa mensagem não fornece uma maneira de saber o tamanho do buffer. Se você usar essa mensagem, primeiro chame a mensagem passando NULL no lParam, isso retornará o número de caracteres, excluindo NULL necessários. Em seguida, chame a mensagem uma segunda vez para recuperar a cadeia de caracteres. Você deve examinar as Considerações de Segurança: Controles do Microsoft Windows antes de continuar.

A cadeia de caracteres retornada corresponde ao texto exibido no momento pelo botão.

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
Nomes Unicode e ANSI
TB_GETBUTTONTEXTW (Unicode) e ANSI (TB_GETBUTTONTEXTA )

Confira também

Referência

TB_GETBUTTONINFO

TB_GETSTRING

TB_SETBUTTONINFO