Partilhar via


Gestão de notificações de dicas de ferramenta

Quando você especifica o estilo TBSTYLE_TOOLTIPS , a barra de ferramentas cria e gerencia um controle de dica de ferramenta. Uma dica de ferramenta é uma pequena janela pop-up que contém uma linha de texto descrevendo um botão da barra de ferramentas. A dica de ferramenta fica oculta, aparecendo apenas quando o utilizador coloca o cursor sobre um botão da barra de ferramentas e o mantém lá por aproximadamente meio segundo. A dica de ferramenta fica perto do cursor.

Antes de a dica de ferramenta ser exibida, a mensagem de notificação TTN_NEEDTEXT é enviada para a janela proprietária da barra de ferramentas para recuperar o texto descritivo do botão. Se a janela do proprietário da barra de ferramentas for uma CFrameWnd janela, as dicas de ferramentas serão exibidas sem qualquer esforço extra, porque CFrameWnd tem um manipulador padrão para a notificação TTN_NEEDTEXT . Se a janela do proprietário da barra de ferramentas não for derivada de CFrameWnd, como uma caixa de diálogo ou modo de exibição de formulário, deve adicionar uma entrada ao mapa de mensagens da janela do proprietário e fornecer um manipulador de notificação no mapa de mensagens. A entrada no mapa de mensagens da janela do proprietário é a seguinte:

ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)

Observações

membroFxn
Uma função de membro que deve ser chamada quando o texto for necessário para este botão.

Observe que o ID de uma dica de ferramenta é sempre 0.

Além da notificação TTN_NEEDTEXT, um controlador de dica de ferramenta pode enviar as seguintes notificações para um controlador de barra de ferramentas:

Notificação Significado
TTN_NEEDTEXTA O controlo de tooltip requer texto ASCII (somente Windows 95)
TTN_NEEDTEXTW O controlo de descrição de ferramenta requer texto Unicode (apenas Windows NT)
TBN_HOTITEMCHANGE Indica que o item quente (realçado) foi alterado.
NM_RCLICK Indica que o usuário clicou com o botão direito do mouse em um botão.
TBN_DRAGOUT Indica que o usuário clicou no botão e arrastou o ponteiro para fora do botão. Ele permite que um aplicativo implemente arrastar e soltar a partir de um botão da barra de ferramentas. Ao receber essa notificação, o aplicativo iniciará a operação de arrastar e soltar.
TBN_DROPDOWN Indica que o usuário clicou em um botão que usa o estilo TBSTYLE_DROPDOWN .
TBN_GETOBJECT Indica que o usuário moveu o ponteiro sobre um botão que usa o estilo TBSTYLE_DROPPABLE .

Para obter um exemplo de função de manipulador e mais informações sobre como habilitar sugestões de ferramentas, consulte Sugestões de ferramentas.

Ver também

Usando CToolBarCtrl
Controlos