Partager via


Classe de CMFCCaptionBar

Un objet d' CMFCCaptionBar est une barre de contrôles qui peut afficher trois éléments : un bouton, une étiquette de texte, et une bitmap.Il ne peut afficher un élément de chaque type à la fois.Vous pouvez aligner chaque élément aux bords gauche ou droit du contrôle ou centre.Vous pouvez également appliquer un plate ou un style 3D aux zones de haut et bas de la barre de légende.

class CMFCCaptionBar : public CPane

Membres

Bb983960.collapse_all(fr-fr,VS.110).gifMéthodes publiques

Nom

Description

CMFCCaptionBar::Create

Crée le contrôle de barre de titre et l'attache à l'objet d' CMFCCaptionBar.

CMFCCaptionBar::DoesAllowDynInsertBefore

Indique si un autre volet peut être dynamiquement inséré entre la barre de légende et son frame parent.(Substitutions CBasePane::DoesAllowDynInsertBefore.)

CMFCCaptionBar::EnableButton

Active ou désactive le bouton dans la barre de légende.

CMFCCaptionBar::GetAlignment

Retourne l'alignement de l'élément spécifié.

CMFCCaptionBar::GetBorderSize

Retourne la taille de la bordure de la barre de légende.

CMFCCaptionBar::GetButtonRect

Récupère le rectangle englobant du bouton sur la barre de légende.

CMFCCaptionBar::GetMargin

Retourne la distance entre le bord des éléments de barre de titre et le bord du contrôle de barre de titre.

CMFCCaptionBar::IsMessageBarMode

Spécifie si la barre de légende est en mode de barre des messages.

CMFCCaptionBar::RemoveBitmap

Supprime l'image bitmap de la barre de légende.

CMFCCaptionBar::RemoveButton

Supprime le bouton de la barre de légende.

CMFCCaptionBar::RemoveIcon

Supprime l'icône de la barre de légende.

CMFCCaptionBar::RemoveText

Supprime l'étiquette de texte de la barre de légende.

CMFCCaptionBar::SetBitmap

Définit l'image bitmap pour la barre de légende.

CMFCCaptionBar::SetBorderSize

Définit la taille de la bordure de la barre de légende.

CMFCCaptionBar::SetButton

Définit le bouton pour la barre de légende.

CMFCCaptionBar::SetButtonPressed

Spécifie si reste du bouton est enfoncé.

CMFCCaptionBar::SetButtonToolTip

Définit l'info-bulle pour le bouton.

CMFCCaptionBar::SetFlatBorder

Définit le style de bordure de la barre de légende.

CMFCCaptionBar::SetIcon

Définit l'icône pour une barre de légende.

CMFCCaptionBar::SetImageToolTip

Définit l'info-bulle de l'image pour la barre de légende.

CMFCCaptionBar::SetMargin

Définit la distance entre le bord de l'élément de la barre de légende et le bord du contrôle de barre de titre.

CMFCCaptionBar::SetText

Définit l'étiquette de texte de la barre de légende.

Bb983960.collapse_all(fr-fr,VS.110).gifMéthodes protégées

Nom

Description

CMFCCaptionBar::OnDrawBackground

Appelé par l'infrastructure pour remplir arrière-plan de la barre de légende.

CMFCCaptionBar::OnDrawBorder

Appelé par l'infrastructure pour dessiner la bordure de la barre de légende.

CMFCCaptionBar::OnDrawButton

Appelé par l'infrastructure pour dessiner le bouton de la barre de légende.

CMFCCaptionBar::OnDrawImage

Appelé par l'infrastructure pour dessiner l'image de la barre de légende.

CMFCCaptionBar::OnDrawText

Appelé par l'infrastructure pour dessiner le texte de la barre de légende.

Bb983960.collapse_all(fr-fr,VS.110).gifMembres de données

Nom

Description

CMFCCaptionBar::m_clrBarBackground

La couleur d'arrière-plan de la barre de légende.

CMFCCaptionBar::m_clrBarBorder

La couleur de la bordure de la barre de légende.

CMFCCaptionBar::m_clrBarText

La couleur du texte de la barre de légende.

Notes

Pour créer une barre de légende, suivez ces étapes :

  1. Construisez l'objet d' CMFCCaptionBar .En général, vous ajoutez la barre de titre à une classe de fenêtre frame.

  2. Appelez la méthode CMFCCaptionBar::Create pour créer le contrôle de barre de titre et le lier à l'objet d' CMFCCaptionBar .

  3. Appelez CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, et CMFCCaptionBar::SetBitmap pour définir les éléments de barre de titre.

Lorsque vous affectez à l'élément de bouton, vous devez assigner un ID de commande du bouton.Lorsque l'utilisateur clique sur le bouton, la barre de légende route les messages d' WM_COMMAND qui ont cet ID à la fenêtre frame parente.

La barre de légende peut également s'exécuter en mode de barre des messages, qui émule la barre des messages qui apparaît dans les applications Microsoft Office 2007.En mode de barre des messages, la barre de titre affiche une bitmap, un message, et un bouton (qui ouvre généralement une boîte de dialogue.) Vous pouvez assigner une info-bulle à la bitmap.

Pour activer le mode de barre des messages, l'appel CMFCCaptionBar::Create et définir le quatrième paramètre (bIsMessageBarMode) à TRUE.

Exemple

L'exemple suivant montre comment utiliser différentes méthodes dans la classe d' CMFCCaptionBar .L'exemple montre comment créer le contrôle de barre de titre, définir une bordure 3D de la barre de légende, définir la distance, en pixels, entre le bord des éléments de barre de titre et le bord du contrôle de barre de titre, le positionnement du bouton pour la barre de légende, définir l'info-bulle pour le bouton, définir l'étiquette de texte de la barre de légende, définir l'image bitmap pour la barre de légende, et définir l'info-bulle de l'image dans la barre de légende.Cet extrait de code fait partie d' Exemple 2007 de démonstration de MS Office.

    CMFCCaptionBar m_wndMessageBar;


...


BOOL CMainFrame::CreateMessageBar()
{
    // The this pointer points to a CMainFrame class which extends the CFrameWndEx class.
    if (!m_wndMessageBar.Create(WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS, this, ID_VIEW_MESSAGEBAR, -1, TRUE))
    {
        TRACE0("Failed to create caption bar\n");
        return FALSE;
    }

    m_wndMessageBar.SetFlatBorder( FALSE );
    m_wndMessageBar.SetMargin(10);
    m_wndMessageBar.SetButton(_T("Options..."), ID_TOOLS_OPTIONS, CMFCCaptionBar::ALIGN_LEFT, FALSE);
    m_wndMessageBar.SetButtonToolTip(_T("Click here to see more options"));

    m_wndMessageBar.SetText(_T("Welcome to the MFC MSOffice2007 demonstration!"), CMFCCaptionBar::ALIGN_LEFT);

    m_wndMessageBar.SetBitmap(IDB_INFO, RGB(255, 255, 255), FALSE, CMFCCaptionBar::ALIGN_LEFT);
    m_wndMessageBar.SetImageToolTip(_T("Important"), _T("Please take a look at MSOffice2007Demo source code to learn how to create advanced user interface in minutes."));

    return TRUE;
}

Hiérarchie d'héritage

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCCaptionBar

Configuration requise

En-tête : afxcaptionbar.h

Voir aussi

Référence

Graphique de la hiérarchie

Autres ressources

Classes MFC