CMFCCaptionBar, classe

Article
06/10/2015

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

Mé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.

Mé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.

Membres 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 :

Construisez l'objet d' CMFCCaptionBar . En général, vous ajoutez la barre de titre à une classe de fenêtre frame.
Appelez la méthode CMFCCaptionBar::Create pour créer le contrôle de barre de titre et le lier à l'objet d' CMFCCaptionBar .
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;
}