Classe di CMFCToolTipCtrl

Articolo
03/26/2013

Un'implementazione completa di descrizione comando basata su Classe di CToolTipCtrl.Una descrizione comando basata sulla classe CMFCToolTipCtrl può visualizzare un'icona, un'etichetta e una descrizione.È possibile personalizzare l'aspetto visivo utilizzando un riempimento sfumato, un testo personalizzato e i colori bordi, un testo in grassetto, gli angoli arrotondati, o uno stile di suggerimento.

class CMFCToolTipCtrl : public CToolTipCtrl

Membri

Costruttori pubblici

Nome	Descrizione
CMFCToolTipCtrl::CMFCToolTipCtrl	Costruttore predefinito.

Metodi pubblici

Nome	Descrizione
CMFCToolTipCtrl::GetIconSize	Restituisce le dimensioni di un'icona in una descrizione comando.
CMFCToolTipCtrl::GetParams	Restituisce le impostazioni di visualizzazione di una descrizione comandi.
CMFCToolTipCtrl::OnDrawBorder	Estrae il bordo di una descrizione comandi.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Visualizza un'icona in una descrizione comando.
CMFCToolTipCtrl::OnDrawLabel	Disegna l'etichetta della descrizione comando, o calcola la dimensione dell'etichetta.
CMFCToolTipCtrl::OnDrawSeparator	Estrae il separatore tra l'etichetta e la descrizione in una descrizione comando.
CMFCToolTipCtrl::OnFillBackground	Riempie lo sfondo di descrizione comandi.
CMFCToolTipCtrl::SetDescription	Imposta la descrizione che verrà visualizzata la descrizione comando.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Specifica l'aspetto di una descrizione comandi utilizzando un oggetto CMFCToolTipInfo.

Note

Utilizzare insieme CMFCToolTipCtrl, CMFCToolTipInfoe gli oggetti Classe di CTooltipManager per implementare descrizioni comandi personalizzate nell'applicazione.

Ad esempio, per utilizzare le descrizioni comandi di tipo fumetto, seguire questi passaggi:

1.Utilizzare il metodo Classe di CWinAppEx per inizializzare l'amministratore di descrizione comandi nell'applicazione.

2.Creare una struttura CMFCToolTipInfo per specificare lo stile di visualizzazione desiderata:

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.Utilizzare il metodo CTooltipManager::SetTooltipParams per impostare lo stile di visualizzazione delle descrizioni comandi nell'applicazione utilizzando gli stili definiti nell'oggetto CMFCToolTipInfo :

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

È inoltre possibile derivare una nuova classe da CMFCToolTipCtrl per controllare il comportamento e il rendering di descrizione comandi.Per specificare una nuova classe del controllo tooltip, utilizzare il metodo CTooltipManager::SetTooltipParams :

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

Per ripristinare la classe predefinita del controllo tooltip e reimpostare l'aspetto di descrizione comandi allo stato predefinito, specificare NULL nei parametri di informazioni di descrizione comandi e della classe di runtime SetTooltipParams:

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

Esempio

Nell'esempio seguente viene illustrato come costruire un oggetto CMFCToolTipCtrl, imposta la descrizione della descrizione comandi visualizzare e impostare la larghezza del controllo 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);