Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.