CMFCBaseTabCtrl-Klasse

Artikel
10/12/2023

Implementiert die Basisfunktionalität für Fenster im Registerkartenformat. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

Syntax

class CMFCBaseTabCtrl : public CWnd

Member

Öffentliche Methoden

Name	Beschreibung
CMFCBaseTabCtrl::AddIcon
CMFCBaseTabCtrl::AddTab	Fügt eine neue Registerkarte dem Fenster im Registerkartenformat hinzu.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
CMFCBaseTabCtrl::AutoDestroyWindow
CMFCBaseTabCtrl::CalcRectEdit
CMFCBaseTabCtrl::CleanUp
CMFCBaseTabCtrl::ClearImageList
CMFCBaseTabCtrl::DetachTab	Trennt eine Registerkarte von einem Fenster im Registerkartenformat.
CMFCBaseTabCtrl::EnableActivateLastActive
CMFCBaseTabCtrl::EnableAutoColor	Aktiviert oder deaktiviert die automatische Registerkartenfärbung.
CMFCBaseTabCtrl::EnableCustomToolTips	Aktiviert oder deaktiviert benutzerdefinierte QuickInfos für Registerkarten.
CMFCBaseTabCtrl::EnableInPlaceEdit	Aktiviert oder deaktiviert die direkte Bearbeitung von Registerkartenbezeichnungen.
CMFCBaseTabCtrl::EnableTabDetach	Aktiviert lösbare Registerkarten.
CMFCBaseTabCtrl::EnableTabSwap	Aktiviert oder deaktiviert die Option, mit der der Benutzer die Registerkartenreihenfolge mit der Maus ändern kann.
CMFCBaseTabCtrl::EnsureVisible	Scrollt durch die Registerkarten, bis die angegebene Registerkarte eingeblendet wird. Diese Methode hat keine Auswirkungen, wenn die angegebene Registerkarte bereits eingeblendet wird.
CMFCBaseTabCtrl::EnterDragMode
CMFCBaseTabCtrl::FindTargetWnd	Gibt einen Bereich zurück, der einen angegebenen Punkt enthält.
CMFCBaseTabCtrl::FireChangeActiveTab
CMFCBaseTabCtrl::FireChangingActiveTab
CMFCBaseTabCtrl::GetActiveTab	Gibt den Index der aktiven Registerkarte zurück.
CMFCBaseTabCtrl::GetActiveTabColor	Gibt die Hintergrundfarbe der aktiven Registerkarte zurück.
CMFCBaseTabCtrl::GetActiveTabTextColor	Gibt die Textfarbe der aktiven Registerkarte zurück.
CMFCBaseTabCtrl::GetActiveWnd	Gibt einen Zeiger auf die aktive Seite des Registerkarten-Steuerelements zurück.
CMFCBaseTabCtrl::GetAutoColors	Gibt einen Verweis auf das Array von Farben zurück, das für die automatische Färbung verwendet wird.
CMFCBaseTabCtrl::GetFirstVisibleTab	Gibt einen Zeiger auf die erste eingeblendete Registerkarte zurück.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
CMFCBaseTabCtrl::GetHighlightedTab	Gibt den Index der aktuell hervorgehobenen Registerkarte.
CMFCBaseTabCtrl::GetImageList
CMFCBaseTabCtrl::GetImageSize
CMFCBaseTabCtrl::GetLastVisibleTab
CMFCBaseTabCtrl::GetLocation	Gibt eine Variable vom Datentyp LOCATION zurück, der angibt, wo der Registerkartenbereich in Bezug auf das Registerkarten-Steuerelement positioniert ist. Beispielsweise oben oder unten.
CMFCBaseTabCtrl::GetMaxWindowSize
CMFCBaseTabCtrl::GetTabArea	Gibt die Größe und Position des Registerkartenbereichs im Fenster im Registerkartenformat zurück. Die Position des Registerkartenbereichs wird mithilfe von Koordinaten definiert.
CMFCBaseTabCtrl::GetTabBkColor	Gibt die Hintergrundfarbe der angegebenen Registerkarte zurück.
CMFCBaseTabCtrl::GetTabBorderSize	Gibt die Größe der Registerkartenrahmen im Registerkarten-Steuerelement zurück.
CMFCBaseTabCtrl::GetTabByID	Gibt den Index der Registerkarte zurück, die durch eine angegebene ID bestimmt wird.
CMFCBaseTabCtrl::GetTabCloseButton
CMFCBaseTabCtrl::GetTabFromHwnd	Gibt den Index einer Registerkarte zurück, die ein angegebenes HWND-Objekt enthält.
CMFCBaseTabCtrl::GetTabFromPoint	Gibt die Registerkarte zurück, die einen angegebenen Punkt enthält.
CMFCBaseTabCtrl::GetTabFullWidth
CMFCBaseTabCtrl::GetTabHicon	Gibt das Symbol zurück, das der angegebenen Registerkarte zugeordnet ist.
CMFCBaseTabCtrl::GetTabID	Gibt mit dem Index der Registerkarte die ID einer Registerkarte zurück.
CMFCBaseTabCtrl::GetTabIcon	Gibt die Symbol-ID für eine angegebene Registerkarte zurück.
CMFCBaseTabCtrl::GetTabLabel	Gibt den Text einer angegebene Registerkarte zurück.
CMFCBaseTabCtrl::GetTabRect	Ruft die Größe und Position einer angegebenen Registerkarte ab.
CMFCBaseTabCtrl::GetTabsHeight
CMFCBaseTabCtrl::GetTabsRect
CMFCBaseTabCtrl::GetTabTextColor	Gibt die Textfarbe einer angegebenen Registerkarte zurück.
CMFCBaseTabCtrl::GetTabWnd	Gibt den Zeiger auf einen Bereich zurück, der sich auf einer angegebenen Registerkartenseite befindet.
CMFCBaseTabCtrl::GetTabWndNoWrapper	Gibt den direkten Zeiger auf ein Steuerelement zurück, das sich auf einer angegebenen Registerkartenseite befindet, auch wenn das Steuerelement über einen Wrapper verfügt.
CMFCBaseTabCtrl::GetTabsNum	Gibt die Anzahl der Registerkarten im Registerkarten-Steuerelement zurück.
CMFCBaseTabCtrl::GetToolTipCtrl	Gibt einen Verweis auf das QuickInfo-Steuerelement zurück, das dem `CMFCBaseTabCtrl` -Objekt zugeordnet ist.
CMFCBaseTabCtrl::GetVisibleTabsNum	Gibt die Anzahl eingeblendeter Registerkarten zurück.
CMFCBaseTabCtrl::HasImage
CMFCBaseTabCtrl::HideSingleTab	Legt eine Option fest, mit der eine Fensterregisterkarte ausgeblendet wird. Dies geschieht jedoch nur, wenn das Fenster im Registerkartenformat nur über eine eingeblendete Registerkarte verfügt.
CMFCBaseTabCtrl::InsertTab	Fügt eine neue Registerkarte ein.
CMFCBaseTabCtrl::InvalidateTab
CMFCBaseTabCtrl::IsActiveTabCloseButton
CMFCBaseTabCtrl::IsAutoColor	Gibt einen Wert zurück, der angibt, ob die automatische Färbung für das Fenster im Registerkartenformat aktiviert ist.
CMFCBaseTabCtrl::IsAutoDestroyWindow
CMFCBaseTabCtrl::IsColored
CMFCBaseTabCtrl::IsDialogControl
CMFCBaseTabCtrl::IsDrawNoPrefix
CMFCBaseTabCtrl::IsFlatFrame	Gibt einen Wert zurück, der angibt, ob der Rahmen für den Registerkartenbereich flach oder dreidimensional ist.
CMFCBaseTabCtrl::IsFlatTab
CMFCBaseTabCtrl::IsHideSingleTab	Gibt einen Wert zurück, der angibt, ob das Registerkarten-Steuerelement zum Ausblenden einer Registerkarte konfiguriert ist. Dies ist jedoch nur dann der Fall, wenn ein Fenster im Registerkartenformat über nur eine eingeblendete Registerkarte verfügt.
CMFCBaseTabCtrl::IsIconAdded
CMFCBaseTabCtrl::IsInPlaceEdit	Gibt an, ob Benutzer die Bezeichnung auf einer Registerkarte ändern können.
CMFCBaseTabCtrl::IsLeftRightRounded
CMFCBaseTabCtrl::IsMDITab
CMFCBaseTabCtrl::IsOneNoteStyle	Gibt an, ob die Registerkarten in einem Fenster im Registerkartenformat im Microsoft OneNote-Format angezeigt werden.
CMFCBaseTabCtrl::IsPtInTabArea	Überprüft, ob ein angegebener Punkt im Registerkartenbereich vorhanden ist.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
CMFCBaseTabCtrl::IsTabCloseButtonPressed
CMFCBaseTabCtrl::IsTabDetachable	Gibt an, ob eine Registerkarte gelöst werden kann.
CMFCBaseTabCtrl::IsTabIconOnly	Gibt an, ob Symbole, und keine Bezeichnungen, auf den Registerkarten angezeigt werden sollen.
CMFCBaseTabCtrl::IsTabSwapEnabled	Gibt an, ob Benutzer durch Ziehen von Registerkarten ihre Position ändern können.
CMFCBaseTabCtrl::IsTabVisible	Gibt an, ob eine angegebene Registerkarte eingeblendet wird.
CMFCBaseTabCtrl::IsVS2005Style
CMFCBaseTabCtrl::MoveTab
CMFCBaseTabCtrl::OnChangeTabs	Vom Framework aufgerufen, wenn sich die Anzahl der Registerkarten ändert.
CMFCBaseTabCtrl::OnDragEnter
CMFCBaseTabCtrl::OnDragLeave
CMFCBaseTabCtrl::OnDragOver
CMFCBaseTabCtrl::OnDrop
CMFCBaseTabCtrl::OnRenameTab
CMFCBaseTabCtrl::PreTranslateMessage	Wird von der CWinApp -Klasse verwendet, um Fenstermeldungen zu übersetzen, bevor diese an die Windows-Funktionen TranslateMessage und DispatchMessage gesendet werden. (Überschreibt CWnd::PreTranslateMessage.)
CMFCBaseTabCtrl::RecalcLayout	Berechnet das interne Layout eines Fensters im Registerkartenformat neu.
CMFCBaseTabCtrl::RemoveAllTabs	Entfernt alle Registerkarten aus dem Fenster im Registerkartenformat.
CMFCBaseTabCtrl::RemoveTab	Entfernt alle Registerkarten aus einem Fenster im Registerkartenformat.
CMFCBaseTabCtrl::RenameTab
CMFCBaseTabCtrl::ResetImageList	Setzt die Bildliste zurück, die einem Fenster im Registerkartenformat angefügt ist.
CMFCBaseTabCtrl::Serialize	Liest oder schreibt dieses Objekt aus einem oder in ein Archiv. (Überschreibt CObject::Serialize.)
CMFCBaseTabCtrl::SetActiveTab	Aktiviert eine Registerkarte.
CMFCBaseTabCtrl::SetActiveTabColor	Legt die Hintergrundfarbe für die aktuelle aktive Registerkarte fest.
CMFCBaseTabCtrl::SetActiveTabTextColor	Legt die Textfarbe für aktive Registerkarten fest.
CMFCBaseTabCtrl::SetAutoColors	Legt die anzuwendenden Farben für das Registerkarten-Steuerelement fest, wenn automatische Färbung aktiviert ist.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC	Legt die Wrapperklasse fest, die für nicht von der CDockablePane Classabgeleitete Objekte verwendet wird.
CMFCBaseTabCtrl::SetDrawNoPrefix	Aktiviert und deaktiviert die Verarbeitung von Präfixzeichen, wenn die Registerkartenbezeichnungen gezeichnet werden.
CMFCBaseTabCtrl::SetImageList	Legt die Symbolbildliste fest.
CMFCBaseTabCtrl::SetLocation
CMFCBaseTabCtrl::SetTabBkColor	Legt die Hintergrundfarbe für eine angegebene Registerkarte fest.
CMFCBaseTabCtrl::SetTabBorderSize	Legt die Größe für einen neuen Registerkartenrahmen fest.
CMFCBaseTabCtrl::SetTabHicon	Legt ein Registerkartensymbol fest.
CMFCBaseTabCtrl::SetTabIcon	Legt eine Registerkartensymbol-ID fest.
CMFCBaseTabCtrl::SetTabIconOnly	Aktiviert und deaktiviert den „Nur Symbol“-Modus für eine angegebene Registerkarte.
CMFCBaseTabCtrl::SetTabLabel	Legt eine Registerkartenbezeichnung auf einen angegebenen Zeichenfolgenwert fest.
CMFCBaseTabCtrl::SetTabsHeight
CMFCBaseTabCtrl::SetTabTextColor	Legt die Textfarbe für eine angegebene Registerkarte fest.
CMFCBaseTabCtrl::SetTabsOrder	Ordnet die Registerkarten in der angegebenen Reihenfolge an.
CMFCBaseTabCtrl::ShowTab	Blendet die angegebene Registerkarte ein oder aus.
CMFCBaseTabCtrl::StartRenameTab
CMFCBaseTabCtrl::SwapTabs

Geschützte Methoden

Name	Beschreibung
CMFCBaseTabCtrl::CreateWrapper	Erstellt einen Wrapper für ein von CWnd abgeleitetes Objekt, das nicht von `CDockablePane`abgeleitet ist. Um ein `CMFCBaseTabCtrl` -Objekt anzudocken, muss jedes eingebettete Steuerelement entweder über einen andockbaren Wrapper verfügen oder von `CDockablePane`abgeleitet sein. Sie können mit `SetDockingBayWrapperRTC`die Klasse des Wrappers festlegen.

Datenelemente

Name	Beschreibung
CMFCBaseTabCtrl::m_bActivateTabOnRightClick	Gibt an, ob Registerkarten durch Klicken mit der linken oder rechten Maustaste ausgewählt werden.
CMFCBaseTabCtrl::m_bAutoDestroyWindow	Gibt an, ob die Bereiche, die auf den Registerkarten enthalten sind, automatisch entfernt werden.

Hinweise

Die CMFCBaseTabCtrl-Klasse ist eine abstrakte Klasse. Daher kann sie nicht instanziiert werden. Um ein Fenster im Registerkartenformat zu erstellen, müssen die eine Klasse von CMFCBaseTabCtrlableiten. Die MFC-Bibliothek enthält einige Beispiele zu abgeleiteten Klassen, zu denen CMFCTabCtrl Class und CMFCOutlookBarTabCtrl Classzählen.

Ab Visual Studio 2015 unterstützt diese Klasse Microsoft Active Accessibility.

Anpassungstipps

Die folgenden Tipps beziehen sich auf die CMFCBaseTabCtrl Class und alle Klassen, die von dieser erben:

Behalten Sie keine Zeiger auf Fenster im Registerkartenformat, wenn lösbare Registerkarten aktiviert sind. Diese lösbaren Registerkarten können dynamisch erstellt und entfernt werden. Daher können Zeiger ungültig werden.
Sie können das Registerkarten-Steuerelement so konfigurieren, dass Benutzer Registerkarten mit der Maus dynamisch auf ein Registerkarten-Steuerelement verschieben können. Diese Funktionalität ist in der CMFCBaseTabCtrl -Klasse integriert. Rufen Sie CMFCBaseTabCtrl::EnableTabSwapauf, um sie zu aktivieren.
Registerkarten sind standardmäßig lösbar, wenn Sie sie zu einem Registerkarten-Steuerelement hinzufügen. Mit CMFCBaseTabCtrl::AddTabkönnen Sie auch nicht lösbare Registerkarten hinzufügen. Wenn Sie den bDetachable -Parameter auf FALSEfestlegen, wird die Registerkarte zu einer nicht lösbaren Registerkarte. Sie können auch durch Aufrufen der CMFCBaseTabCtrl::EnableTabDetach-Methode festlegen, ob die Registerkarte lösbar sein soll.
Objekte, die von der CWnd Class abgeleitet werden, können auf einer andockbaren Symbolleiste oder Registerkarte platziert werden. Für das gesamte anzudockende Steuerelement muss das CWnd -Objekt andockbar sein. Hierzu verwendet MFC eine Wrapperklasse. Diese Wrapperklasse ist die CDockablePaneAdapter Class. Alle CWnd -Objekte, die zu einer andockbaren Symbolleiste oder Registerkarte hinzugefügt werden, werden in ein CDockablePaneAdapter -Objekt eingebunden. Sie können den automatischen Umbruch deaktivieren, indem Sie den m_bEnableWrapping -Parameter des CMFCBaseTablCtrl -Objekts auf FALSEfestlegen. Sie können auch die Klasse, die die Anwendung als Wrapper verwendet, mit der CMFCBaseTabCtrl::SetDockingBarWrapperRTC-Methode ändern.

Vererbungshierarchie

Anforderungen

Header: afxbasetabctrl.h

CMFCBaseTabCtrl::AddIcon

Fügt ein Symbol in die Liste der Symbole im geschützten CMap m_mapAddedIcons-Member ein.

void AddIcon(
    HICON hIcon,
    int iIcon);

Parameter

hIcon
[in] Ein Handle zum Hinzufügen des Symbols.

iIcon
[in] Nullbasierter Index des Symbols im geschützten CImageList m_Images-Member.

Hinweise

CMFCBaseTabCtrl::AddTab

Fügt dem Registerkartensteuerelement eine neue Registerkarte hinzu.

virtual void AddTab(
    CWnd* pTabWnd,
    LPCTSTR lpszTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void AddTab(
    CWnd* pTabWnd,
    UINT uiResTabLabel,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parameter

pTabWnd
[in] Ein Zeiger auf das Fenster, das diese Methode als neue Registerkarte darstellt.

lpszTabLabel
[in] Eine Zeichenfolge, die die Beschriftung für die neue Registerkarte enthält.

uiImageId
[in] Eine Bild-ID aus der Bildliste. Das Registerkartensteuerelement verwendet dieses Bild als Symbol für die neue Registerkarte.

uiResTabLabel
[in] Die Ressourcen-ID für die Bezeichnung.

bDetachable
[in] Ein boolescher Parameter, der festlegt, ob die neue Registerkarte abtrennbar ist.

Hinweise

Wenn pTabWnd auf ein Objekt zeigt, das nicht von der CDockablePane-Klasse abgeleitet ist und bDetachable TRUE ist, erstellt das Framework automatisch einen Wrapper für das pTabWnd-Objekt. Der Wrapper macht das pTabWnd-Objekt trennbar. Standardmäßig ist der Wrapper eine Instanz der CDockablePaneAdapter-Klasse. Wenn die vom Standardwrapper angebotene Funktionalität inakzeptabel ist, verwenden Sie die CMFCBaseTabCtrl::SetDockingBarWrapperRTC-Methode, um einen anderen Wrapper anzugeben.

CMFCBaseTabCtrl::ApplyRestoredTabInfo

virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);

Parameter

[in] bUseTabIndexes

Hinweise

CMFCBaseTabCtrl::AutoDestroyWindow

void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);

Parameter

[in] bAutoDestroy

Hinweise

CMFCBaseTabCtrl::CalcRectEdit

virtual void CalcRectEdit(CRect& rectEdit);

Parameter

[in] rectEdit

Hinweise

CMFCBaseTabCtrl::CleanUp

virtual void CleanUp();

Hinweise

CMFCBaseTabCtrl::ClearImageList

virtual void ClearImageList();

Hinweise

CMFCBaseTabCtrl::CreateWrapper

Erstellt einen Wrapper für ein Framefenster, das von der CWnd-Klasse abgeleitet wird, aber nicht von der CDockablePane-Klasseabgeleitet wird.

virtual CWnd* CreateWrapper(
    CWnd* pWndToWrap,
    LPCTSTR lpszTabLabel,
    BOOL bDetachable);

Parameter

pWndToWrap
[in] Ein Zeiger auf das Rahmenfenster, das umbrochen wird.

lpszTabLabel
[in] Eine Zeichenfolge, die die Beschriftung für das Fenster enthält.

bDetachable
[in] Ein boolescher Parameter, der angibt, ob das Fenster abtrennbar ist.

Rückgabewert

Ein Zeiger auf einen Wrapper, der von der CDockablePane-Klasse abgeleitet wurde, wenn CreateWrapper erfolgreich eine Wrapperklasse für pWndToWrap erstellt. Wenn die Methode fehlschlägt, wird pWndToWrapzurückgegeben.

Hinweise

Ein Fenster mit Registerkarten kann jedes von CWnd abgeleitete Objekt andocken. Damit ein CMFCBaseTabCtrl Class-Objekt andockbar ist, muss jedoch jedes Objekt auf CMFCBaseTabCtrl abtrennbar sein. Daher umschließt CMFCBaseTabCtrl automatisch alle Objekte, die nicht von CDockablePane abgeleitet werden.

Standardmäßig erstellt CMFCBaseTabCtrl Instanzen der CDockablePaneAdapter-Klasse. Um die Standardklasse des Wrappers zu ändern, rufen Sie CMFCBaseTabCtrl::SetDockingBarWrapperRTC auf.

Wenn pWndToWrap von CDockablePane abgeleitet wird, erstellt diese Methode keinen Wrapper. Stattdessen schlägt sie fehl und gibt pWndToWrapzurück.

CMFCBaseTabCtrl::DetachTab

Das Framework ruft diese Methode auf, um eine Registerkarte vom Registerkartensteuerelement zu trennen.

virtual BOOL DetachTab(
    AFX_DOCK_METHOD dockMethod,
    int nTabNum = -1,
    BOOL bHide = FALSE);

Parameter

dockMethod
[in] Ein enumerierter Datentyp, der von der CBasePane-Klasse bereitgestellt wird. Dieser Datentyp gibt die Methode an, die zum Trennen der Registerkarte verwendet wurde.

nTabNum
[in] Der nullbasierte Index der abzutrennenden Registerkarte.

bHide
[in] Ein boolescher Parameter, der angibt, ob das Framework die abgetrennte Registerkarte ausblenden soll.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Wenn die durch nTabNum angegebene Registerkarte nicht abtrennbar ist, schlägt diese Funktion fehl und gibt FALSE zurück.

CMFCBaseTabCtrl::EnableActivateLastActive

void EnableActivateLastActive(BOOL bLastActive = TRUE);

Parameter

[in] bLastActive

Hinweise

CMFCBaseTabCtrl::EnableAutoColor

Steuert, ob das Framework beim Zeichnen einer Registerkarte die automatischen Hintergrundfarben verwendet.

void EnableAutoColor(BOOL bEnable = TRUE);

Parameter

bEnable
[in] Ein boolescher Parameter, der festlegt, ob das Framework automatische Farben verwendet.

Hinweise

Ein Registerkartensteuerelement hat ein Array mit mehreren vordefinierten Farben. Wenn das Framework automatische Farben verwendet, wird jeder Registerkarte in einer Reihe von Registerkarten die nächste Farbe aus diesem Array zugewiesen.

Standardmäßig werden die automatischen Farben durch die bibliotheksdefinierten Farben bestimmt. Sie können ein benutzerdefiniertes Array von Farben bereitstellen, indem Sie CMFCBaseTabCtrl::SetAutoColors aufrufen.

CMFCBaseTabCtrl::EnableCustomToolTips

Aktiviert benutzerdefinierte QuickInfos für das Registerkartensteuerelement.

BOOL EnableCustomToolTips(BOOL bEnable = TRUE);

Parameter

bEnable
[in] Ein boolescher Wert, der festlegt, ob benutzerdefinierte QuickInfos verwendet werden sollen.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Wenn benutzerdefinierte QuickInfos aktiviert sind, sendet das Registerkartensteuerelement die AFX_WM_ON_GET_TAB_TOOLTIP-Nachricht an den Hauptframe. Wenn Sie in Ihrer Anwendung benutzerdefinierte QuickInfos unterstützen möchten, muss das Hauptframefenster diese Methode verarbeiten und den benutzerdefinierten QuickInfo-Text bereitstellen. Weitere Informationen zum Bereitstellen von benutzerdefiniertem QuickInfo-Text finden Sie unter CMFCTabToolTipInfo Structure.

CMFCBaseTabCtrl::EnableInPlaceEdit

Aktiviert die direkte Bearbeitung der Registerkartenbeschriftungen durch den Benutzer.

virtual void EnableInPlaceEdit(BOOL bEnable) = 0;

Parameter

bEnable
[in] Ein boolescher Parameter, der angibt, ob die direkte Bearbeitung der Registerkartenbeschriftungen aktiviert werden soll.

Hinweise

Standardmäßig ist die direkte Bearbeitung der Registerkartenbeschriftungen für Registerkartensteuerelemente deaktiviert.

Sie können die direkte Bearbeitung für eine Teilmenge der Registerkarten im Registerkartensteuerelement aktivieren. Hierzu überschreiben Sie die Methode CMFCBaseTabCtrl::StartRenameTab. StartRenameTab sollte einen Wert ungleich Null für alle Registerkarten zurückgeben, die die direkte Bearbeitung von Registerkartenbeschriftungen unterstützen.

In CMFCBaseTabCtrl Class ist diese Methode eine reine virtuelle Funktion und hat keine Implementierung. Wenn Sie eine Klasse von CMFCBaseTabCtrl ableiten, müssen Sie diese Funktion implementieren.

CMFCBaseTabCtrl::EnableTabDetach

Aktiviert lösbare Registerkarten.

virtual BOOL EnableTabDetach(
    int iTab,
    BOOL bEnable);

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

bEnable
[in] Ein boolescher Wert, der angibt, ob die Registerkarte abtrennbar ist.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

CMFCBaseTabCtrl::EnableTabSwap

Ermöglicht es dem Benutzer, die Aktivierreihenfolge mithilfe einer Maus zu ändern.

void EnableTabSwap(BOOL bEnable);

Parameter

bEnable
[in] Ein boolescher Wert, der angibt, ob das Austauschen von Registerkarten aktiviert werden soll.

Hinweise

Wenn der Registerkartenwechsel aktiviert ist, kann der Benutzer eine Registerkarte ziehen und seine relative Position in der Registerkartensteuerung ändern.

CMFCBaseTabCtrl::EnsureVisible

Scrollt durch die Registerkarten, bis die angegebene Registerkarte eingeblendet wird.

virtual BOOL EnsureVisible(int iTab);

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Diese Methode hat keine Auswirkung, wenn die durch iTab angegebene Registerkarte bereits sichtbar ist.

Diese Methode wird standardmäßig von CMFCBaseTabCtrl Class nicht unterstützt. Sie sollten diese Funktion in einer benutzerdefinierten Klasse implementieren, die von CMFCBaseTabCtrl abgeleitet wird, wenn dieses benutzerdefinierte Registerkartensteuerelement das Scrollen von Registerkarten unterstützt. Diese Methode wird von der CMFCTabCtrl-Klasse unterstützt.

CMFCBaseTabCtrl::EnterDragMode

void EnterDragMode();

Hinweise

CMFCBaseTabCtrl::FindTargetWnd

Identifiziert den Bereich, der einen angegebenen Punkt enthält.

virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;

Parameter

pt
[in] Ein Punkt, der mithilfe von Clientbereichskoordinaten des CMFCBaseTabCtrl-Objekts definiert wird.

Rückgabewert

Ein Zeiger auf ein CWnd-Objekt bei erfolgreicher Ausführung; andernfalls NULL.

Hinweise

In der CMFCBaseTabCtrl-Klasse ist diese Methode eine rein virtuelle Funktion: Sie müssen sie implementieren, wenn Sie eine Klasse von CMFCBaseTabCtrl ableiten.

CMFCBaseTabCtrl::FireChangeActiveTab

virtual void FireChangeActiveTab(int nNewTab);

Parameter

[in] nNewTab

Hinweise

CMFCBaseTabCtrl::FireChangingActiveTab

virtual BOOL FireChangingActiveTab(int nNewTab);

Parameter

[in] nNewTab

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetActiveTab

Ruft den Index der derzeit aktiven Registerkarte ab.

virtual int GetActiveTab() const;

Rückgabewert

Der nullbasierte Index der aktiven Registerkarte; -1, wenn keine aktive Registerkarte vorhanden ist.

CMFCBaseTabCtrl::GetActiveTabColor

Ruft die Hintergrundfarbe der aktuell aktiven Registerkarte ab.

virtual COLORREF GetActiveTabColor() const;

Rückgabewert

Ein COLORREF-Wert, der die Hintergrundfarbe der aktiven Registerkarte angibt.

Hinweise

Standardmäßig ist die Hintergrundfarbe der aktiven Registerkarte COLOR_WINDOW. Sie können die Hintergrundfarbe für die aktive Registerkarte mithilfe der CMFCBaseTabCtrl::SetActiveTabColor-Methode ändern.

CMFCBaseTabCtrl::GetActiveTabTextColor

Ruft die Textfarbe für die aktive Registerkarte ab.

virtual COLORREF GetActiveTabTextColor() const;

Rückgabewert

Ein COLORREF-Wert, der die Textfarbe der aktiven Registerkarte angibt.

Hinweise

Standardmäßig ist die Textfarbe für aktive Registerkarten COLOR_WINDOWTEXT. Sie können die Textfarbe mit der CMFCBaseTabCtrl::SetActiveTabTextColor-Methode ändern.

CMFCBaseTabCtrl::GetActiveWnd

Ruft einen Zeiger auf das derzeit aktive Registerkartenfenster ab.

virtual CWnd* GetActiveWnd() const;

Rückgabewert

Ein Zeiger auf ein Fenster.

CMFCBaseTabCtrl::GetAutoColors

Ruft das Array der Farben ab, die für die automatische Farbgebung verwendet werden.

const CArray<COLORREF,COLORREF>& GetAutoColors() const;

Rückgabewert

Ein Verweis auf ein Array an COLORREF-Werten, die vom CMFCBaseTabCtrl-Objekt für die automatische Registerkartenfarbe verwendet werden.

Hinweise

Standardmäßig initialisiert das Framework das Array der Farben mit bibliotheksdefinierten Farben. Sie können ein benutzerdefiniertes Farbarray bereitstellen, indem Sie die CMFCBaseTabCtrl::SetAutoColors-Methode aufrufen.

CMFCBaseTabCtrl::GetFirstVisibleTab

Ruft einen Zeiger zur ersten eingeblendeten Registerkarte ab.

virtual CWnd* GetFirstVisibleTab(int& iTabNum);

virtual CWnd* GetFirstVisibleTab(
    int iStartFrom,
    int& iTabNum);

Parameter

iTabNum
[out] Ein Verweis auf eine ganze Zahl. Diese Methode schreibt den nullbasierten Index der ersten sichtbaren Registerkarte in diesen Parameter.

iStartFrom
[in] Der nullbasierte Index der ersten zu überprüfenden Registerkarte.

Rückgabewert

Ein Zeiger auf die erste sichtbare Registerkarte bei erfolgreicher Ausführung; andernfalls NULL.

Hinweise

Wenn diese Methode fehlschlägt, schreibt sie den Wert -1 in iStartFrom.

Wenn iStartFrom größer oder gleich der Anzahl der Registerkarten im Registerkartensteuerelement ist, schlägt GetFirstVisibleTab automatisch fehl.

CMFCBaseTabCtrl::GetFirstVisibleTabNum

virtual int GetFirstVisibleTabNum() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetHighlightedTab

Ruft den Index der aktuell hervorgehobenen Registerkarte ab.

int GetHighlightedTab() const;

Rückgabewert

Der nullbasierte Index der hervorgehobenen Registerkarte.

CMFCBaseTabCtrl::GetImageList

virtual const CImageList* GetImageList() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetImageSize

virtual CSize GetImageSize() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetLastVisibleTab

virtual CWnd* GetLastVisibleTab(int& iTabNum);

Parameter

[in] iTabNum

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetLocation

Ruft die Position des Registerkartenbereichs des Registerkartensteuerelements ab.

Location GetLocation() const;

Rückgabewert

Die Position des Registerkartenbereichs.

Hinweise

Mögliche Positionswerte für Registerkartenbereiche sind LOCATION_BOTTOM und LOCATION_TOP.

CMFCBaseTabCtrl::GetMaxWindowSize

virtual CSize GetMaxWindowSize() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetTabArea

Ruft die Größe und Position des Registerkartenbereichs des Registerkartensteuerelements ab.

virtual void GetTabArea(
    CRect& rectTabAreaTop,
    CRect& rectTabAreaBottom) const = 0;

Parameter

rectTabAreaTop
[in] Ein Verweis auf ein CRect-Objekt. GetTabArea verwendet dieses Objekt, um die Größe und Position des oberen Registerkartenbereichs zu speichern.

rectTabAreaBottom
[in] Ein Verweis auf ein CRect-Objekt. GetTabArea verwendet dieses Objekt, um die Größe und Position des unteren Registerkartenbereichs zu speichern.

Hinweise

Nachdem GetTabArea zurückgegeben wurde, enthalten die CRect-Parameter die Größe und Position des Registerkartenbereichs in Clientkoordinaten des Registerkartensteuerelements. Wenn sich oben oder unten im Registersteuerelement kein Registerkartenbereich befindet, sind rectTabAreaTop oder rectTabAreaBottom leer.

CMFCBaseTabCtrl::GetTabBkColor

Ruft die Hintergrundfarbe der angegebenen Registerkarte ab.

virtual COLORREF GetTabBkColor(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

Rückgabewert

Ein COLORREF-Wert, der die Hintergrundfarbe der angegebenen Registerkarte angibt; -1, wenn iTab außerhalb des Bereichs liegt.

CMFCBaseTabCtrl::GetTabBorderSize

Ruft die Größe der Registerkartenrahmen im Registerkartensteuerelement ab.

virtual int GetTabBorderSize() const;

Rückgabewert

Die Größe des Registerkartenrahmens in Pixel.

Hinweise

Die Standardgröße für den Registerkartenrahmen beträgt drei Pixel. Sie können diese Rahmengröße mit der CMFCBaseTabCtrl::SetTabBorderSize-Methode ändern.

CMFCBaseTabCtrl::GetTabByID

Ruft den Index einer Registerkarte basierend auf einer Registerkarten-ID ab.

virtual int GetTabByID(int id) const;

Parameter

id
[in] Eine Registerkarten-ID.

Rückgabewert

Der nullbasierte Index einer Registerkarte, wenn sie gefunden wird; -1, wenn die Registerkarten-ID nicht gefunden wird.

Hinweise

Die Registerkarten-IDs werden automatisch zugewiesen, wenn Registerkarten einem Registerkartensteuerelement hinzugefügt werden.

CMFCBaseTabCtrl::GetTabCloseButton

CRect GetTabCloseButton() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetTabFromHwnd

Ruft den Index der Registerkarte ab, die das angegebene HWND-Objekt enthält.

virtual int GetTabFromHwnd(HWND hwnd) const;

Parameter

hwnd
[in] Das Fensterhandle.

Rückgabewert

Der nullbasierte Index der Registerkarte bei erfolgreicher Ausführung; -1, wenn keine Registerkarte hwndenthält.

CMFCBaseTabCtrl::GetTabFromPoint

Ruft die Registerkarte ab, die einen angegebenen Punkt enthält.

virtual int GetTabFromPoint(CPoint& pt) const;

Parameter

pt
[in] Ein Punkt in den Clientkoordinaten des Registerkartensteuerelements.

Rückgabewert

Der Index der Registerkarte, die pt enthält; -1, wenn keine Registerkarte pt enthält.

CMFCBaseTabCtrl::GetTabFullWidth

virtual int GetTabFullWidth(int iTab) const;

Parameter

[in] iTab

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetTabHicon

Gibt das HICON zurück, das der angegebenen Registerkarte zugeordnet ist.

virtual HICON GetTabHicon(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index für die Registerkarte.

Rückgabewert

Das HICON, das bei erfolgreicher Anwendung mit einer Registerkartenbezeichnung verbunden ist; NULL, wenn kein HICON vorhanden ist oder die Methode fehlschlägt.

CMFCBaseTabCtrl::GetTabIcon

Ruft das Symbol ab, das der angegebenen Registerkarte zugeordnet ist.

virtual UINT GetTabIcon(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

Rückgabewert

Die Symbol-ID für die angegebene Registerkarte bei erfolgreicher Ausführung; -1, wenn der Index ungültig ist.

Hinweise

Das CMFCBaseTabCtrl-Objekt speichert die Symbole im internen CImageList-Objekt.

CMFCBaseTabCtrl::GetTabID

Ruft die ID für eine Registerkarte ab, die durch den Registerkartenindex angegeben wird.

int GetTabID(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

Rückgabewert

Eine ID der Registerkarte oder -1, wenn iTab außerhalb des Bereichs liegt.

CMFCBaseTabCtrl::GetTabLabel

Ruft den Text einer Registerkartenbezeichnung ab.

virtual BOOL GetTabLabel(
    int iTab,
    CString& strLabel) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

strLabel
[out] Ein Verweis auf ein CString -Objekt. Diese Methode speichert die Beschriftung der Registerkarte in diesem Parameter.

Rückgabewert

TRUE, wenn erfolgreich; andernfalls FALSE.

Hinweise

Diese Methode schlägt fehl, wenn der Index iTab ungültig ist.

Sie legen die Beschriftung für eine Registerkarte fest, wenn Sie die Registerkarte mithilfe von CMFCBaseTabCtrl::AddTab erstellen. Sie können die Bezeichnung nach der Erstellung auch anhand der CMFCBaseTabCtrl::SetTabLabel-Methode ändern.

CMFCBaseTabCtrl::GetTabRect

Ruft die Größe und Position einer angegebenen Registerkarte ab.

virtual BOOL GetTabRect(
    int iTab,
    CRect& rect) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

rect
[out] Ein Verweis auf ein CRect -Objekt. Diese Methode speichert die Größe und Position der Registerkarte in diesem Parameter.

Rückgabewert

TRUE, wenn erfolgreich; FALSE, wenn der Registerkartenindex ungültig ist.

CMFCBaseTabCtrl::GetTabsHeight

virtual int GetTabsHeight() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetTabsNum

Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab.

virtual int GetTabsNum() const;

Rückgabewert

Die Anzahl der Registerkarten im Registerkartensteuerelement.

CMFCBaseTabCtrl::GetTabsRect

virtual void GetTabsRect(CRect& rect) const;

Parameter

[in] rect

Hinweise

CMFCBaseTabCtrl::GetTabTextColor

Ruft die Textfarbe für die angegebene Registerkarte ab.

virtual COLORREF GetTabTextColor(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

Rückgabewert

Ein COLORREF-Parameter, der die Textfarbe der angegebenen Registerkarte angibt; -1, wenn iTab außerhalb des Bereichs liegt.

CMFCBaseTabCtrl::GetTabWnd

Gibt den Zeiger auf den Bereich zurück, der sich auf der angegebenen Registerkarte befindet.

virtual CWnd* GetTabWnd(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

Rückgabewert

Ein Zeiger auf das CWnd-Objekt, das sich auf der Registerkarte befindet, die iTab angibt. NULL, wenn iTab ungültig ist.

Hinweise

Das zurückgegebene Objekt ist das Objekt, das die Anwendung beim Aufrufen von entweder CMFCBaseTabCtrl::AddTab oder CMFCBaseTabCtrl::InsertTab hinzugefügt hat.

Wenn das Objekt auf einer Registerkarte über einen Wrapper verfügt, gibt diese Methode den Wrapper für das Objekt zurück. Weitere Informationen zu Wrappern finden Sie unter CMFCBaseTabCtrl::CreateWrapper. Wenn Sie ohne Wrapper auf einen Zeiger auf das direkte Objekt zugreifen möchten, verwenden Sie die Methode CMFCBaseTabCtrl::GetTabWndNoWrapper.

CMFCBaseTabCtrl::GetTabWndNoWrapper

Gibt einen Zeiger auf das Steuerelement zurück, das sich auf einer Registerkarte befindet, auch wenn das Steuerelement einen Wrapper hat.

virtual CWnd* GetTabWndNoWrapper(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

Rückgabewert

Ein Zeiger auf das CWnd-Objekt, das sich auf der angegebenen Registerkarte befindet; NULL, wenn iTab ungültig ist.

Hinweise

Diese Methode ruft einen direkten Zeiger auf das CWnd-Objekt ab, das Sie mithilfe der Methode CMFCBaseTabCtrl::AddTab oder CMFCBaseTabCtrl::InsertTab hinzugefügt haben. GetTabWndNoWrapper wird einen Zeiger auf das hinzugefügte CWnd abrufen, auch wenn das Framework einen Wrapper für das Objekt hinzugefügt hat. Weitere Informationen zu Wrappern und der CMFCBaseTabCtrl-Klasse finden Sie unter CMFCBaseTabCtrl::CreateWrapper.

Verwenden Sie die Methode CMFCBaseTabCtrl::GetTabWnd, wenn Sie die Wrapperklasse nicht ignorieren wollen.

CMFCBaseTabCtrl::GetToolTipCtrl

Ruft einen Verweis auf das QuickInfo-Steuerelement ab.

CToolTipCtrl& GetToolTipCtrl() const;

Rückgabewert

Ein Verweis auf das QuickInfo-Steuerelement.

CMFCBaseTabCtrl::GetVisibleTabsNum

Ruft die Anzahl der aktuell sichtbaren Registerkarten ab.

virtual int GetVisibleTabsNum() const;

Rückgabewert

Die Anzahl eingeblendeter Registerkarten.

CMFCBaseTabCtrl::HasImage

virtual BOOL HasImage(int iTab) const;

Parameter

[in] iTab

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::HideSingleTab

Legt die Option fest, um die Registerkarten für das Registerkartensteuerelement auszublenden, wenn eine sichtbare Registerkarte vorhanden ist.

virtual void HideSingleTab(BOOL bHide = TRUE);

Parameter

bHide
[in] Ein boolescher Wert, der angibt, ob das Ausblenden einzelner Registerkarten aktiviert werden soll.

Hinweise

Wenn Ihre Anwendung so konfiguriert ist, dass einzelne Registerkarten ausgeblendet werden, zeigt das Framework beim Hinzufügen einer zweiten Registerkarte zum Registersteuerelement automatisch Registerkarten an.

CMFCBaseTabCtrl::InsertTab

Fügt eine Registerkarte in das Registerkartensteuerelement ein.

Virtual void InsertTab(
    CWnd* pNewWnd,
    LPCTSTR lpszTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

virtual void InsertTab(
    CWnd* pNewWnd,
    UINT uiResTabLabel,
    int nInsertAt,
    UINT uiImageId = (UINT)-1,
    BOOL bDetachable = TRUE);

Parameter

pNewWnd
[in] Ein Zeiger auf das Fenster, das diese Methode als neue Registerkarte hinzufügt.

lpszTabLabel
[in] Eine Zeichenfolge, die die Beschriftung für die neue Registerkarte enthält.

nInsertAt
[in] Der nullbasierte Index der neuen Registerkarte.

uiImageId
[in] Eine Bild-ID aus der Bildliste. Das Registerkartensteuerelement verwendet dieses Bild als Symbol für die neue Registerkarte.

bDetachable
[in] Ein boolescher Parameter, der festlegt, ob die neue Registerkarte abtrennbar ist.

uiResTabLabel
[in] Die Ressourcen-ID für die Bezeichnung.

Hinweise

Wenn das durch pNewWnd angegebene Objekt nicht von der CDockablePane-Klasse abgeleitet wird und der bDetachable-Parameter TRUE ist, erstellt das Framework einen speziellen Wrapper für die neue Registerkarte. Standardmäßig ist der Wrapper eine Instanz der CDockablePaneAdapter-Klasse. Verwenden Sie die CMFCBaseTabCtrl::SetDockingBarWrapperRTC-Methode, um eine andere Wrapperklasse zu erstellen. Jede benutzerdefinierte Wrapperklasse muss von CDockablePaneAdapterabgeleitet werden.

CMFCBaseTabCtrl::InvalidateTab

void InvalidateTab(int iTab);

Parameter

[in] iTab

Hinweise

CMFCBaseTabCtrl::IsActiveTabCloseButton

virtual BOOL IsActiveTabCloseButton() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsAutoColor

Legt fest, ob sich das Registerkartensteuerelement im Autocolor-Modus befindet.

BOOL IsAutoColor() const;

Rückgabewert

TRUE, wenn sich das Registerkartensteuerelement im Autocolor-Modus befindet; andernfalls FALSE.

Hinweise

Sie können den Autocolor-Modus mithilfe der CMFCBaseTabCtrl::EnableAutoColor-Methode aktivieren oder deaktivieren.

CMFCBaseTabCtrl::IsAutoDestroyWindow

BOOL IsAutoDestroyWindow() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsColored

virtual BOOL IsColored() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsDialogControl

BOOL IsDialogControl() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsDrawNoPrefix

BOOL IsDrawNoPrefix() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsFlatFrame

Gibt an, ob der Rahmen des Registersteuerelements in einem flachen Stil oder in einem 3D-Stil gerendert wird.

virtual BOOL IsFlatFrame() const;

Rückgabewert

TRUE, wenn der Rahmen des Registerkarten-Steuerelements in einem flachen Stil gerendert wird; FALSE, wenn der Rahmen in einem 3D-Stil gerendert wird.

Hinweise

Verwenden Sie CMFCTabCtrl::SetFlatFrame, um die Formatvorlage für den Frame des Registerkartensteuerelements zu ändern.

Registerkartensteuerelemente, die die Outlook-Formatvorlage verwenden, können nicht mit flachen Frames gerendert werden. Dazu gehören die CMFCOutlookBarTabCtrl-Klasse und alle von dieser Klasse abgeleiteten Klassen.

CMFCBaseTabCtrl::IsFlatTab

virtual BOOL IsFlatTab() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsHideSingleTab

Legt fest, ob das Registersteuerelement die Registerkartenbeschriftung ausblendet, wenn es nur eine Registerkarte gibt.

virtual BOOL IsHideSingleTab() const;

Rückgabewert

TRUE, wenn das Registersteuerelement die Registerkartenbeschriftung ausblendet, wenn es eine Registerkarte hat; andernfalls FALSE.

Hinweise

Verwenden Sie die CMFCBaseTabCtrl::HideSingleTab-Methode, um das Ausblenden der Registerkartenbezeichnung zu aktivieren, wenn nur eine Registerkarte vorhanden ist.

CMFCBaseTabCtrl::IsIconAdded

BOOL IsIconAdded(
    HICON hIcon,
    int& iIcon);

Parameter

[in] hIcon

[in] iIcon

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsInPlaceEdit

Gibt an, ob das Registerkartensteuerelement so konfiguriert ist, dass der Benutzer die Registerkartenbeschriftungen dynamisch ändern kann.

virtual BOOL IsInPlaceEdit() const;

Rückgabewert

Nonzero, wenn die direkte Bearbeitung aktiviert ist; andernfalls 0.

Hinweise

Sie können die direkte Bearbeitung aktivieren oder deaktivieren, indem Sie die CMFCBaseTabCtrl::EnableInPlaceEdit-Methode aufrufen.

CMFCBaseTabCtrl::IsLeftRightRounded

virtual BOOL IsLeftRightRounded() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsMDITab

BOOL IsMDITab() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsOneNoteStyle

Legt fest, ob Registerkarten im Stil von Microsoft OneNote angezeigt werden.

virtual BOOL IsOneNoteStyle() const;

Rückgabewert

TRUE, wenn Registerkarten im Stil von Microsoft OneNote angezeigt werden; andernfalls FALSE.

Hinweise

Rufen Sie die CMDIFrameWndEx::EnableMDITabs- Methode auf, um die Microsoft OneNote-Formatvorlage zu aktivieren. Sie können diese Formatvorlage auch aktivieren, wenn Sie die CMFCTabCtrl-Klasse instanziieren: Übergeben Sie einfach die Formatvorlage STYLE_3D_ONENOTE an die CMFCTabCtrl::Create-Methode.

Standardmäßig wird die Microsoft OneNote-Formatvorlage in einer von der CMFCBaseTabCtrl Class abgeleiteten benutzerdefinierten Klasse nicht unterstützt. Sie wird jedoch in der CMFCTabCtrl-Klasse unterstützt.

CMFCBaseTabCtrl::IsPtInTabArea

Legt fest, ob sich ein Punkt innerhalb des Registerkartenbereichs befindet.

virtual BOOL IsPtInTabArea(CPoint point) const = 0;

Parameter

Punkt
[in] Der zu testende Punkt.

Rückgabewert

Nonzero, wenn sich der Punkt im Registerkartenbereich befindet; andernfalls 0.

Hinweise

CMFCBaseTabCtrl::IsTabCloseButtonHighlighted

BOOL IsTabCloseButtonHighlighted() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsTabCloseButtonPressed

BOOL IsTabCloseButtonPressed() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::IsTabDetachable

Legt fest, ob eine Registerkarte abtrennbar ist.

virtual BOOL IsTabDetachable(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der zu überprüfenden Registerkarte.

Rückgabewert

TRUE, wenn die Registerkarte abtrennbar ist; andernfalls FALSE.

Hinweise

Verwenden Sie zum Trennen einer Registerkarte die CMFCBaseTabCtrl::EnableTabDetach-Methode.

CMFCBaseTabCtrl::IsTabIconOnly

Legt fest, ob eine Registerkartenbezeichnung nur Symbole und keinen Text enthält.

virtual BOOL IsTabIconOnly(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

Rückgabewert

TRUE, wenn eine Registerkartenbezeichnung nur Symbole enthält; andernfalls FALSE.

Hinweise

Um die Registerkarten in Ihrer Anwendung so festzulegen, dass nur Symbole angezeigt werden, rufen Sie die CMFCBaseTabCtrl::SetTabIconOnly-Methode auf.

CMFCBaseTabCtrl::IsTabSwapEnabled

Legt fest, ob das Registerkartensteuerelement dem Benutzer das Ändern von Registerkartenpositionen mithilfe der Maus ermöglicht.

BOOL IsTabSwapEnabled() const;

Rückgabewert

Nonzero, wenn Registerkartenpositionen vom Benutzer geändert werden können; andernfalls 0.

Hinweise

Standardmäßig können Benutzer die Reihenfolge von Registerkarten in einem Registerkartensteuerelement nicht ändern. Verwenden Sie die CMFCBaseTabCtrl::EnableTabSwap-Methode, um diese Funktionalität zu aktivieren.

CMFCBaseTabCtrl::IsTabVisible

Gibt an, ob die angegebene Registerkarte sichtbar ist.

virtual BOOL IsTabVisible(int iTab) const;

Parameter

iTab
[in] Der nullbasierte Index der zu überprüfenden Registerkarte.

Rückgabewert

Nonzero, wenn die angegebene Registerkarte sichtbar ist; andernfalls 0.

CMFCBaseTabCtrl::IsVS2005Style

virtual BOOL IsVS2005Style() const;

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::m_bActivateTabOnRightClick

m_bActivateTabOnRightClick legt fest, ob Registerkarten im Fokus sind, wenn der Benutzer mit der rechten Maustaste auf eine Registerkartenbeschriftung klickt.

BOOL m_bActivateTabOnRightClick;

Hinweise

Der Standardwert für dieses Datenelement ist FALSE.

CMFCBaseTabCtrl::m_bAutoDestroyWindow

m_bAutoDestroyWindow legt fest, ob das Framework die Objekte auf Registerkarten automatisch zerstört, wenn die Registerkarten entfernt werden.

BOOL m_bAutoDestroyWindow;

Hinweise

Standardmäßig ist dieser Member FALSE.

CMFCBaseTabCtrl::MoveTab

virtual void MoveTab(
    int nSource,
    int nDest);

Parameter

[in] nSource

[in] nDest

Hinweise

CMFCBaseTabCtrl::OnChangeTabs

Das Framework ruft diese Methode auf, wenn sich die Anzahl der Registerkarten in einem Registerkartensteuerelement ändert.

virtual void OnChangeTabs();

Hinweise

Standardmäßig hat diese Methode keine Auswirkungen. Überschreiben Sie diese Methode, um benutzerdefinierten Code auszuführen, wenn sich die Anzahl der Registerkarten im Registersteuerelement ändert.

CMFCBaseTabCtrl::OnDrop

virtual BOOL OnDrop(
    COleDataObject*,
    DROPEFFECT,
    CPoint);

Parameter

[in] COleDataObject*

[in] DROPEFFECT

[in] CPoint

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::OnDragOver

virtual DROPEFFECT OnDragOver(
    COleDataObject*,
    DWORD,
    CPoint);

Parameter

[in] COleDataObject*

[in] DWORD

[in] CPoint

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::OnDragLeave

virtual void OnDragLeave();

Hinweise

CMFCBaseTabCtrl::OnDragEnter

virtual DROPEFFECT OnDragEnter(
    COleDataObject*,
    DWORD,
    CPoint);

Parameter

[in] COleDataObject*

[in] DWORD

[in] CPoint

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::OnRenameTab

virtual BOOL OnRenameTab(int, CString&);

Parameter

[in] int

[in] CString&

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::PreTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

[in] pMsg

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::RecalcLayout

Berechnet das interne Layout des Registerkartensteuerelements neu.

virtual void RecalcLayout() = 0;

Hinweise

In CMFCBaseTabCtrl Class ist diese Methode eine reine virtuelle Funktion. Wenn Sie eine Klasse von CMFCBaseTabCtrl ableiten, müssen Sie diese Funktion implementieren.

CMFCBaseTabCtrl::RemoveAllTabs

Entfernt alle Registerkarten aus dem Registerkartensteuerelement.

virtual void RemoveAllTabs();

Hinweise

Wenn CMFCBaseTabCtrl::m_bAutoDestroyWindow TRUE ist, löscht das Framework alle CWnd-Objekte, die an die entfernten Registerkarten angefügt sind.

CMFCBaseTabCtrl::RemoveTab

Entfernt eine Registerkarte aus dem Registerkartensteuerelement.

virtual BOOL RemoveTab(
    int iTab,
    BOOL bRecalcLayout = TRUE);

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte.

bRecalcLayout
[in] Ein boolescher Parameter, der angibt, ob das Layout der Registerkarte neu berechnet werden soll.

Rückgabewert

TRUE, wenn die Methode die Registerkarte erfolgreich entfernt; andernfalls FALSE.

Hinweise

Wenn CMFCBaseTabCtrl::m_bAutoDestroyWindow TRUE ist, zerstört RemoveTab das CWnd-Objekt, das der angegebenen Registerkarte zugeordnet ist.

CMFCBaseTabCtrl::RenameTab

virtual BOOL RenameTab();

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::ResetImageList

Setzt die Bildliste für eine Instanz der CMFCBaseTabCtrl-Klasse zurück.

void ResetImageList();

CMFCBaseTabCtrl::Serialize

virtual void Serialize(CArchive& ar);

Parameter

[in] ar

Hinweise

CMFCBaseTabCtrl::SetActiveTab

Aktiviert die angegebene Registerkarte.

virtual BOOL SetActiveTab(int iTab) = 0;

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte. SetActiveTab aktiviert die Registerkarte mit diesem Index.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

In CMFCBaseTabCtrl Class ist diese Methode eine reine virtuelle Funktion. Wenn Sie eine Klasse von CMFCBaseTabCtrl ableiten, müssen Sie diese Funktion implementieren.

CMFCBaseTabCtrl::SetActiveTabColor

Legt die Hintergrundfarbe für die aktive Registerkarte fest.

virtual void SetActiveTabColor(COLORREF clr);

Parameter

clr
[in] Gibt die neue Hintergrundfarbe an.

Hinweise

Das Framework ruft die Standardhintergrundfarbe für aktive Registerkarten aus der GetSysColor-Methode ab.

CMFCBaseTabCtrl::SetActiveTabTextColor

Legt die Textfarbe für aktive Registerkarten fest.

virtual void SetActiveTabTextColor(COLORREF clr);

Parameter

clr
[in] Ein COLORREF-Parameter, der die neue Textfarbe angibt.

Hinweise

Standardmäßig ruft das Framework die Textfarbe von GetSysColor ab. Überschreiben Sie diese Standardfarbe mithilfe der SetActiveTabTextColor-Methode.

CMFCBaseTabCtrl::SetAutoColors

Legt die Farben der Registerkartensteuerung fest, die das Framework im automatischen Farbmodus verwendet.

void SetAutoColors(const CArray<COLORREF,COLORREF>& arColors);

Parameter

arColors
[in] Ein Array von RGB-Farben.

Hinweise

Wenn Sie ein benutzerdefiniertes Array von Farben bereitstellen, wird das Standardarray von Farben ignoriert. Wenn der Parameter arColors leer ist, wird das Framework auf das Standardarray der Farben zurückgesetzt.

Verwenden Sie zum Aktivieren des Autocolor-Modus die CMFCBaseTabCtrl::EnableAutoColor-Methode.

CMFCBaseTabCtrl::SetDockingBarWrapperRTC

Legt die Wrapperklasse fest, die für nicht von der CDockablePane Classabgeleitete Objekte verwendet wird.

void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);

Parameter

pRTC
[in] Die Laufzeitklasseninformationen für die neue Wrapperklasse.

Hinweise

Mit den Methoden CMFCBaseTabCtrl::AddTab und CMFCBaseTabCtrl::InsertTab fügen Sie Registerkarten zu einem Registersteuerelement hinzu. Wenn Sie eine Registerkarte hinzufügen, muss jedes Steuerelement auf dieser Registerkarte andockbar sein. Alle Objekte, die nicht von CDockablePane abgeleitet werden, müssen umschlossen werden. AddTab und InsertTab erstellen einen Wrapper für diese Objekte. Die Standardwrapperklasse ist die CDockablePaneAdapter-Klasse. Mit der SetDockingBarWrapperRTC-Methode können Sie die Klasse ändern, die als Wrapperklasse verwendet wird. Die von Ihnen bereitgestellte Wrapperklasse muss von CDockablePaneAdapterabgeleitet werden.

CMFCBaseTabCtrl::SetDrawNoPrefix

Aktiviert und deaktiviert die Verarbeitung von Präfixzeichen in Registerkartenbezeichnungen.

void SetDrawNoPrefix(
    BOOL bNoPrefix,
    BOOL bRedraw = TRUE);

Parameter

bNoPrefix
[in] TRUE, wenn Sie Präfixzeichen verarbeiten möchten; andernfalls FALSE.

bRedraw
[in] TRUE, wenn das Registerkartenfenster neu gezeichnet werden soll; andernfalls FALSE.

Hinweise

Ein Präfixzeichen ist ein mnemonisches Zeichen, dem ein kaufmännisches Und (&) vorangestellt ist.

CMFCBaseTabCtrl::SetImageList

Legt die Symbolbildliste für das Registerkartensteuerelement fest.

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

virtual BOOL SetImageList(HIMAGELIST hImageList);

Parameter

uiID
[in] Eine Bitmap-Ressourcen-ID. SetImageList lädt die Bildliste aus dieser Ressource.

cx
[in] Die Breite der einzelnen Bilder in Pixeln.

clrTransp
[in] Ein COLORREF-Parameter, der die transparente Farbe des Bildes angibt.

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

Rückgabewert

Nonzero, wenn die Methode erfolgreich war; andernfalls 0.

Hinweise

Die Bilder aus der Symbolbildliste werden zusammen mit den Beschriftungen für die Registerkarte angezeigt. Zum Anzeigen eines Symbols müssen Sie den Index angeben, wenn Sie CMFCBaseTabCtrl::AddTabaufrufen.

SetImageList schlägt fehl, wenn das Registersteuerelement mit einem flachen Stil erstellt wurde. Es schlägt auch fehl, wenn das Framework das durch uiID angegebene Bild nicht laden kann.

Diese Methode berechnet die Höhe der Registerkarte entsprechend den Bild- und Textgrößen neu.

CMFCBaseTabCtrl::SetLocation

virtual void SetLocation(Location location);

Parameter

[in] location

Hinweise

CMFCBaseTabCtrl::SetTabBkColor

Legt die Hintergrundfarbe für die angegebene Registerkarte fest.

virtual BOOL SetTabBkColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

color
[in] Die festzulegende Farbe.

Rückgabewert

TRUE, wenn erfolgreich; andernfalls FALSE.

CMFCBaseTabCtrl::SetTabBorderSize

Legt eine neue Rahmengröße für das Registerkartensteuerelement fest.

virtual void SetTabBorderSize(
    int nTabBorderSize,
    BOOL bRepaint = TRUE);

Parameter

nTabBorderSize
[in] Die neue Rahmengröße in Pixel.

bRepaint
[in] Ein boolescher Parameter, der angibt, ob das Framework das Steuerelement neu zeichnet.

CMFCBaseTabCtrl::SetTabHicon

Legt das Symbol für eine Registerkartenbezeichnung fest.

virtual BOOL SetTabHicon(
    int iTab,
    HICON hIcon);

Parameter

iTab
[in] Der nullbasierte Index einer Registerkarte. Mit dieser Methode wird das Symbol für diese Registerkarte geändert.

hIcon
[in] Ein Handle zu einem Symbol.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

CMFCBaseTabCtrl::SetTabIcon

Legt das Symbol für eine Registerkarte fest.

virtual BOOL SetTabIcon(
    int iTab,
    UINT uiIcon);

Parameter

iTab
[in] Der nullbasierte Index der zu aktualisierenden Registerkarte.

uiIcon
[in] Die Symbol-ID für das neue Symbol. Diese ID verweist auf das interne CImageList-Objekt.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

CMFCBaseTabCtrl::SetTabIconOnly

Aktiviert die Anzeige nur eines Symbols (und keiner Textbeschriftung) auf einer bestimmten Registerkarte.

virtual BOOL SetTabIconOnly(
    int iTab,
    BOOL bIconOnly = TRUE,
    BOOL bShowTooltipAlways = FALSE);

Parameter

iTab
[in] Der nullbasierte Index der zu ändernden Registerkarte.

bIconOnly
[in] Ein boolescher Parameter, der festlegt, ob nur Symbole angezeigt werden sollen.

bShowTooltipAlways
[in] Ein boolescher Parameter, der festlegt, ob das Framework QuickInfos für eine Registerkartenbeschriftung anzeigt, die nur Symbole anzeigt.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

Standardmäßig zeigt ein Registerkartensteuerelement das Symbol und die Beschriftung für jede Registerkarte an.

CMFCBaseTabCtrl::SetTabLabel

Legt den Text für eine Registerkartenbezeichnung fest.

virtual BOOL SetTabLabel(
    int iTab,
    const CString& strLabel);

Parameter

iTab
[in] Der nullbasierte Index der zu aktualisierenden Registerkarte.

strLabel
[in] Ein Verweis auf eine Zeichenfolge, die den neuen Text für die Registerkartenbezeichnung enthält.

Rückgabewert

Nonzero bei erfolgreicher Ausführung; andernfalls 0.

CMFCBaseTabCtrl::SetTabsHeight

virtual void SetTabsHeight();

Hinweise

CMFCBaseTabCtrl::SetTabsOrder

Ordnet die Registerkarten in der angegebenen Reihenfolge an.

BOOL SetTabsOrder(const CArray<int,int>& arOrder);

Parameter

arOrder
[in] Ein Array von nullbasierten Indizes, die die neue Registerkartenreihenfolge definieren.

Rückgabewert

TRUE wenn erfolgreich; andernfalls FAIL.

Hinweise

Die Größe des arOrder-Arrays muss der Anzahl der Registerkarten im Registerkartensteuerelement entsprechen.

CMFCBaseTabCtrl::SetTabTextColor

Legt die Textfarbe für eine angegebene Registerkarte fest.

virtual BOOL SetTabTextColor(
    int iTab,
    COLORREF color = (COLORREF)-1);

Parameter

iTab
[in] Der nullbasierte Index der Registerkarte.

color
[in] Ein COLORREF-Parameter, der die neue Textfarbe angibt.

Rückgabewert

Nonzero bei erfolgreicher Ausführung; andernfalls 0.

CMFCBaseTabCtrl::ShowTab

Blendet die angegebene Registerkarte ein oder aus.

virtual BOOL ShowTab(
    int iTab,
    BOOL bShow = TRUE,
    BOOL bRecalcLayout = TRUE,
    BOOL bActivate = FALSE);

Parameter

iTab
[in] Der Index der Registerkarte, die ShowTab ein- oder ausblendet.

bShow
[in] Ein boolescher Parameter, der angibt, ob die Registerkarte angezeigt werden soll.

bRecalcLayout
[in] Ein boolescher Parameter, der angibt, ob das Fensterlayout sofort neu berechnet werden soll.

bActivate
[in] Ein boolescher Parameter, der angibt, ob die durch iTab angegebene Registerkarte ausgewählt werden soll.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Der Parameter bActivate gilt nur, wenn bShow- TRUE ist. Wenn bActivate TRUE ist und ShowTab erfolgreich ist, sendet ShowTab die Nachricht AFX_WM_CHANGE_ACTIVE_TAB an das übergeordnete Element des Registerkartenfensters.

CMFCBaseTabCtrl::StartRenameTab

virtual BOOL StartRenameTab(int iTab);

Parameter

[in] iTab

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::SwapTabs

virtual void SwapTabs(
    int nFisrtTabID,
    int nSecondTabID);

Parameter

[in] nFisrtTabID

[in] nSecondTabID

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CMFCTabCtrl-Klasse
CMFCOutlookBarTabCtrl-Klasse

Freigeben über

CMFCBaseTabCtrl-Klasse

Syntax

Member

Öffentliche Methoden

Geschützte Methoden

Datenelemente

Hinweise

Anpassungstipps

Vererbungshierarchie

Anforderungen

CMFCBaseTabCtrl::AddIcon

Parameter

Hinweise

CMFCBaseTabCtrl::AddTab

Parameter

Hinweise

CMFCBaseTabCtrl::ApplyRestoredTabInfo

Parameter

Hinweise

CMFCBaseTabCtrl::AutoDestroyWindow

Parameter

Hinweise

CMFCBaseTabCtrl::CalcRectEdit

Parameter

Hinweise

CMFCBaseTabCtrl::CleanUp

Hinweise

CMFCBaseTabCtrl::ClearImageList

Hinweise

CMFCBaseTabCtrl::CreateWrapper

Parameter

Rückgabewert

Hinweise

CMFCBaseTabCtrl::DetachTab

Parameter

Rückgabewert

Hinweise

CMFCBaseTabCtrl::EnableActivateLastActive

Parameter

Hinweise

CMFCBaseTabCtrl::EnableAutoColor

Parameter

Hinweise

CMFCBaseTabCtrl::EnableCustomToolTips

Parameter

Rückgabewert

Hinweise

CMFCBaseTabCtrl::EnableInPlaceEdit

Parameter

Hinweise

CMFCBaseTabCtrl::EnableTabDetach

Parameter

Rückgabewert

CMFCBaseTabCtrl::EnableTabSwap

Parameter

Hinweise

CMFCBaseTabCtrl::EnsureVisible

Parameter

Rückgabewert

Hinweise

CMFCBaseTabCtrl::EnterDragMode

Hinweise

CMFCBaseTabCtrl::FindTargetWnd

Parameter

Rückgabewert

Hinweise

CMFCBaseTabCtrl::FireChangeActiveTab

Parameter

Hinweise

CMFCBaseTabCtrl::FireChangingActiveTab

Parameter

Rückgabewert

Bemerkungen

CMFCBaseTabCtrl::GetActiveTab

Rückgabewert

CMFCBaseTabCtrl::GetActiveTabColor

Rückgabewert

Hinweise

CMFCBaseTabCtrl::GetActiveTabTextColor