Freigeben über


CMFCTabCtrl-Klasse

Die CMFCTabCtrl Klasse stellt Funktionen für ein Registerkartensteuerelement bereit. Das Registerkarten-Steuerelement zeigt ein andockbares Fenster an, mit flachen oder dreidimensionalen Registerkarten am oberen oder unteren Rand. Die Registerkarten können Text und ein Bild enthalten und bei Aktivierung die Farbe ändern.

Syntax

class CMFCTabCtrl : public CMFCBaseTabCtrl

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCTabCtrl::CMFCTabCtrl Der Standardkonstruktor.
CMFCTabCtrl::~CMFCTabCtrl Destruktor.

Öffentliche Methoden

Name Beschreibung
CMFCTabCtrl::ActivateMDITab Zeigt die angegebene Registerkarte des aktuellen Registerkartensteuerelements an und legt den Fokus auf dieser Registerkarte fest.
CMFCTabCtrl::AllowDestroyEmptyTabbedPane
CMFCTabCtrl::AutoSizeWindow Gibt an, ob das Framework die Größe des Clientbereichs aller Registerkartensteuerungsfenster ändern soll, wenn sich ein Benutzeroberflächenelement des Registerkartensteuerelements ändert.
CMFCTabCtrl::CalcRectEdit Vergrößert die Größe des angegebenen Registerkartenbereichs. (Überschreibt CMFCBaseTabCtrl::CalcRectEdit)
CMFCTabCtrl::Create Erstellt das Registersteuerelement und fügt es an das CMFCTabCtrl Objekt an.
CMFCTabCtrl::CreateObject Wird vom Framework verwendet, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCTabCtrl::EnableActiveTabCloseButton Blendet eine Schaltfläche "Schließen" ( X) auf der aktiven Registerkarte ein oder aus.
CMFCTabCtrl::EnableInPlaceEdit Aktiviert oder deaktiviert bearbeitbare Registerkartenbeschriftungen. (Überschreibt CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCTabCtrl::EnableTabDocumentsMenu Ersetzt zwei Schaltflächen zum Scrollen der Fensterregister durch eine Schaltfläche, mit der ein Menü mit Registerkartenfenstern geöffnet wird.
CMFCTabCtrl::EnsureVisible Stellt sicher, dass eine Registerkarte sichtbar ist.
CMFCTabCtrl::GetDocumentIcon Ruft das Symbol ab, das einer Registerkarte in einem Popupmenü von Registerkartenfenstern zugeordnet ist.
CMFCTabCtrl::GetFirstVisibleTabNum Ruft den Index der ersten Registerkarte ab, die im aktuellen Registerkartensteuerelement sichtbar ist.
CMFCTabCtrl::GetResizeMode Ruft einen Wert ab, der angibt, wie die Größe des aktuellen Registerkartensteuerelements geändert werden kann.
CMFCTabCtrl::GetScrollBar Ruft einen Zeiger auf das Bildlaufleistenobjekt ab, das dem Registersteuerelement zugeordnet ist.
CMFCTabCtrl::GetTabArea Ruft das umgebende Rechteck des Registerkartenbezeichnungsbereichs am oberen oder unteren Rand des Registerkartensteuerelements ab. (Überschreibt CMFCBaseTabCtrl::GetTabArea.)
CMFCTabCtrl::GetTabFromPoint Ruft die Registerkarte ab, die einen angegebenen Punkt enthält. (Überschreibt CMFCBaseTabCtrl::GetTabFromPoint.)
CMFCTabCtrl::GetTabMaxWidth Ruft die maximale Breite einer Registerkarte ab.
CMFCTabCtrl::GetTabsHeight Ruft die Höhe des Registerkartenbereichs des aktuellen Registerkartensteuerelements ab.
CMFCTabCtrl::GetTabsRect Ruft ein Rechteck ab, das den Registerkartenbereich des aktuellen Registerkartensteuerelements begrenzt. (Überschreibt CMFCBaseTabCtrl::GetTabsRect.)
CMFCTabCtrl::GetThisClass Wird vom Framework verwendet, um einen Zeiger auf das CRuntimeClass Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCTabCtrl::GetWndArea Ruft die Grenze des Clientbereichs des aktuellen Registerkartensteuerelements ab.
CMFCTabCtrl::HideActiveWindowHorzScrollBar Blendet die horizontale Bildlaufleiste (sofern vorhanden) des aktiven Fensters aus.
CMFCTabCtrl::HideInactiveWindow Gibt an, ob das Framework inaktive Registerkarten-Steuerelementfenster anzeigen soll.
CMFCTabCtrl::HideNoTabs Aktiviert oder deaktiviert das Zeichnen des Registerkartenbereichs, wenn keine sichtbaren Registerkarten vorhanden sind.
CMFCTabCtrl::HideSingleTab Aktiviert oder deaktiviert das Zeichnen einer Registerkarte, wenn ein einzelnes Registerkartenfenster vorhanden ist. (Überschreibt CMFCBaseTabCtrl::HideSingleTab.)
CMFCTabCtrl::IsActiveInMDITabGroup Gibt an, ob die aktuelle Registerkarte eines Registerkartensteuerelements die aktive Registerkarte in einer Gruppe mit mehreren Dokumentoberflächen-Registerkarten ist.
CMFCTabCtrl::IsActiveTabBoldFont Gibt an, ob der Text der aktiven Registerkarte mit einer fett formatierten Schriftart angezeigt wird.
CMFCTabCtrl::IsActiveTabCloseButton Gibt an, ob die Schaltfläche "Schließen" ( X) auf einer aktiven Registerkarte oder in der oberen rechten Ecke des Registerkartenbereichs angezeigt wird.
CMFCTabCtrl::IsDrawFrame Gibt an, ob das Fenster mit Registerkarten ein Rahmenrechteck um eingebettete Bereiche zeichnet.
CMFCTabCtrl::IsFlatFrame Gibt an, ob der Rahmen um den Registerkartenbereich flach oder 3D ist.
CMFCTabCtrl::IsFlatTab Gibt an, ob die Darstellung der Registerkarten im aktuellen Registerkartensteuerelement flach ist oder nicht.
CMFCTabCtrl::IsLeftRightRounded Gibt an, ob die Darstellung der linken und rechten Seite einer Registerkarte im aktuellen Registerkartensteuerelement gerundet ist.
CMFCTabCtrl::IsMDITabGroup Gibt an, ob das aktuelle Registerkartensteuerelement im Clientbereich eines Mehrdokument-Schnittstellenfensters enthalten ist.
CMFCTabCtrl::IsOneNoteStyle Gibt an, ob das aktuelle Registerkartensteuerelement im Stil von Microsoft OneNote angezeigt wird.
CMFCTabCtrl::IsPtInTabArea Legt fest, ob sich ein Punkt innerhalb des Registerkartenbereichs befindet. (Überschreibt CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCTabCtrl::IsSharedScroll Gibt an, ob das aktuelle Registerkartensteuerelement über eine Bildlaufleiste verfügt, die die Registerkarten als Gruppe scrollen kann.
CMFCTabCtrl::IsTabDocumentsMenu Gibt an, ob das Registerkartensteuerelement Bildlaufschaltflächen oder eine Schaltfläche anzeigt, die ein Menü mit Registerkartenfenstern anzeigt.
CMFCTabCtrl::IsVS2005Style Gibt an, ob Registerkarten im Stil von Visual Studio .NET 2005 angezeigt werden.
CMFCTabCtrl::ModifyTabStyle Gibt die Darstellung von Registerkarten im aktuellen Registerkartensteuerelement an.
CMFCTabCtrl::MoveTab Verschiebt eine Registerkarte zu einer anderen Registerkartenposition. (Überschreibt CMFCBaseTabCtrl::MoveTab.)
CMFCTabCtrl::OnDragEnter Wird vom Framework aufgerufen, wenn der Cursor zuerst in das Registersteuerelementfenster gezogen wird.
CMFCTabCtrl::OnDragOver Wird während eines Ziehvorgangs vom Framework aufgerufen, wenn die Maus über das Drop-Zielfenster verschoben wird. (Überschreibt CMFCBaseTabCtrl::OnDragOver.)
CMFCTabCtrl::OnShowTabDocumentsMenu Zeigt ein Popupmenü mit Registerkartenfenstern an, wartet, bis der Benutzer eine Registerkarte auswählt und die ausgewählte Registerkarte zur aktiven Registerkarte macht.
CMFCTabCtrl::PreTranslateMessage Übersetzt Fensternachrichten, bevor sie an die TranslateMessage Und DispatchMessage Windows-Funktionen verteilt werden. (Überschreibt CMFCBaseTabCtrl::PreTranslateMessage.)
CMFCTabCtrl::RecalcLayout Berechnet das interne Layout des Registerkartensteuerelements neu. (Überschreibt CMFCBaseTabCtrl::RecalcLayout.)
CMFCTabCtrl::SetActiveInMDITabGroup Legt die aktuelle Registerkarte eines Registerkartensteuerelements als aktive Registerkarte in einer Gruppe mit mehreren Dokumentoberflächen-Registerkarten fest.
CMFCTabCtrl::SetActiveTab Aktiviert eine Registerkarte. (Überschreibungen CMFCBaseTabCtrl::SetActiveTab.)
CMFCTabCtrl::SetActiveTabBoldFont Aktiviert oder deaktiviert die Verwendung einer fett formatierten Schriftart auf aktiven Registerkarten.
CMFCTabCtrl::SetDrawFrame Aktiviert oder deaktiviert das Zeichnen eines Rahmenrechtecks um einen eingebetteten Balken.
CMFCTabCtrl::SetFlatFrame Gibt an, ob ein flacher oder ein 3D-Frame um den Registerkartenbereich gezeichnet werden soll.
CMFCTabCtrl::SetImageList Gibt eine Bildliste an. (Überschreibt CMFCBaseTabCtrl::SetImageList.)
CMFCTabCtrl::SetResizeMode Gibt an, wie die Größe des aktuellen Registerkartensteuerelements geändert werden kann, und zeigt das Steuerelement dann erneut an.
CMFCTabCtrl::SetTabMaxWidth Gibt die maximale Registerkartenbreite in einem Registerkartenfenster an.
CMFCTabCtrl::StopResize Beendet den aktuellen Größenänderungsvorgang im Registerkartensteuerelement.
CMFCTabCtrl::SwapTabs Tauscht ein Paar Registerkarten aus. (Überschreibt CMFCBaseTabCtrl::SwapTabs.)
CMFCTabCtrl::SynchronizeScrollBar Zeichnet eine horizontale Bildlaufleiste auf einem Registerkartensteuerelement, das flache Registerkarten anzeigt.

Datenelemente

Name Beschreibung
CMFCTabCtrl::m_bEnableActivate Verhindert, dass die aktive Ansicht den Fokus verliert, wenn eine neue Registerkarte eingefügt und aktiviert wird.

Hinweise

Die CMFCTabCtrl Klasse unterstützt Folgendes:

  • Formatvorlagen für Registerkartensteuerelemente, die 3D, flach und flach mit einer freigegebenen horizontalen Bildlaufleiste enthalten.

  • Registerkarten, die sich am oberen oder unteren Rand des Fensters befinden.

  • Registerkarten, die Text, Bilder oder Text und Bilder anzeigen.

  • Registerkarten, die farbe ändern, wenn die Registerkarte aktiv ist.

  • Die Rahmengröße ändert sich für anpassbare Registerkarten.

  • Trennende Fenster mit Registerkarten.

Die CMFCTabCtrl Klasse kann mit einem Dialogfeld verwendet werden, ist jedoch für Anwendungen vorgesehen, die Andocksteuerungsleisten wie Microsoft Excel und Visual Studio verwenden. Weitere Informationen finden Sie unter CDockablePane "Klasse".

Führen Sie die folgenden Schritte aus, um ein anpassbares Steuerelement für das Andocken der Registerkarte in Ihrer Anwendung hinzuzufügen:

  1. Erstellen Sie eine Instanz der CTabbedPane Klasse.

  2. Rufen Sie CDockablePane::Create auf.

  3. Verwenden CBaseTabbedPane::AddTab oder CMFCBaseTabCtrl::InsertTab hinzufügen sie neue Registerkarten.

  4. Rufen Sie CBasePane::EnableDocking an, damit das aktuelle Docking-Tab-Steuerelement im Hauptframefenster andocken kann.

  5. Rufen Sie CFrameWndEx::DockPane auf, um das Fenster "Registerkarten" am Hauptrahmen anzudocken.

Ein Beispiel zum Erstellen eines Registerkartenfensters als Andocksteuerungsleiste finden Sie unter CTabbedPane "Klasse". Um als nicht andockbares Steuerelement zu verwenden CMFCTabCtrl , erstellen Sie ein CMFCTabCtrl Objekt, und rufen Sie dann auf CMFCTabCtrl::Create.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCTabCtrl

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie verschiedene Methoden in der CMFCTabCtrl Klasse zum Konfigurieren eines CMFCTabCtrl Objekts verwendet werden. Im Beispiel wird erläutert, wie Sie eine Registerkarte hinzufügen, die Schaltfläche "Schließen" auf der aktiven Registerkarte anzeigen, bearbeitbare Registerkartenbeschriftungen aktivieren und ein Popupmenü mit Beschriftungen im Registerkartenfenster anzeigen. Dieses Beispiel ist Teil des State Collection-Beispiels.

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

Anforderungen

Kopfball: afxtabctrl.h

CMFCTabCtrl::ActivateMDITab

Zeigt die angegebene Registerkarte des aktuellen Registerkartensteuerelements an und legt den Fokus auf dieser Registerkarte fest.

void ActivateMDITab(int nTab = -1);

Parameter

nTab
[in] Der nullbasierte Index einer anzuzeigenden Registerkarte oder -1, um die aktuell aktive Registerkarte anzugeben.

CMFCTabCtrl::AllowDestroyEmptyTabbedPane

Ausführliche Informationen finden Sie im Quellcode im Ordner mfc Ihrer Visual Studio-Installation. Beispiel: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

virtual BOOL AllowDestroyEmptyTabbedPane() const;

Rückgabewert

Immer TRUE.

Hinweise

CMFCTabCtrl::AutoSizeWindow

Gibt an, ob das Framework die Größe des Clientbereichs aller Registerkartensteuerungsfenster ändern soll, wenn sich ein Benutzeroberflächenelement des Registerkartensteuerelements ändert.

void AutoSizeWindow(BOOL bAutoSize = TRUE);

Parameter

bAutoSize
[in] TRUE um die Größe von Registerkarten-Steuerelementfenstern automatisch zu ändern; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::Create

Erstellt das Registersteuerelement und fügt es an das CMFCTabCtrl Objekt an.

BOOL Create(
    Style style,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    Location location=LOCATION_BOTTOM,
    BOOL bCloseBtn=FALSE);

Parameter

style
[in] Die Formatvorlage des Registerkartensteuerelements. Weitere Informationen finden Sie in den Hinweisen.

rect
[in] Ein Rechteck, das das Registersteuerelement begrenzt.

pParentWnd
[in] Ein Zeiger auf ein übergeordnetes Fenster. Dieser Wert darf nicht NULL sein.

nID
[in] Die ID des Registerkartensteuerelements.

location
[in] Die Position von Registerkarten. Der Standardwert ist LOCATION_BOTTOM. Weitere Informationen finden Sie in den Hinweisen.

bCloseBtn
[in] TRUE um eine Schaltfläche "Schließen" auf der Registerkarte anzuzeigen; andernfalls . FALSE Der Standardwert ist FALSE.

Rückgabewert

TRUE bei Erfolg, andernfalls FALSE.

Hinweise

In der folgenden Tabelle werden die Werte beschrieben, die Sie für den style Parameter angeben können.

Style Beschreibung
STYLE_3D Erstellt ein Registerkartensteuerelement mit dreidimensionaler Darstellung.
STYLE_FLAT Erstellt ein Registerkartensteuerelement mit flachen Registerkarten.
STYLE_FLAT_SHARED_HORZ_SCROLL Erstellt ein Registerkartensteuerelement mit flachen Registerkarten und einer Bildlaufleiste, die die Registerkarten scrollen kann, wenn sie von einem übergeordneten Fenster abgeschnitten werden.
STYLE_3D_ONENOTE Erstellt ein Registerkartensteuerelement im Stil von Microsoft OneNote.
STYLE_3D_VS2005 Erstellt ein Registerkartensteuerelement im Stil von Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED Erstellt ein Registerkartensteuerelement mit abgerundeten Registerkarten im Stil von Microsoft Visual Studio 2005.
STYLE_3D_ROUNDED_SCROLL Erstellt ein Registerkartensteuerelement mit abgerundeten Registerkarten und Bildlaufschaltflächen im Stil von Microsoft Visual Studio 2005.

In der folgenden Tabelle sind die Werte aufgeführt, die Sie für den location Parameter angeben können.

Standort Beschreibung
LOCATION_BOTTOM Registerkarten befinden sich am unteren Rand des Registerkartensteuerelements.
LOCATION_TOP Registerkarten befinden sich am oberen Rand des Registerkartensteuerelements.

Beispiel

Im folgenden Beispiel wird die Verwendung der Create Methode in der CMFCTabCtrl Klasse veranschaulicht. Dieses Beispiel ist Teil des State Collection-Beispiels.

CMFCTabCtrl m_wndTabs;
// Create tabs window:
// CRect rectDummy
// this is a pointer to a parent window
// fourth parameter is the id of the tab control
if (!m_wndTabs.Create (CMFCTabCtrl::STYLE_FLAT, rectDummy, this, 1))
{
    TRACE0("Failed to create output tab window\n");
    return -1;      // fail to create
}

CMFCTabCtrl::CalcRectEdit

Vergrößert die Größe des angegebenen Registerkartenbereichs.

virtual void CalcRectEdit(CRect& rectEdit);

Parameter

rectEdit
[in] Ein Rechteck, das den Bereich einer Registerkarte angibt.

Hinweise

Diese Methode wird aufgerufen, wenn Sie die Beschriftung einer Registerkarte ändern. Mit dieser Methode wird die linke und rechte Seite des angegebenen Rechtecks um eine Hälfte der aktuellen Tabstopphöhe aufgeblasen und die obere und untere Seite um eine Einheit aufgeblasen.

CMFCTabCtrl::EnableActiveTabCloseButton

Blendet eine Schaltfläche "Schließen " ( X) auf der aktiven Registerkarte ein oder aus.

void EnableActiveTabCloseButton(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE um die Schaltfläche "Schließen" auf der aktiven Registerkarte anzuzeigen; FALSE um die Schaltfläche "Schließen" in der oberen rechten Ecke des Registerkartenbereichs anzuzeigen. Der Standardwert ist TRUE.

CMFCTabCtrl::EnableInPlaceEdit

Aktiviert oder deaktiviert bearbeitbare Registerkartenbeschriftungen.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parameter

bEnable
[in] TRUE um bearbeitbare Registerkartenbeschriftungen zu aktivieren; FALSE um bearbeitbare Registerkartenbeschriftungen zu deaktivieren.

Hinweise

CMFCTabCtrl::EnableTabDocumentsMenu

Schaltet zwischen einer Benutzeroberfläche um, die zwei Schaltflächen zum Scrollen der Fensterregister verwendet, und einer Benutzeroberfläche, die ein Popupmenü mit Registerkartenfenstern anzeigt.

void EnableTabDocumentsMenu(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE zum Anzeigen eines Popupmenüs mit Fensterbeschriftungen im Registerkartenformat; FALSE um Vorwärts- und Rückwärtslaufschaltflächen anzuzeigen. Der Standardwert ist TRUE.

Hinweise

Wenn der Benutzer auf eine Registerkartenbeschriftung klickt, zeigt das Framework das entsprechende Fenster mit Registerkartenformat an. Wenn die Registerkartenbeschriftung sichtbar ist, wird das Fenster mit Registerkartenformat geöffnet, ohne seine Position zu ändern. Wenn der Benutzer ein Dokument aus dem Popupmenü auswählt und das entsprechende Fenster im Registerkartenformat auf dem Bildschirm angezeigt wird, wird das Fenster im Registerkartenformat zur ersten Registerkarte.

CMFCTabCtrl::EnsureVisible

Stellt sicher, dass eine Registerkarte sichtbar ist.

virtual BOOL EnsureVisible(int iTab);

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

Rückgabewert

TRUE wenn dies erfolgreich ist; FALSE wenn der iTab Parameterindex ungültig ist.

Hinweise

Verwenden Sie diese Methode, um sicherzustellen, dass die angegebene Registerkarte sichtbar ist. Das Registerkartensteuerelement führt einen Bildlauf durch, wenn es erforderlich ist.

CMFCTabCtrl::GetDocumentIcon

Ruft das Bild ab, das einer Registerkarte in einem Popupmenü mit Registerkartenfenstern zugeordnet ist.

static HICON __stdcall GetDocumentIcon(UINT nCmdID);

Parameter

nCmdID
[in] Die Befehls-ID einer Registerkarte in einem Popupmenü mit Registerkartenfenstern.

Rückgabewert

Das Handle eines Bitmapbilds.

CMFCTabCtrl::GetFirstVisibleTabNum

Ruft den Index der ersten Registerkarte ab, die im aktuellen Registerkartensteuerelement sichtbar ist.

virtual int GetFirstVisibleTabNum() const;

Rückgabewert

Der nullbasierte Index einer Registerkarte im Registerkartensteuerelement.

Hinweise

Verwenden Sie diese Methode nur, wenn das Registerkartensteuerelement im Stil von Microsoft OneNote angezeigt wird. Verwenden Sie die CMFCTabCtrl::IsOneNoteStyle Methode, um die Formatvorlage zu bestimmen.

CMFCTabCtrl::GetResizeMode

Ruft einen Wert ab, der angibt, wie die Größe des aktuellen Registerkartensteuerelements geändert werden kann.

ResizeMode GetResizeMode() const;

Rückgabewert

Einer der Enumerationswerte, der CMFCTabCtrl::ResizeMode angibt, wie die Größe des Registerkartensteuerelements geändert werden kann. Eine Liste der möglichen Werte finden Sie im Abschnitt "Hinweise" der CMFCTabCtrl::SetResizeMode Methode.

CMFCTabCtrl::GetScrollBar

Ruft einen Zeiger auf das Bildlaufleistenobjekt ab, das dem Registersteuerelement zugeordnet ist.

CScrollBar* GetScrollBar();

Rückgabewert

Ein Zeiger auf ein Bildlaufleistenobjekt oder ein NULL , wenn das Registersteuerelement nicht mithilfe der STYLE_FLAT_SHARED_HORZ_SCROLL Formatvorlage erstellt wurde.

Hinweise

Verwenden Sie diese Methode, um auf die eingebettete Bildlaufleiste des Registerkartensteuerelements zuzugreifen. Ein Bildlaufleistenobjekt wird nur erstellt, wenn das Registerkartensteuerelement über die STYLE_FLAT_SHARED_HORZ_SCROLL Formatvorlage verfügt.

CMFCTabCtrl::GetTabArea

Ruft das umgebende Rechteck des Registerkartenbezeichnungsbereichs am oberen oder unteren Rand des Registerkartensteuerelements ab.

void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const;

Parameter

rectTabAreaTop
[out] Wenn diese Methode zurückgegeben wird, enthält dieser Verweis ein Rechteck, das den oberen Bereich der Registerkartenbezeichnung begrenzt. Das Rechteck befindet sich in Clientkoordinaten. Dieser Verweis ist leer, wenn am oberen Rand des Registerkartensteuerelements kein Registerkartenbezeichnungsbereich vorhanden ist.

rectTabAreaBottom
[out] Wenn diese Methode zurückgegeben wird, enthält dieser Verweis ein Rechteck, das den unteren Bereich der Registerkartenbezeichnung begrenzt. Das Rechteck befindet sich in Clientkoordinaten. Dieser Verweis ist leer, wenn am unteren Rand des Registerkartensteuerelements kein Registerkartenbezeichnungsbereich vorhanden ist.

Hinweise

Verwenden Sie diese Methode, um die Größe und Position des Registerkartenbereichs im Registerkartenfenster zu bestimmen.

CMFCTabCtrl::GetTabMaxWidth

Ruft die maximale Breite einer Registerkarte ab.

int GetTabMaxWidth() const;

Rückgabewert

Maximale Breite einer Registerkarte in Pixel. Wenn der Rückgabewert 0 ist, ist die Registerkartenbreite unbegrenzt.

Hinweise

Verwenden Sie die CMFCTabCtrl::SetTabMaxWidth-Methode, um die maximale Registerkartenbreite festzulegen.

CMFCTabCtrl::GetTabsHeight

Ruft die Höhe des Registerkartenbereichs des aktuellen Registerkartensteuerelements ab.

virtual int GetTabsHeight() const;

Rückgabewert

Die Höhe des Registerkartenbereichs, wenn eine Registerkarte sichtbar ist, oder null, wenn keine Registerkarte sichtbar ist.

CMFCTabCtrl::GetTabsRect

Ruft ein Rechteck ab, das den Registerkartenbereich des aktuellen Registerkartensteuerelements begrenzt.

virtual void GetTabsRect(CRect& rect) const;

Parameter

rect
[out] Wenn diese Methode zurückgegeben wird, enthält der rect Parameter ein Rechteck, das den Registerkartenbereich begrenzt.

CMFCTabCtrl::GetWndArea

Ruft die Grenze des Clientbereichs des aktuellen Registerkartensteuerelements ab.

void GetWndArea(CRect& rect) const;

Parameter

rect
[in, out] Wenn diese Methode zurückgegeben wird, enthält dieser Parameter ein Rechteck, das das aktuelle Registersteuerelement begrenzt.

Hinweise

CMFCTabCtrl::HideActiveWindowHorzScrollBar

Blendet die horizontale Bildlaufleiste (sofern vorhanden) im aktiven Fenster aus.

void HideActiveWindowHorzScrollBar();

Hinweise

Verwenden Sie diese Methode, um zu verhindern, dass das Registerkartensteuerelement blinkt, wenn der Benutzer zwischen Registerkartensteuerelementseiten wechselt.

CMFCTabCtrl::HideInactiveWindow

Gibt an, ob das Framework inaktive Registerkarten-Steuerelementfenster anzeigt.

void HideInactiveWindow(BOOL bHide = TRUE);

Parameter

bHide
[in] TRUE kein inaktives Fenster anzeigen; FALSE um ein inaktives Fenster anzuzeigen. Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::HideNoTabs

Aktiviert oder deaktiviert die Zeichnung des Registerkartenbereichs, wenn keine sichtbaren Registerkarten vorhanden sind.

void HideNoTabs(BOOL bHide=TRUE);

Parameter

bHide
[in] TRUE um das Zeichnen des Registerkartenbereichs zu aktivieren; FALSE zum Deaktivieren der Zeichnung. Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::HideSingleTab

Aktiviert oder deaktiviert die Registerkartenzeichnung, wenn ein einzelnes Registerkartenfenster vorhanden ist.

virtual void HideSingleTab(BOOL bHide=TRUE);

Parameter

bHide
[in] TRUE um keine Registerkarte für ein einzelnes Registerkartenfenster zu zeichnen; FALSE um eine einzelne Registerkarte zu zeichnen. Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::IsActiveInMDITabGroup

Gibt an, ob die aktuelle Registerkarte eines Registerkartensteuerelements die aktive Registerkarte in einer Gruppe mit mehreren Dokumentoberflächen-Registerkarten ist.

BOOL IsActiveInMDITabGroup() const;

Rückgabewert

TRUEwenn die aktuelle Registerkarte eines Registerkartensteuerelements die aktive Registerkarte in einer MDI-Registerkartengruppe ist; andernfalls . FALSE

Hinweise

Sie können mehrere Dokumentfenster in vertikalen oder horizontalen Registerkartengruppen organisieren und Dokumente ganz einfach von einer Registerkartengruppe zu einer anderen gruppieren.

CMFCTabCtrl::IsActiveTabBoldFont

Gibt an, ob der Text der aktiven Registerkarte mit einer fett formatierten Schriftart angezeigt wird.

BOOL IsActiveTabBoldFont() const;

Rückgabewert

TRUEwenn die aktive Registerkarte mit der fett formatierten Schriftart angezeigt wird; andernfalls . FALSE

Hinweise

Verwenden Sie die CMFCTabCtrl::SetActiveTabBoldFont Methode, um die aktive Registerkartenschriftart zu ändern.

CMFCTabCtrl::IsActiveTabCloseButton

Gibt an, ob die Schaltfläche "Schließen " ( X) auf einer aktiven Registerkarte oder in der oberen rechten Ecke des Registerkartenbereichs angezeigt wird.

virtual BOOL IsActiveTabCloseButton() const;

Rückgabewert

TRUEwenn die Schaltfläche "Schließen" auf der aktiven Registerkarte angezeigt wird. FALSE Wenn die Schaltfläche "Schließen" in der oberen rechten Ecke des Registerkartenbereichs angezeigt wird.

Hinweise

CMFCTabCtrl::IsDrawFrame

Gibt an, ob das Fenster mit Registerkarten ein Rahmenrechteck um eingebettete Bereiche zeichnet.

BOOL IsDrawFrame() const;

Rückgabewert

TRUEwenn ein Rahmenrechteck gezeichnet wird; andernfalls . FALSE

Hinweise

Verwenden Sie die CMFCTabCtrl::SetDrawFrame Methode, um das Zeichnen eines Rahmenrechtecks zu aktivieren oder zu deaktivieren.

CMFCTabCtrl::IsFlatFrame

Gibt an, ob der Rahmen um den Registerkartenbereich flach oder 3D ist.

BOOL IsFlatFrame() const;

Rückgabewert

TRUE wenn der Rahmen um den Registerkartenbereich flach ist; FALSE wenn der Rahmen dreidimensional ist.

Hinweise

Verwenden Sie die CMFCTabCtrl::SetFlatFrame Methode, um zu ändern, wie der Rahmen gezeichnet wird.

CMFCTabCtrl::IsFlatTab

Gibt an, ob die Darstellung der Registerkarten im aktuellen Registerkartensteuerelement flach ist oder nicht.

virtual BOOL IsFlatTab() const;

Rückgabewert

TRUEwenn die Darstellung der Registerkarten im aktuellen Registerkartensteuerelement flach ist; andernfalls . FALSE

CMFCTabCtrl::IsLeftRightRounded

Gibt an, ob die Darstellung der linken und rechten Seite einer Registerkarte im aktuellen Registerkartensteuerelement gerundet ist.

virtual BOOL IsLeftRightRounded() const;

Rückgabewert

TRUEwenn die Seiten der einzelnen Registerkarten abgerundet werden; andernfalls . FALSE

CMFCTabCtrl::IsMDITabGroup

Gibt an, ob das aktuelle Registerkartensteuerelement im Clientbereich eines Mehrdokument-Schnittstellenfensters enthalten ist.

virtual BOOL IsMDITabGroup() const;

Rückgabewert

TRUEwenn sich das aktuelle Registerkartensteuerelement in einem MDI-Clientbereichsfenster befindet; andernfalls . FALSE

CMFCTabCtrl::IsOneNoteStyle

Gibt an, ob das aktuelle Registerkartensteuerelement im Stil von Microsoft OneNote angezeigt wird.

virtual BOOL IsOneNoteStyle() const;

Rückgabewert

TRUEwenn das Registerkartensteuerelement im Stil von Microsoft OneNote angezeigt wird; andernfalls . FALSE

CMFCTabCtrl::IsSharedScroll

Gibt an, ob das aktuelle Registerkartensteuerelement über eine Bildlaufleiste verfügt, die die Registerkarten als Gruppe scrollen kann.

BOOL IsSharedScroll() const;

Rückgabewert

TRUEwenn das Registerkartensteuerelement über eine freigegebene Bildlaufleiste verfügt; andernfalls . FALSE

Hinweise

Diese Methode gibt zurück TRUE , wenn der style Parameter der CMFCTabCtrl::Create Methode ist STYLE_FLAT_SHARED_HORZ_SCROLL.

CMFCTabCtrl::IsTabDocumentsMenu

Gibt an, ob das Registerkartensteuerelement Bildlaufschaltflächen oder eine Schaltfläche anzeigt, die ein Menü mit Registerkartenfenstern anzeigt.

BOOL IsTabDocumentsMenu() const;

Rückgabewert

TRUE wenn Fenster im Registerkartenformat mithilfe eines Popupmenüs mit Beschriftungen im Registerkartenfenster gescrollt werden; FALSE wenn Fenster im Registerkartenformat mithilfe von Vorwärts- und Rückwärts-Bildlaufschaltflächen gescrollt werden.

Hinweise

Verwenden Sie die CMFCTabCtrl::EnableTabDocumentsMenu Methode, um die Methode des Scrollens von Fenstern im Registerkartenformat anzugeben.

CMFCTabCtrl::IsVS2005Style

Gibt an, ob Registerkarten mit dem Stil von Visual Studio 2005 gezeichnet werden.

virtual BOOL IsVS2005Style() const;

Rückgabewert

TRUEwenn Registerkarten mit der Formatvorlage von Visual Studio 2005 gezeichnet werden; andernfalls . FALSE

Hinweise

Verwenden Sie den style Parameter der CMFCTabCtrl::Create Methode, um anzugeben, wie Registerkarten gezeichnet werden.

CMFCTabCtrl::m_bEnableActivate

Verhindert, dass die aktive Ansicht den Fokus verliert, wenn eine neue Registerkarte eingefügt und aktiviert wird.

static BOOL m_bEnableActivate;

Hinweise

Der Fokus wird in der Regel von einem neuen Registerkartenfenster übernommen, wenn die Registerkarte eingefügt und aktiv gemacht wird. Legen Sie die CMFCTabCtrl::m_bEnableActivate Membervariable fest, um FALSE den ursprünglichen Fokus beizubehalten. Der Standardwert ist TRUE.

CMFCTabCtrl::ModifyTabStyle

Gibt die Darstellung von Registerkarten im aktuellen Registerkartensteuerelement an.

BOOL ModifyTabStyle(Style style);

Parameter

style
[in] Einer der Enumerationswerte, die die Darstellung des Registerkartensteuerelements angibt. Weitere Informationen finden Sie in der Tabelle in den Anmerkungen.

Rückgabewert

Immer TRUE.

Hinweise

Der Wert des style Parameters kann eine der folgenden CMFCTabCtrl::Style Enumerationen sein.

Name Beschreibung
STYLE_3D Zeigt dreidimensionale rechteckige Registerkarten mit runden Ecken an.
STYLE_3D_ONENOTE Zeigt dreidimensionale Registerkarten mit einer vertikalen Seite und einer schrägen Seite an, die abgerundete Ecken aufweisen.
STYLE_3D_ROUNDED Zeigt dreidimensionale Registerkarten mit schrägen Seiten und abgerundeten Ecken an.
STYLE_3D_ROUNDED_SCROLL Zeigt dreidimensionale Registerkarten mit schrägen Seiten und abgerundeten Ecken an. Wenn mehr Registerkarten vorhanden sind, als gleichzeitig angezeigt werden können, zeigt das Framework einen Dropdownpfeil und ein Menü mit Registerkarten an, um aktiv zu werden.
STYLE_3D_SCROLLED Zeigt dreidimensionale rechteckige Registerkarten an. Wenn mehr Registerkarten vorhanden sind, als gleichzeitig angezeigt werden können, zeigt das Framework einen Dropdownpfeil und ein Menü mit Registerkarten an, um aktiv zu werden.
STYLE_3D_VS2005 Zeigt dreidimensionale, abgerundete Registerkarten mit einer schrägen Seite und einer vertikalen Seite an.
STYLE_FLAT Zeigt zweidimensionale Registerkarten an, die links und rechts geneigt sind.
STYLE_FLAT_SHARED_HORZ_SCROLL Zeigt zweidimensionale Registerkarten an. Wenn mehr Registerkarten vorhanden sind, als gleichzeitig angezeigt werden können, zeigt das Framework Bildlaufpfeile am Ende des Registerkartenbereichs an.

CMFCTabCtrl::OnDragEnter

Wird während eines Drag-and-Drop-Vorgangs vom Framework aufgerufen, wenn der Cursor zuerst in das Fenster des aktuellen Registersteuerelements wechselt.

virtual DROPEFFECT OnDragEnter(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameter

pDataObject
[in] Verweist auf ein Datenobjekt, das Daten enthält, die der Benutzer zieht.

dwKeyState
[in] Enthält den Status der Zusatztasten. Dieser Parameter ist eine bitweise Kombination "oder" (|) der folgenden Werte: MK_CONTROL, , MK_SHIFTMK_ALT, MK_LBUTTON, , MK_MBUTTONund MK_RBUTTON. Weitere Informationen finden Sie im Abschnitt "Nachrichtenparameter " von "Informationen zur Mauseingabe".

point
[in] Enthält die aktuelle Position des Cursors in Clientkoordinaten.

Rückgabewert

Immer DROPEFFECT_NONE, was bedeutet, dass das Drop-Ziel die Daten nicht akzeptieren kann.

Hinweise

Verwenden Sie diese Methode, um einen Drag-and-Drop-Vorgang zu unterstützen. Überschreiben Sie diese Methode, um Ihr eigenes benutzerdefiniertes Verhalten zu implementieren.

Standardmäßig ruft diese Methode nur auf CMFCTabCtrl::OnDragOver, was immer zurückgegeben wird DROPEFFECT_NONE.

CMFCTabCtrl::OnDragOver

Wird während eines Ziehvorgangs vom Framework aufgerufen, wenn die Maus über das Drop-Zielfenster verschoben wird.

virtual DROPEFFECT OnDragOver(
    COleDataObject* pDataObject,
    DWORD dwKeyState,
    CPoint point);

Parameter

pDataObject
[in] Zeiger auf ein COleDataObject Objekt, das über das Drop-Ziel gezogen wird.

dwKeyState
[in] Der Zustand der Modifizierertasten, die eine bitweise Kombination "oder" (|) von MK_CONTROL, , MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONund MK_RBUTTON. Weitere Informationen finden Sie unter "Nachrichtenparameter" in "Informationen zur Mauseingabe".

point
[in] Die aktuelle Mausposition.

Rückgabewert

Immer DROPEFFECT_NONE.

Hinweise

Überschreiben Sie diese Methode mit Ihrer benutzerdefinierten Implementierung. Weitere Informationen finden Sie unter der Methode CView::OnDragOver.

CMFCTabCtrl::OnShowTabDocumentsMenu

Zeigt ein Popupmenü mit Registerkartenfenstern an, wartet, bis der Benutzer eine Registerkarte auswählt und die ausgewählte Registerkarte zur aktiven Registerkarte macht.

virtual void OnShowTabDocumentsMenu(CPoint point);

Parameter

point
[in] Die Koordinaten, an denen das Popupmenü angezeigt werden soll.

Hinweise

CMFCTabCtrl::SetActiveInMDITabGroup

Legt die aktuelle Registerkarte eines Registerkartensteuerelements als aktive Registerkarte in einer Gruppe mit mehreren Dokumentoberflächen-Registerkarten fest.

void SetActiveInMDITabGroup(BOOL bActive);

Parameter

bActive
[in] TRUE um die aktuelle Registerkarte zur aktiven Registerkarte zu machen; FALSE um die aktuelle Registerkarte inaktiv zu machen.

Hinweise

Sie können mehrere Dokumentfenster in vertikalen oder horizontalen Registerkartengruppen organisieren und Dokumente ganz einfach von einer Registerkartengruppe zu einer anderen gruppieren.

CMFCTabCtrl::SetActiveTab

Aktiviert eine Registerkarte.

virtual BOOL SetActiveTab(int iTab);

Parameter

iTab
[in] Gibt den nullbasierten Index der zu aktivierenden Registerkarte an.

Rückgabewert

TRUE wenn die angegebene Registerkarte aktiv wurde; FALSE wenn der angegebene iTab Parameterwert ungültig ist.

Hinweise

Dadurch wird die AFX_WM_CHANGE_ACTIVE_TAB Benachrichtigung an das übergeordnete Fenster und den Frame des übergeordneten Steuerelements gesendet.

Die SetActiveTab Methode ruft die CMFCTabCtrl::HideActiveWindowHorzScrollBar Methode automatisch auf, um zu verhindern, dass der Bildschirm blinkt.

CMFCTabCtrl::SetActiveTabBoldFont

Aktiviert oder deaktiviert die Verwendung einer fett formatierten Schriftart auf aktiven Registerkarten.

void SetActiveTabBoldFont(BOOL bIsBold=TRUE);

Parameter

bIsBold
[in] TRUE um eine fett formatierte Schriftart zum Anzeigen der Beschriftung der aktiven Registerkarte zu verwenden; FALSE um die Standardschriftart zum Anzeigen der Beschriftung zu verwenden. Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::SetDrawFrame

Gibt an, ob ein Rahmenrechteck um einen eingebetteten Balken gezeichnet wird.

void SetDrawFrame(BOOL bDraw=TRUE);

Parameter

bDraw
[in] TRUE um ein Rahmenrechteck um einen eingebetteten Balken anzuzeigen; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::SetFlatFrame

Gibt an, ob ein flacher oder ein 3D-Frame um den Registerkartenbereich gezeichnet werden soll.

void SetFlatFrame(
    BOOL bFlat=TRUE,
    BOOL bRepaint=TRUE);

Parameter

bFlat
[in] TRUE um einen flachen (2D)-Rahmen um den Tabstoppbereich zu zeichnen; FALSE um einen dreidimensionalen (3D)-Frame zu zeichnen. Der Standardwert ist TRUE.

bRepaint
[in] TRUE das Fenster sofort neu zu zeichnen; andernfalls . FALSE Der Standardwert ist TRUE.

Hinweise

CMFCTabCtrl::SetImageList

Gibt eine Bildliste an.

virtual BOOL SetImageList(
    UINT uiID,
    int cx=15,
    COLORREF clrTransp=RGB(255, 0, 255));

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parameter

uiID
[in] Die ID einer Bitmapressource, die die Bildliste enthält.

cx
[in] Die Breite der einzelnen Bilder in Pixeln. Der Standardwert lautet 15.

clrTransp
[in] Die transparente Bildfarbe. Die Teile des Bilds, die diese Farbe sind, sind transparent. Der Standardwert ist die Farbe Magenta, RGB(255,0,255).

hImageList
[in] Ein Handle für eine vorinstallierte Bildliste.

Rückgabewert

TRUE wenn diese Methode erfolgreich ist. FALSE wenn das Registerkartensteuerelement mithilfe einer flachen Formatvorlage erstellt wird oder wenn die erste Methodenüberladung die durch den uiID Parameter angegebene Bitmap nicht laden kann.

Hinweise

Verwenden Sie diese Methode, um eine Bildliste für das Registerkartensteuerelement festzulegen. Die Bilder aus der Bildliste werden neben der Registerkartenbezeichnung angezeigt. Mit dieser Methode wird die Registerkartenhöhe neu berechnet, sodass die Größe der Registerkarte so angepasst wird, dass sie sowohl das Bild als auch den Text enthält.

Verwenden Sie die CMFCBaseTabCtrl::AddTab Methode, die vom Registersteuerelement geerbt wird, um den Index des anzuzeigenden Bilds anzugeben.

CMFCTabCtrl::SetResizeMode

Gibt an, wie die Größe des aktuellen Registerkartensteuerelements geändert werden kann, und zeigt das Steuerelement dann erneut an.

void SetResizeMode(ResizeMode resizeMode);

Parameter

resizeMode
[in] Einer der Enumerationswerte, der CMFCTabCtrl::ResizeMode angibt, wie die Größe des Registerkartensteuerelements geändert werden kann. Eine Liste der möglichen Werte finden Sie in der Tabelle in den Hinweisen.

Hinweise

Der Parameter "resizeMode " kann einer der folgenden ResizeMode Enumerationswerte sein:

Name Beschreibung
RESIZE_NO Die Größe des Registerkartensteuerelements kann nicht geändert werden.
RESIZE_VERT Das Registerkartensteuerelement kann vertikal, aber nicht horizontal angepasst werden.
RESIZE_HORIZ Das Registerkartensteuerelement kann horizontal, aber nicht vertikal angepasst werden.

CMFCTabCtrl::SetTabMaxWidth

Gibt die maximale Registerkartenbreite in einem Registerkartenfenster an.

void SetTabMaxWidth(int nTabMaxWidth);

Parameter

nTabMaxWidth
[in] Die maximale Registerkartenbreite in Pixel.

Hinweise

Verwenden Sie diese Methode, um die Breite der einzelnen Registerkarten in einem Fenster mit Registerkartenformat einzuschränken. Diese Methode ist nützlich, wenn Registerkarten sehr lange Beschriftungen aufweisen. Der CMFCTabCtrl Klassenkonstruktor initialisiert die maximale Registerkartenbreite auf 0, was bedeutet, dass die Breite nicht beschränkt ist.

CMFCTabCtrl::StopResize

Beendet den aktuellen Größenänderungsvorgang im Registerkartensteuerelement.

void StopResize(BOOL bCancel);

Parameter

bCancel
[in] TRUE um den aktuellen Größenänderungsvorgang aufzugeben; FALSE um den aktuellen Größenänderungsvorgang abzuschließen. In beiden Fällen beendet das Framework das Zeichnen des Rechtecks zur Größenänderung.

CMFCTabCtrl::SynchronizeScrollBar

Zeichnet eine horizontale Bildlaufleiste auf einem Registerkartensteuerelement, das flache Registerkarten anzeigt.

BOOL SynchronizeScrollBar(SCROLLINFO* pScrollInfo = NULL);

Parameter

pScrollInfo
[out] Zeiger auf eine SCROLLINFO Struktur oder NULL. Wenn diese Methode zurückgegeben wird und dieser Parameter nicht NULLder Fall ist, enthält die Struktur alle Parameter der Bildlaufleiste. Der Standardwert ist NULL.

Rückgabewert

TRUEwenn diese Methode erfolgreich ist; andernfalls . FALSE

Hinweise

Diese Methode wirkt sich nur auf ein Registerkartensteuerelement aus, das flache Registerkarten anzeigt. Die Bildlaufleiste beeinflusst alle Registerkarten gleichzeitig.

Weitere Informationen

Hierarchiediagramm
Klassen
CDockablePane Klasse
CMFCBaseTabCtrl Klasse