CMFCCaptionBar-Klasse

Artikel
06/10/2015

Ein - Objekt CMFCCaptionBar ist eine Steuerleiste, die drei Elemente angezeigt werden: eine Schaltfläche, eine Beschriftung und eine Bitmap. Es kann ein Element jedes Typs nur gleichzeitig anzeigen. Sie können jedes Element zum linken oder rechten Rand des Steuerelements oder den Mittelpunkt ausrichten. Sie können eine Ebene oder ein 3D-Format an der oberen und der unteren Rändern der Titelleiste auch anwenden.

class CMFCCaptionBar : public CPane

Mitglieder

Öffentliche Methoden

Name	Beschreibung
CMFCCaptionBar::Create	Erstellt das Beschriftungsleistesteuerelement und fügt es dem CMFCCaptionBar-Objekt.
CMFCCaptionBar::DoesAllowDynInsertBefore	Gibt an, ob ein anderer Bereich zwischen die Titelleiste und seine übergeordneten Frames dynamisch eingefügt werden kann. (Überschreibungen CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	Aktiviert oder deaktiviert die Schaltfläche in der Titelleiste.
CMFCCaptionBar::GetAlignment	Gibt die Ausrichtung des angegebenen Elements zurück.
CMFCCaptionBar::GetBorderSize	Gibt die Rahmengröße der Titelleiste zurück.
CMFCCaptionBar::GetButtonRect	Ruft das umschließende Rechteck der Schaltfläche in der Titelleiste ab.
CMFCCaptionBar::GetMargin	Gibt den Abstand zwischen dem Rand der Beschriftungsleisteelemente und dem Rand des Beschriftungsleistesteuerelements zurück.
CMFCCaptionBar::IsMessageBarMode	Gibt an, ob die Titelleiste im Statusleistenmodus ist.
CMFCCaptionBar::RemoveBitmap	Entfernt das Bitmapbild von der Titelleiste.
CMFCCaptionBar::RemoveButton	Entfernt die Schaltfläche von der Titelleiste.
CMFCCaptionBar::RemoveIcon	Entfernt das Symbol aus der Titelleiste.
CMFCCaptionBar::RemoveText	Entfernt die Beschriftung von der Titelleiste.
CMFCCaptionBar::SetBitmap	Legt das Bitmapbild für die Titelleiste fest.
CMFCCaptionBar::SetBorderSize	Legt die Rahmengröße der Titelleiste fest.
CMFCCaptionBar::SetButton	Legt die Schaltfläche für die Titelleiste fest.
CMFCCaptionBar::SetButtonPressed	Gibt an, ob die Schaltflächenaufenthalte drücken.
CMFCCaptionBar::SetButtonToolTip	Legt die QuickInfo für die Schaltfläche fest.
CMFCCaptionBar::SetFlatBorder	Legt die Rahmenart der Titelleiste fest.
CMFCCaptionBar::SetIcon	Legt das Symbol für eine Titelleiste fest.
CMFCCaptionBar::SetImageToolTip	Legt die QuickInfo für das Bild für die Titelleiste fest.
CMFCCaptionBar::SetMargin	Legt den Abstand zwischen dem Rand des Beschriftungsleisteelements und dem Rand des Beschriftungsleistesteuerelements fest.
CMFCCaptionBar::SetText	Legt die Beschriftung für die Titelleiste fest.

Geschützte Methoden

Name	Beschreibung
CMFCCaptionBar::OnDrawBackground	Aufgerufen vom Framework, um den Hintergrund der Titelleiste auszufüllen.
CMFCCaptionBar::OnDrawBorder	Aufgerufen vom Framework, um den Rahmen der Titelleiste zu zeichnen.
CMFCCaptionBar::OnDrawButton	Aufgerufen vom Framework, um die Beschriftungsleisteschaltfläche zu zeichnen.
CMFCCaptionBar::OnDrawImage	Aufgerufen vom Framework, um das Beschriftungsleisteimage zu zeichnen.
CMFCCaptionBar::OnDrawText	Aufgerufen vom Framework, um den Beschriftungsleistetext zu zeichnen.

Datenmember

Name	Beschreibung
CMFCCaptionBar::m_clrBarBackground	Die Hintergrundfarbe der Titelleiste.
CMFCCaptionBar::m_clrBarBorder	Die Farbe des Rahmens der Titelleiste.
CMFCCaptionBar::m_clrBarText	Die Farbe des Beschriftungsleistetexts.

Hinweise

Um eine Titelleiste zu erstellen, führen Sie folgende Schritte aus:

Erstellen Sie das CMFCCaptionBar-Objekt. In der Regel ist die Titelleiste einer Rahmenfensterklasse hinzufügen.
Rufen Sie die CMFCCaptionBar::Create-Methode auf, um das Beschriftungsleistesteuerelement zu erstellen und auf CMFCCaptionBar-Objekt anzufügen.
Rufen Sie CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon und CMFCCaptionBar::SetBitmap auf, um die Beschriftungsleisteelemente festzulegen.

Wenn Sie das Schaltflächenelement, Ihnen eine Befehls-ID zur Schaltfläche zuweisen müssen. Wenn der Benutzer auf die Schaltfläche klickt, leitet die Titelleiste die WM_COMMAND Meldungen angezeigt, die diese ID auf das übergeordnete Rahmenfenster haben.

Die Titelleiste kann im Statusleistenmodus auch arbeiten, der die Statusleiste emuliert, die in Microsoft Office 2007-Anwendungen angezeigt wird. Im Statusleistenmodus zeigt die Titelleiste eine Bitmap, eine Meldung und eine Schaltfläche an (in der Regel ein Dialogfeld geöffnet). Sie können eine QuickInfo zur Bitmap zuweisen.

Um Statusleistenmodus zu aktivieren, rufen Sie CMFCCaptionBar::Create auf und legen Sie den vierten Parameter (bIsMessageBarMode) zu TRUE fest.

Beispiel

Das folgende Beispiel zeigt, wie verschiedene Methoden in der Klasse CMFCCaptionBar verwendet. Im Beispiel wird gezeigt, wie das Beschriftungsleistesteuerelement, legen Sie einen 3D-Rahmen der Titelleiste, legen Sie den Abstand, in Pixel, zwischen dem Rand der Beschriftungsleisteelemente und dem Rand des Beschriftungsleistesteuerelements, legen Sie die Schaltfläche für die Titelleiste, legen Sie die QuickInfo für die Schaltfläche, legen Sie die Beschriftung für die Titelleiste, legen Sie das Bitmapbild für die Titelleiste und legen Sie die QuickInfo für das Bild in der Titelleiste erstellt. Dieser Codeausschnitt ist Teil MS Office-Demobeispiel 2007.

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