Classe CTooltipManager

Gestisce informazioni di runtime sulle descrizioni comandi. L'istanza della classe CTooltipManager viene avviata una volta per applicazione.

Sintassi

class CTooltipManager : public CObject

Membri

Metodi pubblici

Nome	Descrizione
CTooltipManager::CreateToolTip	Crea un controllo ToolTip per i tipi di controllo di Windows specificati.
CTooltipManager::D eleteToolTip	Elimina un controllo ToolTip.
CTooltipManager::SetTooltipParams	Personalizza l'aspetto visivo del controllo ToolTip per i tipi di controllo di Windows specificati.
CTooltipManager::SetTooltipText	Imposta il testo e la descrizione per un controllo ToolTip.
CTooltipManager::UpdateTooltips

Osservazioni:

Usare CMFCToolTipCtrl Class, CMFCToolTipInfoe CTooltipManager insieme per implementare descrizioni comando personalizzate nell'applicazione. Per un esempio di come usare queste classi di descrizioni comando, vedere l'argomento Classe CMFCToolTipCtrl.

Gerarchia di ereditarietà

CObject

CTooltipManager

Requisiti

Intestazione: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Crea un controllo descrizione comando.

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

Parametri

pToolTip
[out] Riferimento a un puntatore alla descrizione comando. È impostato in modo che punti alla descrizione comando appena creata quando la funzione viene restituita.

pWndParent
[in] Elemento padre della descrizione comando.

nType
[in] Tipo della descrizione comando.

Valore restituito

Diverso da zero se una descrizione comando è stata creata correttamente.

Osservazioni:

È necessario chiamare CTooltipManager::D eleteToolTip per eliminare il controllo descrizione comando passato di nuovo in pToolTip.

CTooltipManager imposta i parametri di visualizzazione visiva di ogni descrizione comando creata in base al tipo di descrizione comando specificato da nType. Per modificare i parametri per uno o più tipi di descrizione comando, chiamare CTooltipManager::SetTooltipParams.

I tipi di descrizione comando validi sono elencati nella tabella seguente:

Tipo di descrizione comando	Categoria di controllo	Tipi di esempio
AFX_TOOLTIP_TYPE_BUTTON	Pulsante.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Barra della didascalia.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Qualsiasi controllo che non rientra in un'altra categoria.	Nessuno.
AFX_TOOLTIP_TYPE_DOCKBAR	Riquadro ancorabile.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Casella di testo.	Nessuno.
AFX_TOOLTIP_TYPE_MINIFRAME	Miniframe.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Un pianificatore.	Nessuno.
AFX_TOOLTIP_TYPE_RIBBON	Barra multifunzione.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Controllo struttura a schede.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Barra degli strumenti.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Casella degli strumenti.	Nessuno.

CTooltipManager::D eleteToolTip

Elimina un controllo ToolTip.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parametri

pToolTip
[in, out] Riferimento a un puntatore a una descrizione comando da eliminare definitivamente.

Osservazioni:

Chiamare questo metodo per ogni classe CToolTipCtrl creata da CTooltipManager::CreateToolTipTip. Il controllo padre deve chiamare questo metodo dal relativo OnDestroy gestore. Questa operazione è necessaria per rimuovere correttamente la descrizione comando dal framework. Questo metodo imposta pToolTip su NULL prima che venga restituito.

CTooltipManager::SetTooltipParams

Personalizza l'aspetto del controllo descrizione comando per i tipi di controllo Windows specificati.

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

Parametri

nTypes
[in] Specifica i tipi di controllo.

pRTC
[in] Classe di runtime della descrizione comando personalizzata.

pParams
[in] Parametri della descrizione comando.

Osservazioni:

Questo metodo imposta la classe di runtime e i parametri iniziali usati da CToolTipManager quando crea descrizioni comando. Quando un controllo chiama CTooltipManager::CreateToolTip e passa un tipo di descrizione comando che è uno dei tipi indicati da nTypes, il gestore descrizione comando crea un controllo descrizione comando che è un'istanza della classe di runtime specificata da pRTC e passa i parametri specificati da pParams alla nuova descrizione comando.

Quando si chiama questo metodo, tutti i proprietari di descrizioni comando esistenti ricevono il messaggio di AFX_WM_UPDATETOOLTIPS e devono ricreare le descrizioni comando usando CTooltipManager::CreateToolTipTip.

nTypes può essere qualsiasi combinazione dei tipi di descrizione comando validi usati da CTooltipManager::CreateToolTipTip oppure può essere AFX_TOOLTIP_TYPE_ALL. Se si passa AFX_TOOLTIP_TYPE_ALL, tutti i tipi di descrizione comando sono interessati.

Esempio

Nell'esempio seguente viene illustrato come usare il SetTooltipParams metodo della CTooltipManager classe . Questo frammento di codice fa parte dell' esempio Draw Client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Imposta il testo e la descrizione per una descrizione comando.

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

Parametri

Pti
[in] Puntatore a un oggetto TOOLINFO.

pToolTip
[in, out] Puntatore al controllo descrizione comando per il quale impostare il testo e la descrizione.

nType
[in] Specifica il tipo di controllo a cui è associata la descrizione comando.

strText
[in] Testo da impostare come testo della descrizione comando.

lpszDescr
[in] Puntatore alla descrizione della descrizione comando. Può essere NULL.

Osservazioni:

Il valore di nType deve essere lo stesso valore del parametro nType di CTooltipManager::CreateToolTip quando è stata creata la descrizione comando.

CTooltipManager::UpdateTooltips

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

void UpdateTooltips();

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolTipCtrl
Classe CMFCToolTipInfo