Share via


TBN_GETBUTTONINFO código de notificação

Recupera informações de personalização da barra de ferramentas e notifica a janela pai da barra de ferramentas de quaisquer alterações que estão sendo feitas na barra de ferramentas. Esse código de notificação é enviado na forma de uma mensagem WM_NOTIFY .

TBN_GETBUTTONINFO 

    lpnmtb = (LPNMTOOLBAR) lParam; 

Parâmetros

lParam

Ponteiro para uma estrutura NMTOOLBAR . O membro iItem especifica um índice baseado em zero que fornece uma contagem dos botões que a caixa de diálogo Personalizar Barra de Ferramentas exibe como disponíveis e presentes na barra de ferramentas. O membro pszText especifica o endereço do texto do botão atual e cchText especifica seu comprimento em caracteres. O aplicativo deve preencher a estrutura com informações sobre o botão.

Valor retornado

Retornará TRUE se as informações do botão forem copiadas para a estrutura especificada ou FALSE caso contrário.

Comentários

O controle da barra de ferramentas aloca um buffer e o receptor (janela pai) deve copiar o texto para esse buffer. O membro cchText contém o comprimento do buffer alocado pela barra de ferramentas quando TBN_GETBUTTONINFO é enviado para a janela pai.

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
TBN_GETBUTTONINFOW (Unicode) e TBN_GETBUTTONINFOA (ANSI)