Partilhar via

Classe CTooltipManager

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Mantém informação em tempo de execução sobre as dicas de ferramenta. A CTooltipManager aula é instanciada uma vez por aplicação.

Sintaxe

class CTooltipManager : public CObject

Membros

Métodos Públicos

Nome Description
CTooltipManager::CreateToolTip Cria um controlo de dica de ferramenta para o(s) tipo(s) de controlo especificado(s) do Windows.
CTooltipManager::D eleteToolTip Elimina um controlo de tooltip.
CTooltipManager::SetTooltipParams Personaliza a aparência visual do controlo tooltip para o(s) tipo(s) de controlo do Windows especificado.
CTooltipManager::SetTooltipText Define o texto e a descrição para um controlo tooltip.
CTooltipManager::UpdateTooltips

Observações

Use CMFCToolTipCtrl Class, CMFCToolTipInfo, e CTooltipManager em conjunto para implementar tooltips personalizadas na sua aplicação. Para um exemplo de como usar estas classes tooltip, veja o tópico CMFCToolTipCtrl Class .

Hierarquia de herança

CObject

CTooltipManager

Requerimentos

Cabeçalho: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Cria um controlo tooltip.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

Parâmetros

pToolTip
[fora] Uma referência a um ponteiro tooltip. Está configurado para apontar para a tooltip recém-criada quando a função regressa.

pWndParent
[dentro] Pai da dica de ferramenta.

nType
[dentro] Tipo de dica de ferramenta.

Valor de retorno

Diferente de zero se uma dica de ferramenta tiver sido criada com sucesso.

Observações

Deve ligar para CTooltipManager::D eleteToolTip para eliminar o controlo de tooltip que é devolto em pToolTip.

O CTooltipManager define os parâmetros visuais de visualização de cada tooltip que cria com base no tipo de tooltip que o nType especifica. Para alterar os parâmetros de um ou mais tipos de tooltips, ligue para CTooltipManager::SetTooltipParams.

Os tipos de tooltip válidos estão listados na tabela seguinte:

Tipo de dica de ferramenta Categoria de controlo Exemplos de tipos
AFX_TOOLTIP_TYPE_BUTTON Um botão. CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR Uma barra de legendas. CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT Qualquer controlo que não se enquadre noutra categoria. Nenhum.
AFX_TOOLTIP_TYPE_DOCKBAR Um vidro acoplável. CDockablePane
AFX_TOOLTIP_TYPE_EDIT Uma caixa de texto. Nenhum.
AFX_TOOLTIP_TYPE_MINIFRAME Um miniframe. CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER Um planeador. Nenhum.
AFX_TOOLTIP_TYPE_RIBBON Uma barra de fitas. CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB Um controlo de separador. CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR Uma barra de ferramentas. CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX Uma caixa de ferramentas. Nenhum.

CTooltipManager::D eleteToolTip

Elimina um controlo de tooltip.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parâmetros

pToolTip
[inspira, expira] Uma referência a um ponteiro para uma dica de ferramenta a destruir.

Observações

Chame este método para cada Classe CToolTipCtrl criada por CTooltipManager::CreateToolTip. O controlo pai deve chamar este método a partir do seu OnDestroy handler. Isto é necessário para remover corretamente a tooltip do framework. Este método define o pToolTip para NULL antes de regressar.

CTooltipManager::SetTooltipParams

Personaliza a aparência do controlo tooltip para os tipos de controlo Windows especificados.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

Parâmetros

nTipos
[dentro] Especifica os tipos de controlo.

pRTC
[dentro] Classe de execução da dica de ferramenta personalizada.

pParams
[dentro] Parâmetros de tooltip.

Observações

Este método define a classe de execução e os parâmetros iniciais que o CToolTipManager utiliza ao criar tooltips. Quando um controlo chama CTooltipManager::CreateToolTip e passa um tipo de tooltip que é um dos tipos indicados por nTypes, o gestor de tooltips cria um controlo de tooltip que é uma instância da classe de runtime especificada pelo pRTC e passa os parâmetros especificados pelos pParams para a nova tooltip.

Ao chamar este método, todos os proprietários existentes de tooltips recebem a mensagem AFX_WM_UPDATETOOLTIPS e têm de recriar as suas dicas usando CTooltipManager::CreateToolTip.

Os nTypes podem ser qualquer combinação dos tipos de tooltip válidos que o CTooltipManager::CreateToolTip utiliza, ou podem ser AFX_TOOLTIP_TYPE_ALL. Se passares AFX_TOOLTIP_TYPE_ALL, todos os tipos de tooltips são afetados.

Example

O exemplo seguinte demonstra como usar o SetTooltipParams método da CTooltipManager classe. Este excerto de código faz parte do exemplo Draw Client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Define o texto e a descrição para uma dica de ferramenta.

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

Parâmetros

pTI
[dentro] Um apontador para um objeto TOOLINFO.

pToolTip
[inspira, expira] Um ponteiro para o controlo tooltip para definir o texto e a descrição.

nType
[dentro] Especifica o tipo de controlo com que esta tooltip está associada.

strText
[dentro] O texto para definir como texto da dica de ferramenta.

lpszDescr
[dentro] Um apontador para a descrição da dica de ferramenta. Pode ser NULL.

Observações

O valor de nType deve ser o mesmo valor do parâmetro nType do CTooltipManager::CreateToolTip quando criaste a tooltip.

CTooltipManager::UpdateTooltips

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

void UpdateTooltips();

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCToolTipCtrl
Classe CMFCToolTipInfo

  • Last updated on