# QTabWidget Class Reference ## [[QtGui](index.htm) module] 該QTabWidget類提供了一個堆棧標籤小部件。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum TabPosition { North, South, West, East }` * `enum TabShape { Rounded, Triangular }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int addTab (self, QWidget?widget, QString)` * `int addTab (self, QWidget?widget, QIcon?icon, QString?label)` * `changeEvent (self, QEvent)` * `clear (self)` * `QWidget cornerWidget (self, Qt.Corner?corner?=?Qt.TopRightCorner)` * `int count (self)` * `int currentIndex (self)` * `QWidget currentWidget (self)` * `bool documentMode (self)` * `Qt.TextElideMode elideMode (self)` * `bool event (self, QEvent)` * `int heightForWidth (self, int?width)` * `QSize iconSize (self)` * `int indexOf (self, QWidget?widget)` * `initStyleOption (self, QStyleOptionTabWidgetFrame?option)` * `int insertTab (self, int?index, QWidget?widget, QString)` * `int insertTab (self, int?index, QWidget?widget, QIcon?icon, QString?label)` * `bool isMovable (self)` * `bool isTabEnabled (self, int?index)` * `keyPressEvent (self, QKeyEvent)` * `QSize minimumSizeHint (self)` * `paintEvent (self, QPaintEvent)` * `removeTab (self, int?index)` * `resizeEvent (self, QResizeEvent)` * `setCornerWidget (self, QWidget?widget, Qt.Corner?corner?=?Qt.TopRightCorner)` * `setCurrentIndex (self, int?index)` * `setCurrentWidget (self, QWidget?widget)` * `setDocumentMode (self, bool?set)` * `setElideMode (self, Qt.TextElideMode)` * `setIconSize (self, QSize?size)` * `setMovable (self, bool?movable)` * `setTabBar (self, QTabBar)` * `setTabEnabled (self, int?index, bool)` * `setTabIcon (self, int?index, QIcon?icon)` * `setTabPosition (self, TabPosition)` * `setTabsClosable (self, bool?closeable)` * `setTabShape (self, TabShape?s)` * `setTabText (self, int?index, QString)` * `setTabToolTip (self, int?index, QString?tip)` * `setTabWhatsThis (self, int?index, QString?text)` * `setUsesScrollButtons (self, bool?useButtons)` * `showEvent (self, QShowEvent)` * `QSize sizeHint (self)` * `QTabBar tabBar (self)` * `QIcon tabIcon (self, int?index)` * `tabInserted (self, int?index)` * `TabPosition tabPosition (self)` * `tabRemoved (self, int?index)` * `bool tabsClosable (self)` * `TabShape tabShape (self)` * `QString tabText (self, int?index)` * `QString tabToolTip (self, int?index)` * `QString tabWhatsThis (self, int?index)` * `bool usesScrollButtons (self)` * `QWidget widget (self, int?index)` ### Special Methods * `__len__ (self)` ### Qt Signals * `void currentChanged (int)` * `void tabCloseRequested (int)` * * * ## Detailed Description 該QTabWidget類提供了一個堆棧標籤小部件。 一個標籤控件提供了一個標籤欄（見[QTabBar](qtabbar.html)）和用于顯示與每個標籤頁的“頁內” 。默認情況下，標籤欄上面顯示的頁面區域，但不同的配置可供選擇（參見[TabPosition](qtabwidget.html#TabPosition-enum)） 。每個選項卡都與一個不同的窗口小部件（稱為頁）相關聯。只有在當前頁面中顯示的頁面區域，所有的其他頁面是隱藏的。用戶可以通過單擊其選項卡或按下其ALT +顯示不同的頁面_letter_快捷方式（如果有） 。 正常的方式來使用QTabWidget是要做到以下幾點： 1. 創建QTabWidget 。 2. 創建[QWidget](qwidget.html)每個在選項卡對話框的頁面，但不指定父窗口部件他們。 3. 將子控件到頁面窗口小部件，使用布局將它們定位為正常。 4. Call [addTab](qtabwidget.html#addTab)（）或[insertTab](qtabwidget.html#insertTab)（ ）把頁面控件到標籤控件，給每個標籤有一個可選的鍵盤快捷鍵一個合適的標籤。 翼片的位置被定義為[tabPosition](qtabwidget.html#tabPosition-prop)，它們的形狀由[tabShape](qtabwidget.html#tabShape-prop)。 信號[currentChanged](qtabwidget.html#currentChanged)（）當用戶選擇一個頁面被發射。 當前頁面的索引可作為[currentIndex](qtabwidget.html#currentIndex-prop)（ ） ，當前頁面與小部件[currentWidget](qtabwidget.html#currentWidget)（ ） 。可以使用檢索指針的頁插件與給定的索引[widget](qtabwidget.html#widget)（） ，并且可以找到一個插件的索引位置與[indexOf](qtabwidget.html#indexOf)（ ） 。使用[setCurrentWidget](qtabwidget.html#setCurrentWidget)（）或[setCurrentIndex](qtabwidget.html#currentIndex-prop)（）來顯示一個特定的頁面。 您可以使用更改標籤的文字和圖標[setTabText](qtabwidget.html#setTabText)（）或[setTabIcon](qtabwidget.html#setTabIcon)（ ） 。一個標籤和它相關聯的頁面可以被刪除[removeTab](qtabwidget.html#removeTab)（ ） 。 每個選項卡是啟用或在任何特定時間禁止它們（見[setTabEnabled](qtabwidget.html#setTabEnabled)（））。如果標籤被激活，標籤文本通常繪制，用戶可以選擇該選項卡。如果它被禁用，該選項卡繪制以不同的方式，用戶可以不選擇該選項卡。請注意，即使一個選項卡被禁用，頁面仍然可以看到，例如，如果所有選項卡碰巧被禁用。 標籤部件可以是一個很好的方式來分割一個復雜的對話框。一個替代方案是使用一個[QStackedWidget](qstackedwidget.html)要為其提供頁之間導航的一些裝置，例如，一個[QToolBar](qtoolbar.html)或[QListWidget](qlistwidget.html)。 大部分在QTabWidget的功能是由一個提供[QTabBar](qtabbar.html)（在頂部，提供了制表符）和一個[QStackedWidget](qstackedwidget.html)（大部分面積，組織各頁） 。 |  |  |  | | A Windows XP style tab widget. | A Macintosh style tab widget. | A Plastique style tab widget. | * * * ## Type Documentation ``` QTabWidget.TabPosition ``` 該枚舉類型定義了[QTabWidget](qtabwidget.html)繪制選項卡行： | Constant | Value | Description | | --- | --- | --- | | `QTabWidget.North` | `0` | 該選項卡上的頁面繪制。 | | `QTabWidget.South` | `1` | 該標籤繪制下面的頁面。 | | `QTabWidget.West` | `2` | 翼片被吸引到頁面的左邊。 | | `QTabWidget.East` | `3` | 翼片被吸引到頁的右側。 | ``` QTabWidget.TabShape ``` 這個枚舉類型定義了標籤的形狀： | Constant | Value | Description | | --- | --- | --- | | `QTabWidget.Rounded` | `0` | 該選項卡繪制一個圓角的外觀。這是默認的形狀。 | | `QTabWidget.Triangular` | `1` | 的制表符繪制一個三角的外觀。 | * * * ## Method Documentation ``` QTabWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個標籤控件與父_parent_。 ``` int QTabWidget.addTab (self, QWidget?widget, QString) ``` 該_widget_說法有它的所有權轉移給Qt的。 增加了一個選項卡與給定_page_和_label_在選項卡控件，并返回在標籤欄上的選項卡的索引。 如果選項卡的_label_包含一個符號，繼符號的字母是用來作為標籤的快捷方式，例如：如果標籤是“弟兄與WSE ”然后按Alt + W成為這將焦點移動到該選項卡的快捷方式。 **Note:**如果調用addTab （ ）后[show](qwidget.html#show)（ ） ，布局系統將嘗試調整的變化，其部件的層次結構，并可能導致閃爍。為了避免這種情況，可以設置[QWidget.updatesEnabled](qwidget.html#updatesEnabled-prop)屬性為False更改之前，記得將屬性設置為True ，當更改完成，使得小部件再次收到paint事件。 **See also** [insertTab](qtabwidget.html#insertTab)（ ） 。 ``` int QTabWidget.addTab (self, QWidget?widget, QIcon?icon, QString?label) ``` 該_widget_說法有它的所有權轉移給Qt的。 這是一個重載函數。 增加了一個選項卡與給定_page_，_icon_和_label_在選項卡控件，并返回在標籤欄上的選項卡的索引。 這個功能是相同的[addTab](qtabwidget.html#addTab)（），但帶有附加_icon_。 ``` QTabWidget.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` QTabWidget.clear (self) ``` 刪除所有的頁面，但不刪除它們。調用此函數相當于調用[removeTab](qtabwidget.html#removeTab)（ ），直到選項卡控件是空的。 ``` QWidget QTabWidget.cornerWidget (self, Qt.Corner?corner?=?Qt.TopRightCorner) ``` [ 返回圖中所示的部件_corner_的選項卡控件或0 。 ](qwidget.html) [**See also**](qwidget.html) [setCornerWidget](qtabwidget.html#setCornerWidget)（ ） 。 ``` int QTabWidget.count (self) ``` ``` int QTabWidget.currentIndex (self) ``` ``` QWidget QTabWidget.currentWidget (self) ``` [ 返回一個指針，當前正顯示的標籤對話框的網頁。該選項卡對話框會盡力確保這個值是永遠不為0 （但如果你足夠努力，也可以是） 。 ](qwidget.html) [**See also**](qwidget.html) [currentIndex](qtabwidget.html#currentIndex-prop)（）和[setCurrentWidget](qtabwidget.html#setCurrentWidget)（ ） 。 ``` bool QTabWidget.documentMode (self) ``` ``` Qt.TextElideMode QTabWidget.elideMode (self) ``` [ ``` bool QTabWidget.event (self, QEvent) ``` ](qt.html#TextElideMode-enum) [從重新實現](qt.html#TextElideMode-enum)[QObject.event](qobject.html#event)（ ） 。 ``` int QTabWidget.heightForWidth (self, int?width) ``` 從重新實現[QWidget.heightForWidth](qwidget.html#heightForWidth)（ ） 。 此功能被引入Qt的4.8 。 ``` QSize QTabWidget.iconSize (self) ``` [ ``` int QTabWidget.indexOf (self, QWidget?widget) ``` 返回該頁面的索引位置的小窗口佔用_w_，或-1，如果小部件不能被發現。 ``` QTabWidget.initStyleOption (self, QStyleOptionTabWidgetFrame?option) ``` ](qsize.html) [初始化_option_與其它的值](qsize.html)[QTabWidget](qtabwidget.html)。當他們需要一個這種方法是有用的子類[QStyleOptionTabWidgetFrame](qstyleoptiontabwidgetframe.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（）和[QTabBar.initStyleOption](qtabbar.html#initStyleOption)（ ） 。 ``` int QTabWidget.insertTab (self, int?index, QWidget?widget, QString) ``` 該_widget_說法有它的所有權轉移給Qt的。 插入制表符與給定_label_和_page_成的標籤窗口小部件在指定的_index_，并返回在標籤欄的插入選項卡的索引。 的標籤被顯示在選項卡中，并且可以在外觀上發生變化取決于標籤插件的配置。 如果選項卡的_label_包含一個符號，繼符號的字母是用來作為標籤的快捷方式，例如：如果標籤是“弟兄與WSE ”然后按Alt + W成為這將焦點移動到該選項卡的快捷方式。 If _index_超出范圍時，標籤只是簡單地追加。否則，它會插入到指定位置。 如果[QTabWidget](qtabwidget.html)為空，此函數被調用之前，新的頁面成為當前頁面。插入一個新的選項卡的索引小于或等于當前的索引處將增加目前的指數，但保留當前頁面。 **Note:**如果調用insertTab （ ）后[show](qwidget.html#show)（ ） ，布局系統將嘗試調整的變化，其部件的層次結構，并可能導致閃爍。為了避免這種情況，可以設置[QWidget.updatesEnabled](qwidget.html#updatesEnabled-prop)屬性為False更改之前，記得將屬性設置為True ，當更改完成，使得小部件再次收到paint事件。 **See also** [addTab](qtabwidget.html#addTab)（ ） 。 ``` int QTabWidget.insertTab (self, int?index, QWidget?widget, QIcon?icon, QString?label) ``` 該_widget_說法有它的所有權轉移給Qt的。 ``` bool QTabWidget.isMovable (self) ``` ``` bool QTabWidget.isTabEnabled (self, int?index) ``` 返回True如果在位置頁面_index_被啟用，否則返回False 。 **See also** [setTabEnabled](qtabwidget.html#setTabEnabled)（）和[QWidget.isEnabled](qwidget.html#enabled-prop)（ ） 。 ``` QTabWidget.keyPressEvent (self, QKeyEvent) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（ ） 。 ``` QSize QTabWidget.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 返回一個合適的最小尺寸為選項卡控件。 ``` QTabWidget.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 描繪了標籤控件的標籤欄響應漆_event_。 ``` QTabWidget.removeTab (self, int?index) ``` 移除選項卡的位置_index_從這個堆棧窗口小部件。在網頁插件本身不會被刪除。 **See also** [addTab](qtabwidget.html#addTab)（）和[insertTab](qtabwidget.html#insertTab)（ ） 。 ``` QTabWidget.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QTabWidget.setCornerWidget (self, QWidget?widget, Qt.Corner?corner?=?Qt.TopRightCorner) ``` 該_widget_說法有它的所有權轉移給Qt的。 設置給定_widget_在指定要顯示_corner_的選項卡控件。小部件的幾何形狀是基于Widget的決定[sizeHint](qtabwidget.html#sizeHint)（ ）和[style](qwidget.html#style)（ ） 。 唯一的水平元素_corner_將被使用。 路過0顯示沒有插件的角落里。 任何以前設置的角落widget被隱藏。 這里設置的所有部件將由選項卡控件時，它被摧毀，除非你單獨reparent小部件設置一些其他角落部件（或0 ）后刪除。 注：角部件是專為[North](qtabwidget.html#TabPosition-enum)和[South](qtabwidget.html#TabPosition-enum)標籤的位置，其他方位已知無法正常工作。 **See also** [cornerWidget](qtabwidget.html#cornerWidget)（）和[setTabPosition](qtabwidget.html#tabPosition-prop)（ ） 。 ``` QTabWidget.setCurrentIndex (self, int?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentIndex(int)`。 ``` QTabWidget.setCurrentWidget (self, QWidget?widget) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentWidget(QWidget *)`。 品牌_widget_當前的窗口小部件。該_widget_使用的必須是一個頁面在此選項卡控件。 **See also** [addTab](qtabwidget.html#addTab)（ ）[setCurrentIndex](qtabwidget.html#currentIndex-prop)（）和[currentWidget](qtabwidget.html#currentWidget)（ ） 。 ``` QTabWidget.setDocumentMode (self, bool?set) ``` ``` QTabWidget.setElideMode (self, Qt.TextElideMode) ``` ``` QTabWidget.setIconSize (self, QSize?size) ``` ``` QTabWidget.setMovable (self, bool?movable) ``` ``` QTabWidget.setTabBar (self, QTabBar) ``` 該_QTabBar_說法有它的所有權轉移給Qt的。 替換對話框的[QTabBar](qtabbar.html)與標籤欄標題_tb_。請注意，這必須調用_before_任何標籤已被添加，或行為是未定義的。 **See also** [tabBar](qtabwidget.html#tabBar)（ ） 。 ``` QTabWidget.setTabEnabled (self, int?index, bool) ``` If _enable_誠然，在位置頁面_index_被啟用，否則在位置頁面_index_被禁用。頁面的選項卡進行適當重繪。 [QTabWidget](qtabwidget.html) uses [QWidget.setEnabled](qwidget.html#enabled-prop)（ ）內部，而不是保持一個獨立的標志。 請注意，即使已禁用選項卡/頁可能是可見的。如果頁面已經可見，[QTabWidget](qtabwidget.html)不會隱藏它，如果所有頁面都禁用，[QTabWidget](qtabwidget.html)將顯示其中之一。 **See also** [isTabEnabled](qtabwidget.html#isTabEnabled)（）和[QWidget.setEnabled](qwidget.html#enabled-prop)（ ） 。 ``` QTabWidget.setTabIcon (self, int?index, QIcon?icon) ``` 這是一個重載函數。 設置_icon_對于位置的選項卡_index_。 **See also** [tabIcon](qtabwidget.html#tabIcon)（ ） 。 ``` QTabWidget.setTabPosition (self, TabPosition) ``` ``` QTabWidget.setTabsClosable (self, bool?closeable) ``` ``` QTabWidget.setTabShape (self, TabShape?s) ``` ``` QTabWidget.setTabText (self, int?index, QString) ``` 定義了一個新_label_對于位置的頁面_index_的標籤。 如果提供的文字包含符號字符（ '＆' ） ，一個快捷方式自動為其創建。后面的“＆”將被用來作為快捷鍵的字符。任何先前的快捷方式將被復蓋，或者如果沒有快捷方式是通過文本中的定義清除。請參閱[QShortcut](qshortcut.html#mnemonic)有關詳細信息的文檔（顯示的實際符號，使用“\u0026\u0026” ） 。 **See also** [tabText](qtabwidget.html#tabText)（ ） 。 ``` QTabWidget.setTabToolTip (self, int?index, QString?tip) ``` 設置選項卡工具提示位置的頁面_index_至_tip_。 **See also** [tabToolTip](qtabwidget.html#tabToolTip)（ ） 。 ``` QTabWidget.setTabWhatsThis (self, int?index, QString?text) ``` 設置這是什么幫助文本位置的頁面_index_至_text_。 這個函數是Qt 4.1中引入。 **See also** [tabWhatsThis](qtabwidget.html#tabWhatsThis)（ ） 。 ``` QTabWidget.setUsesScrollButtons (self, bool?useButtons) ``` ``` QTabWidget.showEvent (self, QShowEvent) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（ ） 。 ``` QSize QTabWidget.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QTabBar QTabWidget.tabBar (self) ``` [](qtabbar.html) [返回當前](qtabbar.html)[QTabBar](qtabbar.html)。 **See also** [setTabBar](qtabwidget.html#setTabBar)（ ） 。 ``` QIcon QTabWidget.tabIcon (self, int?index) ``` [ 返回圖標位置的頁面上的標籤_index_。 ](qicon.html) [**See also**](qicon.html) [setTabIcon](qtabwidget.html#setTabIcon)（ ） 。 ``` QTabWidget.tabInserted (self, int?index) ``` 后一個新的選項卡中添加或插入的位置這個虛擬處理器被調用_index_。 **See also** [tabRemoved](qtabwidget.html#tabRemoved)（ ） 。 ``` TabPosition QTabWidget.tabPosition (self) ``` [ ``` QTabWidget.tabRemoved (self, int?index) ``` 一個選項卡是從位置移除后，此虛擬處理器被調用_index_。 ](qtabwidget.html#TabPosition-enum) [**See also**](qtabwidget.html#TabPosition-enum) [tabInserted](qtabwidget.html#tabInserted)（ ） 。 ``` bool QTabWidget.tabsClosable (self) ``` ``` TabShape QTabWidget.tabShape (self) ``` [ ``` QString QTabWidget.tabText (self, int?index) ``` 返回的標籤文本在位置頁面上的選項卡_index_。 ](qtabwidget.html#TabShape-enum) [**See also**](qtabwidget.html#TabShape-enum) [setTabText](qtabwidget.html#setTabText)（ ） 。 ``` QString QTabWidget.tabToolTip (self, int?index) ``` 返回標籤工具提示位置的頁面_index_或空字符串，如果沒有刀尖已定。 **See also** [setTabToolTip](qtabwidget.html#setTabToolTip)（ ） 。 ``` QString QTabWidget.tabWhatsThis (self, int?index) ``` 返回這是什么幫助文本位置的頁面_index_，或一個空字符串，如果沒有幫助文本已定。 這個函數是Qt 4.1中引入。 **See also** [setTabWhatsThis](qtabwidget.html#setTabWhatsThis)（ ） 。 ``` bool QTabWidget.usesScrollButtons (self) ``` ``` QWidget QTabWidget.widget (self, int?index) ``` [ 返回標籤頁的索引位置_index_或者0，如果_index_超出范圍。 ``` QTabWidget.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void currentChanged (int) ``` 這是該信號的默認超載。 ](qwidget.html) [這個信號被發射時在當前頁面的索引變化。該參數是當前新頁面_index_位置，或-1 ，如果沒有一個新的（例如，如果沒有部件在](qwidget.html)[QTabWidget](qtabwidget.html)） **See also** [currentWidget](qtabwidget.html#currentWidget)（）和[currentIndex](qtabwidget.html#currentIndex-prop)。 ``` void tabCloseRequested (int) ``` 這是該信號的默認超載。 點擊一個選項卡上的關閉按鈕時，這個信號被發射。該_index_是應該被刪除的索引。 此功能被引入Qt的4.5 。 **See also** [setTabsClosable](qtabwidget.html#tabsClosable-prop)（ ） 。