QMdiArea Class

成员函数文档

QMdiArea::QMdiArea(QWidget *parent = nullptr)

构造一个空的 mdi 区域。parent 传递给QWidget 的构造函数。

[virtual noexcept] QMdiArea::~QMdiArea()

销毁 MDI 区域。

[slot] void QMdiArea::activateNextSubWindow()

将键盘焦点指向子窗口列表中的另一个窗口。激活的窗口将是由当前activation order 决定的下一个窗口。

另请参阅 activatePreviousSubWindow() 和QMdiArea::WindowOrder 。

[slot] void QMdiArea::activatePreviousSubWindow()

将键盘焦点指向子窗口列表中的另一个窗口。激活的窗口将是由当前activation order 决定的前一个窗口。

另请参阅 activateNextSubWindow() 和QMdiArea::WindowOrder 。

QMdiSubWindow *QMdiArea::activeSubWindow() const

返回指向当前活动子窗口的指针。如果当前没有活动窗口，则返回nullptr 。

就窗口状态而言，子窗口被视为顶层窗口，也就是说，如果 MDI 区域外的窗口部件是活动窗口，则不会有子窗口处于活动状态。请注意，如果 MDI 区域所在窗口中的部件获得焦点，该窗口将被激活。

另请参阅 setActiveSubWindow() 和Qt::WindowState 。

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

将widget 作为新的子窗口添加到 MDI 区域。如果windowFlags 非零，它们将覆盖 widget 上设置的标志。

widget 可以是QMdiSubWindow 或另一个QWidget （在这种情况下，MDI 区域将创建一个子窗口，并将widget 设置为内部 widget）。

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

    QMdiSubWindow *subWindow2 =
        mdiArea.addSubWindow(internalWidget2);

创建自己的子窗口时，如果希望窗口在 MDI 区域关闭时被删除，则必须设置Qt::WA_DeleteOnClose widget 属性。否则，窗口将被隐藏，MDI 区域将不会激活下一个子窗口。

返回添加到 MDI 区域的QMdiSubWindow 。

另请参阅 removeSubWindow()。

[slot] void QMdiArea::cascadeSubWindows()

以层叠模式排列所有子窗口。

另请参阅 tileSubWindows().

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

重实现：QObject::childEvent(QChildEvent *event).

[slot] void QMdiArea::closeActiveSubWindow()

关闭活动子窗口。

另请参阅 closeAllSubWindows().

[slot] void QMdiArea::closeAllSubWindows()

通过向每个窗口发送QCloseEvent 关闭所有子窗口。在子窗口关闭前，您可能会收到来自子窗口的subWindowActivated() 信号（如果 MDI 区域在另一个子窗口关闭时激活了该子窗口）。

忽略关闭事件的子窗口将保持打开状态。

另请参阅 closeActiveSubWindow()。

QMdiSubWindow *QMdiArea::currentSubWindow() const

返回指向当前子窗口的指针，如果没有当前子窗口，则返回nullptr 。

如果包含QMdiArea 的QApplication 处于活动状态，则该函数的返回值与activeSubWindow() 相同。

另请参阅 activeSubWindow() 和QApplication::activeWindow()。

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

重实现：QAbstractScrollArea::event(QEvent *event).

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

重实现：QObject::eventFilter(QObject *watched, QEvent *event).

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

重实现：QAbstractScrollArea::minimumSizeHint() const.

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

重实现：QAbstractScrollArea::paintEvent(QPaintEvent *event).

void QMdiArea::removeSubWindow(QWidget *widget)

从 MDI 区域移除widget 。widget 必须是QMdiSubWindow 或作为子窗口内部 widget 的 widget。注意widget 不会被QMdiArea 删除。如果传入的是QMdiSubWindow ，则其父窗口部件会被设置为nullptr 并被删除；但如果传入的是内部窗口部件，则其子窗口部件会被设置为nullptr ，而QMdiSubWindow 不会被删除。

另请参阅 addSubWindow() 。

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

重实现：QAbstractScrollArea::resizeEvent(QResizeEvent *event).

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

重实现：QAbstractScrollArea::scrollContentsBy(int dx, int dy）。

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

激活子窗口window 。如果window 是nullptr ，则当前活动窗口将被停用。

另请参阅 activeSubWindow() 。

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

如果on 为 true，则在 MDI 区域启用option ；否则禁用。有关各选项的效果，请参见AreaOption 。

另请参阅 AreaOption 和testOption()。

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

重实现：QAbstractScrollArea::setupViewport(QWidget *viewport).

QAbstractScrollArea 在调用setViewport() 后调用此槽。在QMdiArea 的子类中重新实现此函数，以便在使用新的viewport 之前对其进行初始化。

另请参阅 setViewport()。

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

重实现：QWidget::showEvent(QShowEvent *event).

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

重实现：QAbstractScrollArea::sizeHint() const.

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

QMdiArea window 激活后发出此信号。当 为 时， 刚刚停用最后一个活动窗口，工作区中没有活动窗口。window nullptr QMdiArea

另请参阅 QMdiArea::activeSubWindow() 。

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

返回 MDI 区域中所有子窗口的列表。如果order 是CreationOrder （默认值），窗口将按插入工作区的顺序排序。如果order 是StackingOrder ，窗口将按堆叠顺序排列，最上面的窗口为列表中的最后一项。如果order 是ActivationHistoryOrder ，窗口将根据其最近的激活历史记录列出。

另请参阅 WindowOrder 。

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

如果option 已启用，则返回true ；否则返回false 。

另请参阅 AreaOption 和setOption()。

[slot] void QMdiArea::tileSubWindows()

将所有子窗口按平铺模式排列。

另请参阅 cascadeSubWindows()。

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

重实现：QObject::timerEvent(QTimerEvent *event).

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

重实现：QAbstractScrollArea::viewportEvent(QEvent *event).