QMdiSubWindow Class Reference

QMdiSubWindow Class Reference

[QtGui module]

该QMdiSubWindow类提供了一个子窗口类QMdiArea。More…

继承QWidget。

Types

enum SubWindowOption { RubberBandResize, RubberBandMove }
class **[SubWindowOptions]($docs-index.htm)**

Methods

__init__ (self, QWidget parent = None, Qt.WindowFlags flags = 0)
changeEvent (self, QEvent changeEvent)
childEvent (self, QChildEvent childEvent)
closeEvent (self, QCloseEvent closeEvent)
contextMenuEvent (self, QContextMenuEvent contextMenuEvent)
bool event (self, QEvent event)
bool eventFilter (self, QObject object, QEvent event)
focusInEvent (self, QFocusEvent focusInEvent)
focusOutEvent (self, QFocusEvent focusOutEvent)
hideEvent (self, QHideEvent hideEvent)
bool isShaded (self)
int keyboardPageStep (self)
int keyboardSingleStep (self)
keyPressEvent (self, QKeyEvent keyEvent)
leaveEvent (self, QEvent leaveEvent)
QMdiArea mdiArea (self)
QSize minimumSizeHint (self)
mouseDoubleClickEvent (self, QMouseEvent mouseEvent)
mouseMoveEvent (self, QMouseEvent mouseEvent)
mousePressEvent (self, QMouseEvent mouseEvent)
mouseReleaseEvent (self, QMouseEvent mouseEvent)
moveEvent (self, QMoveEvent moveEvent)
paintEvent (self, QPaintEvent paintEvent)
resizeEvent (self, QResizeEvent resizeEvent)
setKeyboardPageStep (self, int step)
setKeyboardSingleStep (self, int step)
setOption (self, SubWindowOption option, bool on = True)
setSystemMenu (self, QMenu systemMenu)
setWidget (self, QWidget widget)
showEvent (self, QShowEvent showEvent)
showShaded (self)
showSystemMenu (self)
QSize sizeHint (self)
QMenu systemMenu (self)
bool testOption (self, SubWindowOption)
timerEvent (self, QTimerEvent timerEvent)
QWidget widget (self)

Qt Signals

void aboutToActivate ()
void windowStateChanged (Qt::WindowStates,Qt::WindowStates)

Detailed Description

该QMdiSubWindow类提供了一个子窗口类QMdiArea。

QMdiSubWindow代表了一个顶层窗口QMdiArea，并包含有窗装饰，内部部件，并（根据目前的风格）窗框和大小手柄一个标题栏。 QMdiSubWindow有自己的布局，其中包括标题栏和一个中心区内部小部件。

QMdiSubWindow Class Reference - 图1

构造一个QMdiSubWindow最常见的方法是调用QMdiArea.addSubWindow（）与内部部件作为参数。您也可以自己创建一个子窗口，并通过调用设置一个内部小部件setWidget（）。

当与子窗口与普通顶层窗口（例如，编程您可以使用相同的API ，你可以调用函数，如show（）hide（）showMaximized（）和setWindowTitle（））。

Subwindow Handling

QMdiSubWindow还支持特定于一个MDI子窗口区域的行为。

默认情况下，每个QMdiSubWindow是MDI领域内视可见搬来搬去的时候，但它也可以指定透明窗口的移动和调整大小的行为，其中一个子窗口，只有轮廓在这些行动中被更新。该setOption（）函数是用来启用此行为。

该isShaded（）函数检测子窗口当前是否处于阴影（即窗口处于折叠状态，因此只有标题栏可见）。进入着色模式，通话时间showShaded（）。 QMdiSubWindow放出windowStateChanged（）信号时窗口状态发生了变化（例如，当窗口最小化或恢复）。它还发出aboutToActivate（）之前被激活。

在键盘的交互模式，窗户被移动和调整大小的键盘。你可以通过这个窗口的系统菜单进入该模式。该keyboardSingleStep和keyboardPageStep属性控制部件被移动或改变大小为每个按键事件的距离。当换挡时按下页的步骤使用，否则单步使用。

您也可以使用键盘更改活动窗口。通过按压控制和tab键在同一时间，接下来的处理（使用当前WindowOrder）子窗口将被激活。按Ctrl ，Shift和标籤上，您将激活上一个窗口。这等同于调用activateNextSubWindow()和activatePreviousSubWindow()。需要注意的是这些快捷方式复盖全局的快捷键，但不是QMdiAreas捷径。

Type Documentation

QMdiSubWindow.SubWindowOption

这个枚举变量描述了自定义的行为的选项QMdiSubWindow。

Constant	Value	Description
`QMdiSubWindow.RubberBandResize`	`0x4`	如果启用此选项，橡皮筋控制是用来表示子窗口的轮廓，以及用户调整，而不是子窗口本身这一点。因此，子窗口保持其原来的位置和大小，直到调整操作已经完成，届时将接受一个单一的QResizeEvent。默认情况下，该选项被禁用。
`QMdiSubWindow.RubberBandMove`	`0x8`	如果启用此选项，橡皮筋控制是用来表示子窗口的轮廓，以及用户移动，而不是子窗口本身这一点。其结果是，在子窗口保持在其原来的位置，直到在移动操作已经完成，在该时间QMoveEvent被发送到窗口。默认情况下，该选项被禁用。

该SubWindowOptions类型是一个typedef为QFlags\u003cSubWindowOption\u003e 。它存储SubWindowOption值的或组合。

Method Documentation

QMdiSubWindow.__init__ (self, QWidget parent = None, Qt.WindowFlags flags = 0)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个新的QMdiSubWindow小工具。该parent和flags参数被传递给QWidget的构造。

代替使用addSubWindow （）的，它也只是可以使用setParent（）当您添加子窗口到QMdiArea。

请注意，只有QMdiSubWindowS可设定为儿童QMdiArea，你不能，例如，写：

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

See also QMdiArea.addSubWindow（）。

QMdiSubWindow.changeEvent (self, QEvent changeEvent)

从重新实现QWidget.changeEvent（）。

QMdiSubWindow.childEvent (self, QChildEvent childEvent)

从重新实现QObject.childEvent（）。

QMdiSubWindow.closeEvent (self, QCloseEvent closeEvent)

从重新实现QWidget.closeEvent（）。

QMdiSubWindow.contextMenuEvent (self, QContextMenuEvent contextMenuEvent)

从重新实现QWidget.contextMenuEvent（）。

bool QMdiSubWindow.event (self, QEvent event)

从重新实现QObject.event（）。

bool QMdiSubWindow.eventFilter (self, QObject object, QEvent event)

从重新实现QObject.eventFilter（）。

QMdiSubWindow.focusInEvent (self, QFocusEvent focusInEvent)

从重新实现QWidget.focusInEvent（）。

QMdiSubWindow.focusOutEvent (self, QFocusEvent focusOutEvent)

从重新实现QWidget.focusOutEvent（）。

QMdiSubWindow.hideEvent (self, QHideEvent hideEvent)

从重新实现QWidget.hideEvent（）。

bool QMdiSubWindow.isShaded (self)

返回True如果此窗口阴影，否则返回False 。

如果它处于折叠状态，因此只有标题栏是可见的窗口的阴影。

int QMdiSubWindow.keyboardPageStep (self)

int QMdiSubWindow.keyboardSingleStep (self)

QMdiSubWindow.keyPressEvent (self, QKeyEvent keyEvent)

从重新实现QWidget.keyPressEvent（）。

QMdiSubWindow.leaveEvent (self, QEvent leaveEvent)

从重新实现QWidget.leaveEvent（）。

QMdiArea QMdiSubWindow.mdiArea (self)

[

返回包含该子窗口，或者0，如果是没有的区域。

此功能被引入Qt的4.4 。

]($docs-qmdiarea.html)

See also QMdiArea.addSubWindow（）。

QSize QMdiSubWindow.minimumSizeHint (self)

从重新实现 QWidget.minimumSizeHint（）。

QMdiSubWindow.mouseDoubleClickEvent (self, QMouseEvent mouseEvent)

从重新实现QWidget.mouseDoubleClickEvent（）。

QMdiSubWindow.mouseMoveEvent (self, QMouseEvent mouseEvent)

从重新实现QWidget.mouseMoveEvent（）。

QMdiSubWindow.mousePressEvent (self, QMouseEvent mouseEvent)

从重新实现QWidget.mousePressEvent（）。

QMdiSubWindow.mouseReleaseEvent (self, QMouseEvent mouseEvent)

从重新实现QWidget.mouseReleaseEvent（）。

QMdiSubWindow.moveEvent (self, QMoveEvent moveEvent)

从重新实现QWidget.moveEvent（）。

QMdiSubWindow.paintEvent (self, QPaintEvent paintEvent)

从重新实现QWidget.paintEvent（）。

QMdiSubWindow.resizeEvent (self, QResizeEvent resizeEvent)

从重新实现QWidget.resizeEvent（）。

QMdiSubWindow.setKeyboardPageStep (self, int step)

QMdiSubWindow.setKeyboardSingleStep (self, int step)

QMdiSubWindow.setOption (self, SubWindowOption option, bool on = True)

If on是真的，option在子窗口被激活，否则将被禁用。看SubWindowOption每个选项的效果。

See also SubWindowOption和testOption（）。

QMdiSubWindow.setSystemMenu (self, QMenu systemMenu)

该systemMenu说法有它的所有权转移给Qt的。

Sets systemMenu作为该子窗口中当前的系统菜单。

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

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

由用户添加QActions不被更新QMdiSubWindow。

QMdiSubWindow采取所有权systemMenu，您不必删除它。任何现有的菜单将被删除。

See also systemMenu（）和showSystemMenu（）。

QMdiSubWindow.setWidget (self, QWidget widget)

该widget说法有它的所有权转移给Qt的。

Sets widget作为这个子窗口的内部部件。内部小部件将显示在标题栏下的子窗口的中心。

QMdiSubWindow采取的临时所有权widget，您不必删除它。任何现有的内部部件将被删除和重设父到根窗口。

See also widget（）。

QMdiSubWindow.showEvent (self, QShowEvent showEvent)

从重新实现QWidget.showEvent（）。

QMdiSubWindow.showShaded (self)

这种方法也是一个Qt槽与C + +的签名void showShaded()。

调用此函数使子窗口进入着色模式。当子窗口被遮蔽，只有标题栏可见。

虽然阴影是不支持的所有样式，这个功能仍然会显示为阴影的子窗口，无论是可用于遮阳的支持。然而，随着款式不支持底纹使用时，用户将无法从阴影模式通过用户界面返回（例如，通过在标题栏中窗帘按键）。

See also isShaded（）。

QMdiSubWindow.showSystemMenu (self)

这种方法也是一个Qt槽与C + +的签名void showSystemMenu()。

下面显示在标题栏中显示的系统菜单图标，系统菜单。

See also setSystemMenu（）和systemMenu（）。

QSize QMdiSubWindow.sizeHint (self)

从重新实现 QWidget.sizeHint（）。

QMenu QMdiSubWindow.systemMenu (self)

返回一个指针，指向当前系统菜单，或零，如果没有系统菜单设置。QMdiSubWindow提供了默认的系统菜单，但你也可以设置菜单与setSystemMenu（）。

See also setSystemMenu（）和showSystemMenu（）。

bool QMdiSubWindow.testOption (self, SubWindowOption)

返回True如果option被启用，否则返回False 。

See also SubWindowOption和setOption（）。

QMdiSubWindow.timerEvent (self, QTimerEvent timerEvent)

从重新实现QObject.timerEvent（）。

QWidget QMdiSubWindow.widget (self)

[

返回当前的内部部件。

]($docs-qwidget.html)

See also setWidget（）。

Qt Signal Documentation

void aboutToActivate ()

这是该信号的默认超载。

QMdiSubWindow发出这个信号之前立即被激活。后的子窗口已经被激活，则QMdiArea管理该子窗口也将放出subWindowActivated()信号。

See also QMdiArea.subWindowActivated（）。

void windowStateChanged (Qt::WindowStates,Qt::WindowStates)

这是该信号的默认超载。

QMdiSubWindow之后，窗口状态的改变会发出这个信号。oldState是窗口状态才改变，newState是新的，目前的状态。