Compartilhar via


TB_GETBUTTONINFO mensagem

Recupera informações estendidas para um botão em uma barra de ferramentas.

Parâmetros

wParam

Identificador de comando do botão.

lParam

Ponteiro para uma estrutura TBBUTTONINFO que recebe as informações do botão. Os membros cbSize e dwMask dessa estrutura devem ser preenchidos antes de enviar essa mensagem.

Valor retornado

Retorna o índice baseado em zero do botão ou -1 se ocorrer um erro.

Comentários

Quando você usa TB_ADDBUTTONS ou TB_INSERTBUTTON para colocar botões na barra de ferramentas, o texto do botão normalmente é especificado pelo índice do pool de cadeias de caracteres. TB_GETBUTTONINFO não recuperará essa cadeia de caracteres. Para usar TB_GETBUTTONINFO para recuperar o texto do botão, primeiro você deve definir a cadeia de caracteres de texto com TB_SETBUTTONINFO. Depois de definir o texto do botão com TB_SETBUTTONINFO, você não poderá mais usar o índice do pool de cadeias de caracteres.

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_GETBUTTONINFOW (Unicode) e TB_GETBUTTONINFOA (ANSI)

Confira também

Referência

TB_SETBUTTONINFO

TB_GETBUTTONTEXT