QMdiArea Class

Dokumentation der Mitgliedsfunktionen

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Konstruiert einen leeren mdi-Bereich. parent wird an den Konstruktor von QWidget übergeben.

[virtual noexcept] QMdiArea::~QMdiArea()

Zerstört den MDI-Bereich.

[slot] void QMdiArea::activateNextSubWindow()

Gibt den Tastaturfokus an ein anderes Fenster in der Liste der untergeordneten Fenster. Das aktivierte Fenster wird das nächste sein, das durch das aktuelle activation order bestimmt wird.

Siehe auch activatePreviousSubWindow() und QMdiArea::WindowOrder.

[slot] void QMdiArea::activatePreviousSubWindow()

Gibt den Tastaturfokus an ein anderes Fenster in der Liste der untergeordneten Fenster. Das aktivierte Fenster ist das vorherige, das durch das aktuelle activation order bestimmt wird.

Siehe auch activateNextSubWindow() und QMdiArea::WindowOrder.

QMdiSubWindow *QMdiArea::activeSubWindow() const

Gibt einen Zeiger auf das aktuell aktive Teilfenster zurück. Wenn kein Fenster aktiv ist, wird nullptr zurückgegeben.

Unterfenster werden in Bezug auf den Fensterstatus wie Top-Level-Fenster behandelt, d.h. wenn ein Widget außerhalb des MDI-Bereichs das aktive Fenster ist, wird kein Unterfenster aktiv sein. 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 ist, überschreibt es die auf dem Widget gesetzten Flags.

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

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

    QMdiSubWindow *subWindow2 =
        mdiArea.addSubWindow(internalWidget2);

Wenn Sie Ihr eigenes Teilfenster erstellen, müssen Sie das Attribut Qt::WA_DeleteOnClose widget setzen, wenn Sie möchten, dass das Fenster beim Schließen im MDI-Bereich gelöscht wird. Andernfalls wird das Fenster ausgeblendet und der MDI-Bereich aktiviert nicht das nächste Teilfenster.

Gibt die QMdiSubWindow zurück, die dem MDI-Bereich hinzugefügt wird.

Siehe auch removeSubWindow().

[slot] void QMdiArea::cascadeSubWindows()

Ordnet alle untergeordneten Fenster in einem Kaskadenmuster an.

Siehe auch tileSubWindows().

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

Reimplements: QObject::childEvent(QChildEvent *event).

[slot] void QMdiArea::closeActiveSubWindow()

Schließt das aktive Teilfenster.

Siehe auch closeAllSubWindows().

[slot] void QMdiArea::closeAllSubWindows()

Schließt alle Unterfenster durch Senden eines QCloseEvent an jedes Fenster. Sie können subWindowActivated()-Signale von Unterfenstern erhalten, bevor diese geschlossen werden (wenn 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, wenn es kein aktuelles Unterfenster gibt.

Diese Funktion gibt das Gleiche zurück wie activeSubWindow(), wenn QApplication, das QMdiArea enthält, aktiv ist.

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

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

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

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

Reimplements: QObject::eventFilter(QObject *watched, QEvent *event).

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

Reimplements: QAbstractScrollArea::minimumSizeHint() const.

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

Reimplements: 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. Beachten Sie, dass widget niemals tatsächlich von QMdiArea gelöscht wird. Wenn ein QMdiSubWindow übergeben wird, wird sein übergeordnetes Widget auf nullptr gesetzt und entfernt; wenn jedoch ein internes Widget übergeben wird, wird das untergeordnete Widget auf nullptr gesetzt und QMdiSubWindow wird nicht entfernt.

Siehe auch addSubWindow().

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

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

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

Reimplements: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

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

Aktiviert das Unterfenster window. Wenn window gleich nullptr ist, wird jedes derzeit aktive Fenster deaktiviert.

Siehe auch activeSubWindow().

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

Wenn on wahr ist, ist option für den MDI-Bereich aktiviert; andernfalls ist sie deaktiviert. Siehe AreaOption für die Auswirkungen der einzelnen Optionen.

Siehe auch AreaOption und testOption().

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

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

Dieser Slot wird von QAbstractScrollArea aufgerufen, nachdem setViewport() aufgerufen wurde. Reimplementieren Sie diese Funktion in einer Unterklasse von QMdiArea, um die neue viewport zu initialisieren, bevor sie verwendet wird.

Siehe auch setViewport().

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

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

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

Reimplements: QAbstractScrollArea::sizeHint() const.

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

QMdiArea gibt dieses Signal aus, nachdem window aktiviert wurde. Wenn window nullptr ist, hat QMdiArea gerade sein letztes aktives Fenster deaktiviert, und es gibt 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 gleich CreationOrder ist (Standardeinstellung), werden die Fenster in der Reihenfolge sortiert, in der sie in den Arbeitsbereich eingefügt wurden. Wenn order gleich StackingOrder ist, werden die Fenster in ihrer Stapelreihenfolge aufgelistet, wobei das oberste Fenster das letzte Element in der Liste ist. Wenn order gleich ActivationHistoryOrder ist, werden die Fenster entsprechend ihrer jüngsten 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)

Reimplements: QObject::timerEvent(QTimerEvent *event).

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

Reimplements: QAbstractScrollArea::viewportEvent(QEvent *Event).