QWorkspace Class Reference · PyQt4 中文文檔

# QWorkspace Class Reference ## [[QtGui](index.htm) module] 該QWorkspace小部件提供一個工作區窗口，可以在MDI應用程序中使用。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum WindowOrder { CreationOrder, StackingOrder }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `activateNextWindow (self)` * `activatePreviousWindow (self)` * `QWidget activeWindow (self)` * `QWidget addWindow (self, QWidget?w, Qt.WindowFlags?flags?=?0)` * `arrangeIcons (self)` * `QBrush background (self)` * `cascade (self)` * `changeEvent (self, QEvent)` * `childEvent (self, QChildEvent)` * `closeActiveWindow (self)` * `closeAllWindows (self)` * `bool event (self, QEvent?e)` * `bool eventFilter (self, QObject, QEvent)` * `hideEvent (self, QHideEvent?e)` * `paintEvent (self, QPaintEvent?e)` * `resizeEvent (self, QResizeEvent)` * `bool scrollBarsEnabled (self)` * `setActiveWindow (self, QWidget?w)` * `setBackground (self, QBrush?background)` * `setScrollBarsEnabled (self, bool?enable)` * `showEvent (self, QShowEvent?e)` * `QSize sizeHint (self)` * `tile (self)` * `wheelEvent (self, QWheelEvent?e)` * `list-of-QWidget windowList (self, WindowOrder?order?=?QWorkspace.CreationOrder)` ### Qt Signals * `void windowActivated (QWidget *)` * * * ## Detailed Description 該QWorkspace小部件提供一個工作區窗口，可以在MDI應用程序中使用。此類已被否決。使用[QMdiArea](qmdiarea.html)代替。多文檔界面（MDI ）應用程序通常由包含一個菜單欄，工具欄，和中央QWorkspace部件一個主窗口。工作空間本身是用來顯示多個子窗口，其中每一個是一個部件。工作區本身就是一個普通的Qt的部件。它有一個標準的構造函數接受一個父部件。工作空間可以被放置在任何布局，但通常被給定為在中央部件[QMainWindow](qmainwindow.html)： ``` MainWindow.MainWindow() { workspace = new QWorkspace; setCentralWidget(workspace); ... } ``` 子窗口（ MDI窗口）是插入到工作區中使用標準的Qt部件[addWindow](qworkspace.html#addWindow)（）。與頂層窗口部件，你可以調用函數，如[show](qwidget.html#show)（）[hide](qwidget.html#hide)（）[showMaximized](qwidget.html#showMaximized)（）和[setWindowTitle](qwidget.html#windowTitle-prop)（）在子窗口更改工作區中它的外觀。您也可以提供窗口部件標記，以確定裝修或部件本身的行為的布局。要更改或檢索一個子窗口的幾何形狀，你必須在它的操作[parentWidget](qwidget.html#parentWidget)（）。該[parentWidget](qwidget.html#parentWidget)（）提供了訪問的裝飾框，其中包含子窗口小部件。當一個子窗口最大化，它的裝飾框被隱藏。如果頂層窗口部件包含一個菜單欄，它會顯示最大化窗口的操作菜單中的菜單項的左側，和窗口的控制，以正確的。當它獲取鍵盤焦點時，或者當子窗口被激活[setFocus](qwidget.html#setFocus)（）被調用。用戶可以通過點擊窗口或按Tab鍵移動焦點在通常的方法，例如激活的窗口。工作區中發射的信號[windowActivated](qworkspace.html#windowActivated)（）當活動窗口的變化，并且功能[activeWindow](qworkspace.html#activeWindow)（）返回一個指向活動的子窗口，或者0，如果沒有窗口被激活。便利的功能[windowList](qworkspace.html#windowList)（）返回所有子窗口的列表。此信息可以在含有窗口的列表的彈出式菜單中使用，例如。此功能也可作為部分[Window Menu](http://doc.qt.digia.com/qq/qq09-qt-solutions.html)解決方案。 QWorkspace為子窗口有兩個內置的布局策略：[cascade](qworkspace.html#cascade)（）和[tile](qworkspace.html#tile)（）。兩者都是插槽讓您可以輕松的菜單項連接到它們。 | ![](https://img.kancloud.cn/32/2c/322cea885b64635b1ea652a22dd17a53_235x207.png) | ![](https://img.kancloud.cn/65/73/6573bc216546f91802acfece33443815_235x207.png) | 如果你希望你的用戶能夠與子窗口比可見工作區面積較大的工作，設置[scrollBarsEnabled](qworkspace.html#scrollBarsEnabled-prop)屬性設置為True 。 * * * ## Type Documentation ``` QWorkspace.WindowOrder ``` 指定在其中的子窗口從返回的順序[windowList](qworkspace.html#windowList)（）。 | Constant | Value | Description | | --- | --- | --- | | `QWorkspace.CreationOrder` | `0` | 該窗口在其創建的順序返回 | | `QWorkspace.StackingOrder` | `1` | 該窗口在它們的層疊順序返回 | * * * ## Method Documentation ``` QWorkspace.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個工作區與給定_parent_。 ``` QWorkspace.activateNextWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void activateNextWindow()`。給出了輸入焦點的子窗口列表中的下一個窗口。 **See also** [activatePreviousWindow](qworkspace.html#activatePreviousWindow)（）。 ``` QWorkspace.activatePreviousWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void activatePreviousWindow()`。給出了輸入焦點到前一個窗口中的子窗口的列表中。 **See also** [activateNextWindow](qworkspace.html#activateNextWindow)（）。 ``` QWidget QWorkspace.activeWindow (self) ``` [ 返回一個指針，對應于活動的子窗口，或者0，如果沒有窗口被激活的窗口小部件。 ](qwidget.html) [**See also**](qwidget.html) [setActiveWindow](qworkspace.html#setActiveWindow)（）。 ``` QWidget QWorkspace.addWindow (self, QWidget?w, Qt.WindowFlags?flags?=?0) ``` [ 該_w_說法有它的所有權轉移給Qt的。添加小工具_w_作為新的子窗口的工作空間。如果_flags_是非零的，它們將復蓋在部件上設置的標志。返回用于窗口框架的窗口部件。 ](qwidget.html) [要刪除小工具_w_從工作區，只需調用](qwidget.html)[setParent](qwidget.html#setParent)（）與新的父（或0 ，使之成為單獨的窗口）。 ``` QWorkspace.arrangeIcons (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void arrangeIcons()`。所有排列圖標化窗口在工作區的底部。 **See also** [cascade](qworkspace.html#cascade)（）和[tile](qworkspace.html#tile)（）。 ``` QBrush QWorkspace.background (self) ``` [ ``` QWorkspace.cascade (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void cascade()`。安排所有子窗口在級聯模式。 ](qbrush.html) [**See also**](qbrush.html) [tile](qworkspace.html#tile)（）和[arrangeIcons](qworkspace.html#arrangeIcons)（）。 ``` QWorkspace.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` QWorkspace.childEvent (self, QChildEvent) ``` 從重新實現[QObject.childEvent](qobject.html#childEvent)（）。 ``` QWorkspace.closeActiveWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void closeActiveWindow()`。關閉子窗口，是目前活躍。 **See also** [closeAllWindows](qworkspace.html#closeAllWindows)（）。 ``` QWorkspace.closeAllWindows (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void closeAllWindows()`。關閉所有的子窗口。如果任何子窗口無法接受close事件，其馀窗口將繼續開放。 **See also** [closeActiveWindow](qworkspace.html#closeActiveWindow)（）。 ``` bool QWorkspace.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QWorkspace.eventFilter (self, QObject, QEvent) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（）。 ``` QWorkspace.hideEvent (self, QHideEvent?e) ``` 從重新實現[QWidget.hideEvent](qwidget.html#hideEvent)（）。 ``` QWorkspace.paintEvent (self, QPaintEvent?e) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` QWorkspace.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` bool QWorkspace.scrollBarsEnabled (self) ``` ``` QWorkspace.setActiveWindow (self, QWidget?w) ``` 這種方法也是一個Qt槽與C + +的簽名`void setActiveWindow(QWidget *)`。使得包含子窗口_w_活動的子窗口。 **See also** [activeWindow](qworkspace.html#activeWindow)（）。 ``` QWorkspace.setBackground (self, QBrush?background) ``` ``` QWorkspace.setScrollBarsEnabled (self, bool?enable) ``` ``` QWorkspace.showEvent (self, QShowEvent?e) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（）。 ``` QSize QWorkspace.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` QWorkspace.tile (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void tile()`。安排所有子窗口的瓷磚圖案。 **See also** [cascade](qworkspace.html#cascade)（）和[arrangeIcons](qworkspace.html#arrangeIcons)（）。 ``` QWorkspace.wheelEvent (self, QWheelEvent?e) ``` 從重新實現[QWidget.wheelEvent](qwidget.html#wheelEvent)（）。 ``` list-of-QWidget QWorkspace.windowList (self, WindowOrder?order?=?QWorkspace.CreationOrder) ``` 返回所有可見或最小化的子窗口的列表。如果_order_ is [CreationOrder](qworkspace.html#WindowOrder-enum)（默認值），該窗口被列在它們被插入到工作區中的順序。如果_order_ is [StackingOrder](qworkspace.html#WindowOrder-enum)，窗口中列出了它們的堆疊順序，與最頂層窗口的最后一個項目在列表中。 * * * ## Qt Signal Documentation ``` void windowActivated (QWidget *) ``` 這是該信號的默認超載。這個信號被發射時的子窗口_w_變得活躍。需要注意的是_w_可以是0，和一個以上的信號可用于單個激活事件發射。 **See also** [activeWindow](qworkspace.html#activeWindow)（）和[windowList](qworkspace.html#windowList)（）。