QMdiArea Class

Dokumentation zu den Mitgliedsfunktionen

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Erstellt einen leeren MDI-Bereich. „ parent “ wird an den Konstruktor von „ QWidget “ übergeben.

[virtual noexcept] QMdiArea::~QMdiArea()

Löscht den MDI-Bereich.

[slot] void QMdiArea::activateNextSubWindow()

Weist den Tastaturfokus einem anderen Fenster in der Liste der untergeordneten Fenster zu. Das aktivierte Fenster ist das nächste, das durch den aktuellen activation order bestimmt wird.

Siehe auch ` activatePreviousSubWindow()` und ` QMdiArea::WindowOrder`.

[slot] void QMdiArea::activatePreviousSubWindow()

Weist den Tastaturfokus einem anderen Fenster in der Liste der untergeordneten Fenster zu. Das aktivierte Fenster ist dasjenige, das zuvor durch den aktuellen Wert von ` activation order` bestimmt wurde.

Siehe auch ` activateNextSubWindow()` und ` QMdiArea::WindowOrder`.

QMdiSubWindow *QMdiArea::activeSubWindow() const

Gibt einen Zeiger auf das derzeit aktive Unterfenster zurück. Ist derzeit kein Fenster aktiv, wird ` nullptr ` zurückgegeben.

Unterfenster werden hinsichtlich des Fensterstatus wie Fenster der obersten Ebene behandelt, d. h., wenn ein Widget außerhalb des MDI-Bereichs das aktive Fenster ist, ist kein Unterfenster aktiv. Beachten Sie, dass das Fenster aktiviert wird, wenn ein Widget in dem Fenster, in dem sich der MDI-Bereich befindet, den Fokus erhält.

Siehe auch „ setActiveSubWindow()“ und „ Qt::WindowState “.

QMdiSubWindow *QMdiArea::addSubWindow(QWidget *widget, Qt::WindowFlags windowFlags = Qt::WindowFlags())

Fügt „ widget “ als neues Unterfenster zum MDI-Bereich hinzu. Wenn „ windowFlags “ ungleich Null sind, überschreiben sie die für das Widget festgelegten Flags.

Das „ widget “ kann entweder ein „ QMdiSubWindow “ oder ein anderes „ QWidget “ sein (in diesem Fall erstellt der MDI-Bereich ein Unterfenster und legt das „ widget “ als internes Widget fest).

QMdiArea mdiArea;
QMdiSubWindow *subWindow1 = new QMdiSubWindow;
subWindow1->setWidget(internalWidget1);
subWindow1->setAttribute(Qt::WA_DeleteOnClose);
mdiArea.addSubWindow(subWindow1);

QMdiSubWindow *subWindow2 =
    mdiArea.addSubWindow(internalWidget2);

Wenn Sie ein eigenes Unterfenster erstellen, müssen Sie das Widget-Attribut „ Qt::WA_DeleteOnClose “ setzen, falls das Fenster beim Schließen im MDI-Bereich gelöscht werden soll. Andernfalls wird das Fenster ausgeblendet, und der MDI-Bereich aktiviert das nächste Unterfenster nicht.

Gibt das „ QMdiSubWindow “ zurück, das dem MDI-Bereich hinzugefügt wurde.

Siehe auch ` removeSubWindow()`

[slot] void QMdiArea::cascadeSubWindows()

Ordnet alle untergeordneten Fenster kaskadenartig an.

Siehe auch ` tileSubWindows()`.

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

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

[slot] void QMdiArea::closeActiveSubWindow()

Schließt das aktive Unterfenster.

Siehe auch „ closeAllSubWindows()“.

[slot] void QMdiArea::closeAllSubWindows()

Schließt alle Unterfenster, indem an jedes Fenster ein „ QCloseEvent “ gesendet wird. Möglicherweise erhalten Sie „ subWindowActivated()“-Signale von Unterfenstern, bevor diese geschlossen werden (falls der MDI-Bereich das Unterfenster aktiviert, während ein anderes geschlossen wird).

Unterfenster, die das Schließereignis ignorieren, bleiben geöffnet.

Siehe auch ` closeActiveSubWindow()`.

QMdiSubWindow *QMdiArea::currentSubWindow() const

Gibt einen Zeiger auf das aktuelle Unterfenster zurück oder „ nullptr “, falls kein aktuelles Unterfenster vorhanden ist.

Diese Funktion liefert denselben Wert wie ` activeSubWindow()`, wenn das ` QApplication `, das ` QMdiArea ` enthält, aktiv ist.

Siehe auch „ activeSubWindow()“ und „ QApplication::activeWindow()“.

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

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

[override virtual protected] bool QMdiArea::eventFilter(QObject *object, QEvent *event)

Implementiert: ` QObject::eventFilter` (`QObject *watched, QEvent *event`).

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

Implementiert: ` QAbstractScrollArea::minimumSizeHint()` const.

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

Umsetzt: ` QAbstractScrollArea::paintEvent` (`QPaintEvent *event`).

void QMdiArea::removeSubWindow(QWidget *widget)

Entfernt „ widget “ aus dem MDI-Bereich. Das „ widget “ muss entweder ein „ QMdiSubWindow “ oder ein Widget sein, das das interne Widget eines Unterfensters ist. Hinweis: „ widget “ wird durch „ QMdiArea “ niemals tatsächlich gelöscht. Wird ein „ QMdiSubWindow “ übergeben, wird dessen übergeordnetes Widget auf „ nullptr “ gesetzt und es wird entfernt; wird jedoch ein internes Widget übergeben, wird das untergeordnete Widget auf „ nullptr “ gesetzt und das „ QMdiSubWindow “ wird nicht entfernt.

Siehe auch addSubWindow().

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

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

[override virtual protected] void QMdiArea::scrollContentsBy(int dx, int dy)

Implementiert: ` QAbstractScrollArea::scrollContentsBy(int dx, int dy)`.

[slot] void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

Aktiviert das Unterfenster „ window “. Wenn „ window “ auf „ nullptr “ gesetzt ist, wird jedes aktuell aktive Fenster deaktiviert.

Siehe auch activeSubWindow().

void QMdiArea::setOption(QMdiArea::AreaOption option, bool on = true)

Wenn „ on “ auf „true“ gesetzt ist, ist „ option “ im MDI-Bereich aktiviert; andernfalls ist es deaktiviert. Informationen zu den Auswirkungen der einzelnen Optionen finden Sie unter AreaOption.

Siehe auch „ AreaOption “ und „ testOption()“.

[override virtual protected slot] void QMdiArea::setupViewport(QWidget *viewport)

Umsetzt: QAbstractScrollArea::setupViewport(QWidget *viewport).

Dieser Slot wird von ` QAbstractScrollArea ` aufgerufen, nachdem ` setViewport()` aufgerufen wurde. Implementieren Sie diese Funktion in einer Unterklasse von ` QMdiArea ` neu, um das neue ` viewport ` vor seiner Verwendung zu initialisieren.

Siehe auch setViewport().

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

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

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

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

[signal] void QMdiArea::subWindowActivated(QMdiSubWindow *window)

QMdiArea gibt dieses Signal aus, nachdem „ window “ aktiviert wurde. Wenn „ window “ den Wert „ nullptr “ annimmt, hat „ QMdiArea “ gerade sein zuletzt aktives Fenster deaktiviert, und es befinden sich keine aktiven Fenster auf der Arbeitsfläche.

Siehe auch QMdiArea::activeSubWindow().

QList<QMdiSubWindow *> QMdiArea::subWindowList(QMdiArea::WindowOrder order = CreationOrder) const

Gibt eine Liste aller Unterfenster im MDI-Bereich zurück. Wenn „ order “ auf „ CreationOrder “ gesetzt ist (Standard), werden die Fenster in der Reihenfolge sortiert, in der sie in den Arbeitsbereich eingefügt wurden. Wenn „ order “ auf „ StackingOrder “ gesetzt ist, werden die Fenster in ihrer Stapelreihenfolge aufgelistet, wobei das oberste Fenster als letztes Element in der Liste erscheint. Wenn „ order “ auf „ ActivationHistoryOrder “ gesetzt ist, werden die Fenster entsprechend ihrer letzten Aktivierungshistorie aufgelistet.

Siehe auch WindowOrder.

bool QMdiArea::testOption(QMdiArea::AreaOption option) const

Gibt „ true “ zurück, wenn „ option “ aktiviert ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch AreaOption und setOption().

[slot] void QMdiArea::tileSubWindows()

Ordnet alle untergeordneten Fenster in einem Kachelmuster an.

Siehe auch „ cascadeSubWindows()“.

[override virtual protected] void QMdiArea::timerEvent(QTimerEvent *timerEvent)

Umsetzt: ` QObject::timerEvent(QTimerEvent *event)`.

[override virtual protected] bool QMdiArea::viewportEvent(QEvent *event)

Umsetzt: ` QAbstractScrollArea::viewportEvent(QEvent *event)`.