QTabBar Class

Die Klasse QTabBar bietet eine Registerkartenleiste, z.B. für die Verwendung in Dialogen mit Registerkarten. Mehr...

Kopfzeile: #include <QTabBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Vererbungen: QWidget

Öffentliche Typen

enum ButtonPosition { LeftSide, RightSide }
enum SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab }
enum Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, TriangularNorth, …, TriangularEast }

Eigenschaften

Öffentliche Funktionen

QTabBar(QWidget *parent = nullptr)
virtual ~QTabBar()
QString accessibleTabName(int index) const
int addTab(const QString &text)
int addTab(const QIcon &icon, const QString &text)
bool autoHide() const
bool changeCurrentOnDrag() const
int count() const
int currentIndex() const
bool documentMode() const
bool drawBase() const
Qt::TextElideMode elideMode() const
bool expanding() const
QSize iconSize() const
int insertTab(int index, const QString &text)
int insertTab(int index, const QIcon &icon, const QString &text)
bool isMovable() const
bool isTabEnabled(int index) const
bool isTabVisible(int index) const
void moveTab(int from, int to)
void removeTab(int index)
QTabBar::SelectionBehavior selectionBehaviorOnRemove() const
void setAccessibleTabName(int index, const QString &name)
void setAutoHide(bool hide)
void setChangeCurrentOnDrag(bool change)
void setDocumentMode(bool set)
void setDrawBase(bool drawTheBase)
void setElideMode(Qt::TextElideMode mode)
void setExpanding(bool enabled)
void setIconSize(const QSize &size)
void setMovable(bool movable)
void setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior)
void setShape(QTabBar::Shape shape)
void setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)
void setTabData(int index, const QVariant &data)
void setTabEnabled(int index, bool enabled)
void setTabIcon(int index, const QIcon &icon)
void setTabText(int index, const QString &text)
void setTabTextColor(int index, const QColor &color)
void setTabToolTip(int index, const QString &tip)
void setTabVisible(int index, bool visible)
void setTabWhatsThis(int index, const QString &text)
void setTabsClosable(bool closable)
void setUsesScrollButtons(bool useButtons)
QTabBar::Shape shape() const
int tabAt(const QPoint &position) const
QWidget *tabButton(int index, QTabBar::ButtonPosition position) const
QVariant tabData(int index) const
QIcon tabIcon(int index) const
QRect tabRect(int index) const
QString tabText(int index) const
QColor tabTextColor(int index) const
QString tabToolTip(int index) const
QString tabWhatsThis(int index) const
bool tabsClosable() const
bool usesScrollButtons() const

Reimplementierte öffentliche Funktionen

virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Öffentliche Slots

void setCurrentIndex(int index)

Signale

void currentChanged(int index)
void tabBarClicked(int index)
void tabBarDoubleClicked(int index)
void tabCloseRequested(int index)
void tabMoved(int from, int to)

Geschützte Funktionen

virtual void initStyleOption(QStyleOptionTab *option, int tabIndex) const
virtual QSize minimumTabSizeHint(int index) const
virtual void tabInserted(int index)
virtual void tabLayoutChange()
virtual void tabRemoved(int index)
virtual QSize tabSizeHint(int index) const

Reimplementierte geschützte Funktionen

virtual void changeEvent(QEvent *event) override
virtual bool event(QEvent *event) override
virtual void hideEvent(QHideEvent *) override
virtual void keyPressEvent(QKeyEvent *event) override
virtual void mouseDoubleClickEvent(QMouseEvent *event) override
virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *event) override
virtual void paintEvent(QPaintEvent *) override
virtual void resizeEvent(QResizeEvent *) override
virtual void showEvent(QShowEvent *) override
virtual void timerEvent(QTimerEvent *event) override
virtual void wheelEvent(QWheelEvent *event) override

Detaillierte Beschreibung

QTabBar ist einfach zu benutzen; es zeichnet die Tabs mit einem der vordefinierten shapes und gibt ein Signal aus, wenn ein Tab ausgewählt wird. Sie kann subclassed werden, um das Look and Feel anzupassen. Qt bietet auch eine vorgefertigte QTabWidget.

Jede Registerkarte hat ein tabText(), ein optionales tabIcon(), ein optionales tabToolTip(), ein optionales tabWhatsThis() und ein optionales tabData(). Die Attribute der Registerkarten können mit setTabText(), setTabIcon(), setTabToolTip(), setTabWhatsThis und setTabData() geändert werden. Jede Registerkarte kann mit setTabEnabled() einzeln aktiviert oder deaktiviert werden.

Jede Registerkarte kann Text in einer anderen Farbe anzeigen. Die aktuelle Textfarbe für eine Registerkarte kann mit der Funktion tabTextColor() ermittelt werden. Die Textfarbe für eine bestimmte Registerkarte kann mit setTabTextColor() eingestellt werden.

Tabulatoren werden mit addTab() hinzugefügt oder mit insertTab() an bestimmten Positionen eingefügt. Die Gesamtzahl der Tabulatoren wird mit count() angegeben. Tabulatoren können mit removeTab() aus der Tabulatorleiste entfernt werden. Die Kombination von removeTab() und insertTab() ermöglicht es, Tabulatoren an verschiedene Positionen zu verschieben.

Die Eigenschaft shape bestimmt das Aussehen der Tabulatoren. Die Wahl der Form ist Geschmackssache, obwohl Tabulator-Dialoge (für Einstellungen und ähnliches) immer RoundedNorth verwenden. Tab-Steuerelemente in anderen Fenstern als Dialogen verwenden fast immer entweder RoundedSouth oder TriangularSouth. Viele Tabellenkalkulationen und andere Tab-Steuerelemente, bei denen alle Seiten im Wesentlichen gleich sind, verwenden TriangularSouth, während RoundedSouth meist verwendet wird, wenn die Seiten unterschiedlich sind (z.B. bei einer mehrseitigen Werkzeugpalette). Die Voreinstellung in QTabBar ist RoundedNorth.

Der wichtigste Teil der API von QTabBar ist das Signal currentChanged(). Dieses Signal wird immer dann ausgegeben, wenn sich die aktuelle Registerkarte ändert (sogar beim Start, wenn die aktuelle Registerkarte von 'keine' zu 'keine' wechselt). Es gibt auch einen Slot, setCurrentIndex(), der verwendet werden kann, um eine Registerkarte programmatisch auszuwählen. Die Funktion currentIndex() gibt den Index der aktuellen Registerkarte zurück, count enthält die Anzahl der Registerkarten.

QTabBar erzeugt automatische mnemonische Tasten in der Art von QAbstractButton; z.B. wenn die Beschriftung eines Tabs "&Graphics" ist, wird Alt+G zu einer Schnelltaste für den Wechsel zu diesem Tab.

Die folgenden virtuellen Funktionen müssen möglicherweise neu implementiert werden, um das Erscheinungsbild anzupassen oder zusätzliche Daten mit jeder Registerkarte zu speichern:

  • tabSizeHint() errechnet die Größe einer Registerkarte.
  • tabInserted() meldet, dass eine neue Registerkarte hinzugefügt wurde.
  • tabRemoved() meldet, dass eine Registerkarte entfernt wurde.
  • tabLayoutChange() meldet, dass die Registerkarten neu angeordnet wurden.
  • paintEvent() malt alle Tabulatoren.

Für Unterklassen benötigen Sie möglicherweise auch die Funktionen tabRect(), die die visuelle Geometrie einer einzelnen Registerkarte zurückgeben.

Screenshot of a Fusion style tab barEine im Fusion-Widget-Stil dargestellte Registerkartenleiste.
Screenshot of a truncated Fusion tab barEine abgeschnittene Registerkartenleiste im Fusion-Widget-Stil.

Siehe auch QTabWidget.

Dokumentation der Mitgliedstypen

enum QTabBar::ButtonPosition

Dieser Enum-Typ listet die Position des Widgets auf einer Registerkarte auf.

KonstanteWertBeschreibung
QTabBar::LeftSide0Linke Seite der Registerkarte.
QTabBar::RightSide1Rechte Seite der Registerkarte.

enum QTabBar::SelectionBehavior

Dieser Enum-Typ listet das Verhalten von QTabBar auf, wenn ein Tabulator entfernt wird und der entfernte Tabulator auch der aktuelle Tabulator ist.

KonstanteWertBeschreibung
QTabBar::SelectLeftTab0Wählen Sie die Registerkarte links von der zu entfernenden Registerkarte aus.
QTabBar::SelectRightTab1Wählen Sie die Registerkarte rechts von der zu entfernenden Registerkarte aus.
QTabBar::SelectPreviousTab2Wählen Sie die zuvor ausgewählte Registerkarte aus.

enum QTabBar::Shape

Dieser Enum-Typ listet die eingebauten Formen auf, die von QTabBar unterstützt werden. Betrachten Sie diese als Hinweise, da einige Stile einige der Formen möglicherweise nicht darstellen. Die Position sollte jedoch beachtet werden.

KonstanteWertBeschreibung
QTabBar::RoundedNorth0Das normale abgerundete Aussehen oberhalb der Seiten
QTabBar::RoundedSouth1Das normale abgerundete Aussehen unterhalb der Seiten
QTabBar::RoundedWest2Das normale abgerundete Aussehen auf der linken Seite der Seiten
QTabBar::RoundedEast3Das normale abgerundete Aussehen auf der rechten Seite der Seiten
QTabBar::TriangularNorth4Dreieckige Tabulatoren über den Seiten.
QTabBar::TriangularSouth5Dreieckige Tabulatoren, ähnlich denen, die in der Excel-Tabelle verwendet werden, zum Beispiel
QTabBar::TriangularWest6Dreieckige Registerkarten auf der linken Seite der Seiten.
QTabBar::TriangularEast7Dreieckige Registerkarten auf der rechten Seite der Seiten.

Dokumentation der Eigenschaften

autoHide : bool

Wenn true, wird die Registerkartenleiste automatisch ausgeblendet, wenn sie weniger als 2 Registerkarten enthält.

Standardmäßig ist diese Eigenschaft falsch.

Zugriffsfunktionen:

bool autoHide() const
void setAutoHide(bool hide)

Siehe auch QWidget::visible.

changeCurrentOnDrag : bool

Wenn true, dann wird die aktuelle Registerkarte automatisch geändert, wenn Sie über die Registerkartenleiste ziehen.

Hinweis: Sie sollten auch die Eigenschaft acceptDrops auf true setzen, damit diese Funktion funktioniert.

Standardmäßig ist diese Eigenschaft auf false gesetzt.

Zugriffsfunktionen:

bool changeCurrentOnDrag() const
void setChangeCurrentOnDrag(bool change)

[read-only] count : const int

Diese Eigenschaft enthält die Anzahl der Registerkarten in der Registerkartenleiste

Zugriffsfunktionen:

int count() const

currentIndex : int

Diese Eigenschaft enthält den Index der sichtbaren Registerkarte in der Registerkartenleiste

Der aktuelle Index ist -1, wenn es keine aktuelle Registerkarte gibt.

Zugriffsfunktionen:

int currentIndex() const
void setCurrentIndex(int index)

Benachrichtigungssignal:

void currentChanged(int index)

documentMode : bool

Diese Eigenschaft gibt an, ob die Registerkartenleiste in einem für das Hauptfenster geeigneten Modus gerendert wird oder nicht.

Diese Eigenschaft wird als Hinweis für Stile verwendet, um die Registerkarten auf eine andere Weise zu zeichnen, als sie normalerweise in einem Registerkarten-Widget aussehen würden. Unter macOS sieht das ähnlich aus wie die Tabs in Safari oder Terminal.app von Sierra.

Funktionen aufrufen:

bool documentMode() const
void setDocumentMode(bool set)

Siehe auch QTabWidget::documentMode.

drawBase : bool

legt fest, ob die Tab-Leiste ihre Basis zeichnen soll oder nicht.

Wenn true, dann zeichnet QTabBar eine Basis in Bezug auf die Überlappung der Stile. Andernfalls werden nur die Tabulatoren gezeichnet.

Zugriffsfunktionen:

bool drawBase() const
void setDrawBase(bool drawTheBase)

Siehe auch QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap, und QStyleOptionTabBarBase.

elideMode : Qt::TextElideMode

Ausblenden von Text in der Registerkartenleiste

Diese Eigenschaft steuert, wie Elemente ausgeblendet werden, wenn nicht genügend Platz vorhanden ist, um sie bei einer bestimmten Größe der Registerkartenleiste anzuzeigen.

Standardmäßig ist der Wert stilabhängig.

Zugriffsfunktionen:

Qt::TextElideMode elideMode() const
void setElideMode(Qt::TextElideMode mode)

Siehe auch QTabWidget::elideMode, usesScrollButtons, und QStyle::SH_TabBar_ElideMode.

expanding : bool

Wenn der Wert true ist, erweitert QTabBar die Tabulatoren, um den leeren Platz zu nutzen.

Standardmäßig ist der Wert true.

Zugriffsfunktionen:

bool expanding() const
void setExpanding(bool enabled)

Siehe auch QTabWidget::documentMode.

iconSize : QSize

Diese Eigenschaft legt die Größe der Symbole in der Registerkartenleiste fest

Der Standardwert ist stilabhängig. iconSize ist eine Maximalgröße; Symbole, die kleiner sind, werden nicht hochskaliert.

Zugriffsfunktionen:

QSize iconSize() const
void setIconSize(const QSize &size)

Siehe auch QTabWidget::iconSize.

movable : bool

Diese Eigenschaft legt fest, ob der Benutzer die Registerkarten innerhalb des Bereichs der Registerkartenleiste verschieben kann.

Standardmäßig ist diese Eigenschaft false;

Zugriffsfunktionen:

bool isMovable() const
void setMovable(bool movable)

selectionBehaviorOnRemove : SelectionBehavior

Welche Registerkarte beim Aufruf von removeTab als aktuell gesetzt werden soll, wenn die entfernte Registerkarte auch die aktuelle Registerkarte ist.

Standardmäßig ist der Wert SelectRightTab.

Zugriffsfunktionen:

QTabBar::SelectionBehavior selectionBehaviorOnRemove() const
void setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior)

Siehe auch removeTab().

shape : Shape

Diese Eigenschaft enthält die Form der Registerkarten in der Registerkartenleiste

Die möglichen Werte für diese Eigenschaft werden durch die Aufzählung Shape beschrieben.

Zugriffsfunktionen:

QTabBar::Shape shape() const
void setShape(QTabBar::Shape shape)

tabsClosable : bool

Diese Eigenschaft legt fest, ob eine Registerkartenleiste auf jeder Registerkarte Schaltflächen zum Schließen enthalten soll oder nicht

Wenn tabsClosable auf true gesetzt ist, erscheint auf der Registerkarte je nach Stil entweder auf der linken oder rechten Seite eine Schaltfläche zum Schließen. Wenn die Schaltfläche angeklickt wird, wird das Signal tabCloseRequested ausgegeben.

Standardmäßig ist der Wert false.

Zugriffsfunktionen:

bool tabsClosable() const
void setTabsClosable(bool closable)

Siehe auch setTabButton() und tabRemoved().

usesScrollButtons : bool

Diese Eigenschaft legt fest, ob eine Registerkartenleiste Schaltflächen zum Blättern in den Registerkarten verwenden soll, wenn sie viele Registerkarten enthält oder nicht.

Wenn eine Registerkartenleiste zu viele Registerkarten für ihre Größe enthält, kann die Registerkartenleiste entweder ihre Größe erweitern oder Schaltflächen hinzufügen, mit denen Sie durch die Registerkarten blättern können.

Standardmäßig ist der Wert stilabhängig.

Zugriffsfunktionen:

bool usesScrollButtons() const
void setUsesScrollButtons(bool useButtons)

Siehe auch elideMode, QTabWidget::usesScrollButtons, und QStyle::SH_TabBar_PreferNoArrows.

Dokumentation der Mitgliedsfunktionen

[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)

Erzeugt eine neue Registerkartenleiste mit der angegebenen parent.

[virtual noexcept] QTabBar::~QTabBar()

Zerstört die Registerkartenleiste.

QString QTabBar::accessibleTabName(int index) const

Gibt den zugänglichen Namen der Registerkarte an der Position index zurück, oder eine leere Zeichenkette, wenn index außerhalb des Bereichs liegt.

Siehe auch setAccessibleTabName().

int QTabBar::addTab(const QString &text)

Fügt eine neue Registerkarte mit dem Text text hinzu. Gibt den Index der neuen Registerkarte zurück.

int QTabBar::addTab(const QIcon &icon, const QString &text)

Dies ist eine überladene Funktion.

Fügt eine neue Registerkarte mit dem Symbol icon und dem Text text hinzu. Gibt den Index der neuen Registerkarte zurück.

[override virtual protected] void QTabBar::changeEvent(QEvent *event)

Reimplements: QWidget::changeEvent(QEvent *Event).

[signal] void QTabBar::currentChanged(int index)

Dieses Signal wird ausgegeben, wenn sich die aktuelle Registerkarte in der Registerkartenleiste ändert. Der neue aktuelle hat die angegebene index, oder -1, wenn es keinen neuen gibt (z.B. wenn es keine Tabs in der QTabBar gibt).

Hinweis: Meldersignal für die Eigenschaft currentIndex.

[override virtual protected] bool QTabBar::event(QEvent *event)

Reimplements: QWidget::event(QEvent *Event).

[override virtual protected] void QTabBar::hideEvent(QHideEvent *)

Reimplements: QWidget::hideEvent(QHideEvent *event).

[virtual protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const

Initialisieren Sie option mit den Werten aus der Registerkarte tabIndex. Diese Methode ist für Unterklassen nützlich, wenn sie eine QStyleOptionTab benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom() und QTabWidget::initStyleOption().

int QTabBar::insertTab(int index, const QString &text)

Fügt einen neuen Tabulator mit dem Text text an der Position index ein. Wenn index außerhalb des Bereichs liegt, wird die neue Registerkarte angehängt. Gibt den Index der neuen Registerkarte zurück.

int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)

Dies ist eine überladene Funktion.

Fügt einen neuen Tabulator mit dem Symbol icon und dem Text text an der Position index ein. Wenn index außerhalb des Bereichs liegt, wird die neue Registerkarte angehängt. Gibt den Index der neuen Registerkarte zurück.

Wenn QTabBar leer war, bevor diese Funktion aufgerufen wurde, wird die eingefügte Registerkarte zur aktuellen Registerkarte.

Das Einfügen einer neuen Registerkarte mit einem Index, der kleiner oder gleich dem aktuellen Index ist, erhöht den aktuellen Index, behält aber die aktuelle Registerkarte bei.

bool QTabBar::isTabEnabled(int index) const

Gibt true zurück, wenn der Tabulator an der Position index aktiviert ist; andernfalls wird false zurückgegeben.

bool QTabBar::isTabVisible(int index) const

Gibt true zurück, wenn der Tabulator an der Position index sichtbar ist; andernfalls wird false zurückgegeben.

[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual] QSize QTabBar::minimumSizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.

[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const

Gibt den Hinweis auf die minimale Tabulatorgröße für den Tabulator an der Position index zurück.

[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)

Reimplements: QWidget::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

void QTabBar::moveTab(int from, int to)

Verschiebt das Element an der Indexposition from zur Indexposition to.

Siehe auch tabMoved() und tabLayoutChange().

[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)

Reimplements: QWidget::paintEvent(QPaintEvent *event).

void QTabBar::removeTab(int index)

Entfernt den Tabulator an der Position index.

Siehe auch SelectionBehavior.

[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)

Reimplements: QWidget::resizeEvent(QResizeEvent *event).

void QTabBar::setAccessibleTabName(int index, const QString &name)

Setzt den accessibleName der Registerkarte an der Position index auf name.

Siehe auch accessibleTabName().

void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)

Legt widget auf der Registerkarte index fest. Das Widget wird je nach position auf der linken oder rechten Seite platziert.

Alle zuvor unter position eingestellten Widgets werden ausgeblendet. Wenn Sie widget auf nullptr setzen, wird das aktuelle Widget unter position ausgeblendet.

Die Registerkartenleiste wird Eigentümerin des Widgets, so dass alle hier gesetzten Widgets von der Registerkartenleiste gelöscht werden, wenn sie zerstört wird, es sei denn, Sie reparieren das Widget separat, nachdem Sie ein anderes Widget gesetzt haben (oder nullptr).

Siehe auch tabButton() und tabsClosable().

void QTabBar::setTabData(int index, const QVariant &data)

Setzt die Daten der Registerkarte an der Position index auf data.

Siehe auch tabData().

void QTabBar::setTabEnabled(int index, bool enabled)

Wenn enabled wahr ist, wird die Registerkarte an der Position index aktiviert; andernfalls wird das Element an der Position index deaktiviert.

Siehe auch isTabEnabled().

void QTabBar::setTabIcon(int index, const QIcon &icon)

Setzt das Symbol der Registerkarte an der Position index auf icon.

Siehe auch tabIcon().

void QTabBar::setTabText(int index, const QString &text)

Setzt den Text der Registerkarte an der Position index auf text.

Siehe auch tabText().

void QTabBar::setTabTextColor(int index, const QColor &color)

Setzt die Farbe des Textes in der Registerkarte mit dem angegebenen index auf die angegebene color.

Wenn eine ungültige Farbe angegeben wird, verwendet die Registerkarte stattdessen die QTabBar Vordergrundrolle.

Siehe auch tabTextColor().

void QTabBar::setTabToolTip(int index, const QString &tip)

Setzt den Tooltip der Registerkarte an der Position index auf tip.

Siehe auch tabToolTip().

void QTabBar::setTabVisible(int index, bool visible)

Wenn visible wahr ist, wird der Tabulator an der Position index sichtbar, andernfalls wird er ausgeblendet.

Siehe auch isTabVisible().

void QTabBar::setTabWhatsThis(int index, const QString &text)

Setzt den What's This-Hilfetext der Registerkarte an der Position index auf text.

Siehe auch tabWhatsThis().

[override virtual protected] void QTabBar::showEvent(QShowEvent *)

Reimplements: QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QTabBar::sizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

int QTabBar::tabAt(const QPoint &position) const

Gibt den Index der Registerkarte zurück, die position abdeckt, oder -1, wenn keine Registerkarte position abdeckt;

[signal] void QTabBar::tabBarClicked(int index)

Dieses Signal wird ausgegeben, wenn der Benutzer auf eine Registerkarte unter index klickt.

index ist der Index einer angeklickten Registerkarte, oder -1, wenn sich keine Registerkarte unter dem Cursor befindet.

[signal] void QTabBar::tabBarDoubleClicked(int index)

Dieses Signal wird ausgegeben, wenn der Benutzer einen Doppelklick auf eine Registerkarte unter index ausführt.

index bezieht sich auf die angeklickte Registerkarte, oder -1, wenn sich keine Registerkarte unter dem Cursor befindet.

QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const

Gibt das Widget zurück, das einen Reiter index und position oder nullptr gesetzt hat, falls keiner gesetzt ist.

Siehe auch setTabButton().

[signal] void QTabBar::tabCloseRequested(int index)

Dieses Signal wird ausgegeben, wenn die Schaltfläche "Schließen" auf einer Registerkarte angeklickt wird. Die index ist der Index, der entfernt werden soll.

Siehe auch setTabsClosable().

QVariant QTabBar::tabData(int index) const

Gibt die Daten der Registerkarte an der Position index zurück oder eine Nullvariante, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabData().

QIcon QTabBar::tabIcon(int index) const

Gibt das Symbol der Registerkarte an der Position index zurück, oder ein Null-Symbol, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabIcon().

[virtual protected] void QTabBar::tabInserted(int index)

Dieser virtuelle Handler wird aufgerufen, nachdem ein neuer Tabulator an der Position index hinzugefügt oder eingefügt wurde.

Siehe auch tabRemoved().

[virtual protected] void QTabBar::tabLayoutChange()

Dieser virtuelle Handler wird immer dann aufgerufen, wenn sich das Layout der Registerkarte ändert.

Siehe auch tabRect().

[signal] void QTabBar::tabMoved(int from, int to)

Dieses Signal wird ausgegeben, wenn der Tabulator die Registerkarte an der Indexposition from zur Indexposition to verschoben hat.

Hinweis: QTabWidget wird die Seite automatisch verschieben, wenn dieses Signal von der Tabulatorleiste ausgegeben wird.

Siehe auch moveTab().

QRect QTabBar::tabRect(int index) const

Liefert das sichtbare Rechteck der Registerkarte an der Position index oder ein Null-Rechteck, wenn index ausgeblendet ist oder außerhalb des Bereichs liegt.

[virtual protected] void QTabBar::tabRemoved(int index)

Dieser virtuelle Handler wird aufgerufen, nachdem ein Tabulator von der Position index entfernt wurde.

Siehe auch tabInserted().

[virtual protected] QSize QTabBar::tabSizeHint(int index) const

Gibt den Größenhinweis für den Tabulator an der Position index zurück.

QString QTabBar::tabText(int index) const

Gibt den Text des Tabulators an der Position index zurück, oder eine leere Zeichenkette, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabText().

QColor QTabBar::tabTextColor(int index) const

Gibt die Textfarbe der Registerkarte mit der angegebenen index zurück, oder eine ungültige Farbe, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabTextColor().

QString QTabBar::tabToolTip(int index) const

Gibt den Tooltip der Registerkarte an der Position index zurück oder einen leeren String, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabToolTip().

QString QTabBar::tabWhatsThis(int index) const

Gibt den What's This-Hilfetext der Registerkarte an der Position index zurück, oder eine leere Zeichenkette, wenn index außerhalb des Bereichs liegt.

Siehe auch setTabWhatsThis().

[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)

Reimplements: QObject::timerEvent(QTimerEvent *event).

[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)

Reimplements: QWidget::wheelEvent(QWheelEvent *event).

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.