QMdiArea 类

成员函数文档

QMdiArea::QMdiArea(QWidget *parent = nullptr)

构建一个空MDI区域。参数parent传递给了QWidget的构造函数。

[virtual noexcept] QMdiArea::~QMdiArea()

销毁MDI区域。

[slot] void QMdiArea::activateNextSubWindow()

将键盘焦点给予子窗口列表中的另一个窗口。激活的窗口将是根据当前的激活顺序确定的下一个窗口。

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

[slot] void QMdiArea::activatePreviousSubWindow()

将键盘焦点给予子窗口列表中的另一个窗口。激活的窗口将是根据当前的激活顺序确定的上一个窗口。

另请参阅 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可以是QMdiSubWindow或另一个QWidget（在这种情况下，MDI区域将创建一个子窗口并将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小部件属性。如果不设置，则窗口将被隐藏，MDI区域不会激活下一个子窗口。

返回添加到MDI区域的QMdiSubWindow。

另请参阅 removeSubWindow。

[slot] void QMdiArea::cascadeSubWindows()

按级联模式排列所有子窗口。

另请参阅 tileSubWindows。

[覆盖虚保护] void QMdiArea::childEvent(QChildEvent *childEvent)

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

[槽函数] void QMdiArea::closeActiveSubWindow()

关闭活动子窗口。

另请参阅closeAllSubWindows。

[槽函数] void QMdiArea::closeAllSubWindows()

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

忽略关闭事件的后台窗口将保持开启状态。

另请参阅closeActiveSubWindow。

QMdiSubWindow *QMdiArea::currentSubWindow() const

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

如果包含QMdiArea的QApplication是活动的，此函数将返回与activeSubWindow()相同的结果。

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

[覆盖虚保护] bool QMdiArea::event(QEvent *event)

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

[覆盖虚保护] bool QMdiArea::eventFilter(QObject *object, QEvent *event)

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

[覆盖虚] QSize QMdiArea::minimumSizeHint() const

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

[覆盖虚保护] void QMdiArea::paintEvent(QPaintEvent *paintEvent)

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

void QMdiArea::removeSubWindow(QWidget *widget)

从MDI区域移除widget。此widget必须是QMdiSubWindow或子窗口的内部控件。注意widget绝不会由QMdiArea实际删除。如果传入QMdiSubWindow，则其父对象设置为nullptr，并且将其移除；但如果传入内部控件，则子控件设置为nullptr，并且QMdiSubWindow不会被移除。

另请参阅addSubWindow。

[重写虚受保护] void QMdiArea::resizeEvent(QResizeEvent *resizeEvent)

重写： QAbstractScrollArea::resizeEvent(QResizeEvent *event).

[重写虚受保护] void QMdiArea::scrollContentsBy(int dx, int dy)

重写： QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[槽函数] void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

激活子窗口 window。如果 window 是 nullptr，则取消任何当前激活窗口的激活状态。

另请参阅activeSubWindow。

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

如果 on 为 true，则在 MDI 面板中启用 option；否则禁用。有关每个选项的效PC路请参阅 AreaOption。

另请参阅AreaOption 和 testOption。

[重写虚受保护槽函数] void QMdiArea::setupViewport(QWidget *viewport)

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

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

另请参阅setViewport。

[重写虚受保护] void QMdiArea::showEvent(QShowEvent *showEvent)

重写： QWidget::showEvent(QShowEvent *event).

[重写虚] QSize QMdiArea::sizeHint() const

重写： QAbstractScrollArea::sizeHint() const.

[信号] void QMdiArea::subWindowActivated(QMdiSubWindow *window)

当 window 被激活后， QMdiArea 发射此信号。当 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)