CTooltipManager, classe

Gère les informations d'exécution relatives aux info-bulles. La classe CTooltipManager est instanciée une fois par application.

Syntaxe

class CTooltipManager : public CObject

Membres

Méthodes publiques

Nom	Description
CTooltipManager ::CreateToolTip	Crée un contrôle d'info-bulle pour les types de contrôles Windows spécifiés.
CTooltipManager ::D eleteToolTip	Supprime un contrôle d'info-bulle.
CTooltipManager ::SetTooltipParams	Personnalise l'apparence visuelle du contrôle d'info-bulle pour les types de contrôles Windows spécifiés.
CTooltipManager ::SetTooltipText	Définit le texte et la description d'un contrôle d'info-bulle.
CTooltipManager ::UpdateTooltips

Notes

Utilisez cmFCToolTipCtrl, classe, CMFCToolTipInfoet CTooltipManager ensemble pour implémenter des info-bulles personnalisées dans votre application. Pour obtenir un exemple d’utilisation de ces classes d’info-bulles, consultez la rubrique CMFCToolTipCtrl, classe .

Hiérarchie d'héritage

CObject

CTooltipManager

Spécifications

En-tête : afxtooltipmanager.h

CTooltipManager ::CreateToolTip

Crée un contrôle d’info-bulle.

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

Paramètres

pToolTip
[out] Référence à un pointeur d’info-bulle. Il est défini pour pointer vers l’info-bulle nouvellement créée lorsque la fonction est retournée.

pWndParent
[in] Parent de l’info-bulle.

nType
[in] Type de l’info-bulle.

Valeur de retour

Différent de zéro si une info-bulle a été créée avec succès.

Notes

Vous devez appeler CTooltipManager ::D eleteToolTip pour supprimer le contrôle d’info-bulle passé dans pToolTip.

CTooltipManager définit les paramètres d’affichage visuels de chaque info-bulle qu’il crée en fonction du type d’info-bulle spécifié par nType. Pour modifier les paramètres d’un ou plusieurs types d’info-bulles, appelez CTooltipManager ::SetTooltipParams.

Les types d’info-bulle valides sont répertoriés dans le tableau suivant :

Type d’info-bulle	Catégorie de contrôle	Exemples de types
AFX_TOOLTIP_TYPE_BUTTON	Bouton.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Barre légende.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Tout contrôle qui ne correspond pas à une autre catégorie.	Aucune.
AFX_TOOLTIP_TYPE_DOCKo AR	Volet ancreable.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Zone de texte.	Aucune.
AFX_TOOLTIP_TYPE_MINIFRAME	Un miniframe.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Un planificateur.	Aucune.
AFX_TOOLTIP_TYPE_RIBBON	Barre de ruban.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Contrôle d’onglet.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Barre d’outils.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Boîte à outils.	Aucune.

CTooltipManager ::D eleteToolTip

Supprime un contrôle d'info-bulle.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Paramètres

pToolTip
[in, out] Référence à un pointeur vers une info-bulle à détruire.

Notes

Appelez cette méthode pour chaque classe CToolTipCtrl créée par CTooltipManager ::CreateToolTip. Le contrôle parent doit appeler cette méthode à partir de son OnDestroy gestionnaire. Cela est nécessaire pour supprimer correctement l’info-bulle de l’infrastructure. Cette méthode définit pToolTip sur NULL avant de retourner.

CTooltipManager ::SetTooltipParams

Personnalise l’apparence du contrôle d’info-bulle pour les types de contrôle Windows spécifiés.

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

Paramètres

nTypes
[in] Spécifie les types de contrôle.

Cfrp
[in] Classe runtime de l’info-bulle personnalisée.

pParams
[in] Paramètres d’info-bulle.

Notes

Cette méthode définit la classe runtime et les paramètres initiaux utilisés par CToolTipManager lors de la création d’info-bulles. Lorsqu’un contrôle appelle CTooltipManager ::CreateToolTip et passe un type d’info-bulle qui est l’un des types indiqués par nTypes, le gestionnaire d’info-bulles crée un contrôle d’info-bulle qui est une instance de la classe runtime spécifiée par pRTC et transmet les paramètres spécifiés par pParams à la nouvelle info-bulle.

Lorsque vous appelez cette méthode, tous les propriétaires d’info-bulle existants reçoivent le message AFX_WM_UPDATETOOLTIPS et doivent recréer leurs info-bulles à l’aide de CTooltipManager ::CreateToolTip.

nTypes peut être n’importe quelle combinaison des types d’info-bulle valides que CTooltipManager ::CreateToolTip utilise, ou il peut être AFX_TOOLTIP_TYPE_ALL. Si vous passez AFX_TOOLTIP_TYPE_ALL, tous les types d’info-bulles sont affectés.

Exemple

L’exemple suivant montre comment utiliser la SetTooltipParams méthode de la CTooltipManager classe. Cet extrait de code fait partie de l’ exemple Draw Client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager ::SetTooltipText

Définit le texte et la description d’une info-bulle.

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

Paramètres

Pti
[in] Pointeur vers un objet TOOLINFO.

pToolTip
[in, out] Pointeur vers le contrôle d’info-bulle pour lequel définir le texte et la description.

nType
[in] Spécifie le type de contrôle auquel cette info-bulle est associée.

strText
[in] Texte à définir comme texte d’info-bulle.

lpszDescr
[in] Pointeur vers la description de l’info-bulle. Sa valeur peut être NULL.

Notes

La valeur de nType doit être la même que le paramètre nType de CTooltipManager ::CreateToolTip lorsque vous avez créé l’info-bulle.

CTooltipManager ::UpdateTooltips

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

void UpdateTooltips();

Notes

Voir aussi

Graphique hiérarchique
Classes
CMFCToolTipCtrl, classe
CMFCToolTipInfo, classe