QTabBar Class
Die Klasse „QTabBar“ stellt eine Registerleiste bereit, die beispielsweise in Dialogen mit Registerkarten verwendet werden kann. Mehr...
| Header: | #include <QTabBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | 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 |
Neu implementierte ö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 |
Neu implementierte 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 |
Ausführliche Beschreibung
QTabBar ist einfach zu verwenden; sie zeichnet die Registerkarten mithilfe einer der vordefinierten Funktionen ` shapes` und sendet ein Signal, wenn eine Registerkarte ausgewählt wird. Sie kann unterklasseiert werden, um das Erscheinungsbild anzupassen. Qt stellt außerdem eine vorgefertigte Klasse ` QTabWidget` zur Verfügung.
Jede Registerkarte verfügt über eine „ tabText()“, eine optionale „ tabIcon()“, eine optionale „ tabToolTip()“, eine optionale „ tabWhatsThis()“ und eine optionale „ tabData()“. Die Attribute der Registerkarten können mit „ setTabText()“, „ setTabIcon()“, „ setTabToolTip()“, „ setTabWhatsThis “ und „ setTabData()“ geändert werden. Jede Registerkarte kann einzeln mit „ setTabEnabled()“ aktiviert oder deaktiviert werden.
Jede Registerkarte kann Text in einer eigenen Farbe anzeigen. Die aktuelle Textfarbe einer Registerkarte kann mit der Funktion „ tabTextColor “ () ermittelt werden. Die Textfarbe einer bestimmten Registerkarte lässt sich mit „ setTabTextColor “ () festlegen.
Registerkarten werden mit ` addTab()` hinzugefügt oder mit ` insertTab()` an bestimmten Positionen eingefügt. Die Gesamtzahl der Registerkarten wird durch ` count()` angegeben. Registerkarten können mit ` removeTab()` aus der Registerkartenleiste entfernt werden. Durch die Kombination von ` removeTab()` und ` insertTab()` können Sie Registerkarten an verschiedene Positionen verschieben.
Die Eigenschaft „ shape “ definiert das Erscheinungsbild der Registerkarten. Die Wahl der Form ist Geschmackssache, obwohl Registerkartendialoge (für Einstellungen und Ähnliches) ausnahmslos „ RoundedNorth “ verwenden. Registerkartensteuerelemente in anderen Fenstern als Dialogfeldern verwenden fast immer entweder „ RoundedSouth “ oder „ TriangularSouth “. Viele Tabellenkalkulationsprogramme und andere Registerkartensteuerelemente, bei denen alle Seiten im Wesentlichen ähnlich sind, verwenden „ TriangularSouth “, während „ RoundedSouth “ meist dann zum Einsatz kommt, wenn sich die Seiten unterscheiden (z. B. bei einer mehrseitigen Werkzeugpalette). Die Standardeinstellung in QTabBar ist „ RoundedNorth “.
Der wichtigste Teil der API von QTabBar ist das Signal „ currentChanged()“. Dieses wird immer dann ausgelöst, wenn sich die aktuelle Registerkarte ändert (auch beim Start, wenn die aktuelle Registerkarte von „none“ wechselt). Es gibt außerdem einen Slot, „ setCurrentIndex()“, mit dem eine Registerkarte programmgesteuert ausgewählt werden kann. Die Funktion „ currentIndex()“ gibt den Index der aktuellen Registerkarte zurück, „ count “ enthält die Anzahl der Registerkarten.
QTabBar erstellt automatisch Mnemonik-Tasten nach dem Muster „ QAbstractButton “; wenn beispielsweise die Beschriftung eines Reiters „&Graphics“ lautet, wird Alt+G zur Tastenkombination, um zu diesem Reiter zu wechseln.
Die folgenden virtuellen Funktionen müssen möglicherweise neu implementiert werden, um das Erscheinungsbild anzupassen oder zusätzliche Daten für jede Registerkarte zu speichern:
- tabSizeHint() berechnet 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() zeichnet alle Registerkarten.
Für Unterklassen benötigen Sie möglicherweise auch die Funktionen „ tabRect “ (), die die visuelle Geometrie einer einzelnen Registerkarte zurückgeben.
 | Eine Registerkartenleiste im Fusion-Widget-Stil. |
 | Eine abgeschnittene Registerkartenleiste im Fusion-Widget-Stil. |
Siehe auch QTabWidget.
Dokumentation zu Mitgliedstypen
enum QTabBar::ButtonPosition
Dieser Enum-Typ gibt die Position des Widgets auf einer Registerkarte an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QTabBar::LeftSide | 0 | Linke Seite der Registerkarte. |
QTabBar::RightSide | 1 | Rechte Seite der Registerkarte. |
enum QTabBar::SelectionBehavior
Dieser Enum-Typ listet das Verhalten von „ QTabBar “ auf, wenn eine Registerkarte entfernt wird und die zu entfernende Registerkarte gleichzeitig die aktuelle Registerkarte ist.
| Konstante | Wert | Beschreibung |
|---|---|---|
QTabBar::SelectLeftTab | 0 | Wählen Sie die Registerkarte links neben der zu entfernenden Registerkarte aus. |
QTabBar::SelectRightTab | 1 | Wählt die Registerkarte rechts neben der zu entfernenden Registerkarte aus. |
QTabBar::SelectPreviousTab | 2 | Wählen Sie die zuvor ausgewählte Registerkarte aus. |
enum QTabBar::Shape
Dieser Enum-Typ listet die von QTabBar unterstützten integrierten Formen auf. Betrachten Sie diese Angaben als Hinweise, da manche Stile bestimmte Formen möglicherweise nicht darstellen. Die Position sollte jedoch berücksichtigt werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QTabBar::RoundedNorth | 0 | Das normale, abgerundete Erscheinungsbild oberhalb der Seiten |
QTabBar::RoundedSouth | 1 | Das normale, abgerundete Erscheinungsbild unterhalb der Seiten |
QTabBar::RoundedWest | 2 | Das normale, abgerundete Aussehen auf der linken Seite der Seiten |
QTabBar::RoundedEast | 3 | Das normale, abgerundete Aussehen auf der rechten Seite der Seiten |
QTabBar::TriangularNorth | 4 | Dreieckige Registerkarten oberhalb der Seiten. |
QTabBar::TriangularSouth | 5 | Dreieckige Registerkarten, ähnlich denen, die beispielsweise in der Excel-Tabelle verwendet werden |
QTabBar::TriangularWest | 6 | Dreieckige Registerkarten auf der linken Seite der Seiten. |
QTabBar::TriangularEast | 7 | Dreieckige Registerkarten auf der rechten Seite der Seiten. |
Eigenschaftsdokumentation
autoHide : bool
Wenn „true“, wird die Registerkartenleiste automatisch ausgeblendet, sobald sie weniger als 2 Registerkarten enthält.
Standardmäßig ist diese Eigenschaft auf „false“ gesetzt.
Zugriffsfunktionen:
| bool | autoHide() const |
| void | setAutoHide(bool hide) |
Siehe auch „ QWidget::visible “.
changeCurrentOnDrag : bool
Wenn dieser Wert auf „true“ gesetzt ist, wird die aktuelle Registerkarte automatisch gewechselt, wenn der Mauszeiger über die Registerkartenleiste gezogen wird.
Hinweis: Damit diese Funktion funktioniert, solltenSie außerdem die Eigenschaft „acceptDrops“ auf „true“ setzen.
Standardmäßig ist diese Eigenschaft auf „false“ gesetzt.
Zugriffsfunktionen:
| bool | changeCurrentOnDrag() const |
| void | setChangeCurrentOnDrag(bool change) |
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Registerkarten in der Registerkartenleiste an
Zugriffsfunktionen:
| int | count() const |
currentIndex : int
Diese Eigenschaft enthält den Index der sichtbaren Registerkarte in der Registerkartenleiste
Der aktuelle Index ist -1, wenn keine Registerkarte ausgewählt ist.
Zugriffsfunktionen:
| int | currentIndex() const |
| void | setCurrentIndex(int index) |
Notifier-Signal:
| void | currentChanged(int index) |
documentMode : bool
Diese Eigenschaft gibt an, ob die Registerkartenleiste in einem für das Hauptfenster geeigneten Modus dargestellt wird oder nicht.
Diese Eigenschaft dient als Hinweis für Stile, um die Registerkarten anders darzustellen, als sie normalerweise in einem Registerkarten-Widget erscheinen würden. Unter macOS sieht dies ähnlich aus wie die Registerkarten in Safari oder in der Terminal.app von Sierra.
Zugriffsfunktionen:
| bool | documentMode() const |
| void | setDocumentMode(bool set) |
Siehe auch „ QTabWidget::documentMode “.
drawBase : bool
Legt fest, ob die Tab-Leiste ihre Basis anzeigen soll oder nicht.
Ist der Wert „true“, zeichnet „ QTabBar “ eine Basis entsprechend der Überlappung der Stile. Andernfalls werden nur die Registerkarten gezeichnet.
Zugriffsfunktionen:
| bool | drawBase() const |
| void | setDrawBase(bool drawTheBase) |
Siehe auch „ QStyle::pixelMetric()“, „ QStyle::PM_TabBarBaseOverlap “ und „ QStyleOptionTabBarBase “.
elideMode : Qt::TextElideMode
So wird Text in der Tab-Leiste abgeschnitten
Diese Eigenschaft legt fest, wie Elemente gekürzt werden, wenn bei einer bestimmten Größe der Tab-Leiste nicht genügend Platz für ihre Anzeige vorhanden ist.
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 „Expandieren“ auf „true“ gesetzt ist, erweitert QTabBar die Registerkarten, um den freien Platz auszunutzen.
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 Tab-Leiste fest
Der Standardwert ist stilabhängig. „ iconSize “ ist eine maximale Größe; kleinere Symbole werden nicht vergrößert.
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 Registerkartenbereichs verschieben kann.
Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt;
Zugriffsfunktionen:
| bool | isMovable() const |
| void | setMovable(bool movable) |
selectionBehaviorOnRemove : SelectionBehavior
Welcher Reiter soll beim Aufruf von „ removeTab “ als aktueller Reiter festgelegt werden, wenn der entfernte Reiter gleichzeitig der aktuelle Reiter ist?
Standardmäßig lautet der Wert „ SelectRightTab “.
Zugriffsfunktionen:
| QTabBar::SelectionBehavior | selectionBehaviorOnRemove() const |
| void | setSelectionBehaviorOnRemove(QTabBar::SelectionBehavior behavior) |
Siehe auch ` removeTab()`.
shape : Shape
Diese Eigenschaft legt die Form der Registerkarten in der Registerkartenleiste fest
Mögliche Werte für diese Eigenschaft werden durch die Enumeration „Shape“ beschrieben.
Zugriffsfunktionen:
| QTabBar::Shape | shape() const |
| void | setShape(QTabBar::Shape shape) |
tabsClosable : bool
Diese Eigenschaft legt fest, ob eine Registerkartenleiste auf jeder Registerkarte Schließen-Schaltflächen anzeigen soll oder nicht
Wenn „tabsClosable“ auf „true“ gesetzt ist, erscheint je nach Stil entweder auf der linken oder rechten Seite der Registerkarte eine Schließen-Schaltfläche. Wenn die Schaltfläche direkt angeklickt wird oder ein Klick mit der mittleren Maustaste an einer beliebigen Stelle der Registerkarte erfolgt, wird das Signal „ tabCloseRequested “ ausgelöst.
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 Tab-Leiste bei einer großen Anzahl von Tabs Schaltflächen zum Blättern zwischen den Tabs verwenden soll oder nicht.
Wenn eine Tab-Leiste zu viele Tabs für ihre Größe enthält, kann sie entweder ihre Größe erweitern oder Schaltflächen hinzufügen, mit denen Sie durch die Tabs 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 zu Mitgliedsfunktionen
[explicit] QTabBar::QTabBar(QWidget *parent = nullptr)
Erstellt eine neue Registerkartenleiste mit dem angegebenen „ parent “.
[virtual noexcept] QTabBar::~QTabBar()
Löscht die Registerkartenleiste.
QString QTabBar::accessibleTabName(int index) const
Gibt den „accessibleName“ des Tab-Elements an der Position index zurück oder eine leere Zeichenkette, wenn index außerhalb des zulässigen 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)
Fügt eine neue Registerkarte mit dem Symbol „ icon “ und dem Text „ text “ hinzu. Gibt den Index der neuen Registerkarte zurück.
Dies ist eine überladene Funktion.
[override virtual protected] void QTabBar::changeEvent(QEvent *event)
Umsetzt: ` QWidget::changeEvent(QEvent *event)`.
[signal] void QTabBar::currentChanged(int index)
Dieses Signal wird ausgelöst, wenn sich der aktuell aktive Reiter in der Reiterleiste ändert. Der neue aktive Reiter hat die angegebene Eigenschaft „ index “ oder den Wert -1, wenn kein neuer Reiter vorhanden ist (beispielsweise, wenn in der Eigenschaft „ QTabBar “ kein Reiter vorhanden ist).
Hinweis: Notifier -Signal für die Eigenschaft ` currentIndex`.
[override virtual protected] bool QTabBar::event(QEvent *event)
Umsetzt: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QTabBar::hideEvent(QHideEvent *)
Implementiert: ` QWidget::hideEvent(QHideEvent *event)`.
[virtual protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const
Initialisieren Sie ` option ` mit den Werten aus der Registerkarte unter tabIndex. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionTab` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch ` QStyleOption::initFrom()` und ` QTabWidget::initStyleOption()`.
int QTabBar::insertTab(int index, const QString &text)
Fügt an der Position „ index “ einen neuen Tab mit dem Text „ text “ ein. Liegt „ index “ außerhalb des zulässigen Bereichs, wird der neue Tab angehängt. Gibt den Index des neuen Tabs zurück.
int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)
Fügt an der Position index einen neuen Tab mit dem Symbol icon und dem Text text ein. Liegt index außerhalb des zulässigen Bereichs, wird der neue Tab angehängt. Gibt den Index des neuen Tabs zurück.
War die QTabBar vor dem Aufruf dieser Funktion leer, wird die eingefügte Registerkarte zur aktuellen Registerkarte.
Wird ein neuer Tab an einem Index eingefügt, der kleiner oder gleich dem aktuellen Index ist, wird der aktuelle Index erhöht, der aktuelle Tab bleibt jedoch erhalten.
Dies ist eine überladene Funktion.
bool QTabBar::isTabEnabled(int index) const
Gibt „ true “ zurück, wenn die Registerkarte an der Position „ index “ aktiviert ist; andernfalls wird „ false “ zurückgegeben.
bool QTabBar::isTabVisible(int index) const
Gibt „true“ zurück, wenn die Registerkarte an der Position „ index “ sichtbar ist; andernfalls wird „false“ zurückgegeben.
[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)
Implementiert: ` QWidget::keyPressEvent` (`QKeyEvent *event`).
[override virtual] QSize QTabBar::minimumSizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.
[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const
Gibt den Mindestwert für die Tabulatorgröße des Tabulators an der Position index zurück.
[override virtual protected] void QTabBar::mouseDoubleClickEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseDoubleClickEvent` (`QMouseEvent *event`).
[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.
[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)
Implementiert: ` QWidget::mousePressEvent` (`QMouseEvent *event`).
[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).
void QTabBar::moveTab(int from, int to)
Verschiebt das Element an der Indexposition from an die Indexposition to.
Siehe auch tabMoved() und tabLayoutChange().
[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)
Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).
void QTabBar::removeTab(int index)
Entfernt die Registerkarte an der Position index.
Siehe auch SelectionBehavior.
[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)
Implementiert: ` QWidget::resizeEvent(QResizeEvent *event)`.
void QTabBar::setAccessibleTabName(int index, const QString &name)
Setzt den „accessibleName“ des Reiters 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 Einstellung unter „ position “ links oder rechts platziert.
Jedes zuvor unter „ position “ festgelegte Widget wird ausgeblendet. Wenn Sie „ widget “ auf „ nullptr “ setzen, wird das aktuelle Widget unter „ position “ ausgeblendet.
Die Registerkartenleiste übernimmt die Verantwortung für das Widget, sodass alle hier festgelegten Widgets von der Registerkartenleiste gelöscht werden, wenn diese zerstört wird, es sei denn, Sie weisen dem Widget nach dem Festlegen eines anderen Widgets (oder von nullptr) separat eine neue übergeordnete Instanz zu.
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, ist die Registerkarte an der Position „ index “ aktiviert; andernfalls ist 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)
Legt die Farbe des Textes in der Registerkarte mit der angegebenen „ index “ auf die angegebene „ color “ fest.
Wird eine ungültige Farbe angegeben, verwendet die Registerkarte stattdessen die Vordergrundfarbe „ QTabBar “.
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 die Registerkarte an der Position „ index “ sichtbar gemacht, andernfalls wird sie ausgeblendet.
Siehe auch isTabVisible().
void QTabBar::setTabWhatsThis(int index, const QString &text)
Setzt den „Was ist das?“-Hilfetext der Registerkarte an der Position index auf text.
Siehe auch tabWhatsThis().
[override virtual protected] void QTabBar::showEvent(QShowEvent *)
Implementiert: ` QWidget::showEvent(QShowEvent *event)`.
[override virtual] QSize QTabBar::sizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.
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 ausgelöst, wenn der Benutzer auf eine Registerkarte auf index klickt.
index ist der Index der angeklickten Registerkarte oder -1, wenn sich keine Registerkarte unter dem Cursor befindet.
[signal] void QTabBar::tabBarDoubleClicked(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer auf index auf eine Registerkarte doppelklickt.
index Bezieht sich auf die angeklickte Registerkarte oder auf -1, wenn sich keine Registerkarte unter dem Cursor befindet.
QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const
Gibt die im Widget festgelegte Registerkarte „ index “ zurück und „ position “ oder „ nullptr “, falls keine festgelegt ist.
Siehe auch setTabButton().
[signal] void QTabBar::tabCloseRequested(int index)
Dieses Signal wird ausgelöst, wenn auf die Schaltfläche „Schließen“ eines Tabs geklickt wird. „ index “ ist der Index, der entfernt werden soll.
Siehe auch ` setTabsClosable()`.
QVariant QTabBar::tabData(int index) const
Gibt die Daten des Tabs an der Position index zurück oder eine Null-Variante, wenn index außerhalb des zulässigen 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 zulässigen Bereichs liegt.
Siehe auch setTabIcon().
[virtual protected] void QTabBar::tabInserted(int index)
Dieser virtuelle Handler wird aufgerufen, nachdem ein neuer Tab 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 Tab-Layout ändert.
Siehe auch „ tabRect()“.
[signal] void QTabBar::tabMoved(int from, int to)
Dieses Signal wird ausgelöst, wenn der Tab den Tab an der Indexposition from an die Indexposition to verschoben hat.
Hinweis: QTabWidget verschiebt die Seite automatisch, wenn dieses Signal von der Registerkartenleiste ausgegeben wird.
Siehe auch moveTab().
QRect QTabBar::tabRect(int index) const
Gibt das visuelle Rechteck der Registerkarte an der Position index zurück 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 an der Position index entfernt wurde.
Siehe auch tabInserted().
[virtual protected] QSize QTabBar::tabSizeHint(int index) const
Gibt den Größenhinweis für die Registerkarte an der Position index zurück.
QString QTabBar::tabText(int index) const
Gibt den Text der Registerkarte an der Position index zurück oder eine leere Zeichenkette, wenn index außerhalb des zulässigen Bereichs liegt.
Siehe auch setTabText().
QColor QTabBar::tabTextColor(int index) const
Gibt die Textfarbe der Registerkarte mit dem angegebenen „ index “ zurück oder eine ungültige Farbe, wenn „ index “ außerhalb des zulässigen Bereichs liegt.
Siehe auch ` setTabTextColor()`.
QString QTabBar::tabToolTip(int index) const
Gibt den Tooltip der Registerkarte an der Position index zurück oder eine leere Zeichenkette, wenn index außerhalb des zulässigen Bereichs liegt.
Siehe auch setTabToolTip().
QString QTabBar::tabWhatsThis(int index) const
Gibt den „Was ist das?“-Hilfetext der Registerkarte an der Position index zurück oder eine leere Zeichenkette, wenn index außerhalb des zulässigen Bereichs liegt.
Siehe auch setTabWhatsThis().
[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)
Implementiert: ` QObject::timerEvent(QTimerEvent *event)`.
[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)
Implementiert: ` QWidget::wheelEvent` (`QWheelEvent *event`).
© 2026 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.
