QTabWidget Class

Die Klasse QTabWidget bietet einen Stapel von Widgets mit Registerkarten. Mehr...

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

Öffentliche Typen

enum TabPosition { North, South, West, East }
enum TabShape { Rounded, Triangular }

Eigenschaften

Öffentliche Funktionen

QTabWidget(QWidget *parent = nullptr)
virtual ~QTabWidget()
int addTab(QWidget *page, const QString &label)
int addTab(QWidget *page, const QIcon &icon, const QString &label)
void clear()
QWidget *cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const
int count() const
int currentIndex() const
QWidget *currentWidget() const
bool documentMode() const
Qt::TextElideMode elideMode() const
QSize iconSize() const
int indexOf(const QWidget *w) const
int insertTab(int index, QWidget *page, const QString &label)
int insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)
bool isMovable() const
bool isTabEnabled(int index) const
bool isTabVisible(int index) const
void removeTab(int index)
void setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)
void setDocumentMode(bool set)
void setElideMode(Qt::TextElideMode mode)
void setIconSize(const QSize &size)
void setMovable(bool movable)
void setTabBarAutoHide(bool enabled)
void setTabEnabled(int index, bool enable)
void setTabIcon(int index, const QIcon &icon)
void setTabPosition(QTabWidget::TabPosition position)
void setTabShape(QTabWidget::TabShape s)
void setTabText(int index, const QString &label)
void setTabToolTip(int index, const QString &tip)
void setTabVisible(int index, bool visible)
void setTabWhatsThis(int index, const QString &text)
void setTabsClosable(bool closeable)
void setUsesScrollButtons(bool useButtons)
QTabBar *tabBar() const
bool tabBarAutoHide() const
QIcon tabIcon(int index) const
QTabWidget::TabPosition tabPosition() const
QTabWidget::TabShape tabShape() const
QString tabText(int index) const
QString tabToolTip(int index) const
QString tabWhatsThis(int index) const
bool tabsClosable() const
bool usesScrollButtons() const
QWidget *widget(int index) const

Reimplementierte öffentliche Funktionen

virtual bool hasHeightForWidth() const override
virtual int heightForWidth(int width) const override
virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Öffentliche Slots

void setCurrentIndex(int index)
void setCurrentWidget(QWidget *widget)

Signale

void currentChanged(int index)
void tabBarClicked(int index)
void tabBarDoubleClicked(int index)
void tabCloseRequested(int index)

Geschützte Funktionen

virtual void initStyleOption(QStyleOptionTabWidgetFrame *option) const
void setTabBar(QTabBar *tb)
virtual void tabInserted(int index)
virtual void tabRemoved(int index)

Reimplementierte geschützte Funktionen

virtual void changeEvent(QEvent *ev) override
virtual bool event(QEvent *ev) override
virtual void keyPressEvent(QKeyEvent *e) override
virtual void paintEvent(QPaintEvent *event) override
virtual void resizeEvent(QResizeEvent *e) override
virtual void showEvent(QShowEvent *) override

Detaillierte Beschreibung

Ein Registerkarten-Widget bietet eine Registerkartenleiste (siehe QTabBar) und einen "Seitenbereich", der zur Anzeige von Seiten zu jeder Registerkarte verwendet wird. Standardmäßig wird die Registerkartenleiste oberhalb des Seitenbereichs angezeigt, aber es sind verschiedene Konfigurationen möglich (siehe TabPosition). Jeder Registerkarte ist ein anderes Widget (eine so genannte Seite) zugeordnet. Nur die aktuelle Seite wird im Seitenbereich angezeigt; alle anderen Seiten sind ausgeblendet. Der Benutzer kann eine andere Seite anzeigen, indem er auf die Registerkarte klickt oder die Tastenkombination Alt+Buchstabe drückt, falls es eine solche gibt.

Der normale Weg, QTabWidget zu verwenden, ist der folgende:

  1. Erstellen Sie ein QTabWidget.
  2. Erstellen Sie ein QWidget für jede der Seiten im Tab-Dialog, aber geben Sie keine übergeordneten Widgets für sie an.
  3. Fügen Sie Kind-Widgets in das Seiten-Widget ein und verwenden Sie Layouts, um sie wie gewohnt zu positionieren.
  4. Rufen Sie addTab() oder insertTab() auf, um die Seiten-Widgets in das Registerkarten-Widget einzufügen und geben Sie jeder Registerkarte eine geeignete Bezeichnung mit einem optionalen Tastaturkürzel.

Die Position der Registerkarten wird durch tabPosition definiert, ihre Form durch tabShape.

Das Signal currentChanged() wird ausgegeben, wenn der Benutzer eine Seite auswählt.

Der aktuelle Seitenindex ist als currentIndex() verfügbar, das aktuelle Seitenwidget mit currentWidget(). Sie können einen Zeiger auf ein Seiten-Widget mit einem bestimmten Index mit widget() abrufen, und Sie können die Indexposition eines Widgets mit indexOf() ermitteln. Verwenden Sie setCurrentWidget() oder setCurrentIndex(), um eine bestimmte Seite anzuzeigen.

Sie können den Text und das Symbol einer Registerkarte mit setTabText() oder setTabIcon() ändern. Eine Registerkarte und die zugehörige Seite können mit removeTab() entfernt werden.

Jede Registerkarte ist zu einem bestimmten Zeitpunkt entweder aktiviert oder deaktiviert (siehe setTabEnabled()). Wenn eine Registerkarte aktiviert ist, wird der Text der Registerkarte normal gezeichnet und der Benutzer kann diese Registerkarte auswählen. Wenn er deaktiviert ist, wird der Tabulator anders gezeichnet und der Benutzer kann ihn nicht auswählen. Beachten Sie, dass die Seite auch bei deaktivierter Registerkarte sichtbar sein kann, z. B. wenn alle Registerkarten deaktiviert sind.

Registerkarten-Widgets können eine sehr gute Möglichkeit sein, einen komplexen Dialog aufzuteilen. Eine Alternative ist die Verwendung eines QStackedWidget, für das Sie eine Möglichkeit zur Navigation zwischen den Seiten bereitstellen, z. B. ein QToolBar oder ein QListWidget.

Der größte Teil der Funktionalität in QTabWidget wird durch ein QTabBar (oben, für die Registerkarten) und ein QStackedWidget (der größte Teil des Bereichs, für die Organisation der einzelnen Seiten) bereitgestellt.

Siehe auch QTabBar, QStackedWidget, QToolBox, und Tab Dialog Example.

Dokumentation der Mitgliedstypen

enum QTabWidget::TabPosition

Dieser Enum-Typ definiert, wo QTabWidget die Tabulatorzeile zeichnet:

KonstanteWertBeschreibung
QTabWidget::North0Die Tabulatoren werden oberhalb der Seiten gezeichnet.
QTabWidget::South1Die Registerkarten werden unter den Seiten gezeichnet.
QTabWidget::West2Die Registerkarten werden links von den Seiten gezeichnet.
QTabWidget::East3Die Registerkarten werden rechts von den Seiten gezeichnet.

enum QTabWidget::TabShape

Dieser Enum-Typ definiert die Form der Tabs:

KonstanteWertBeschreibung
QTabWidget::Rounded0Die Registerkarten werden mit einem abgerundeten Aussehen gezeichnet. Dies ist die Standardform.
QTabWidget::Triangular1Die Registerkarten werden in dreieckiger Form gezeichnet.

Eigenschaft Dokumentation

[read-only] count : const int

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

Standardmäßig enthält diese Eigenschaft einen Wert von 0.

Zugriffsfunktionen:

int count() const

currentIndex : int

Diese Eigenschaft enthält die Indexposition der aktuellen Registerkarte

Der aktuelle Index ist -1, wenn es kein aktuelles Widget gibt.

Standardmäßig enthält diese Eigenschaft den Wert -1, da es anfangs keine Registerkarten im Widget gibt.

Zugriffsfunktionen:

int currentIndex() const
void setCurrentIndex(int index)

Benachrichtigungssignal:

void currentChanged(int index)

documentMode : bool

Diese Eigenschaft legt fest, ob das Registerkarten-Widget in einem für Dokumentenseiten geeigneten Modus dargestellt wird. Dies ist dasselbe wie der Dokumentenmodus unter macOS.

Wenn diese Eigenschaft gesetzt ist, wird der Rahmen des Registerkarten-Widgets nicht gerendert. Dieser Modus ist nützlich, um dokumentenartige Seiten anzuzeigen, bei denen die Seite den größten Teil des Tab-Widget-Bereichs abdeckt.

Zugriffsfunktionen:

bool documentMode() const
void setDocumentMode(bool set)

Siehe auch elideMode, QTabBar::documentMode, QTabBar::usesScrollButtons, und QStyle::SH_TabBar_PreferNoArrows.

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 QTabBar::elideMode, usesScrollButtons, und QStyle::SH_TabBar_ElideMode.

iconSize : QSize

Diese Eigenschaft bestimmt die Größe der Symbole in der Registerkartenleiste

Der Standardwert ist stilabhängig. Dies ist die maximale Größe, die die Symbole haben werden. Wenn die Icons kleiner sind, werden sie nicht vergrößert.

Zugriffsfunktionen:

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

Siehe auch QTabBar::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)

tabBarAutoHide : bool

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

Standardmäßig ist diese Eigenschaft falsch.

Zugriffsfunktionen:

bool tabBarAutoHide() const
void setTabBarAutoHide(bool enabled)

Siehe auch QWidget::visible.

tabPosition : TabPosition

Diese Eigenschaft enthält die Position der Registerkarten in diesem Registerkarten-Widget

Mögliche Werte für diese Eigenschaft werden durch die Aufzählung TabPosition beschrieben.

Standardmäßig ist diese Eigenschaft auf North gesetzt.

Zugriffsfunktionen:

QTabWidget::TabPosition tabPosition() const
void setTabPosition(QTabWidget::TabPosition position)

Siehe auch TabPosition.

tabShape : TabShape

Diese Eigenschaft enthält die Form der Registerkarten in diesem Registerkarten-Widget

Mögliche Werte für diese Eigenschaft sind QTabWidget::Rounded (Standard) oder QTabWidget::Triangular.

Zugriffsfunktionen:

QTabWidget::TabShape tabShape() const
void setTabShape(QTabWidget::TabShape s)

Siehe auch TabShape.

tabsClosable : bool

Diese Eigenschaft legt fest, ob die Schaltflächen zum Schließen automatisch zu jeder Registerkarte hinzugefügt werden.

Zugriffsfunktionen:

bool tabsClosable() const
void setTabsClosable(bool closeable)

Siehe auch QTabBar::tabsClosable().

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, QTabBar::usesScrollButtons, und QStyle::SH_TabBar_PreferNoArrows.

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Registerkarten-Widget mit übergeordnetem parent.

[virtual noexcept] QTabWidget::~QTabWidget()

Zerstört das Registerkarten-Widget.

int QTabWidget::addTab(QWidget *page, const QString &label)

Fügt eine Registerkarte mit den angegebenen page und label zum Registerkarten-Widget hinzu und gibt den Index der Registerkarte in der Registerkartenleiste zurück. Die Eigentümerschaft von page wird an QTabWidget weitergegeben.

Wenn die Registerkarte label ein kaufmännisches Und enthält, wird der Buchstabe nach dem kaufmännischen Und als Tastenkürzel für die Registerkarte verwendet, z. B. wenn die Bezeichnung "Bro&wse" lautet, wird Alt+W zu einem Tastenkürzel, das den Fokus auf diese Registerkarte verschiebt.

Hinweis: Wenn Sie addTab() nach show() aufrufen, versucht das Layoutsystem, sich an die Änderungen in der Widgethierarchie anzupassen, was zu einem Flackern führen kann. Um dies zu verhindern, können Sie die Eigenschaft QWidget::updatesEnabled vor den Änderungen auf false setzen; denken Sie daran, die Eigenschaft auf true zu setzen, wenn die Änderungen abgeschlossen sind, damit das Widget wieder Malereignisse empfängt.

Siehe auch insertTab().

int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label)

Dies ist eine überladene Funktion.

Fügt eine Registerkarte mit den angegebenen page, icon und label zum Registerkarten-Widget hinzu und gibt den Index der Registerkarte in der Registerkartenleiste zurück. Die Eigentümerschaft von page wird an QTabWidget weitergegeben.

Diese Funktion ist die gleiche wie addTab(), jedoch mit einem zusätzlichen icon.

[override virtual protected] void QTabWidget::changeEvent(QEvent *ev)

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

void QTabWidget::clear()

Entfernt alle Seiten, löscht sie aber nicht. Der Aufruf dieser Funktion ist gleichbedeutend mit dem Aufruf von removeTab(), bis das Tab-Widget leer ist.

QWidget *QTabWidget::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

Gibt das Widget zurück, das in corner des Tab-Widgets oder nullptr angezeigt wird.

Siehe auch setCornerWidget().

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

Dieses Signal wird ausgegeben, wenn sich der aktuelle Seitenindex ändert. Der Parameter ist die neue Position der aktuellen Seite index oder -1, wenn es keine neue gibt (z.B. wenn es keine Widgets in der QTabWidget gibt).

Hinweis: Benachrichtigungssignal für die Eigenschaft currentIndex.

Siehe auch currentWidget() und currentIndex.

QWidget *QTabWidget::currentWidget() const

Gibt einen Zeiger auf die Seite zurück, die gerade vom Tab-Dialog angezeigt wird. Das Registerkarten-Dialogfeld tut sein Bestes, um sicherzustellen, dass dieser Wert niemals 0 ist (aber wenn man sich genug Mühe gibt, kann er es sein).

Siehe auch currentIndex() und setCurrentWidget().

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

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

[override virtual] bool QTabWidget::hasHeightForWidth() const

Reimplements: QWidget::hasHeightForWidth() const.

[override virtual] int QTabWidget::heightForWidth(int width) const

Reimplements: QWidget::heightForWidth(int w) const.

int QTabWidget::indexOf(const QWidget *w) const

Gibt die Indexposition der Seite zurück, die das Widget w belegt, oder -1, wenn das Widget nicht gefunden werden kann.

[virtual protected] void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const

Initialisieren Sie option mit den Werten aus dieser QTabWidget. Diese Methode ist für Unterklassen nützlich, wenn sie eine QStyleOptionTabWidgetFrame benötigen, aber nicht alle Informationen selbst ausfüllen wollen.

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

int QTabWidget::insertTab(int index, QWidget *page, const QString &label)

Fügt eine Registerkarte mit den angegebenen label und page in das Registerkarten-Widget an der angegebenen index ein und gibt den Index der eingefügten Registerkarte in der Registerkartenleiste zurück. Die Eigentümerschaft von page wird an QTabWidget weitergegeben.

Die Beschriftung wird in der Registerkarte angezeigt und kann je nach der Konfiguration des Registerkarten-Widgets unterschiedlich aussehen.

Wenn die Registerkarte label ein kaufmännisches Und enthält, wird der Buchstabe nach dem kaufmännischen Und als Tastenkombination für die Registerkarte verwendet, z. B. wenn die Bezeichnung "Bro&wse" lautet, wird Alt+W zu einer Tastenkombination, die den Fokus auf diese Registerkarte verschiebt.

Wenn index außerhalb des Bereichs liegt, wird die Registerkarte einfach angehängt. Andernfalls wird sie an der angegebenen Position eingefügt.

Wenn QTabWidget leer war, bevor diese Funktion aufgerufen wurde, wird die neue Seite zur aktuellen Seite. Wird ein neuer Tabulator an einem Index eingefügt, der kleiner oder gleich dem aktuellen Index ist, wird der aktuelle Index erhöht, aber die aktuelle Seite bleibt erhalten.

Hinweis: Wenn Sie insertTab() nach show() aufrufen, versucht das Layoutsystem, sich an die Änderungen in der Widgethierarchie anzupassen, was zu einem Flackern führen kann. Um dies zu verhindern, können Sie die Eigenschaft QWidget::updatesEnabled vor den Änderungen auf false setzen; denken Sie daran, die Eigenschaft auf true zu setzen, wenn die Änderungen abgeschlossen sind, damit das Widget wieder Malereignisse empfängt.

Siehe auch addTab().

int QTabWidget::insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)

Dies ist eine überladene Funktion.

Fügt eine Registerkarte mit den angegebenen label, page und icon in das Registerkarten-Widget an der angegebenen index ein und gibt den Index der eingefügten Registerkarte in der Registerkartenleiste zurück. Die Eigentümerschaft von page wird an QTabWidget weitergegeben.

Diese Funktion ist die gleiche wie insertTab(), aber mit einem zusätzlichen icon.

bool QTabWidget::isTabEnabled(int index) const

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

Siehe auch setTabEnabled() und QWidget::isEnabled().

bool QTabWidget::isTabVisible(int index) const

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

Siehe auch setTabVisible().

[override virtual protected] void QTabWidget::keyPressEvent(QKeyEvent *e)

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

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

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

Gibt eine geeignete Mindestgröße für das Registerkarten-Widget zurück.

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

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

Zeichnet die Registerkartenleiste des Registerkarten-Widgets als Reaktion auf das Paint-Ereignis event.

void QTabWidget::removeTab(int index)

Entfernt die Registerkarte an der Position index aus diesem Stapel von Widgets. Das Seiten-Widget selbst wird nicht gelöscht.

Siehe auch addTab() und insertTab().

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

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

void QTabWidget::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

Legt fest, dass das angegebene widget in der angegebenen corner des Registerkarten-Widgets angezeigt wird. Die Geometrie des Widgets wird anhand der sizeHint() und style() des Widgets bestimmt.

Es wird nur das horizontale Element des corner verwendet.

Die Übergabe von nullptr zeigt kein Widget in der Ecke an.

Jedes zuvor gesetzte Eck-Widget wird ausgeblendet.

Alle hier gesetzten Widgets werden vom Tab-Widget gelöscht, wenn es zerstört wird, es sei denn, Sie reparieren das Widget separat, nachdem Sie ein anderes Eck-Widget (oder nullptr) gesetzt haben.

Hinweis: Eck-Widgets sind für die Registerkartenpositionen North und South konzipiert; andere Ausrichtungen funktionieren bekanntermaßen nicht richtig.

Siehe auch cornerWidget() und setTabPosition().

[slot] void QTabWidget::setCurrentWidget(QWidget *widget)

Macht widget zum aktuellen Widget. Die verwendete widget muss eine Seite in diesem Tab-Widget sein.

Siehe auch addTab(), setCurrentIndex(), und currentWidget().

[protected] void QTabWidget::setTabBar(QTabBar *tb)

Ersetzt die Überschrift des Dialogs QTabBar durch die Registerkartenleiste tb. Beachten Sie, dass dies aufgerufen werden muss , bevor irgendwelche Registerkarten hinzugefügt wurden, oder das Verhalten ist undefiniert.

Siehe auch tabBar().

void QTabWidget::setTabEnabled(int index, bool enable)

Wenn enable wahr ist, wird die Seite an Position index aktiviert; andernfalls wird die Seite an Position index deaktiviert. Die Registerkarte der Seite wird entsprechend neu gezeichnet.

QTabWidget verwendet intern QWidget::setEnabled(), anstatt ein separates Flag zu führen.

Beachten Sie, dass auch eine deaktivierte Registerkarte/Seite sichtbar sein kann. Wenn die Seite bereits sichtbar ist, wird QTabWidget sie nicht ausblenden; wenn alle Seiten deaktiviert sind, wird QTabWidget eine von ihnen anzeigen.

Siehe auch isTabEnabled() und QWidget::setEnabled().

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

Setzt die icon für den Tabulator an der Position index.

Siehe auch tabIcon().

void QTabWidget::setTabText(int index, const QString &label)

Definiert eine neue label für die Seite an der Position index's tab.

Wenn der angegebene Text ein kaufmännisches Und-Zeichen ('&') enthält, wird automatisch ein Tastaturkürzel für ihn erstellt. Das Zeichen, das auf das '&' folgt, wird als Tastenkürzel verwendet. Jede vorherige Tastenkombination wird überschrieben oder gelöscht, wenn keine Tastenkombination durch den Text definiert ist. Einzelheiten finden Sie in der Dokumentation QShortcut (um ein echtes kaufmännisches Und darzustellen, verwenden Sie '&&').

Siehe auch tabText().

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

Setzt den Tabulator-Tooltip für die Seite an der Position index auf tip.

Siehe auch tabToolTip().

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

Wenn visible wahr ist, ist die Seite an der Position index sichtbar, andernfalls ist die Seite an der Position index ausgeblendet. Die Registerkarte der Seite wird entsprechend neu gezeichnet.

Siehe auch isTabVisible().

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

Setzt den What's This-Hilfetext für die Seite an der Position index auf text.

Siehe auch tabWhatsThis().

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

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

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

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

QTabBar *QTabWidget::tabBar() const

Gibt die aktuelle QTabBar zurück.

Siehe auch setTabBar().

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

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

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

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

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

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

[signal] void QTabWidget::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().

QIcon QTabWidget::tabIcon(int index) const

Gibt das Symbol für die Registerkarte auf der Seite an der Position index zurück.

Siehe auch setTabIcon().

[virtual protected] void QTabWidget::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 QTabWidget::tabRemoved(int index)

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

Siehe auch tabInserted().

QString QTabWidget::tabText(int index) const

Gibt den Beschriftungstext für die Registerkarte auf der Seite an der Position index zurück.

Siehe auch setTabText().

QString QTabWidget::tabToolTip(int index) const

Liefert den Tabulator-Tooltip für die Seite an der Position index oder einen leeren String, wenn kein Tooltip gesetzt wurde.

Siehe auch setTabToolTip().

QString QTabWidget::tabWhatsThis(int index) const

Gibt den What's This-Hilfetext für die Seite an der Position index zurück, oder eine leere Zeichenkette, wenn kein Hilfetext festgelegt wurde.

Siehe auch setTabWhatsThis().

QWidget *QTabWidget::widget(int index) const

Gibt die Registerkarte an der Indexposition index oder nullptr zurück, wenn index außerhalb des Bereichs liegt.

© 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.