CMFCTabCtrl-Klasse

Artikel
02/26/2013

Die Klasse stellt CMFCTabCtrl-Funktionalität für ein Tab-Steuerelement bereit.Das Tab-Steuerelement zeigt ein andockbares Fenster mit gleichmäßige oder dreidimensionalen Registerkarten an der oberen oder unteren Rand an an.Die Registerkarten können Text und ein Bild anzeigen und können Farbe ändern, wenn aktiv.

class CMFCTabCtrl : public CMFCBaseTabCtrl

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCTabCtrl::CMFCTabCtrl	Standardkonstruktor.
CMFCTabCtrl::~CMFCTabCtrl	Destruktor.

Öffentliche Methoden

Name	Description
CMFCTabCtrl::ActivateMDITab	Zeigt die angegebene Registerkarte des aktuellen Tab-Steuerelements an und legt den Fokus auf dieser Registerkarte fest.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow	Gibt an, ob das Framework, den Clientbereich aller Tab-Steuerelement-Fenster Größe ändern wenn ein Benutzeroberflächenelement der Tab-Steuerelement-Änderungen ist.
CMFCTabCtrl::CalcRectEdit	Entlüftet die Größe des angegebenen Registerkartenbereichs.(Überschreibungen CMFCBaseTabCtrl::CalcRectEdit.)
CMFCTabCtrl::Create	Erstellt das Tab-Steuerelement und fügt es dem CMFCTabCtrl-Objekt.
CMFCTabCtrl::CreateObject	Wird vom Framework, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCTabCtrl::EnableActiveTabCloseButton	Zeigt an oder blendet eine Schaltfläche zum X() auf der aktiven Registerkarte aus.
CMFCTabCtrl::EnableInPlaceEdit	Aktiviert oder deaktiviert bearbeitbare Registerkartenbezeichnungen.(Überschreibungen CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu	Ersetzt zwei Schaltflächen, die die Fensterregisterkarten mit einer Schaltfläche wechseln, die ein Menü von Fenstern im Registerkartenformat öffnet.
CMFCTabCtrl::EnsureVisible	Stellt sicher, dass eine Registerkarte sichtbar ist.
CMFCTabCtrl::GetDocumentIcon	Ruft das Symbol ab, das einer Registerkarte in einem Popupmenü von Fenstern im Registerkartenformat zugeordnet ist.
CMFCTabCtrl::GetFirstVisibleTabNum	Ruft den Index der ersten Registerkarte ab, die im aktuellen Tab-Steuerelement sichtbar ist.
CMFCTabCtrl::GetResizeMode	Ruft einen Wert ab, der angibt, wie das aktuelle Tab-Steuerelement Größe geändert werden kann.
CMFCTabCtrl::GetScrollBar	Ruft einen Zeiger auf das Bildlaufleistenobjekt ab, das dem Tab-Steuerelement zugeordnet ist.
CMFCTabCtrl::GetTabArea	Ruft das umschließende Rechteck des Registerkartenetikettbereichs oben oder unteren Rand des Tab-Steuerelements ab.(Überschreibungen CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint	Ruft die Registerkarte ab, die einen angegebenen Punkt enthält.(Überschreibungen CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth	Ruft die maximale Breite einer Registerkarte ab.
CMFCTabCtrl::GetTabsHeight	Ruft die Höhe des Registerkartenbereichs des aktuellen Tab-Steuerelements ab.
CMFCTabCtrl::GetTabsRect	Ruft ein Rechteck ab, das den Registerkartenbereich des aktuellen Tab-Steuerelements begrenzt.(Überschreibungen CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass	Wird vom Framework, um ein Zeiger auf CRuntimeClass-Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCTabCtrl::GetWndArea	Ruft die Begrenzung des Clientbereichs des aktuellen Tab-Steuerelements ab.
CMFCTabCtrl::HideActiveWindowHorzScrollBar	Blendet die horizontale Bildlaufleiste ggf. des aktiven Fensters aus.
CMFCTabCtrl::HideInactiveWindow	Gibt an, ob das Framework, inaktive Tab-Steuerelement-Fenster anzuzeigen.
CMFCTabCtrl::HideNoTabs	Aktiviert oder deaktiviert das Zeichnen des Registerkartenbereichs, wenn keine sichtbaren Registerkarten gibt.
CMFCTabCtrl::HideSingleTab	Aktiviert oder deaktiviert das Zeichnen einer Registerkarte, wenn es ein einzelnes Fenster im Registerkartenformat gibt.(Überschreibungen CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup	Gibt an, ob die aktuelle Registerkarte eines Tab-Steuerelements die aktive Registerkarte in einer MDI (Multiple Document Interface-Registerkartengruppe ist.
CMFCTabCtrl::IsActiveTabBoldFont	Gibt an, ob der Text der aktiven Registerkarte mit fett formatierter Schrift angezeigt wird.
CMFCTabCtrl::IsActiveTabCloseButton	Gibt an, ob die Schaltfläche Schließen (X) auf einer aktiven Registerkarte oder der rechten oberen Ecke des Registerkartenbereichs angezeigt wird.
CMFCTabCtrl::IsDrawFrame	Gibt an, ob das Fenster im Registerkartenformat Framerechteck um eingebettete Bereiche zeichnet.
CMFCTabCtrl::IsFlatFrame	Gibt an, ob die Rahmen um den Registerkartenbereich flach oder 3D sind.
CMFCTabCtrl::IsFlatTab	Gibt an, ob die Darstellung der Registerkarten im aktuellen Tab-Steuerelement oder nicht flach ist.
CMFCTabCtrl::IsLeftRightRounded	Gibt an, ob die Darstellung der linken und rechten Seite einer Registerkarte im aktuellen Tab-Steuerelement gerundet.
CMFCTabCtrl::IsMDITabGroup	Gibt an, ob das aktuelle Tab-Steuerelement im Clientbereich eines Multiple Document Interface-Fensters enthalten ist.
CMFCTabCtrl::IsOneNoteStyle	Gibt an, ob das aktuelle Tab-Steuerelement im Stil von Microsoft OneNote angezeigt wird.
CMFCTabCtrl::IsPtInTabArea	Bestimmt, ob ein Punkt innerhalb des Registerkartenbereichs ist.(Überschreibungen CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll	Gibt an, ob das aktuelle Tab-Steuerelement eine Bildlaufleiste verfügt, die Registerkarten als Gruppe einen Bildlauf durchführen kann.
CMFCTabCtrl::IsTabDocumentsMenu	Gibt an, ob das Tab-Steuerelement Bildlaufschaltflächen oder eine Schaltfläche angezeigt wird, die ein Menü von Fenstern im Registerkartenformat anzeigt.
CMFCTabCtrl::IsVS2005Style	Gibt an, ob Registerkarten im Format Visual Studio .NET 2005. angezeigt werden.
CMFCTabCtrl::ModifyTabStyle	Gibt die Darstellung von Registerkarten im aktuellen Tab-Steuerelement auf.
CMFCTabCtrl::MoveTab	Verschiebt eine Registerkarte auf eine andere Tabstoppposition.(Überschreibungen CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter	Aufgerufen vom Framework, wenn der Cursor zuerst in das Tab-Steuerelement-Fenster gezogen wird.
CMFCTabCtrl::OnDragOver	Aufgerufen vom Framework während eines Ziehvorgangs, wenn die Maus über das Ablagezielfenster bewegt wird.(Überschreibungen CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu	Zeigt ein Popupmenü von Fenstern im Registerkartenformat, wartet, bis der Benutzer eine Registerkarte auswählt, und macht die ausgewählte Registerkarte die aktive Registerkarte.
CMFCTabCtrl::PreTranslateMessage	Übersetzt Fenstermeldungen, bevor sie an den TranslateMessage und DispatchMessage Windows-Funktionen weitergeleitet werden.(Überschreibungen CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout	Berechnet das interne Layout des Tab-Steuerelements neu.(Überschreibungen CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup	Legt die aktuelle Registerkarte einem Registersteuerelement wie die aktive Registerkarte in einer MDI (Multiple Document Interface-Registerkartengruppe fest.
CMFCTabCtrl::SetActiveTab	Aktiviert eine Registerkarte.(Überschreibungen CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont	Aktiviert oder Sperrungsgebrauch von fett formatierter Schrift auf aktiven Registerkarten.
CMFCTabCtrl::SetDrawFrame	Aktiviert oder deaktiviert drawinga Framerechteck um eine eingebettete Leiste.
CMFCTabCtrl::SetFlatFrame	Gibt an, ob eine Ebene oder 3D-Frame um den Registerkartenbereich zeichnet.
CMFCTabCtrl::SetImageList	Gibt eine Bildliste an.(Überschreibungen CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode	Gibt, an, wie das aktuelle Tab-Steuerelement Größe geändert werden kann und zeigt dann das Steuerelement erneut an.
CMFCTabCtrl::SetTabMaxWidth	Gibt die maximale Registerkartenbreite in ein Fenster im Registerkartenformat an.
CMFCTabCtrl::StopResize	Beendet die aktuelle Größe ändern Vorgang auf dem Tab-Steuerelement.
CMFCTabCtrl::SwapTabs	Vertauscht ein Paar Registerkarten aus.(Überschreibungen CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar	Zeichnet eine horizontale Bildlaufleiste auf einem Tab-Steuerelement, das flache Registerkarten anzeigt.

Datenmember

Name	Description
CMFCTabCtrl::m_bEnableActivate	Verhindert die aktive Ansicht an verlierendem den Fokus, wenn eine neue Registerkarte eingefügt und aktiviert ist.

Hinweise

Die Klasse einzelne CMFCTabCtrl:

Tab-Steuerelement-Formate, die 3D, Ebene und Ebene einer freigegebenen horizontalen Bildlaufleiste enthalten.
Registerkarten oben isoliert oder den unteren Rand des Fensters.
Registerkarten, die Text, Bilder oder Text und Bilder anzeigen.
Registerkarten, die Farbe ändern, wenn die Registerkarte aktiv ist.
Rahmengrößenänderungen für justierbare Registerkarten.
Abnehmbare Fenster im Registerkartenformat.

Die CMFCTabCtrl-Klasse kann mit einem Dialogfeld verwendet werden, jedoch wird für Anwendungen geeignet, die andockbare Steuerleisten wie Microsoft Excel und Visual Studio verwenden.Weitere Informationen finden Sie unter CDockablePane-Klasse.

Führen Sie folgende Schritte aus, um ein in der Größe veränderbares, Andockes Registersteuerelement in der Anwendung hinzuzufügen:

Erstellen Sie eine Instanz von CTabbedPane-Klasse.
Rufen Sie CDockablePane::Create auf.
Verwenden Sie CBaseTabbedPane::AddTab oder CMFCBaseTabCtrl::InsertTab, um neue Registerkarten hinzuzufügen.
Rufen Sie CBasePane::EnableDocking auf, damit das aktuelle andockbare Tab-Steuerelement am Hauptrahmenfenster andocken kann.
Rufen Sie CFrameWndEx::DockPane auf, um das Fenster im Registerkartenformat am Hauptframes anzudocken.

Ein Beispiel, wie ein Fenster im Registerkartenformat als andockbare Symbolleisten, finden Sie unter CTabbedPane-Klasse erstellt wird.Um CMFCTabCtrl als NichtAndocken Steuerelement zu verwenden, erstellen Sie ein CMFCTabCtrl-Objekt und rufen Sie dann CMFCTabCtrl::Create auf.

Vererbungshierarchie

Beispiel

Das folgende Beispiel zeigt, wie verschiedene Methoden in der CMFCTabCtrl-Klasse verwendet, um ein CMFCTabCtrl-Objekt zu konfigurieren.Im Beispiel wird erläutert, wie Sie eine Registerkarte hinzufügt, die Schaltfläche Schließen auf der aktiven Registerkarte angezeigt wird, Registerkartenbezeichnungen bearbeitbare aktiviert und ein Popupmenü von Fensterbezeichnungen im Registerkartenformat anzeigt.Dieses Beispiel ist Teil Zustands-Auflistungsbeispiel.

    CMFCTabCtrl m_wndTabs;


...


    // Attach list windows to tab:
    // CListCtrl m_wndList1
    // CListCtrl m_wndList2
    // CListCtrl m_wndList3
    m_wndTabs.AddTab (&m_wndList1, _T("Output 1"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList2, _T("Output 2"), (UINT)-1);
    m_wndTabs.AddTab (&m_wndList3, _T("Output 3"), (UINT)-1);

    m_wndTabs.EnableActiveTabCloseButton();
    m_wndTabs.EnableInPlaceEdit(true);
    m_wndTabs.EnableTabDocumentsMenu();
    m_wndTabs.SetActiveTab(1);
    m_wndTabs.SetDrawFrame();
    m_wndTabs.SetFlatFrame();