Classe CMFCToolTipCtrl

Artigo
08/25/2010

Uma implementação de dica de ferramenta estendida com base na Classe CToolTipCtrl. Uma dica de ferramenta com base na CMFCToolTipCtrl classe pode exibir um ícone, um rótulo e uma descrição. Você pode personalizar sua aparência visual, usando um preenchimento gradiente, texto personalizado e cores de borda, texto em negrito, cantos arredondados ou um estilo de balão.

class CMFCToolTipCtrl : public CToolTipCtrl

Membros

Construtores públicos

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

Métodos públicos

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

Comentários

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

Por exemplo, para usar dicas de ferramentas de estilo de balão, execute estas etapas:

1.Use o Classe CWinAppEx método para inicializar o Gerenciador de dica de ferramenta em seu aplicativo.

2.Criar um CMFCToolTipInfo estrutura para especificar o estilo visual desejado:

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 CTooltipManager::SetTooltipParams método para conjunto o estilo visual para todas as dicas de ferramentas no aplicativo usando os estilos definidos na CMFCToolTipInfo objeto:

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

Também é possível derivar uma nova classe de CMFCToolTipCtrl para controlar o comportamento de dica de ferramenta e o renderização. Para especificar uma nova classe de controle de dica de ferramenta, use o CTooltipManager::SetTooltipParams método:

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

restauração a classe de controle de dica de ferramenta padrão e reiniciar a aparência de dica de ferramenta para seu estado padrão, especifique nulo no tempo de execução classe e dica de ferramenta informações sobre parâmetros de SetTooltipParams:

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

Exemplo

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

   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);