QMdiSubWindow Class

成员函数文档

QMdiSubWindow::QMdiSubWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

创建一个新的 QMdiSubWindow 控件。parent 和flags 参数将传递给QWidget 的构造函数。

除了使用 addSubWindow() 之外，在将子窗口添加到QMdiArea 时，也可以直接使用setParent()。

请注意，只有QMdiSubWindow对象才能被设置为QMdiArea 的子窗口；例如，你不能这样写：

//bad code
QMdiArea mdiArea;
QTextEdit editor(&mdiArea); // invalid child widget

另请参阅 QMdiArea::addSubWindow()。

[virtual noexcept] QMdiSubWindow::~QMdiSubWindow()

销毁子窗口。

另请参阅 QMdiArea::removeSubWindow()。

[signal] void QMdiSubWindow::aboutToActivate()

QMdiSubWindow 在子窗口被激活之前会立即发出该信号。子窗口被激活后，管理该子窗口的QMdiArea 也会发出subWindowActivated()信号。

另请参阅 QMdiArea::subWindowActivated()。

[override virtual protected] void QMdiSubWindow::changeEvent(QEvent *changeEvent)

重写了：QWidget::changeEvent(QEvent *event)。

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

重写了：QObject::childEvent(QChildEvent *event)。

[override virtual protected] void QMdiSubWindow::closeEvent(QCloseEvent *closeEvent)

重写了：QWidget::closeEvent(QCloseEvent *event)。

[override virtual protected] void QMdiSubWindow::contextMenuEvent(QContextMenuEvent *contextMenuEvent)

重写：QWidget::contextMenuEvent(QContextMenuEvent *event)。

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

重写了：QWidget::event(QEvent *event)。

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

重写了：QObject::eventFilter(QObject *watched, QEvent *event)。

[override virtual protected] void QMdiSubWindow::focusInEvent(QFocusEvent *focusInEvent)

重写了：QWidget::focusInEvent(QFocusEvent *event)。

[override virtual protected] void QMdiSubWindow::focusOutEvent(QFocusEvent *focusOutEvent)

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

[override virtual protected] void QMdiSubWindow::hideEvent(QHideEvent *hideEvent)

重写了：QWidget::hideEvent(QHideEvent *event)。

bool QMdiSubWindow::isShaded() const

如果该窗口处于折叠状态，则返回true ；否则返回false 。

如果窗口被折叠，仅显示标题栏，则该窗口处于折叠状态。

[override virtual protected] void QMdiSubWindow::keyPressEvent(QKeyEvent *keyEvent)

重写了：QWidget::keyPressEvent(QKeyEvent *event)。

[override virtual protected] void QMdiSubWindow::leaveEvent(QEvent *leaveEvent)

重写了：QWidget::leaveEvent(QEvent *event)。

QMdiArea *QMdiSubWindow::mdiArea() const

返回包含此子窗口的区域，如果不存在则返回nullptr 。

另请参阅 QMdiArea::addSubWindow()。

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

重新实现了属性QWidget::minimumSizeHint 的访问函数。

[override virtual protected] void QMdiSubWindow::mouseDoubleClickEvent(QMouseEvent *mouseEvent)

重写了：QWidget::mouseDoubleClickEvent(QMouseEvent *event)。

[override virtual protected] void QMdiSubWindow::mouseMoveEvent(QMouseEvent *mouseEvent)

重写了：QWidget::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QMdiSubWindow::mousePressEvent(QMouseEvent *mouseEvent)

重写了：QWidget::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QMdiSubWindow::mouseReleaseEvent(QMouseEvent *mouseEvent)

重写了：QWidget::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] void QMdiSubWindow::moveEvent(QMoveEvent *moveEvent)

重写了：QWidget::moveEvent(QMoveEvent *event)。

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

重写了：QWidget::paintEvent(QPaintEvent *event)。

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

重写：QWidget::resizeEvent(QResizeEvent *event)。

void QMdiSubWindow::setOption(QMdiSubWindow::SubWindowOption option, bool on = true)

如果on 为真，则子窗口上启用了option ；否则，该功能被禁用。有关每个选项的作用，请参阅SubWindowOption 。

另请参阅 SubWindowOption 和testOption()。

void QMdiSubWindow::setSystemMenu(QMenu *systemMenu)

将systemMenu 设置为该子窗口的当前系统菜单。

默认情况下，每个QMdiSubWindow 都有一个标准系统菜单。

由QMdiSubWindow 创建的系统菜单中的 QActions 将根据当前窗口状态自动更新；例如，窗口最小化后，“最小化”操作将被禁用。

QMdiSubWindow 不会更新用户添加的 QActions。

QMdiSubWindow systemMenu 会接管所有权；您无需将其删除。任何现有的菜单都将被删除。

另请参阅 systemMenu() 和showSystemMenu()。

void QMdiSubWindow::setWidget(QWidget *widget)

将widget 设置为该子窗口的内部小部件。内部小部件显示在子窗口标题栏下方的中央位置。

QMdiSubWindow 临时接管widget 的所有权；您无需将其删除。任何现有的内部控件都将被移除，并重新关联到根窗口。

另请参阅 widget()。

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

重写了：QWidget::showEvent(QShowEvent *event)。

[slot] void QMdiSubWindow::showShaded()

调用此函数会使子窗口进入阴影模式。当子窗口处于阴影模式时，仅显示标题栏。

尽管并非所有样式都支持遮蔽模式，但无论是否支持遮蔽，该函数仍会将子窗口显示为遮蔽状态。不过，若与不支持遮蔽的样式配合使用，用户将无法通过用户界面（例如标题栏中的遮蔽按钮）退出遮蔽模式。

另请参阅 isShaded()。

[slot] void QMdiSubWindow::showSystemMenu()

在标题栏的系统菜单图标下方显示系统菜单。

另请参阅 setSystemMenu() 和systemMenu()。

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

重新实现了属性QWidget::sizeHint 的访问函数。

QMenu *QMdiSubWindow::systemMenu() const

返回指向当前系统菜单的指针；如果未设置系统菜单，则返回零。QMdiSubWindow 提供了一个默认系统菜单，但您也可以使用setSystemMenu() 来设置菜单。

另请参阅 setSystemMenu() 和showSystemMenu()。

bool QMdiSubWindow::testOption(QMdiSubWindow::SubWindowOption option) const

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

另请参阅 SubWindowOption 和setOption()。

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

重写了：QObject::timerEvent(QTimerEvent *event)。

QWidget *QMdiSubWindow::widget() const

返回当前的内部控件。

另请参阅 setWidget()。

[signal] void QMdiSubWindow::windowStateChanged(Qt::WindowStates oldState, Qt::WindowStates newState)

QMdiSubWindow 在窗口状态发生变化后发出此信号。oldState 表示状态变化前的窗口状态，newState 表示新的、当前的状态。