Manipulando notificações da dica de ferramenta
Quando você especifica o estilo de TBSTYLE_TOOLTIPS , a barra de ferramentas cria e gerencia um controle da dica de ferramenta. Uma dica de ferramenta é uma janela pop-up pequeno que contém uma linha de texto que descreve um botão da barra de ferramentas. A dica de ferramenta é ocultada, aparecendo apenas quando o usuário coloca o cursor em um botão da barra de ferramentas e em planilhas nele para aproximadamente um meio de segundo. A dica de ferramenta é exibida pelo cursor.
Antes que a dica de ferramenta é exibida, a notificação de TTN_NEEDTEXT é enviada à janela do proprietário da barra de ferramentas para recuperar o texto descritivo para o botão. Se a janela do proprietário da barra de ferramentas é uma janela de CFrameWnd , as dicas de ferramenta é exibida sem esforço adicional, porque CFrameWnd tem um manipulador padrão para a notificação de TTN_NEEDTEXT . Se a janela do proprietário da barra de ferramentas não é derivada de CFrameWnd, como uma exibição da caixa de diálogo ou do formulário, adicione uma entrada para mapa de mensagem da janela do proprietário e forneça um manipulador de notificação da mensagem. A entrada para mapa de mensagem da janela do proprietário é a seguinte:
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
Comentários
- memberFxn
A função de membro a ser chamada quando o texto é necessário para esse botão.
Observe que a ID de uma dica de ferramenta é sempre 0.
Além da notificação de TTN_NEEDTEXT , um controle da dica de ferramenta pode enviar as seguintes notificações a um controle da barra de ferramentas:
Notificação |
Significado |
|---|---|
TTN_NEEDTEXTA |
O controle da dica de ferramenta requer o texto ASCII (Windows somente 95) |
TTN_NEEDTEXTW |
O controle da dica de ferramenta requer o texto Unicode (Windows NT somente) |
TBN_HOTITEMCHANGE |
Indica que o item realçado (quente) foi alterado. |
NM_RCLICK |
Indica que o usuário clique com o botão direito do mouse em um botão. |
TBN_DRAGOUT |
Indica que o usuário clicou o botão e arrastou o ponteiro fora do botão. Permite que um aplicativo implementar o arraste e solte de um botão da barra de ferramentas. Ao receber essa notificação, o aplicativo iniciará à direita e removerá a operação. |
TBN_DROPDOWN |
Indica que o usuário clicou um botão que usa o estilo de TBSTYLE_DROPDOWN . |
TBN_GETOBJECT |
Indica que o usuário moveu o ponteiro sobre um botão que usa o estilo de TBSTYLE_DROPPABLE . |
Para uma função de manipulador de exemplo e mais informações sobre como ativar dicas de ferramenta, consulte Dicas de ferramenta.