QMdiArea Class Reference · PyQt4 中文文檔

# QMdiArea Class Reference ## [[QtGui](index.htm) module] 該QMdiArea小部件提供在MDI窗口的顯示區域。[More...](#details) 繼承[QAbstractScrollArea](qabstractscrollarea.html)。 ### Types * `enum AreaOption { DontMaximizeSubWindowOnActivation }` * `class **[AreaOptions](index.htm)**` * `enum ViewMode { SubWindowView, TabbedView }` * `enum WindowOrder { CreationOrder, StackingOrder, ActivationHistoryOrder }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `activateNextSubWindow (self)` * `activatePreviousSubWindow (self)` * `WindowOrder activationOrder (self)` * `QMdiSubWindow activeSubWindow (self)` * `QMdiSubWindow addSubWindow (self, QWidget?widget, Qt.WindowFlags?flags?=?0)` * `QBrush background (self)` * `cascadeSubWindows (self)` * `childEvent (self, QChildEvent?childEvent)` * `closeActiveSubWindow (self)` * `closeAllSubWindows (self)` * `QMdiSubWindow currentSubWindow (self)` * `bool documentMode (self)` * `bool event (self, QEvent?event)` * `bool eventFilter (self, QObject?object, QEvent?event)` * `QSize minimumSizeHint (self)` * `paintEvent (self, QPaintEvent?paintEvent)` * `removeSubWindow (self, QWidget?widget)` * `resizeEvent (self, QResizeEvent?resizeEvent)` * `scrollContentsBy (self, int?dx, int?dy)` * `setActivationOrder (self, WindowOrder?order)` * `setActiveSubWindow (self, QMdiSubWindow?window)` * `setBackground (self, QBrush?background)` * `setDocumentMode (self, bool?enabled)` * `setOption (self, AreaOption?option, bool?on?=?True)` * `setTabPosition (self, QTabWidget.TabPosition?position)` * `setTabsClosable (self, bool?closable)` * `setTabShape (self, QTabWidget.TabShape?shape)` * `setTabsMovable (self, bool?movable)` * `setupViewport (self, QWidget?viewport)` * `setViewMode (self, ViewMode?mode)` * `showEvent (self, QShowEvent?showEvent)` * `QSize sizeHint (self)` * `list-of-QMdiSubWindow subWindowList (self, WindowOrder?order?=?QMdiArea.CreationOrder)` * `QTabWidget.TabPosition tabPosition (self)` * `bool tabsClosable (self)` * `QTabWidget.TabShape tabShape (self)` * `bool tabsMovable (self)` * `bool testOption (self, AreaOption?opton)` * `tileSubWindows (self)` * `timerEvent (self, QTimerEvent?timerEvent)` * `ViewMode viewMode (self)` * `bool viewportEvent (self, QEvent?event)` ### Qt Signals * `void subWindowActivated (QMdiSubWindow *)` * * * ## Detailed Description 該QMdiArea小部件提供在MDI窗口的顯示區域。 QMdiArea功能，本質上，就像一個窗口管理器的MDI窗口。例如，它繪制它管理自身并安排他們在一個層疊或平鋪圖案的窗戶。 QMdiArea是常用的在一個中心部件[QMainWindow](qmainwindow.html)創建MDI應用程序，但也可以放置在任何布局。下面的代碼將一個區域的主窗口： ``` [QMainWindow](qmainwindow.html) *mainWindow = new [QMainWindow](qmainwindow.html); mainWindow->setCentralWidget(mdiArea); ``` 不同的是窗口管理器的頂層窗口，所有窗口的標志（[Qt.WindowFlags](qt.html#WindowType-enum)）通過QMdiArea只要標志由當前插件式支承。如果一個特定的標記是不支持的樣式（例如，[WindowShadeButtonHint](qt.html#WindowType-enum)），你仍然可以遮陽的窗口showShaded （）。在QMdiArea子窗口的實例[QMdiSubWindow](qmdisubwindow.html)。它們被添加到一個MDI面積[addSubWindow](qmdiarea.html#addSubWindow)（）。這是常見的傳遞[QWidget](qwidget.html)，它被設置為內部部件，該函數，但也有可能通過一個[QMdiSubWindow](qmdisubwindow.html)directly.The類繼承[QWidget](qwidget.html)和編程時，你可以使用相同的API作為一個正常的頂層窗口。[QMdiSubWindow](qmdisubwindow.html)也有行為特定于MDI窗口。請參閱[QMdiSubWindow](qmdisubwindow.html)類的描述更多的細節。當它獲取鍵盤焦點時，或者當子窗口被激活[setFocus](qwidget.html#setFocus)（）被調用。用戶通過在通常的方式移動焦點激活一個窗口。在MDI領域放出[subWindowActivated](qmdiarea.html#subWindowActivated)（）信號，當活動窗口的變化，以及[activeSubWindow](qmdiarea.html#activeSubWindow)（）函數返回活動子窗口。便利的功能[subWindowList](qmdiarea.html#subWindowList)（）返回所有子窗口的列表。此信息可以在含有窗口的列表的彈出式菜單中使用，例如。該子窗口是由當前分類[WindowOrder](qmdiarea.html#WindowOrder-enum)。這是用于[subWindowList](qmdiarea.html#subWindowList)（）和[activateNextSubWindow](qmdiarea.html#activateNextSubWindow)（）和acivatePreviousSubWindow （）。此外，它與層疊或平鋪的窗口時使用[cascadeSubWindows](qmdiarea.html#cascadeSubWindows)（）和[tileSubWindows](qmdiarea.html#tileSubWindows)（）。 QMdiArea為子窗口有兩個內置的布局策略：[cascadeSubWindows](qmdiarea.html#cascadeSubWindows)（）和[tileSubWindows](qmdiarea.html#tileSubWindows)（）。兩者都是插槽，很容易連接到菜單項。 | ![](https://img.kancloud.cn/32/2c/322cea885b64635b1ea652a22dd17a53_235x207.png) | ![](https://img.kancloud.cn/65/73/6573bc216546f91802acfece33443815_235x207.png) | **Note:**默認的滾動條屬性QMdiArea是[Qt.ScrollBarAlwaysOff](qt.html#ScrollBarPolicy-enum)。 * * * ## Type Documentation ``` QMdiArea.AreaOption ``` 這個枚舉變量描述了自定義的行為的選項[QMdiArea](qmdiarea.html)。 | Constant | Value | Description | | --- | --- | --- | | `QMdiArea.DontMaximizeSubWindowOnActivation` | `0x1` | 當活動的子窗口最大化時，默認的行為是最大限度的被激活的下一個子窗口。如果你不希望出現此行為，設置這個選項。 | 該AreaOptions類型是一個typedef為[QFlags](index.htm)\u003cAreaOption\u003e 。它存儲AreaOption值的或組合。 ``` QMdiArea.ViewMode ``` 這個枚舉變量描述了區域的視圖模式，即如何子窗口將被顯示。 | Constant | Value | Description | | --- | --- | --- | | `QMdiArea.SubWindowView` | `0` | 顯示子窗口與窗框（默認）。 | | `QMdiArea.TabbedView` | `1` | 顯示子窗口與標籤在標籤欄。 | 這個枚舉被引入或修改的Qt 4.4 。 **See also** [setViewMode](qmdiarea.html#viewMode-prop)（）。 ``` QMdiArea.WindowOrder ``` 指定的標準來使用訂購的通過返回的子窗口列表[subWindowList](qmdiarea.html#subWindowList)（）。該功能[cascadeSubWindows](qmdiarea.html#cascadeSubWindows)（）和[tileSubWindows](qmdiarea.html#tileSubWindows)（）布置窗口的時候按照這個順序。 | Constant | Value | Description | | --- | --- | --- | | `QMdiArea.CreationOrder` | `0` | 該窗口在其創建的順序返回。 | | `QMdiArea.StackingOrder` | `1` | 該窗口在它們被疊的順序返回，與最頂層窗口是在列表的最后。 | | `QMdiArea.ActivationHistoryOrder` | `2` | 該窗口在其被激活的順序返回。 | **See also** [subWindowList](qmdiarea.html#subWindowList)（）。 * * * ## Method Documentation ``` QMdiArea.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個空MDI區域。_parent_被傳遞給[QWidget](qwidget.html)的構造。 ``` QMdiArea.activateNextSubWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void activateNextSubWindow()`。使鍵盤焦點到另一個窗口的子窗口的列表中。激活該窗口將成為下一個由電流決定[activation order](qmdiarea.html#WindowOrder-enum)。 **See also** [activatePreviousSubWindow](qmdiarea.html#activatePreviousSubWindow)（）和[QMdiArea.WindowOrder](qmdiarea.html#WindowOrder-enum)。 ``` QMdiArea.activatePreviousSubWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void activatePreviousSubWindow()`。使鍵盤焦點到另一個窗口的子窗口的列表中。激活的窗口將是前一個的電流確定[activation order](qmdiarea.html#WindowOrder-enum)。 **See also** [activateNextSubWindow](qmdiarea.html#activateNextSubWindow)（）和[QMdiArea.WindowOrder](qmdiarea.html#WindowOrder-enum)。 ``` WindowOrder QMdiArea.activationOrder (self) ``` [](qmdiarea.html#WindowOrder-enum) ``` QMdiSubWindow QMdiArea.activeSubWindow (self) ``` [ 返回一個指向當前活動的子窗口。如果沒有窗口當前處于活動狀態，則返回0 。子窗口被視為頂層窗口相對于窗口狀態，即，如果在MDI禁區外一個小部件是活動窗口，沒有子窗口將被激活。請注意，如果在窗口小部件中，在MDI領域的生活獲得焦點時，該窗口將被激活。 ](qmdisubwindow.html) [**See also**](qmdisubwindow.html) [setActiveSubWindow](qmdiarea.html#setActiveSubWindow)（）和[Qt.WindowState](qt.html#WindowState-enum)。 ``` QMdiSubWindow QMdiArea.addSubWindow (self, QWidget?widget, Qt.WindowFlags?flags?=?0) ``` [ 該_widget_說法有它的所有權轉移給Qt的。添加_widget_作為一個新的子窗口的MDI區域。如果_windowFlags_是非零的，它們將復蓋在部件上設置的標志。 ](qmdisubwindow.html) [該_widget_可以是一個](qmdisubwindow.html)[QMdiSubWindow](qmdisubwindow.html)或其他[QWidget](qwidget.html)（在這種情況下， MDI的區域將創建一個子窗口，并設置_widget_作為內部部件）。 **Note:**一旦子窗口已經被添加，其母公司將是_viewport widget_的[QMdiArea](qmdiarea.html)。 ``` [QMdiArea](qmdiarea.html) mdiArea; [QMdiSubWindow](qmdisubwindow.html) *subWindow1 = new [QMdiSubWindow](qmdisubwindow.html); subWindow1->setWidget(internalWidget1); subWindow1->setAttribute([Qt](qt.html).WA_DeleteOnClose); mdiArea.addSubWindow(subWindow1); [QMdiSubWindow](qmdisubwindow.html) *subWindow2 = mdiArea.addSubWindow(internalWidget2); ``` 當您創建自己的子窗口中，你必須設置[Qt.WA_DeleteOnClose](qt.html#WidgetAttribute-enum)如果您想要在在MDI領域關上窗戶要刪除小工具屬性。如果不是，該窗口會被隱藏，并在MDI面積不會激活下一個子窗口。返回[QMdiSubWindow](qmdisubwindow.html)被添加到MDI區域。 **See also** [removeSubWindow](qmdiarea.html#removeSubWindow)（）。 ``` QBrush QMdiArea.background (self) ``` [ ``` QMdiArea.cascadeSubWindows (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void cascadeSubWindows()`。安排所有子窗口在級聯模式。 ](qbrush.html) [**See also**](qbrush.html) [tileSubWindows](qmdiarea.html#tileSubWindows)（）。 ``` QMdiArea.childEvent (self, QChildEvent?childEvent) ``` 從重新實現[QObject.childEvent](qobject.html#childEvent)（）。 ``` QMdiArea.closeActiveSubWindow (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void closeActiveSubWindow()`。關閉激活的子窗口。 **See also** [closeAllSubWindows](qmdiarea.html#closeAllSubWindows)（）。 ``` QMdiArea.closeAllSubWindows (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void closeAllSubWindows()`。通過發送關閉所有的子窗口[QCloseEvent](qcloseevent.html)每個窗口。您可能會收到[subWindowActivated](qmdiarea.html#subWindowActivated)（）從子窗口的信號，他們正在關閉之前（如果在MDI領域啟動子窗口時，另一個被關閉）。這種無視close事件子窗口將保持打開狀態。 **See also** [closeActiveSubWindow](qmdiarea.html#closeActiveSubWindow)（）。 ``` QMdiSubWindow QMdiArea.currentSubWindow (self) ``` [ 返回一個指向當前子窗口，或者0，如果沒有當前的子窗口。 ](qmdisubwindow.html) [這個函數將返回相同的](qmdisubwindow.html)[activeSubWindow](qmdiarea.html#activeSubWindow)（）如果[QApplication](qapplication.html) containing [QMdiArea](qmdiarea.html)是活動的。 **See also** [activeSubWindow](qmdiarea.html#activeSubWindow)（）和[QApplication.activeWindow](qapplication.html#activeWindow)（）。 ``` bool QMdiArea.documentMode (self) ``` ``` bool QMdiArea.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QMdiArea.eventFilter (self, QObject?object, QEvent?event) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（）。 ``` QSize QMdiArea.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（）。 ``` QMdiArea.paintEvent (self, QPaintEvent?paintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` QMdiArea.removeSubWindow (self, QWidget?widget) ``` 移除_widget_從MDI區域。該_widget_必須是[QMdiSubWindow](qmdisubwindow.html)或一個小部件是一個子窗口的內部部件。注_widget_是從來沒有真正被刪除[QMdiArea](qmdiarea.html)。如果[QMdiSubWindow](qmdisubwindow.html)傳遞在其父被設置為0 ，并將其除去，但是，如果內部部件被傳遞到子插件被設置為0 ，但[QMdiSubWindow](qmdisubwindow.html)不會被刪除。 **See also** [addSubWindow](qmdiarea.html#addSubWindow)（）。 ``` QMdiArea.resizeEvent (self, QResizeEvent?resizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（）。 ``` QMdiArea.scrollContentsBy (self, int?dx, int?dy) ``` 從重新實現[QAbstractScrollArea.scrollContentsBy](qabstractscrollarea.html#scrollContentsBy)（）。 ``` QMdiArea.setActivationOrder (self, WindowOrder?order) ``` ``` QMdiArea.setActiveSubWindow (self, QMdiSubWindow?window) ``` 這種方法也是一個Qt槽與C + +的簽名`void setActiveSubWindow(QMdiSubWindow *)`。激活的子窗口_window_。如果_window_為0時，任何當前活動窗口被關閉。 **See also** [activeSubWindow](qmdiarea.html#activeSubWindow)（）。 ``` QMdiArea.setBackground (self, QBrush?background) ``` ``` QMdiArea.setDocumentMode (self, bool?enabled) ``` ``` QMdiArea.setOption (self, AreaOption?option, bool?on?=?True) ``` If _on_是真的，_option_是對MDI的區域中啟用，否則它被禁用。看[AreaOption](qmdiarea.html#AreaOption-enum)每個選項的效果。 **See also** [AreaOption](qmdiarea.html#AreaOption-enum)和[testOption](qmdiarea.html#testOption)（）。 ``` QMdiArea.setTabPosition (self, QTabWidget.TabPosition?position) ``` ``` QMdiArea.setTabsClosable (self, bool?closable) ``` ``` QMdiArea.setTabShape (self, QTabWidget.TabShape?shape) ``` ``` QMdiArea.setTabsMovable (self, bool?movable) ``` ``` QMdiArea.setupViewport (self, QWidget?viewport) ``` 這個槽被調用者[QAbstractScrollArea](qabstractscrollarea.html)后[setViewport](qabstractscrollarea.html#setViewport)（）被調用。在子類重新實現此功能[QMdiArea](qmdiarea.html)初始化新_viewport_之前就被采用。 **See also** [setViewport](qabstractscrollarea.html#setViewport)（）。 ``` QMdiArea.setViewMode (self, ViewMode?mode) ``` ``` QMdiArea.showEvent (self, QShowEvent?showEvent) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（）。 ``` QSize QMdiArea.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` list-of-QMdiSubWindow QMdiArea.subWindowList (self, WindowOrder?order?=?QMdiArea.CreationOrder) ``` 返回在MDI領域的所有子窗口的列表。如果_order_ is [CreationOrder](qmdiarea.html#WindowOrder-enum)（默認值），該窗口被排列在它們被插入到工作區中的順序。如果_order_ is [StackingOrder](qmdiarea.html#WindowOrder-enum)，窗口中列出了它們的堆疊順序，與最頂層窗口的最后一個項目在列表中。如果_order_ is [ActivationHistoryOrder](qmdiarea.html#WindowOrder-enum)，窗戶是根據他們最近的激活歷史記錄中列出。 **See also** [WindowOrder](qmdiarea.html#WindowOrder-enum)。 ``` QTabWidget.TabPosition QMdiArea.tabPosition (self) ``` [ ``` bool QMdiArea.tabsClosable (self) ``` ](qtabwidget.html#TabPosition-enum) ``` QTabWidget.TabShape QMdiArea.tabShape (self) ``` [ ``` bool QMdiArea.tabsMovable (self) ``` ``` bool QMdiArea.testOption (self, AreaOption?opton) ``` 返回True如果_option_被啟用，否則返回False 。 ](qtabwidget.html#TabShape-enum) [**See also**](qtabwidget.html#TabShape-enum) [AreaOption](qmdiarea.html#AreaOption-enum)和[setOption](qmdiarea.html#setOption)（）。 ``` QMdiArea.tileSubWindows (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void tileSubWindows()`。安排所有子窗口的瓷磚圖案。 **See also** [cascadeSubWindows](qmdiarea.html#cascadeSubWindows)（）。 ``` QMdiArea.timerEvent (self, QTimerEvent?timerEvent) ``` 從重新實現[QObject.timerEvent](qobject.html#timerEvent)（）。 ``` ViewMode QMdiArea.viewMode (self) ``` [ ``` bool QMdiArea.viewportEvent (self, QEvent?event) ``` ](qmdiarea.html#ViewMode-enum) [從重新實現](qmdiarea.html#ViewMode-enum)[QAbstractScrollArea.viewportEvent](qabstractscrollarea.html#viewportEvent)（）。 * * * ## Qt Signal Documentation ``` void subWindowActivated (QMdiSubWindow *) ``` 這是該信號的默認超載。 [QMdiArea](qmdiarea.html)之后發出這個信號_window_已被激活。何時_window_為0時，[QMdiArea](qmdiarea.html)剛剛解除其最后一個活動窗口，并有在工作區沒有活動的窗口。 **See also** [QMdiArea.activeSubWindow](qmdiarea.html#activeSubWindow)（）。