QMdiSubWindow Class Reference · PyQt4 中文文檔

# QMdiSubWindow Class Reference ## [[QtGui](index.htm) module] 該QMdiSubWindow類提供了一個子窗口類[QMdiArea](qmdiarea.html)。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum SubWindowOption { RubberBandResize, RubberBandMove }` * `class **[SubWindowOptions](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](qmdiarea.html)。 QMdiSubWindow代表了一個頂層窗口[QMdiArea](qmdiarea.html)，并包含有窗裝飾，內部部件，并（根據目前的風格）窗框和大小手柄一個標題欄。 QMdiSubWindow有自己的布局，其中包括標題欄和一個中心區內部小部件。 ![](https://img.kancloud.cn/fd/49/fd494436529391e18e7c526cc9e066f2_191x158.png) 構造一個QMdiSubWindow最常見的方法是調用[QMdiArea.addSubWindow](qmdiarea.html#addSubWindow)（）與內部部件作為參數。您也可以自己創建一個子窗口，并通過調用設置一個內部小部件[setWidget](qmdisubwindow.html#setWidget)（）。當與子窗口與普通頂層窗口（例如，編程您可以使用相同的API ，你可以調用函數，如[show](qwidget.html#show)（）[hide](qwidget.html#hide)（）[showMaximized](qwidget.html#showMaximized)（）和[setWindowTitle](qwidget.html#windowTitle-prop)（））。 ### Subwindow Handling QMdiSubWindow還支持特定于一個MDI子窗口區域的行為。默認情況下，每個QMdiSubWindow是MDI領域內視可見搬來搬去的時候，但它也可以指定透明窗口的移動和調整大小的行為，其中一個子窗口，只有輪廓在這些行動中被更新。該[setOption](qmdisubwindow.html#setOption)（）函數是用來啟用此行為。該[isShaded](qmdisubwindow.html#isShaded)（）函數檢測子窗口當前是否處于陰影（即窗口處于折疊狀態，因此只有標題欄可見）。進入著色模式，通話時間[showShaded](qmdisubwindow.html#showShaded)（）。 QMdiSubWindow放出[windowStateChanged](qmdisubwindow.html#windowStateChanged)（）信號時窗口狀態發生了變化（例如，當窗口最小化或恢復）。它還發出[aboutToActivate](qmdisubwindow.html#aboutToActivate)（）之前被激活。在鍵盤的交互模式，窗戶被移動和調整大小的鍵盤。你可以通過這個窗口的系統菜單進入該模式。該[keyboardSingleStep](qmdisubwindow.html#keyboardSingleStep-prop)和[keyboardPageStep](qmdisubwindow.html#keyboardPageStep-prop)屬性控制部件被移動或改變大小為每個按鍵事件的距離。當換擋時按下頁的步驟使用，否則單步使用。您也可以使用鍵盤更改活動窗口。通過按壓控制和tab鍵在同一時間，接下來的處理（使用當前[WindowOrder](qmdiarea.html#WindowOrder-enum)）子窗口將被激活。按Ctrl ，Shift和標籤上，您將激活上一個窗口。這等同于調用[activateNextSubWindow()](qmdiarea.html#activateNextSubWindow)和[activatePreviousSubWindow()](qmdiarea.html#activatePreviousSubWindow)。需要注意的是這些快捷方式復蓋全局的快捷鍵，但不是[QMdiArea](qmdiarea.html)s捷徑。 * * * ## Type Documentation ``` QMdiSubWindow.SubWindowOption ``` 這個枚舉變量描述了自定義的行為的選項[QMdiSubWindow](qmdisubwindow.html)。 | Constant | Value | Description | | --- | --- | --- | | `QMdiSubWindow.RubberBandResize` | `0x4` | 如果啟用此選項，橡皮筋控制是用來表示子窗口的輪廓，以及用戶調整，而不是子窗口本身這一點。因此，子窗口保持其原來的位置和大小，直到調整操作已經完成，屆時將接受一個單一的[QResizeEvent](qresizeevent.html)。默認情況下，該選項被禁用。 | | `QMdiSubWindow.RubberBandMove` | `0x8` | 如果啟用此選項，橡皮筋控制是用來表示子窗口的輪廓，以及用戶移動，而不是子窗口本身這一點。其結果是，在子窗口保持在其原來的位置，直到在移動操作已經完成，在該時間[QMoveEvent](qmoveevent.html)被發送到窗口。默認情況下，該選項被禁用。 | 該SubWindowOptions類型是一個typedef為[QFlags](index.htm)\u003cSubWindowOption\u003e 。它存儲SubWindowOption值的或組合。 * * * ## Method Documentation ``` QMdiSubWindow.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的[QMdiSubWindow](qmdisubwindow.html)小工具。該_parent_和_flags_參數被傳遞給[QWidget](qwidget.html)的構造。代替使用addSubWindow （）的，它也只是可以使用[setParent](qwidget.html#setParent)（）當您添加子窗口到[QMdiArea](qmdiarea.html)。請注意，只有[QMdiSubWindow](qmdisubwindow.html)S可設定為兒童[QMdiArea](qmdiarea.html)，你不能，例如，寫： ``` QMdiArea mdiArea; QTextEdit editor(&mdiArea); // invalid child widget ``` **See also** [QMdiArea.addSubWindow](qmdiarea.html#addSubWindow)（）。 ``` QMdiSubWindow.changeEvent (self, QEvent?changeEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` QMdiSubWindow.childEvent (self, QChildEvent?childEvent) ``` 從重新實現[QObject.childEvent](qobject.html#childEvent)（）。 ``` QMdiSubWindow.closeEvent (self, QCloseEvent?closeEvent) ``` 從重新實現[QWidget.closeEvent](qwidget.html#closeEvent)（）。 ``` QMdiSubWindow.contextMenuEvent (self, QContextMenuEvent?contextMenuEvent) ``` 從重新實現[QWidget.contextMenuEvent](qwidget.html#contextMenuEvent)（）。 ``` bool QMdiSubWindow.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QMdiSubWindow.eventFilter (self, QObject?object, QEvent?event) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（）。 ``` QMdiSubWindow.focusInEvent (self, QFocusEvent?focusInEvent) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（）。 ``` QMdiSubWindow.focusOutEvent (self, QFocusEvent?focusOutEvent) ``` 從重新實現[QWidget.focusOutEvent](qwidget.html#focusOutEvent)（）。 ``` QMdiSubWindow.hideEvent (self, QHideEvent?hideEvent) ``` 從重新實現[QWidget.hideEvent](qwidget.html#hideEvent)（）。 ``` bool QMdiSubWindow.isShaded (self) ``` 返回True如果此窗口陰影，否則返回False 。如果它處于折疊狀態，因此只有標題欄是可見的窗口的陰影。 ``` int QMdiSubWindow.keyboardPageStep (self) ``` ``` int QMdiSubWindow.keyboardSingleStep (self) ``` ``` QMdiSubWindow.keyPressEvent (self, QKeyEvent?keyEvent) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。 ``` QMdiSubWindow.leaveEvent (self, QEvent?leaveEvent) ``` 從重新實現[QWidget.leaveEvent](qwidget.html#leaveEvent)（）。 ``` QMdiArea QMdiSubWindow.mdiArea (self) ``` [ 返回包含該子窗口，或者0，如果是沒有的區域。此功能被引入Qt的4.4 。 ](qmdiarea.html) [**See also**](qmdiarea.html) [QMdiArea.addSubWindow](qmdiarea.html#addSubWindow)（）。 ``` QSize QMdiSubWindow.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（）。 ``` QMdiSubWindow.mouseDoubleClickEvent (self, QMouseEvent?mouseEvent) ``` 從重新實現[QWidget.mouseDoubleClickEvent](qwidget.html#mouseDoubleClickEvent)（）。 ``` QMdiSubWindow.mouseMoveEvent (self, QMouseEvent?mouseEvent) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（）。 ``` QMdiSubWindow.mousePressEvent (self, QMouseEvent?mouseEvent) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。 ``` QMdiSubWindow.mouseReleaseEvent (self, QMouseEvent?mouseEvent) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（）。 ``` QMdiSubWindow.moveEvent (self, QMoveEvent?moveEvent) ``` 從重新實現[QWidget.moveEvent](qwidget.html#moveEvent)（）。 ``` QMdiSubWindow.paintEvent (self, QPaintEvent?paintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` QMdiSubWindow.resizeEvent (self, QResizeEvent?resizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QMdiSubWindow.setKeyboardPageStep (self, int?step) ``` ``` QMdiSubWindow.setKeyboardSingleStep (self, int?step) ``` ``` QMdiSubWindow.setOption (self, SubWindowOption?option, bool?on?=?True) ``` If _on_是真的，_option_在子窗口被激活，否則將被禁用。看[SubWindowOption](qmdisubwindow.html#SubWindowOption-enum)每個選項的效果。 **See also** [SubWindowOption](qmdisubwindow.html#SubWindowOption-enum)和[testOption](qmdisubwindow.html#testOption)（）。 ``` QMdiSubWindow.setSystemMenu (self, QMenu?systemMenu) ``` 該_systemMenu_說法有它的所有權轉移給Qt的。 Sets _systemMenu_作為該子窗口中當前的系統菜單。默認情況下，每[QMdiSubWindow](qmdisubwindow.html)有一個標準的系統菜單。 QActions由創建的系統菜單[QMdiSubWindow](qmdisubwindow.html)根據當前窗口狀態會自動更新;例如，窗口最小化后的最小化操作將被禁用。由用戶添加QActions不被更新[QMdiSubWindow](qmdisubwindow.html)。 [QMdiSubWindow](qmdisubwindow.html)采取所有權_systemMenu_，您不必刪除它。任何現有的菜單將被刪除。 **See also** [systemMenu](qmdisubwindow.html#systemMenu)（）和[showSystemMenu](qmdisubwindow.html#showSystemMenu)（）。 ``` QMdiSubWindow.setWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 Sets _widget_作為這個子窗口的內部部件。內部小部件將顯示在標題欄下的子窗口的中心。 [QMdiSubWindow](qmdisubwindow.html)采取的臨時所有權_widget_，您不必刪除它。任何現有的內部部件將被刪除和重設父到根窗口。 **See also** [widget](qmdisubwindow.html#widget)（）。 ``` QMdiSubWindow.showEvent (self, QShowEvent?showEvent) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（）。 ``` QMdiSubWindow.showShaded (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showShaded()`。調用此函數使子窗口進入著色模式。當子窗口被遮蔽，只有標題欄可見。雖然陰影是不支持的所有樣式，這個功能仍然會顯示為陰影的子窗口，無論是可用于遮陽的支持。然而，隨著款式不支持底紋使用時，用戶將無法從陰影模式通過用戶界面返回（例如，通過在標題欄中窗簾按鍵）。 **See also** [isShaded](qmdisubwindow.html#isShaded)（）。 ``` QMdiSubWindow.showSystemMenu (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void showSystemMenu()`。下面顯示在標題欄中顯示的系統菜單圖標，系統菜單。 **See also** [setSystemMenu](qmdisubwindow.html#setSystemMenu)（）和[systemMenu](qmdisubwindow.html#systemMenu)（）。 ``` QSize QMdiSubWindow.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` QMenu QMdiSubWindow.systemMenu (self) ``` [](qmenu.html) [返回一個指針，指向當前系統菜單，或零，如果沒有系統菜單設置。](qmenu.html)[QMdiSubWindow](qmdisubwindow.html)提供了默認的系統菜單，但你也可以設置菜單與[setSystemMenu](qmdisubwindow.html#setSystemMenu)（）。 **See also** [setSystemMenu](qmdisubwindow.html#setSystemMenu)（）和[showSystemMenu](qmdisubwindow.html#showSystemMenu)（）。 ``` bool QMdiSubWindow.testOption (self, SubWindowOption) ``` 返回True如果_option_被啟用，否則返回False 。 **See also** [SubWindowOption](qmdisubwindow.html#SubWindowOption-enum)和[setOption](qmdisubwindow.html#setOption)（）。 ``` QMdiSubWindow.timerEvent (self, QTimerEvent?timerEvent) ``` 從重新實現[QObject.timerEvent](qobject.html#timerEvent)（）。 ``` QWidget QMdiSubWindow.widget (self) ``` [ 返回當前的內部部件。 ](qwidget.html) [**See also**](qwidget.html) [setWidget](qmdisubwindow.html#setWidget)（）。 * * * ## Qt Signal Documentation ``` void aboutToActivate () ``` 這是該信號的默認超載。 [QMdiSubWindow](qmdisubwindow.html)發出這個信號之前立即被激活。后的子窗口已經被激活，則[QMdiArea](qmdiarea.html)管理該子窗口也將放出[subWindowActivated()](qmdiarea.html#subWindowActivated)信號。 **See also** [QMdiArea.subWindowActivated](qmdiarea.html#subWindowActivated)（）。 ``` void windowStateChanged (Qt::WindowStates,Qt::WindowStates) ``` 這是該信號的默認超載。 [QMdiSubWindow](qmdisubwindow.html)之后，窗口狀態的改變會發出這個信號。_oldState_是窗口狀態才改變，_newState_是新的，目前的狀態。