QSplitter Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt einen horizontalen Splitter, wobei das Argument „ parent “ an den Konstruktor „ QFrame “ übergeben wird.

Siehe auch setOrientation().

[explicit] QSplitter::QSplitter(Qt::Orientation orientation, QWidget *parent = nullptr)

Erstellt einen Splitter mit den angegebenen Werten für „ orientation “ und „ parent “.

Siehe auch setOrientation().

[virtual noexcept] QSplitter::~QSplitter()

Löscht den Splitter. Alle untergeordneten Elemente werden gelöscht.

void QSplitter::addWidget(QWidget *widget)

Fügt das angegebene „ widget “ nach allen anderen Elementen in das Layout des Splitters ein.

Befindet sich „ widget “ bereits im Splitter, wird es an die neue Position verschoben.

Siehe auch „ insertWidget()“, „ widget()“ und „ indexOf()“.

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

Implementiert: ` QFrame::changeEvent(QEvent *ev)`.

[override virtual protected] void QSplitter::childEvent(QChildEvent *c)

Implementiert: ` QObject::childEvent` (`QChildEvent *event`).

Teilt dem Splitter mit, dass das durch ` c ` beschriebene untergeordnete Widget eingefügt oder entfernt wurde.

Diese Methode wird auch verwendet, um den Fall zu behandeln, in dem ein Widget mit dem Splitter als übergeordnetem Element erstellt, aber nicht explizit mit ` insertWidget()` oder ` addWidget()` hinzugefügt wurde. Dies dient der Kompatibilität und ist nicht die empfohlene Vorgehensweise, um Widgets in neuem Code in einen Splitter einzufügen. Bitte verwenden Sie in neuem Code ` insertWidget()` oder ` addWidget()`.

Siehe auch addWidget() und insertWidget().

[protected] int QSplitter::closestLegalPosition(int pos, int index)

Gibt die nächstgelegene zulässige Position für „ pos “ des Widgets unter „ index “ zurück.

Bei Sprachen mit Schreibrichtung von rechts nach links, wie Arabisch und Hebräisch, wird das Layout der horizontalen Trennlinien umgekehrt. Die Positionen werden dann vom rechten Rand des Widgets aus gemessen.

Siehe auch getRange().

int QSplitter::count() const

Gibt die Anzahl der Widgets zurück, die im Layout des Splitters enthalten sind.

Siehe auch widget() und handle().

[virtual protected] QSplitterHandle *QSplitter::createHandle()

Gibt einen neuen Splitter-Handle als untergeordnetes Widget dieses Splitters zurück. Diese Funktion kann in Unterklassen neu implementiert werden, um benutzerdefinierte Handles zu unterstützen.

Siehe auch „ handle()“ und „ indexOf()“.

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

Implementiert: ` QFrame::event(QEvent *e)`.

void QSplitter::getRange(int index, int *min, int *max) const

Gibt den gültigen Bereich des Splitters unter index in *min und *max zurück, sofern min und max nicht 0 sind.

QSplitterHandle *QSplitter::handle(int index) const

Gibt den Griff links (bzw. oberhalb) des Elements im Layout des Splitters an der angegebenen Position index zurück oder nullptr, falls kein solches Element vorhanden ist. Der Griff am Index 0 ist immer ausgeblendet.

Bei Sprachen mit Schreibrichtung von rechts nach links, wie Arabisch und Hebräisch, ist das Layout horizontaler Splitter umgekehrt. Der Griff befindet sich an der Position „ index “ rechts vom Widget.

Siehe auch count(), widget(), indexOf(), createHandle() und setHandleWidth().

int QSplitter::indexOf(QWidget *widget) const

Gibt den Index des angegebenen „ widget “ im Layout des Splitters zurück oder -1, wenn „ widget “ nicht gefunden wird. Dies funktioniert auch für Handles.

Handles werden ab 0 nummeriert. Es gibt so viele Handles wie untergeordnete Widgets, aber das Handle an Position 0 ist immer ausgeblendet.

Siehe auch „ count()“ und „ widget()“.

void QSplitter::insertWidget(int index, QWidget *widget)

Fügt das angegebene Element „ widget “ an der angegebenen Position „ index “ in das Layout des Splitters ein.

Befindet sich „ widget “ bereits im Splitter, wird es an die neue Position verschoben.

Ist „ index “ ein ungültiger Index, wird das Widget am Ende eingefügt.

Siehe auch addWidget(), indexOf() und widget().

bool QSplitter::isCollapsible(int index) const

Gibt „ true “ zurück, wenn das Widget unter index einklappbar ist, andernfalls „ false “.

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

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

[protected] void QSplitter::moveSplitter(int pos, int index)

Verschiebt den linken oder oberen Rand des Trennbalken-Ziehgriffs an der Position „ index “ so nah wie möglich an die Position „ pos “, die dem Abstand vom linken oder oberen Rand des Widgets entspricht.

Bei Sprachen mit Schreibrichtung von rechts nach links, wie Arabisch und Hebräisch, wird das Layout horizontaler Splitter umgekehrt. „ pos “ ist dann der Abstand vom rechten Rand des Widgets.

Siehe auch splitterMoved(), closestLegalPosition() und getRange().

void QSplitter::refresh()

Aktualisiert den Status des Splitters. Sie sollten diese Funktion nicht aufrufen müssen.

QWidget *QSplitter::replaceWidget(int index, QWidget *widget)

Ersetzt das Widget im Layout des Splitters an der angegebenen Position „ index “ durch „ widget “.

Gibt das soeben ersetzte Widget zurück, sofern index gültig ist und widget noch kein untergeordnetes Element des Splitters ist. Andernfalls wird null zurückgegeben und es erfolgt weder ein Austausch noch eine Hinzufügung.

Die Geometrie des neu eingefügten Widgets entspricht der des Widgets, das es ersetzt. Auch dessen sichtbarer und zusammengeklappter Zustand werden übernommen.

Siehe auch „ insertWidget()“ und „ indexOf()“.

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

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

bool QSplitter::restoreState(const QByteArray &state)

Stellt das Layout des Splitters auf den angegebenen Wert „ state “ zurück. Gibt „ true “ zurück, wenn der Zustand wiederhergestellt wurde; andernfalls wird „ false “ zurückgegeben.

In der Regel wird dies in Verbindung mit ` QSettings ` verwendet, um die Größe aus einer früheren Sitzung wiederherzustellen. Hier ein Beispiel:

Den Zustand des Splitters wiederherstellen:

QSettings settings;
splitter->restoreState(settings.value("splitterSizes").toByteArray());

Ein Fehlschlag beim Wiederherstellen des Layouts des Splitters kann auf ungültige oder veraltete Daten im übergebenen Byte-Array zurückzuführen sein.

Siehe auch ` saveState()`.

QByteArray QSplitter::saveState() const

Speichert den Zustand des Splitter-Layouts.

In der Regel wird dies in Verbindung mit ` QSettings ` verwendet, um die Größe für eine spätere Sitzung zu speichern. Als Teil der Daten wird eine Versionsnummer gespeichert. Hier ein Beispiel:

QSettings settings;
settings.setValue("splitterSizes", splitter->saveState());

Siehe auch ` restoreState()`.

void QSplitter::setCollapsible(int index, bool collapse)

Legt fest, ob das unter index befindliche untergeordnete Widget auf collapse minimierbar ist.

Standardmäßig sind untergeordnete Widgets zusammenklappbar, d. h., der Benutzer kann ihre Größe auf 0 reduzieren, selbst wenn sie einen Wert ungleich Null für minimumSize() oder minimumSizeHint() haben. Dieses Verhalten kann für jedes Widget einzeln durch Aufruf dieser Funktion oder global für alle Widgets im Splitter durch Setzen der Eigenschaft childrenCollapsible geändert werden.

Siehe auch isCollapsible() und childrenCollapsible.

[protected] void QSplitter::setRubberBand(int pos)

Zeigt ein Gummiband an der Position „ pos “ an. Ist „ pos “ negativ, wird das Gummiband entfernt.

void QSplitter::setSizes(const QList<int> &list)

Legt die jeweiligen Größen der untergeordneten Widgets auf die in der Eigenschaft „ list “ angegebenen Werte fest.

Ist der Splitter horizontal, legen die Werte die Breite jedes Widgets in Pixeln von links nach rechts fest. Ist der Splitter vertikal, wird die Höhe jedes Widgets von oben nach unten festgelegt.

Zusätzliche Werte in der Datei „ list “ werden ignoriert. Enthält die Datei „ list “ zu wenige Werte, ist das Ergebnis undefiniert, das Programm verhält sich jedoch weiterhin korrekt.

Die Gesamtgröße des Splitter-Widgets wird davon nicht beeinflusst. Stattdessen wird jeder zusätzliche oder fehlende Platz entsprechend dem relativen Gewichtsanteil der Größen auf die Widgets verteilt.

Wenn Sie eine Größe von 0 angeben, ist das Widget unsichtbar. Die Größenrichtlinien der Widgets bleiben erhalten. Das heißt, ein Wert, der kleiner ist als der minimale Größenhinweis des jeweiligen Widgets, wird durch den Wert des Hinweises ersetzt.

Siehe auch ` sizes()`.

void QSplitter::setStretchFactor(int index, int stretch)

Aktualisiert die Größenrichtlinie des Widgets an der Position index so, dass es einen Dehnungsfaktor von stretch erhält.

stretch ist nicht der tatsächliche Streckfaktor; der tatsächliche Streckfaktor wird berechnet, indem die ursprüngliche Größe des Widgets mit stretch multipliziert wird.

Diese Funktion dient der Vereinfachung. Sie entspricht

QWidget *widget = splitter->widget(index);
QSizePolicy policy = widget->sizePolicy();
policy.setHorizontalStretch(stretch);
policy.setVerticalStretch(stretch);
widget->setSizePolicy(policy);

Siehe auch setSizes() und widget().

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

Implementiert: ` QFrame::sizeHint()` const.

QList<int> QSplitter::sizes() const

Gibt eine Liste der Größenparameter aller Widgets in diesem Splitter zurück.

Wenn der Splitter horizontal ausgerichtet ist, enthält die Liste die Breiten der Widgets in Pixeln, von links nach rechts; wenn die Ausrichtung vertikal ist, enthält die Liste die Höhen der Widgets in Pixeln, von oben nach unten.

Werden diese Werte an die Funktion ` setSizes()` eines anderen Splitters übergeben, wird ein Splitter mit demselben Layout wie dieser erstellt.

Beachten Sie, dass unsichtbare Widgets eine Größe von 0 haben.

Siehe auch ` setSizes()`.

[signal] void QSplitter::splitterMoved(int pos, int index)

Dieses Signal wird ausgelöst, wenn der Trennbalken-Griff an einer bestimmten Stelle index in die Position pos verschoben wurde.

Bei Sprachen, die von rechts nach links geschrieben werden, wie Arabisch und Hebräisch, ist die Anordnung der horizontalen Trennzeichen umgekehrt. „ pos “ ist dann der Abstand vom rechten Rand des Widgets.

Siehe auch moveSplitter().

QWidget *QSplitter::widget(int index) const

Gibt das Widget an der angegebenen Position „ index “ im Layout des Splitters zurück oder „ nullptr “, falls kein solches Widget vorhanden ist.

Siehe auch „ count()“, „ handle()“, „ indexOf()“ und „ insertWidget()“.