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:
- Erstellen Sie ein QTabWidget.
- Erstellen Sie ein QWidget für jede der Seiten im Tab-Dialog, aber geben Sie keine übergeordneten Widgets für sie an.
- Fügen Sie Kind-Widgets in das Seiten-Widget ein und verwenden Sie Layouts, um sie wie gewohnt zu positionieren.
- 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:
Konstante | Wert | Beschreibung |
---|---|---|
QTabWidget::North | 0 | Die Tabulatoren werden oberhalb der Seiten gezeichnet. |
QTabWidget::South | 1 | Die Registerkarten werden unter den Seiten gezeichnet. |
QTabWidget::West | 2 | Die Registerkarten werden links von den Seiten gezeichnet. |
QTabWidget::East | 3 | Die Registerkarten werden rechts von den Seiten gezeichnet. |
enum QTabWidget::TabShape
Dieser Enum-Typ definiert die Form der Tabs:
Konstante | Wert | Beschreibung |
---|---|---|
QTabWidget::Rounded | 0 | Die Registerkarten werden mit einem abgerundeten Aussehen gezeichnet. Dies ist die Standardform. |
QTabWidget::Triangular | 1 | Die 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.