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区域将创建一个子窗口，并将该 设置为内部控件）。

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 控件属性。否则，该窗口将被隐藏，且 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)

将widget 从MDI区域中移除。widget 必须是QMdiSubWindow ，或者是一个作为子窗口内部控件的控件。注意：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 为真，则 MDI 区域中启用option ；否则，该功能被禁用。有关每个选项的效果，请参阅AreaOption 。

另请参阅 AreaOption 和testOption()。

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

重写：QAbstractScrollArea::setupViewport(QWidget *viewport)。

在调用setViewport()之后，QAbstractScrollArea 会调用此槽函数。请在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)。