CMFCToolTipCtrl, classe

Article
06/10/2015

Une implémentation étendue d'info-bulle sur CToolTipCtrl, classe. Une info-bulle sur la classe d' CMFCToolTipCtrl peut afficher une icône, une étiquette, et une description. Vous pouvez personnaliser son apparence visuelle à l'aide d'un dégradé, un texte personnalisé et les couleurs de la bordure, les caractères gras, des angles arrondis, ou un style de propagation.

class CMFCToolTipCtrl : public CToolTipCtrl

Membres

Constructeurs publics

Nom	Description
CMFCToolTipCtrl::CMFCToolTipCtrl	Constructeur par défaut.

Méthodes publiques

Nom	Description
CMFCToolTipCtrl::GetIconSize	Retourne la taille d'une icône dans une info-bulle.
CMFCToolTipCtrl::GetParams	Retourne les paramètres d'affichage d'une info-bulle.
CMFCToolTipCtrl::OnDrawBorder	Dessine une bordure d'une info-bulle.
CMFCToolTipCtrl::OnDrawDescription
CMFCToolTipCtrl::OnDrawIcon	Affiche une icône dans une info-bulle.
CMFCToolTipCtrl::OnDrawLabel	Dessine l'étiquette d'une info-bulle, ou calcule la taille de l'étiquette.
CMFCToolTipCtrl::OnDrawSeparator	Dessine le séparateur entre l'étiquette et la description dans une info-bulle.
CMFCToolTipCtrl::OnFillBackground	Remplit arrière-plan d'info-bulle.
CMFCToolTipCtrl::SetDescription	Définit la description à afficher l'info-bulle.
CMFCToolTipCtrl::SetFixedWidth
CMFCToolTipCtrl::SetHotRibbonButton
CMFCToolTipCtrl::SetLocation
CMFCToolTipCtrl::SetParams	Spécifie l'apparence visuelle d'une info-bulle à l'aide d'un objet d' CMFCToolTipInfo .

Notes

Utilisez CMFCToolTipCtrl, CMFCToolTipInfo, et les objets de CTooltipManager, classe ensemble pour implémenter des info-bulles personnalisées dans votre application.

Par exemple, pour utiliser des info-bulles de style de la propagation, suivez ces étapes :

1. Utilisez la méthode de CWinAppEx, classe pour initialiser le gestionnaire d'info-bulle dans votre application.

2. Créez une structure d' CMFCToolTipInfo pour spécifier le style visuel que vous voulez :

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. Utilisez la méthode de CTooltipManager::SetTooltipParams pour définir le style visuel pour les info-bulles dans l'application à l'aide de les styles définis dans l'objet d' CMFCToolTipInfo :

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

Vous pouvez également dériver une nouvelle classe d' CMFCToolTipCtrl pour contrôler le comportement et le rendu d'une info-bulle. Pour spécifier une nouvelle classe de contrôle d'info-bulle, utilisez la méthode d' CTooltipManager::SetTooltipParams :

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

Pour restaurer la classe par défaut du contrôle d'info-bulle et réinitialiser l'apparence d'une info-bulle à son état par défaut, spécifiez la valeur NULL dans les paramètres de classe de runtime et d'informations de l'info-bulle d' SetTooltipParams:

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

Exemple

L'exemple suivant montre comment construire un objet d' CMFCToolTipCtrl , définissez la description que l'info-bulle affiche, et est fixé la largeur du contrôle d'info-bulle.

   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);