Classe CMFCToolTipCtrl

Uma implementação extensa baseada na Classe CToolTipCtrl. Uma dica baseada na CMFCToolTipCtrl classe pode mostrar um ícone, um rótulo e uma descrição. Pode personalizar a sua aparência visual usando um preenchimento em gradiente, texto personalizado e cores das bordas, texto a negrito, cantos arredondados ou um estilo de balão.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCToolTipCtrl : public CToolTipCtrl

Membros

Construtores Públicos

Métodos Públicos

Observações

Use CMFCToolTipCtrl, CMFCToolTipInfo, e os objetos CTooltipManager Class juntos para implementar tooltips personalizados na sua aplicação.

Por exemplo, para usar dicas ao estilo balão, siga estes passos:

1. Use o método CWinAppEx Class para inicializar o gestor de tooltip na sua aplicação.

2. Crie uma CMFCToolTipInfo estrutura para especificar o estilo visual que pretende:

   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 CTooltipManager::SetTooltipParams para definir o estilo visual de todas as tooltips na aplicação, utilizando os estilos definidos no CMFCToolTipInfo objeto:

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

Também podes derivar uma nova classe a partir de CMFCToolTipCtrl para controlar o comportamento da tooltip e a renderização. Para especificar uma nova classe de controlo de tooltip, use o CTooltipManager::SetTooltipParams método:

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

Para restaurar a classe de controlo predefinida da tooltip e redefinir a aparência da tooltip para o seu estado predefinido, especifique NULL nos parâmetros da classe de runtime e da informação da tooltip de SetTooltipParams:

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

Example

O exemplo seguinte demonstra como construir um CMFCToolTipCtrl objeto, definir a descrição que a dica de ferramenta apresenta e definir a largura do controlo da 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);

Hierarquia de herança

CObject

CCmdTarget

CWnd

CToolTipCtrl

CMFCToolTipCtrl

Requerimentos

Cabeçalho: afxtooltipctrl.h

CMFCToolTipCtrl::CMFCToolTipCtrl

CMFCToolTipCtrl(CMFCToolTipInfo* pParams = NULL);

Parâmetros

[dentro] pParams

Observações

CMFCToolTipCtrl::GetIconSize

Devolve o tamanho de um ícone numa dica de ferramenta.

virtual CSize GetIconSize();

Valor de retorno

O tamanho do ícone, em pixels.

CMFCToolTipCtrl::GetParams

Devolve as definições de ecrã de uma dica de ferramenta.

const CMFCToolTipInfo& GetParams() const;

Valor de retorno

As definições atuais de apresentação da tooltip, que são armazenadas num objeto de classe CMFCToolTipInfo .

CMFCToolTipCtrl::OnDrawBorder

Desenha a borda de uma dica de ferramenta.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rect,
    COLORREF clrLine);

Parâmetros

pDC
[dentro] Apontador para o contexto de um dispositivo.

retângulo
[dentro] O retângulo delimitador da dica de ferramenta.

clrLine
[dentro] Cor da borda.

Observações

Substitua este método numa classe derivada para personalizar a aparência da borda da tooltip.

CMFCToolTipCtrl::OnDrawDescription

virtual CSize OnDrawDescription(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parâmetros

[dentro] pDC
[dentro] Rect
[dentro] bCalcOnly

Valor de retorno

Observações

CMFCToolTipCtrl::OnDrawIcon

Mostra um ícone numa dica de ferramenta.

virtual BOOL OnDrawIcon(
    CDC* pDC,
    CRect rectImage);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectImage
[dentro] Coordenadas do ícone.

Valor de retorno

VERDADEIRO se o ícone foi desenhado. Caso contrário, FALSO.

Observações

Substitua este método numa classe derivada para mostrar um ícone personalizado. Também deve sobrescrever CMFCToolTipCtrl::GetIconSize para permitir que a dica de ferramenta calcule corretamente o layout do texto e da descrição.

CMFCToolTipCtrl::OnDrawLabel

Desenha o rótulo de uma dica de ferramenta, ou calcula o tamanho do rótulo.

virtual CSize OnDrawLabel(
    CDC* pDC,
    CRect rect,
    BOOL bCalcOnly);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Retângulo delimitado da área do rótulo.

bCalcOnly
[dentro] Se for VERDADEIRO, o rótulo não será desenhado.

Valor de retorno

Tamanho da etiqueta, em pixels.

Observações

Substitua este método numa classe derivada se quiser personalizar a aparência do rótulo da tooltip.

CMFCToolTipCtrl::OnDrawSeparator

Desenha o separador entre o rótulo e a descrição numa dica de ferramenta.

virtual void OnDrawSeparator(
    CDC* pDC,
    int x1,
    int x2,
    int y);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

x1
[dentro] Coordenada horizontal da extremidade esquerda do separador.

x2
[dentro] Coordenada horizontal da extremidade direita do separador.

Y
[dentro] Coordenada vertical do separador.

Observações

A implementação padrão traça uma linha do ponto (x1, y) até ao ponto (x2, y).

Substitua este método numa classe derivada para personalizar a aparência do separador.

CMFCToolTipCtrl::OnFillContexto

Preenche o fundo da tooltip.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect,
    COLORREF& clrText,
    COLORREF& clrLine);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] Especifica o retângulo delimitador da área a preencher.

clrText
[dentro] Dica de ferramenta cor do primeiro plano.

clrLine
[dentro] Cor das bordas e a linha delimitadora entre o rótulo e a descrição.

Observações

A implementação padrão preenche o retângulo especificado por rect com a cor ou padrão especificado pela chamada mais recente para CMFCToolTipCtrl::SetParams.

Substitui este método numa classe derivada se quiseres personalizar a aparência da tooltip.

CMFCToolTipCtrl::SetDescription

Define a descrição para ser exibida pela dica de ferramenta.

virtual void SetDescription(const CString strDesrciption);

Parâmetros

strDesrciption
[dentro] Texto da descrição.

Observações

O texto da descrição é apresentado na dica de ferramenta sob o separador.

CMFCToolTipCtrl::SetFixedWidth

void SetFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parâmetros

[dentro] nLarguraRegular
[dentro] nLarguraGrandeImagem

Observações

CMFCToolTipCtrl::SetHotRibbonButton

void SetHotRibbonButton(CMFCRibbonButton* pRibbonButton);

Parâmetros

[dentro] pRibbonButton

Observações

CMFCToolTipCtrl::SetLocation

void SetLocation(CPoint pt);

Parâmetros

[dentro] pt

Observações

CMFCToolTipCtrl::SetParams

Especifica a aparência visual de uma dica de ferramenta usando um objeto CMFCToolTipInfo Class .

void SetParams(CMFCToolTipInfo* pParams);

Parâmetros

pParams
[dentro] Apontador para um objeto CMFCToolTipInfo Class que contém os parâmetros de visualização.

Observações

Sempre que a dica de ferramenta é exibida, é desenhada usando as cores e estilos visuais que o pParams especifica. O valor dos pParams é armazenado no membro m_Paramsprotegido , que pode ser acedido por uma classe derivada que sobrepõe CMFCToolTipCtrl::OnDrawBorder, CMFCToolTipCtrl::OnDrawIcon, CMFCToolTipCtrl::OnDrawLabel, CMFCToolTipCtrl::OnDrawSeparator, ou CMFCToolTipCtrl::OnFillBackground para manter a aparência especificada.

Consulte também

Gráfico de Hierarquia
Classes
Classe CToolTipCtrl
Classe CTooltipManager
Classe CMFCToolTipInfo
Classe CWinAppEx