QTabWidget Class

Dokumentation zu Mitgliedsfunktionen

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

Erstellt ein Widget mit Registerkarten, dessen übergeordnetes Element „ parent “ ist.

[virtual noexcept] QTabWidget::~QTabWidget()

Löscht das Widget mit Registerkarten.

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

Fügt dem Tab-Widget eine Registerkarte mit den angegebenen Bezeichnungen „ page “ und „ label “ hinzu und gibt den Index der Registerkarte in der Registerkartenleiste zurück. Die Eigentümerschaft an „ page “ wird an „ QTabWidget “ weitergegeben.

Wenn die Bezeichnung „ label “ der Registerkarte ein Und-Zeichen enthält, wird der Buchstabe nach dem Und-Zeichen als Tastenkürzel für die Registerkarte verwendet. Wenn die Bezeichnung beispielsweise „Bro&wse“ lautet, wird Alt+W zu einem Tastenkürzel, mit dem der Fokus auf diese Registerkarte verschoben wird.

Siehe auch ` insertTab()`.

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

Fügt dem Tab-Widget eine Registerkarte mit den angegebenen Werten „ page “, „ icon “ und „ label “ hinzu und gibt den Index der Registerkarte in der Registerkartenleiste zurück. Die Eigentumsrechte an „ page “ werden an „ QTabWidget “ weitergegeben.

Diese Funktion entspricht addTab(), verfügt jedoch zusätzlich über einen Parameter „ icon “.

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

Umsetzt: QWidget::changeEvent(QEvent *event).

void QTabWidget::clear()

Entfernt alle Seiten, löscht sie jedoch nicht. Der Aufruf dieser Funktion entspricht dem Aufruf von „ removeTab()“, bis das Register-Widget leer ist.

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

Gibt das Widget zurück, das in der Eigenschaft „ corner “ des Tab-Widgets oder unter „ nullptr “ angezeigt wird.

Siehe auch „ setCornerWidget()“.

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

Dieses Signal wird immer dann ausgelöst, wenn sich der aktuelle Seitenindex ändert. Der Parameter ist die neue aktuelle Seiten- index -Position oder -1, wenn es keine neue gibt (zum Beispiel, wenn sich keine Widgets im QTabWidget befinden).

Siehe auch „ currentWidget()“ und „ currentIndex “.

QWidget *QTabWidget::currentWidget() const

Gibt einen Zeiger auf die Seite zurück, die derzeit vom Registerdialog angezeigt wird. Der Registerdialog versucht nach Kräften sicherzustellen, dass dieser Wert niemals 0 ist (aber wenn man sich genug Mühe gibt, kann es doch vorkommen).

Siehe auch currentIndex() und setCurrentWidget().

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

Umsetzt: ` QWidget::event(QEvent *event)`.

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

Implementiert: ` QWidget::hasHeightForWidth()` const.

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

Implementiert neu: ` QWidget::heightForWidth(int w) const`.

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

Gibt die Indexposition der Seite zurück, auf der sich das Widget „ w “ befindet, 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 Datei: QTabWidget. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionTabWidgetFrame` benötigen, aber nicht alle Informationen selbst eingeben möchten.

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

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

Fügt eine Registerkarte mit den angegebenen Werten „ label “ und „ page “ in das Registerkarten-Widget an der angegebenen Position „ index “ ein und gibt den Index der eingefügten Registerkarte in der Registerkartenleiste zurück. Die Eigentumsrechte an „ page “ werden an „ QTabWidget “ übertragen.

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

Wenn die Bezeichnung des Tabs „ label “ ein Und-Zeichen enthält, wird der Buchstabe nach dem Und-Zeichen als Tastenkombination für den Tab verwendet; wenn die Bezeichnung beispielsweise „Bro&wse“ lautet, wird Alt+W zu einer Tastenkombination, die den Fokus auf diesen Tab verschiebt.

Liegt „ index “ außerhalb des zulässigen Bereichs, wird die Registerkarte einfach angehängt. Andernfalls wird sie an der angegebenen Position eingefügt.

War ` QTabWidget ` vor dem Aufruf dieser Funktion leer, wird die neue Seite zur aktuellen Seite. Das Einfügen einer neuen Registerkarte an einer Position, die kleiner oder gleich dem aktuellen Index ist, erhöht den aktuellen Index, behält jedoch die aktuelle Seite bei.

Siehe auch ` addTab()`.

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

Fügt eine Registerkarte mit den angegebenen Werten für „ label “, „ page “ und „ icon “ in das Registerkarten-Widget an der angegebenen Position „ index “ ein und gibt den Index der eingefügten Registerkarte in der Registerkartenleiste zurück. Die Eigentumsrechte an „ page “ werden an „ QTabWidget “ übertragen.

Diese Funktion entspricht insertTab(), verfügt jedoch zusätzlich über einen Parameter „ icon “.

bool QTabWidget::isTabEnabled(int index) const

Gibt „ true “ zurück, wenn die Seite unter der Adresse 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 unter der Adresse index sichtbar ist; andernfalls wird „false“ zurückgegeben.

Siehe auch setTabVisible().

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

Implementiert: ` QWidget::keyPressEvent(QKeyEvent *event)`.

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.

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

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

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

Zeichnet die Registerkartenleiste des Registerkarten-Widgets als Reaktion auf das „paint“- event.

void QTabWidget::removeTab(int index)

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

Siehe auch addTab() und insertTab().

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

Implementiert: ` QWidget::resizeEvent(QResizeEvent *event)`.

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

Legt fest, dass das angegebene „ widget “ im angegebenen „ corner “ des Tab-Widgets angezeigt wird. Die Geometrie des Widgets wird anhand der Methoden „ sizeHint()“ und „ style()“ des Widgets bestimmt.

Es wird nur die horizontale Komponente des „ corner “ verwendet.

Wird „ nullptr “ übergeben, wird in der Ecke kein Widget angezeigt.

Jedes zuvor festgelegte Eck-Widget wird ausgeblendet.

Alle hier festgelegten Widgets werden vom Tab-Widget beim Zerstören gelöscht, es sei denn, Sie weisen dem Widget nach dem Festlegen eines anderen Eck-Widgets (oder von ` nullptr`) separat eine neue übergeordnete Ebene zu.

Hinweis: Eck-Widgets sind für die Tab-Positionen „ North “ und „ South “ ausgelegt; andere Ausrichtungen funktionieren bekanntermaßen nicht ordnungsgemäß.

Siehe auch cornerWidget() und setTabPosition().

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

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

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

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

Ersetzt die Überschrift „ QTabBar “ des Dialogfelds durch die Registerleiste „ tb “. Beachten Sie, dass diese Funktion aufgerufen werden muss, bevor Registerkarten hinzugefügt wurden, da sonst das Verhalten nicht definiert ist.

Siehe auch „ tabBar()“.

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

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

QTabWidget Verwendet intern ` QWidget::setEnabled()`, anstatt ein separates Flag zu verwalten.

Beachten Sie, dass auch eine deaktivierte Registerkarte/Seite sichtbar sein kann. Ist die Seite bereits sichtbar, wird sie durch ` QTabWidget ` nicht ausgeblendet; sind alle Seiten deaktiviert, zeigt ` QTabWidget ` eine davon an.

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

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

Legt die „ icon “ für die Registerkarte an der Position index fest.

Siehe auch tabIcon().

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

Definiert eine neue Tastenkombination ( label ) für die Registerkarte der Seite unter der Adresse index.

Wenn der angegebene Text ein Und-Zeichen („&“) enthält, wird automatisch eine Tastenkombination dafür erstellt. Das Zeichen, das auf das „&“ folgt, wird als Tastenkombination verwendet. Eine eventuell bereits vorhandene Tastenkombination wird überschrieben oder gelöscht, wenn durch den Text keine Tastenkombination definiert wird. Weitere Informationen finden Sie in der Dokumentation zu „ QShortcut “ (um ein echtes Und-Zeichen anzuzeigen, verwenden Sie „&&“).

Siehe auch tabText().

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

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

Siehe auch tabToolTip().

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

Wenn „ visible “ wahr ist, ist die Seite unter der Adresse index sichtbar; andernfalls ist die Seite unter der Adresse index ausgeblendet. Die Registerkarte der Seite wird entsprechend neu gezeichnet.

Siehe auch isTabVisible().

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

Legt den „Was ist das?“-Hilfetext für die Seite an der Position index auf text fest.

Siehe auch tabWhatsThis().

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

Implementiert: ` QWidget::showEvent(QShowEvent *event)`.

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.

QTabBar *QTabWidget::tabBar() const

Gibt den aktuellen „ QTabBar “ zurück.

Siehe auch setTabBar().

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

Dieses Signal wird ausgelöst, wenn der Benutzer auf eine Registerkarte unter index klickt.

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

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

Dieses Signal wird ausgelöst, wenn der Benutzer auf eine Registerkarte unter index doppelklickt.

index ist der Index des angeklickten Reiters oder -1, wenn sich kein Reiter unter dem Cursor befindet.

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

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 Tab hinzugefügt oder an der Position index eingefügt wurde.

Siehe auch tabRemoved().

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

Dieser virtuelle Handler wird aufgerufen, nachdem ein Tabulator an 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

Gibt den Tooltip für die Seite unter der Position index zurück oder eine leere Zeichenkette, falls kein Tooltip festgelegt wurde.

Siehe auch setTabToolTip().

QString QTabWidget::tabWhatsThis(int index) const

Gibt den „Was ist das?“-Hilfetext für die Seite an der Position index zurück oder eine leere Zeichenkette, falls kein Hilfetext festgelegt wurde.

Siehe auch setTabWhatsThis().

QWidget *QTabWidget::widget(int index) const

Gibt die Registerkarte an der Indexposition „ index “ zurück oder „ nullptr “, falls der Wert „ index “ außerhalb des zulässigen Bereichs liegt.