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

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:

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