Manipulando o controle da dica de ferramenta

A classe CToolTipCtrl fornece um grupo de funções membro que controlam os diversos atributos do objeto CToolTipCtrl e da janela de dica de ferramenta.

As durações inicial, de pop-up e de reaparecimento das janelas de dica de ferramenta podem ser definidas e recuperadas com chamadas para GetDelayTime e SetDelayTime.

Altere a aparência das janelas de dica de ferramenta com as seguintes funções:

• GetMargin e SetMargin Recupera e define a largura entre a borda da dica de ferramenta e o texto da dica de ferramenta.

• GetMaxTipWidth e SetMaxTipWidth Recupera e define a largura máxima da janela de dica de ferramenta.

• GetTipBkColor e SetTipBkColor Recupera e define a cor da tela de fundo da janela de dica de ferramenta.

• GetTipTextColor e SetTipTextColor Recupera e define a cor do texto da janela de dica de ferramenta.

Para que o controle de dica de ferramenta seja notificado de mensagens importantes, como mensagens WM_LBUTTONXXX, retransmita as mensagens para o controle de dica de ferramenta. O melhor método para essa retransmissão é fazer uma chamada para CToolTipCtrl::RelayEvent, na função PreTranslateMessage da janela proprietário. O seguinte exemplo ilustra um método possível (supondo que o controle de dica de ferramenta seja chamado m_ToolTip):

BOOL CMyDialog::PreTranslateMessage(MSG* pMsg)
{
   if (pMsg->message == WM_LBUTTONDOWN ||
      pMsg->message == WM_LBUTTONUP ||
      pMsg->message == WM_MOUSEMOVE)
   {
      m_ToolTipCtrl.RelayEvent(pMsg);
   }

   return CDialog::PreTranslateMessage(pMsg);
}

Para remover imediatamente uma janela de dica de ferramenta, chame a função membro Pop.

Confira também

Usando CToolTipCtrl
Controles