QMainWindow Class Reference · PyQt4 中文文檔

# QMainWindow Class Reference ## [[QtGui](index.htm) module] QMainWindow類提供了一個主應用程序窗口。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum DockOption { AnimatedDocks, AllowNestedDocks, AllowTabbedDocks, ForceTabbedDocks, VerticalTabs }` * `class **[DockOptions](index.htm)**` ### Methods * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `addDockWidget (self, Qt.DockWidgetArea?area, QDockWidget?dockwidget)` * `addDockWidget (self, Qt.DockWidgetArea?area, QDockWidget?dockwidget, Qt.Orientation?orientation)` * `addToolBar (self, Qt.ToolBarArea?area, QToolBar?toolbar)` * `addToolBar (self, QToolBar?toolbar)` * `QToolBar addToolBar (self, QString?title)` * `addToolBarBreak (self, Qt.ToolBarArea?area?=?Qt.TopToolBarArea)` * `QWidget centralWidget (self)` * `contextMenuEvent (self, QContextMenuEvent?event)` * `Qt.DockWidgetArea corner (self, Qt.Corner?corner)` * `QMenu createPopupMenu (self)` * `DockOptions dockOptions (self)` * `Qt.DockWidgetArea dockWidgetArea (self, QDockWidget?dockwidget)` * `bool documentMode (self)` * `bool event (self, QEvent?event)` * `QSize iconSize (self)` * `insertToolBar (self, QToolBar?before, QToolBar?toolbar)` * `insertToolBarBreak (self, QToolBar?before)` * `bool isAnimated (self)` * `bool isDockNestingEnabled (self)` * `bool isSeparator (self, QPoint?pos)` * `QMenuBar menuBar (self)` * `QWidget menuWidget (self)` * `removeDockWidget (self, QDockWidget?dockwidget)` * `removeToolBar (self, QToolBar?toolbar)` * `removeToolBarBreak (self, QToolBar?before)` * `bool restoreDockWidget (self, QDockWidget?dockwidget)` * `bool restoreState (self, QByteArray?state, int?version?=?0)` * `QByteArray saveState (self, int?version?=?0)` * `setAnimated (self, bool?enabled)` * `setCentralWidget (self, QWidget?widget)` * `setCorner (self, Qt.Corner?corner, Qt.DockWidgetArea?area)` * `setDockNestingEnabled (self, bool?enabled)` * `setDockOptions (self, DockOptions?options)` * `setDocumentMode (self, bool?enabled)` * `setIconSize (self, QSize?iconSize)` * `setMenuBar (self, QMenuBar?menubar)` * `setMenuWidget (self, QWidget?menubar)` * `setStatusBar (self, QStatusBar?statusbar)` * `setTabPosition (self, Qt.DockWidgetAreas?areas, QTabWidget.TabPosition?tabPosition)` * `setTabShape (self, QTabWidget.TabShape?tabShape)` * `setToolButtonStyle (self, Qt.ToolButtonStyle?toolButtonStyle)` * `setUnifiedTitleAndToolBarOnMac (self, bool?set)` * `splitDockWidget (self, QDockWidget?after, QDockWidget?dockwidget, Qt.Orientation?orientation)` * `QStatusBar statusBar (self)` * `list-of-QDockWidget tabifiedDockWidgets (self, QDockWidget?dockwidget)` * `tabifyDockWidget (self, QDockWidget?first, QDockWidget?second)` * `QTabWidget.TabPosition tabPosition (self, Qt.DockWidgetArea?area)` * `QTabWidget.TabShape tabShape (self)` * `Qt.ToolBarArea toolBarArea (self, QToolBar?toolbar)` * `bool toolBarBreak (self, QToolBar?toolbar)` * `Qt.ToolButtonStyle toolButtonStyle (self)` * `bool unifiedTitleAndToolBarOnMac (self)` ### Qt Signals * `void iconSizeChanged (const QSize&)` * `void toolButtonStyleChanged (Qt::ToolButtonStyle)` * * * ## Detailed Description QMainWindow類提供了一個主應用程序窗口。 ### Qt Main Window Framework 一個主窗口提供了構建應用程序的用戶界面的框架。 Qt擁有的QMainWindow和其[related classes](index.htm)主窗口管理。 QMainWindow中有自己的布局中，您可以添加[QToolBar](qtoolbar.html)秒，[QDockWidget](qdockwidget.html)秒，一個[QMenuBar](qmenubar.html)和[QStatusBar](qstatusbar.html)。布局具有能夠由任何類型的窗口小部件所佔據的中心區域。你可以看到下面的布局的圖像。 ![](https://img.kancloud.cn/51/ae/51ae38c79f85e05d1ab4dde0381daefe_347x314.png) **Note:**創建沒有中央部件的主窗口，不支持。你必須有一個中心窗體，即使它只是一個佔位符。 ### Creating Main Window Components 一個核心部件，通常是一個標準的Qt窗口部件，如[QTextEdit](qtextedit.html)或[QGraphicsView](qgraphicsview.html)。自定義部件也可用于高級應用。您設置的中央小部件`setCentralWidget()`。主窗口有一個單一（ SDI ）或多個（ MDI）的文檔界面。您可以通過使用創建Qt中MDI應用程序[QMdiArea](qmdiarea.html)作為中央部件。現在，我們將檢查每一個可以添加到主窗口中的其他部件。我們就如何創建和添加他們的例子。 #### Creating Menus Qt的實現在菜單[QMenu](qmenu.html)和QMainWindow的讓他們在一個[QMenuBar](qmenubar.html)。[QAction](qaction.html)s的加入到菜單，它們顯示為菜單項。你可以通過調用添加新的菜單到主窗口的菜單欄`menuBar()`，它返回[QMenuBar](qmenubar.html)為窗口，然后添加一個菜單[QMenuBar.addMenu](qmenubar.html#addMenu)（）。 QMainWindow中帶有一個默認的菜單欄，但你也可以設置一個與自己`setMenuBar()`。如果你想實現一個自定義菜單欄（即不使用[QMenuBar](qmenubar.html)小工具），你可以用它設置`setMenuWidget()`。如何創建菜單的示例如下： ``` void MainWindow.createMenus() { fileMenu = menuBar()->addMenu(tr("&File")); fileMenu->addAction(newAct); fileMenu->addAction(openAct); fileMenu->addAction(saveAct); ``` 該`createPopupMenu()`函數創建一個彈出式菜單，當主窗口接收上下文菜單事件。默認的實現產生與從碼頭小部件和工具欄的可復操作的菜單。您可以重新實現`createPopupMenu()`自定義菜單。 #### Creating Toolbars 工具欄的實現[QToolBar](qtoolbar.html)類。你將工具欄添加到主窗口`addToolBar()`。您可以通過將其分配到特定的控制工具欄的初始位置[Qt.ToolBarArea](qt.html#ToolBarArea-enum)。您可以通過插入一個工具欄斷裂分割的區域 - 認為這是在文本編輯換行符 - 與`addToolBarBreak()` or `insertToolBarBreak()`。您還可以通過與用戶的位置限制[QToolBar.setAllowedAreas](qtoolbar.html#allowedAreas-prop)（）和[QToolBar.setMovable](qtoolbar.html#movable-prop)（）。工具欄圖標的大小可以檢索與`iconSize()`。的大小是依賴于平臺的，你可以設置一個固定大小`setIconSize()`。你可以改變所有工具按鈕在工具欄的外觀`setToolButtonStyle()`。工具欄上創建的示例如下： ``` void MainWindow.createToolBars() { fileToolBar = addToolBar(tr("File")); fileToolBar->addAction(newAct); ``` #### Creating Dock Widgets 底座部件都在實施[QDockWidget](qdockwidget.html)類。一個可停靠小部件是一個可以停靠到主窗口的窗口。您添加小部件碼頭到主窗口`addDockWidget()`。有四個底座部件領域給予的[Qt.DockWidgetArea](qt.html#DockWidgetArea-enum)枚舉：左，右，頂部和底部。您可以指定哪些碼頭小工具區域，應該佔據的區域中重疊的角落`setCorner()`。默認情況下每個區域只能包含一行塢窗口小部件（垂直或水平），但如果你啟用拼圖與`setDockNestingEnabled()`，停靠小部件可以在任一方向被添加。兩底座部件也可以堆疊在彼此的頂部上。一[QTabBar](qtabbar.html)然后，用于選擇哪一個應該被顯示的窗口小部件。我們給出了如何創建和添加停靠小部件到主窗口的例子： ``` [QDockWidget](qdockwidget.html) *dockWidget = new [QDockWidget](qdockwidget.html)(tr("Dock Widget"), this); dockWidget->setAllowedAreas([Qt](qt.html).LeftDockWidgetArea | [Qt](qt.html).RightDockWidgetArea); dockWidget->setWidget(dockWidgetContents); addDockWidget([Qt](qt.html).LeftDockWidgetArea, dockWidget); ``` #### The Status Bar 你可以設置一個狀態欄與`setStatusBar()`，但一個是創建的第一次`statusBar()`（返回主窗口的狀態欄）被調用。看[QStatusBar](qstatusbar.html)關于如何使用它的信息。 ### Storing State QMainWindow中可以存儲與布局的狀態`saveState()`它可在以后被檢索以`restoreState()`。它的位置和大小存儲工具欄和停靠窗口小部件（相對于主窗口的大小）。 * * * ## Type Documentation ``` QMainWindow.DockOption ``` 此枚舉包含指定的停靠行為的標志[QMainWindow](qmainwindow.html)。 | Constant | Value | Description | | --- | --- | --- | | `QMainWindow.AnimatedDocks` | `0x01` | 相同的[animated](qmainwindow.html#animated-prop)屬性。 | | `QMainWindow.AllowNestedDocks` | `0x02` | 相同的[dockNestingEnabled](qmainwindow.html#dockNestingEnabled-prop)屬性。 | | `QMainWindow.AllowTabbedDocks` | `0x04` | 用戶可以在“上面”的另一個摔個碼頭部件。這兩個部件堆疊和標籤欄出現選擇哪一個是可見的。 | | `QMainWindow.ForceTabbedDocks` | `0x08` | 每個碼頭區域包含標籤船塢部件的單一堆棧。換句話說，基座部件不能彼此相鄰放置在一個基座區域。如果這個選項被設置， AllowNestedDocks沒有效果。 | | `QMainWindow.VerticalTabs` | `0x10` | 在主窗口的兩側的兩個垂直的碼頭區展示自己的標籤垂直。如果未設置此選項，則所有碼頭區展示自己的標籤在底部。意味著AllowTabbedDocks 。另請參閱[setTabPosition](qmainwindow.html#setTabPosition)（）。 | 這些選項僅控制如何停靠小部件可以在一個被丟棄[QMainWindow](qmainwindow.html)。他們不重新安排了被告席小部件，以符合指定的選項。出于這個原因，他們應該之前設置任何船塢小部件添加到主窗口。例外情況是在AnimatedDocks和VerticalTabs選項，其可以在任何時候設置。這個枚舉被引入或修改的Qt 4.3 。該DockOptions類型是一個typedef為[QFlags](index.htm)\u003cDockOption\u003e 。它存儲DockOption值的或組合。 * * * ## Method Documentation ``` QMainWindow.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QMainWindow](qmainwindow.html)用給定的_parent_和指定的窗口小部件_flags_。 [QMainWindow](qmainwindow.html)設置[Qt.Window](qt.html#WindowType-enum)標志本身，并會因此總是被創建為一個頂級窗口部件。 ``` QMainWindow.addDockWidget (self, Qt.DockWidgetArea?area, QDockWidget?dockwidget) ``` 該_dockwidget_說法有它的所有權轉移給Qt的。將給定_dockwidget_到指定的_area_。 ``` QMainWindow.addDockWidget (self, Qt.DockWidgetArea?area, QDockWidget?dockwidget, Qt.Orientation?orientation) ``` 該_dockwidget_說法有它的所有權轉移給Qt的。添加_dockwidget_在給定的_area_在由指定的方向_orientation_。 ``` QMainWindow.addToolBar (self, Qt.ToolBarArea?area, QToolBar?toolbar) ``` 該_toolbar_說法有它的所有權轉移給Qt的。添加_toolbar_到指定的_area_在這個主窗口。該_toolbar_被放置在當前工具欄塊（即行）的端部。如果主窗口已經管理_toolbar_那么它只是將工具欄移動到_area_。 **See also** [insertToolBar](qmainwindow.html#insertToolBar)（）[addToolBarBreak](qmainwindow.html#addToolBarBreak)（）和[insertToolBarBreak](qmainwindow.html#insertToolBarBreak)（）。 ``` QMainWindow.addToolBar (self, QToolBar?toolbar) ``` 該_toolbar_說法有它的所有權轉移給Qt的。這是一個重載函數。相當于調用addToolBar （中[Qt.TopToolBarArea](qt.html#ToolBarArea-enum)，_toolbar_） ``` QToolBar QMainWindow.addToolBar (self, QString?title) ``` [ 這是一個重載函數。 ](qtoolbar.html) [創建](qtoolbar.html)[QToolBar](qtoolbar.html)對象，其窗口標題設置為_title_，并將其插入到頂部的工具欄區域。 **See also** [setWindowTitle](qwidget.html#windowTitle-prop)（）。 ``` QMainWindow.addToolBarBreak (self, Qt.ToolBarArea?area?=?Qt.TopToolBarArea) ``` 增加了一個工具欄突破給定的_area_所有存在的其它對象之后。 ``` QWidget QMainWindow.centralWidget (self) ``` [ 返回中央部件的主窗口。該函數返回零，如果中央部件尚未確定。 ](qwidget.html) [**See also**](qwidget.html) [setCentralWidget](qmainwindow.html#setCentralWidget)（）。 ``` QMainWindow.contextMenuEvent (self, QContextMenuEvent?event) ``` 從重新實現[QWidget.contextMenuEvent](qwidget.html#contextMenuEvent)（）。 ``` Qt.DockWidgetArea QMainWindow.corner (self, Qt.Corner?corner) ``` [ 返回碼頭小工具區域，佔據指定_corner_。 ](qt.html#DockWidgetArea-enum) [**See also**](qt.html#DockWidgetArea-enum) [setCorner](qmainwindow.html#setCorner)（）。 ``` QMenu QMainWindow.createPopupMenu (self) ``` [ 返回包含存在于主窗口中的工具欄和停靠小部件可選中條目的彈出式菜單。如果沒有工具欄和停靠小部件存在，此函數返回一個空指針。默認情況下，該功能是由所謂的主窗口當用戶激活上下文菜單，通常通過一個工具欄或停靠控件上單擊鼠標右鍵。如果你想創建一個自定義彈出菜單，重新實現這個函數，并返回一個新創建的彈出式菜單。在彈出菜單的所有權被傳遞給調用者。 ](qmenu.html) [**See also**](qmenu.html) [addDockWidget](qmainwindow.html#addDockWidget)（）[addToolBar](qmainwindow.html#addToolBar)（）和[menuBar](qmainwindow.html#menuBar)（）。 ``` DockOptions QMainWindow.dockOptions (self) ``` [](index.htm) ``` Qt.DockWidgetArea QMainWindow.dockWidgetArea (self, QDockWidget?dockwidget) ``` [](qt.html#DockWidgetArea-enum) [返回](qt.html#DockWidgetArea-enum)[Qt.DockWidgetArea](qt.html#DockWidgetArea-enum)為_dockwidget_。如果_dockwidget_還沒有被添加到主窗口，該函數返回`Qt.NoDockWidgetArea`。 **See also** [addDockWidget](qmainwindow.html#addDockWidget)（）[splitDockWidget](qmainwindow.html#splitDockWidget)（）和[Qt.DockWidgetArea](qt.html#DockWidgetArea-enum)。 ``` bool QMainWindow.documentMode (self) ``` ``` bool QMainWindow.event (self, QEvent?event) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QSize QMainWindow.iconSize (self) ``` [ ``` QMainWindow.insertToolBar (self, QToolBar?before, QToolBar?toolbar) ``` 該_toolbar_說法有它的所有權轉移給Qt的。插入_toolbar_到由所佔用的面積_before_工具欄，使其出現之前它。例如，在正常的左到右的布局的操作中，這意味著_toolbar_會出現由指定的工具欄左側_before_在水平工具欄區域。 ](qsize.html) [**See also**](qsize.html) [insertToolBarBreak](qmainwindow.html#insertToolBarBreak)（）[addToolBar](qmainwindow.html#addToolBar)（）和[addToolBarBreak](qmainwindow.html#addToolBarBreak)（）。 ``` QMainWindow.insertToolBarBreak (self, QToolBar?before) ``` 通過插入指定的工具欄前一個工具欄突破_before_。 ``` bool QMainWindow.isAnimated (self) ``` ``` bool QMainWindow.isDockNestingEnabled (self) ``` ``` bool QMainWindow.isSeparator (self, QPoint?pos) ``` ``` QMenuBar QMainWindow.menuBar (self) ``` [ 返回主窗口中的菜單欄。這個函數創建并返回一個空的菜單欄，如果菜單欄不存在。 ](qmenubar.html) [如果你想在一臺Mac應用程序的所有窗口共享一個菜單欄，請不要使用此功能來創建它，因為在這里創建的菜單欄都會有這樣的](qmenubar.html)[QMainWindow](qmainwindow.html)作為其母公司。相反，你必須創建一個沒有父母，然后您可以將所有的Mac窗口之間共享一個菜單欄。創建一個父少菜單欄是這樣的： ``` [QMenuBar](qmenubar.html) *menuBar = new [QMenuBar](qmenubar.html)(0); ``` **See also** [setMenuBar](qmainwindow.html#setMenuBar)（）。 ``` QWidget QMainWindow.menuWidget (self) ``` [ 返回主窗口中的菜單欄。如果菜單欄沒有已建成但這個函數返回null。這個函數中引入了Qt 4.2中。 ](qwidget.html) [**See also**](qwidget.html) [setMenuWidget](qmainwindow.html#setMenuWidget)（）。 ``` QMainWindow.removeDockWidget (self, QDockWidget?dockwidget) ``` 該_dockwidget_爭論移除_dockwidget_從主窗口的布局和隱藏它。注意，這個_dockwidget_ is _not_刪除。 ``` QMainWindow.removeToolBar (self, QToolBar?toolbar) ``` 移除_toolbar_從主窗口的布局和隱藏它。注意，這個_toolbar_ is _not_刪除。 ``` QMainWindow.removeToolBarBreak (self, QToolBar?before) ``` 通過刪除指定的工具欄之前，先前插入一個工具欄突破_before_。 ``` bool QMainWindow.restoreDockWidget (self, QDockWidget?dockwidget) ``` 恢復的狀態_dockwidget_如果它被調用之后創建[restoreState](qmainwindow.html#restoreState)（）。返回True如果狀態得到恢復，否則返回False 。 **See also** [restoreState](qmainwindow.html#restoreState)（）和[saveState](qmainwindow.html#saveState)（）。 ``` bool QMainWindow.restoreState (self, QByteArray?state, int?version?=?0) ``` 恢復_state_這個主窗口的工具欄和dockwidgets 。該_version_號與存儲在比較_state_。如果它們不匹配，則主窗口的狀態保持不變，并且該函數返回`false`否則，該狀態被恢復，并且該函數返回`true`。要使用恢復保存幾何[QSettings](qsettings.html)，你可以使用如下代碼： ``` void MainWindow.readSettings() { [QSettings](qsettings.html) settings("MyCompany", "MyApp"); restoreGeometry(settings.value("myWidget/geometry").toByteArray()); restoreState(settings.value("myWidget/windowState").toByteArray()); } ``` **See also** [saveState](qmainwindow.html#saveState)（）[QWidget.saveGeometry](qwidget.html#saveGeometry)（）[QWidget.restoreGeometry](qwidget.html#restoreGeometry)（）和[restoreDockWidget](qmainwindow.html#restoreDockWidget)（）。 ``` QByteArray QMainWindow.saveState (self, int?version?=?0) ``` [ 保存這個主窗口的工具欄和dockwidgets的當前狀態。該_version_號碼被存儲作為數據的一部分。 ](qbytearray.html) [該](qbytearray.html)[objectName](qobject.html#objectName-prop)屬性是用于識別每個[QToolBar](qtoolbar.html)和[QDockWidget](qdockwidget.html)。您應該確保這個屬性是唯一的每個[QToolBar](qtoolbar.html)和[QDockWidget](qdockwidget.html)您添加到[QMainWindow](qmainwindow.html) 要恢復保存的狀態，通過返回值和_version_數[restoreState](qmainwindow.html#restoreState)（）。要保存窗口關閉時的幾何形狀，可以實現這樣一個close事件： ``` void MyMainWindow.closeEvent([QCloseEvent](qcloseevent.html) *event) { [QSettings](qsettings.html) settings("MyCompany", "MyApp"); settings.setValue("geometry", saveGeometry()); settings.setValue("windowState", saveState()); [QMainWindow](qmainwindow.html).closeEvent(event); } ``` **See also** [restoreState](qmainwindow.html#restoreState)（）[QWidget.saveGeometry](qwidget.html#saveGeometry)（）和[QWidget.restoreGeometry](qwidget.html#restoreGeometry)（）。 ``` QMainWindow.setAnimated (self, bool?enabled) ``` 這種方法也是一個Qt槽與C + +的簽名`void setAnimated(bool)`。 ``` QMainWindow.setCentralWidget (self, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。設置給定_widget_要在主窗口的中央窗口部件。注意：[QMainWindow](qmainwindow.html)采取所有權_widget_指針并刪除它在適當的時候。 **See also** [centralWidget](qmainwindow.html#centralWidget)（）。 ``` QMainWindow.setCorner (self, Qt.Corner?corner, Qt.DockWidgetArea?area) ``` 設置給定塢窗口小部件_area_佔據了指定_corner_。 **See also** [corner](qmainwindow.html#corner)（）。 ``` QMainWindow.setDockNestingEnabled (self, bool?enabled) ``` 這種方法也是一個Qt槽與C + +的簽名`void setDockNestingEnabled(bool)`。 ``` QMainWindow.setDockOptions (self, DockOptions?options) ``` ``` QMainWindow.setDocumentMode (self, bool?enabled) ``` ``` QMainWindow.setIconSize (self, QSize?iconSize) ``` ``` QMainWindow.setMenuBar (self, QMenuBar?menubar) ``` 該_menubar_說法有它的所有權轉移給Qt的。設置主窗口菜單欄_menuBar_。注意：[QMainWindow](qmainwindow.html)采取所有權_menuBar_指針并刪除它在適當的時候。 **See also** [menuBar](qmainwindow.html#menuBar)（）。 ``` QMainWindow.setMenuWidget (self, QWidget?menubar) ``` 該_menubar_說法有它的所有權轉移給Qt的。設置主窗口菜單欄_menuBar_。 [QMainWindow](qmainwindow.html)采取所有權_menuBar_指針并刪除它在適當的時候。這個函數中引入了Qt 4.2中。 **See also** [menuWidget](qmainwindow.html#menuWidget)（）。 ``` QMainWindow.setStatusBar (self, QStatusBar?statusbar) ``` 該_statusbar_說法有它的所有權轉移給Qt的。設置主窗口的狀態欄_statusbar_。狀態欄設置為0將在主窗口中刪除它。需要注意的是[QMainWindow](qmainwindow.html)采取所有權_statusbar_指針并刪除它在適當的時候。 **See also** [statusBar](qmainwindow.html#statusBar)（）。 ``` QMainWindow.setTabPosition (self, Qt.DockWidgetAreas?areas, QTabWidget.TabPosition?tabPosition) ``` 設置為給定的碼頭插件的選項卡位置_areas_到指定的_tabPosition_。默認情況下，所有的停靠區域顯示在底部的標籤。 **Note:**該[VerticalTabs](qmainwindow.html#DockOption-enum)碼頭選項將復蓋此方法設置的制表位位置。此功能被引入Qt的4.5 。 **See also** [tabPosition](qmainwindow.html#tabPosition)（）和[setTabShape](qmainwindow.html#tabShape-prop)（）。 ``` QMainWindow.setTabShape (self, QTabWidget.TabShape?tabShape) ``` ``` QMainWindow.setToolButtonStyle (self, Qt.ToolButtonStyle?toolButtonStyle) ``` ``` QMainWindow.setUnifiedTitleAndToolBarOnMac (self, bool?set) ``` ``` QMainWindow.splitDockWidget (self, QDockWidget?after, QDockWidget?dockwidget, Qt.Orientation?orientation) ``` 該_dockwidget_說法有它的所有權轉移給Qt的。分割復蓋的空間_first_停靠小部件分為兩個部分，移動_first_對接構件到第一部分中，并且使_second_停靠小部件進入第二部分。該_orientation_指定如何將空間劃分：一個[Qt.Horizontal](qt.html#Orientation-enum)拆分將第二碼頭Widget在第一個的右邊，一個[Qt.Vertical](qt.html#Orientation-enum)分割放置下面的第一個，第二碼頭部件。 _Note_：如果_first_目前在一個標籤式的停靠區域，_second_將作為一個新的標籤，而不是作為一個鄰居_first_。這是因為一個標籤只能包含一個基座部件。 _Note_：該[Qt.LayoutDirection](qt.html#LayoutDirection-enum)影響中的劃分區域的兩個部分的基座部件的順序。當從右到左的布局方向被啟用，碼頭部件的擺放將得到扭轉。 **See also** [tabifyDockWidget](qmainwindow.html#tabifyDockWidget)（）[addDockWidget](qmainwindow.html#addDockWidget)（）和[removeDockWidget](qmainwindow.html#removeDockWidget)（）。 ``` QStatusBar QMainWindow.statusBar (self) ``` [ 返回主窗口的狀態欄中。這個函數創建并返回一個空的狀態欄，如果狀態欄不存在。 ](qstatusbar.html) [**See also**](qstatusbar.html) [setStatusBar](qmainwindow.html#setStatusBar)（）。 ``` list-of-QDockWidget QMainWindow.tabifiedDockWidgets (self, QDockWidget?dockwidget) ``` 返回與tabified在一起了被告席小部件_dockwidget_。此功能被引入Qt的4.5 。 **See also** [tabifyDockWidget](qmainwindow.html#tabifyDockWidget)（）。 ``` QMainWindow.tabifyDockWidget (self, QDockWidget?first, QDockWidget?second) ``` Moves _second_之上碼頭部件_first_停靠窗口小部件，創建主窗口的選項卡式停靠區域。 **See also** [tabifiedDockWidgets](qmainwindow.html#tabifiedDockWidgets)（）。 ``` QTabWidget.TabPosition QMainWindow.tabPosition (self, Qt.DockWidgetArea?area) ``` [ 把標籤位置_area_。 ](qtabwidget.html#TabPosition-enum) [**Note:**該](qtabwidget.html#TabPosition-enum)[VerticalTabs](qmainwindow.html#DockOption-enum)碼頭選項復蓋由該函數返回的標籤位置。此功能被引入Qt的4.5 。 **See also** [setTabPosition](qmainwindow.html#setTabPosition)（）和[tabShape](qmainwindow.html#tabShape-prop)（）。 ``` QTabWidget.TabShape QMainWindow.tabShape (self) ``` [](qtabwidget.html#TabShape-enum) ``` Qt.ToolBarArea QMainWindow.toolBarArea (self, QToolBar?toolbar) ``` [](qt.html#ToolBarArea-enum) [返回](qt.html#ToolBarArea-enum)[Qt.ToolBarArea](qt.html#ToolBarArea-enum)為_toolbar_。如果_toolbar_還沒有被添加到主窗口，該函數返回`Qt.NoToolBarArea`。 **See also** [addToolBar](qmainwindow.html#addToolBar)（）[addToolBarBreak](qmainwindow.html#addToolBarBreak)（）和[Qt.ToolBarArea](qt.html#ToolBarArea-enum)。 ``` bool QMainWindow.toolBarBreak (self, QToolBar?toolbar) ``` 返回是否有前一個工具欄突破_toolbar_。 **See also** [addToolBarBreak](qmainwindow.html#addToolBarBreak)（）和[insertToolBarBreak](qmainwindow.html#insertToolBarBreak)（）。 ``` Qt.ToolButtonStyle QMainWindow.toolButtonStyle (self) ``` [ ``` bool QMainWindow.unifiedTitleAndToolBarOnMac (self) ``` * * * ## Qt Signal Documentation ``` void iconSizeChanged (const QSize&) ``` 這是該信號的默認超載。當在窗口中使用的圖標的大小改變時，這個信號被發射。新的圖標大小是通過在_iconSize_。您可以將此信號連接到其他組件，以幫助保持一致的外觀為您的應用程序。 ](qt.html#ToolButtonStyle-enum) [**See also**](qt.html#ToolButtonStyle-enum) [setIconSize](qmainwindow.html#iconSize-prop)（）。 ``` void toolButtonStyleChanged (Qt::ToolButtonStyle) ``` 這是該信號的默認超載。當用于在窗口中的工具按鈕的樣式改變時，這個信號被發射。新樣式傳入_toolButtonStyle_。您可以將此信號連接到其他組件，以幫助保持一致的外觀為您的應用程序。 **See also** [setToolButtonStyle](qmainwindow.html#toolButtonStyle-prop)（）。