Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Quando você especifica o estilo TBSTYLE_TOOLTIPS, a barra de ferramentas cria e gerencia um controle de tooltip. Uma dica de ferramenta é uma pequena janela pop-up que contém uma linha de texto que descreve um botão de 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 proprietária da barra de ferramentas for uma janela CFrameWnd, as dicas de ferramenta serão exibidas sem esforço extra, pois CFrameWnd possui um manipulador padrão para a notificação TTN_NEEDTEXT. Se a janela proprietária da barra de ferramentas não for derivada de CFrameWnd, como uma caixa de diálogo ou uma exibição de formulário, você deverá adicionar uma entrada no mapa de mensagens da janela proprietária 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
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 tooltip requer texto ASCII (apenas 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. Ele permite que um aplicativo implemente arrastar e soltar de um botão de 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.