Classe CMFCToolTipCtrl

Artigo
06/10/2015

Uma implementação estendido de tooltip com base em Classe CToolTipCtrl. Uma dica de ferramenta com base na classe de CMFCToolTipCtrl pode exibir um ícone, um rótulo, e descrição. Você pode personalizar sua aparência visual usando um preenchimento gradual, as cores de texto personalizados e da borda, um texto em negrito, os cantos arredondados, ou um estilo do balão.

class CMFCToolTipCtrl : public CToolTipCtrl

Membros

Construtores public

Nome	Descrição
CMFCToolTipCtrl::CMFCToolTipCtrl	Construtor padrão.

Métodos públicos

Nome	Descrição
CMFCToolTipCtrl::GetIconSize	Retorna o tamanho de um ícone em uma dica de ferramenta.
CMFCToolTipCtrl::GetParams	Retorna as configurações de exibição de um tooltip.
CMFCToolTipCtrl::OnDrawBorder	Desenhar a borda de um tooltip.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Exibe um ícone em uma dica de ferramenta.
CMFCToolTipCtrl::OnDrawLabel	Desenha o rótulo de um tooltip, ou calcula o tamanho do rótulo.
CMFCToolTipCtrl::OnDrawSeparator	Desenha o separador entre o rótulo e uma descrição em uma dica de ferramenta.
CMFCToolTipCtrl::OnFillBackground	Preenche o plano de fundo de tooltip.
CMFCToolTipCtrl::SetDescription	Define a descrição a ser exibida pelo tooltip.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Especifica a aparência visual de um tooltip usando um objeto de CMFCToolTipInfo .

Comentários

Use CMFCToolTipCtrl, CMFCToolTipInfo, e objetos de Classe CTooltipManager juntos para implementar dicas de ferramentas personalizadas em seu aplicativo.

Por exemplo, para usar dicas de balão- estilo, siga estas etapas:

1. Use o método de Classe CWinAppEx para inicializar o gerenciador de tooltip em seu aplicativo.

2. Criar uma estrutura de CMFCToolTipInfo para especificar o estilo visual que você deseja:

CMFCToolTipInfo params;
 params.m_bBoldLabel = FALSE;
 params.m_bDrawDescription = FALSE;
 params.m_bDrawIcon = FALSE;
 params.m_bRoundedCorners = TRUE;
 params.m_bDrawSeparator = FALSE;
 if (m_bCustomColors)
 {
  params.m_clrFill = RGB (255, 255, 255);
  params.m_clrFillGradient = RGB (228, 228, 240);
  params.m_clrText = RGB (61, 83, 80);
  params.m_clrBorder = RGB (144, 149, 168);
 }

3. Use o método de CTooltipManager::SetTooltipParams para definir o estilo visual para todos as dicas para o aplicativo usando estilos definidos no objeto de CMFCToolTipInfo :

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMFCToolTipCtrl), &params);

Você também pode derivar uma nova classe de CMFCToolTipCtrl para controlar o comportamento e a renderização de tooltip. Para especificar um novo controle tooltip a classe, use o método de CTooltipManager::SetTooltipParams :

myApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    RUNTIME_CLASS (CMyToolTipCtrl))

Para restaurar o padrão de controle tooltip a classe e redefina a aparência de tooltip para seu estado padrão, especifica NULL nos parâmetros da classe de tempo de execução e informações de tooltip de SetTooltipParams:

theApp.GetTooltipManager ()->SetTooltipParams (AFX_TOOLTIP_TYPE_ALL,
    NULL, NULL);

Exemplo

O exemplo a seguir demonstra como criar um objeto de CMFCToolTipCtrl , defina a descrição que a dica de ferramenta exibe, e defina a largura do controle de tooltip.

 CMFCToolTipInfo* params = new CMFCToolTipInfo();
    
    params->m_bBoldLabel = FALSE;
    params->m_bDrawDescription = FALSE;
    params->m_bDrawIcon = FALSE;
    params->m_bRoundedCorners = TRUE;
    params->m_bDrawSeparator = FALSE;
    params->m_clrFill = RGB (255, 255, 255);
    params->m_clrFillGradient = RGB (228, 228, 240);
    params->m_clrText = RGB (61, 83, 80);
    params->m_clrBorder = RGB (144, 149, 168);

    CMFCToolTipCtrl* tipCtrl = new CMFCToolTipCtrl(params);
    tipCtrl->SetDescription(_T("tool tip control"));
    tipCtrl->SetFixedWidth(100,150);