Manipulando notificações da dica 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 que descreve um botão da barra de ferramentas. A dica de ferramenta fica oculta, aparecendo somente quando o usuário coloca o cursor em um botão de barra de ferramentas e o deixa lá por aproximadamente meio segundo. A dica de ferramenta é exibida perto do cursor.
Antes que a dica de ferramenta seja exibida, a mensagem de notificação TTN_NEEDTEXT é enviada à janela do proprietário da barra de ferramentas para recuperar o texto descritivo do botão. Se a janela do proprietário da barra de ferramentas for uma janela CFrameWnd, as dicas de ferramentas serão exibidas sem nenhum esforço extra, pois CFrameWnd tem um manipulador padrão para a notificação TTN_NEEDTEXT. Se a janela de proprietário da barra de ferramentas não for derivada de CFrameWnd, como uma caixa de diálogo ou um modo de exibição de formulário, você deverá adicionar uma entrada ao mapa de mensagens da janela do proprietário e fornecer um manipulador de notificação no mapa da mensagem. A entrada no mapa de mensagens da janela do proprietário é a seguinte:
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
Comentários
memberFxn
A função membro a ser chamada quando é necessário texto para este botão.
Observe que a ID de uma dica de ferramenta é sempre 0.
Além da notificação TTN_NEEDTEXT, um controle de dica de ferramenta pode enviar as seguintes notificações para um controle da barra de ferramentas:
| Notificação | Significado |
|---|---|
| TTN_NEEDTEXTA | O controle de dica de ferramenta requer texto ASCII (somente Windows 95) |
| TTN_NEEDTEXTW | O controle de dica de ferramenta requer texto UNICODE (somente 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. Isso permite que um aplicativo implemente arrastar e soltar 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 uma função de manipulador de exemplo e mais informações sobre como habilitar dicas de ferramentas, consulte Dicas de Ferramentas.