# QTabBar Class Reference ## [[QtGui](index.htm) module] 該QTabBar類提供了一個標籤欄，例如在標籤對話框中使用。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum ButtonPosition { LeftSide, RightSide }` * `enum SelectionBehavior { SelectLeftTab, SelectRightTab, SelectPreviousTab }` * `enum Shape { RoundedNorth, RoundedSouth, RoundedWest, RoundedEast, ..., TriangularEast }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `int addTab (self, QString?text)` * `int addTab (self, QIcon?icon, QString?text)` * `changeEvent (self, QEvent)` * `int count (self)` * `int currentIndex (self)` * `bool documentMode (self)` * `bool drawBase (self)` * `Qt.TextElideMode elideMode (self)` * `bool event (self, QEvent)` * `bool expanding (self)` * `hideEvent (self, QHideEvent)` * `QSize iconSize (self)` * `initStyleOption (self, QStyleOptionTab?option, int?tabIndex)` * `int insertTab (self, int?index, QString?text)` * `int insertTab (self, int?index, QIcon?icon, QString?text)` * `bool isMovable (self)` * `bool isTabEnabled (self, int?index)` * `keyPressEvent (self, QKeyEvent)` * `QSize minimumSizeHint (self)` * `mouseMoveEvent (self, QMouseEvent)` * `mousePressEvent (self, QMouseEvent)` * `mouseReleaseEvent (self, QMouseEvent)` * `moveTab (self, int?from, int?to)` * `paintEvent (self, QPaintEvent)` * `removeTab (self, int?index)` * `resizeEvent (self, QResizeEvent)` * `SelectionBehavior selectionBehaviorOnRemove (self)` * `setCurrentIndex (self, int?index)` * `setDocumentMode (self, bool?set)` * `setDrawBase (self, bool?drawTheBase)` * `setElideMode (self, Qt.TextElideMode)` * `setExpanding (self, bool?enabled)` * `setIconSize (self, QSize?size)` * `setMovable (self, bool?movable)` * `setSelectionBehaviorOnRemove (self, SelectionBehavior?behavior)` * `setShape (self, Shape?shape)` * `setTabButton (self, int?index, ButtonPosition?position, QWidget?widget)` * `setTabData (self, int?index, QVariant?data)` * `setTabEnabled (self, int?index, bool)` * `setTabIcon (self, int?index, QIcon?icon)` * `setTabsClosable (self, bool?closable)` * `setTabText (self, int?index, QString?text)` * `setTabTextColor (self, int?index, QColor?color)` * `setTabToolTip (self, int?index, QString?tip)` * `setTabWhatsThis (self, int?index, QString?text)` * `setUsesScrollButtons (self, bool?useButtons)` * `Shape shape (self)` * `showEvent (self, QShowEvent)` * `QSize sizeHint (self)` * `int tabAt (self, QPoint?pos)` * `QWidget tabButton (self, int?index, ButtonPosition?position)` * `QVariant tabData (self, int?index)` * `QIcon tabIcon (self, int?index)` * `tabInserted (self, int?index)` * `tabLayoutChange (self)` * `QRect tabRect (self, int?index)` * `tabRemoved (self, int?index)` * `bool tabsClosable (self)` * `QSize tabSizeHint (self, int?index)` * `QString tabText (self, int?index)` * `QColor tabTextColor (self, int?index)` * `QString tabToolTip (self, int?index)` * `QString tabWhatsThis (self, int?index)` * `bool usesScrollButtons (self)` * `wheelEvent (self, QWheelEvent?event)` ### Special Methods * `__len__ (self)` ### Qt Signals * `void currentChanged (int)` * `void tabCloseRequested (int)` * `void tabMoved (int,int)` * * * ## Detailed Description 該QTabBar類提供了一個標籤欄，例如在標籤對話框中使用。 QTabBar直接就能使用，它使用預定義的一個繪制標籤[shapes](qtabbar.html#Shape-enum)，并發射時，所選擇的標籤的信號。它可以被子類化定制的外觀和感覺。 Qt還提供了一個現成的[QTabWidget](qtabwidget.html)。 每個標籤都有一個[tabText](qtabbar.html#tabText)（） ，可選[tabIcon](qtabbar.html#tabIcon)（） ，可選[tabToolTip](qtabbar.html#tabToolTip)（ ），可選[tabWhatsThis](qtabbar.html#tabWhatsThis)（）和可選[tabData](qtabbar.html#tabData)（ ） 。的標籤的屬性可以被改變[setTabText](qtabbar.html#setTabText)（ ）[setTabIcon](qtabbar.html#setTabIcon)（ ）[setTabToolTip](qtabbar.html#setTabToolTip)（ ） ， setTabWhatsThis和[setTabData](qtabbar.html#setTabData)（ ） 。每個選項卡可以啟用或禁用單獨[setTabEnabled](qtabbar.html#setTabEnabled)（ ） 。 每個選項卡都可以在不同的顏色顯示文本。目前的文本顏色選項卡可以與發現[tabTextColor](qtabbar.html#tabTextColor)（）函數。設置文字的顏色與特定標籤[setTabTextColor](qtabbar.html#setTabTextColor)（ ） 。 標籤使用添加[addTab](qtabbar.html#addTab)（），或者使用插入在特定位置[insertTab](qtabbar.html#insertTab)（ ） 。片的總數由下式給出[count](qtabbar.html#count-prop)（ ） 。標籤可以從與標籤欄被移除[removeTab](qtabbar.html#removeTab)（ ） 。結合[removeTab](qtabbar.html#removeTab)（）和[insertTab](qtabbar.html#insertTab)（）允許您移動標籤到不同的位置。 該[shape](qtabbar.html#shape-prop)屬性定義的選項卡'的出現。形狀的選擇是一個品味的問題，雖然選項卡對話框（對于喜好和類似的）總是使用[RoundedNorth](qtabbar.html#Shape-enum)。在windows對話框比其他選項卡控件幾乎總是使用任[RoundedSouth](qtabbar.html#Shape-enum) or [TriangularSouth](qtabbar.html#Shape-enum)。許多電子表格和其他選項卡控件中的所有頁面都基本類似用途[TriangularSouth](qtabbar.html#Shape-enum)，而[RoundedSouth](qtabbar.html#Shape-enum)大多采用在頁面是不同的（例如，一個多頁的工具選項板） 。在QTabBar默認為[RoundedNorth](qtabbar.html#Shape-enum)。 的QTabBar的API中最重要的部分是[currentChanged](qtabbar.html#currentChanged)（）信號。這是發射時在當前選項卡的變化（即使在啟動時，當在當前選項卡的“無”的變化） 。還有一個槽，[setCurrentIndex](qtabbar.html#currentIndex-prop)（ ） ，它可以用來以編程方式選擇一個選項卡。該功能[currentIndex](qtabbar.html#currentIndex-prop)（ ）返回當前選項卡的索引，[count](qtabbar.html#count-prop)保持標籤的數量。 QTabBar在創建的方式自動記憶鍵[QAbstractButton](qabstractbutton.html);如如果一個選項卡的標籤是“與圖形” ， Alt + G鍵變成了快捷鍵切換到該選項卡。 下面的虛函數可能需要以重新實現來定制外觀和感覺或存儲額外的數據與每個選項卡： * [tabSizeHint](qtabbar.html#tabSizeHint)() calcuates the size of a tab. * [tabInserted](qtabbar.html#tabInserted)() notifies that a new tab was added. * [tabRemoved](qtabbar.html#tabRemoved)() notifies that a tab was removed. * [tabLayoutChange](qtabbar.html#tabLayoutChange)() notifies that the tabs have been re-laid out. * [paintEvent](qtabbar.html#paintEvent)() paints all tabs. 對于子類，你可能還需要[tabRect](qtabbar.html#tabRect)（ ）函數返回一個標籤的視覺幾何形狀。 |  | A tab bar shown in the Plastique widget style. | |  | A truncated tab bar shown in the Plastique widget style. | * * * ## Type Documentation ``` QTabBar.ButtonPosition ``` 該枚舉類型列出一個選項卡上的窗口小部件的位置。 | Constant | Value | Description | | --- | --- | --- | | `QTabBar.LeftSide` | `0` | 該選項卡的左側。 | | `QTabBar.RightSide` | `1` | 該選項卡的右側。 | 這個枚舉被引入或修改的Qt 4.5 。 ``` QTabBar.SelectionBehavior ``` 該枚舉類型列出的行為[QTabBar](qtabbar.html)當一個標籤被刪除，被刪除的標籤也是當前選項卡。 | Constant | Value | Description | | --- | --- | --- | | `QTabBar.SelectLeftTab` | `0` | 選擇標籤，以一個被刪除的左側。 | | `QTabBar.SelectRightTab` | `1` | 選擇標籤，以一個被刪除的權利。 | | `QTabBar.SelectPreviousTab` | `2` | 選擇先前選定的選項卡。 | 這個枚舉被引入或修改的Qt 4.5 。 ``` QTabBar.Shape ``` 該枚舉類型列出了所支持的內建的形狀[QTabBar](qtabbar.html)。把這些作為提示一些樣式可能不會呈現一些形狀。然而，位置應該履行。 | Constant | Value | Description | | --- | --- | --- | | `QTabBar.RoundedNorth` | `0` | 正常的圓形看看上面的頁面 | | `QTabBar.RoundedSouth` | `1` | 正常圓潤的外觀下頁 | | `QTabBar.RoundedWest` | `2` | 正常的圓潤外觀上頁面的左側 | | `QTabBar.RoundedEast` | `3` | 正常的圓形的外表上的右側的頁面 | | `QTabBar.TriangularNorth` | `4` | 三角形標籤上方的頁面。 | | `QTabBar.TriangularSouth` | `5` | 三角形標籤類似于Excel的電子表格中使用，例如 | | `QTabBar.TriangularWest` | `6` | 三角形標籤上的頁面的左側。 | | `QTabBar.TriangularEast` | `7` | 三角形標籤上的頁面的右側。 | * * * ## Method Documentation ``` QTabBar.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 創建具有給定一個新的標籤欄_parent_。 ``` int QTabBar.addTab (self, QString?text) ``` 增加了文本的新選項卡_text_。返回新的選項卡的索引。 ``` int QTabBar.addTab (self, QIcon?icon, QString?text) ``` 這是一個重載函數。 添加帶有圖標的新選項卡_icon_和文本_text_。返回新的選項卡的索引。 ``` QTabBar.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` int QTabBar.count (self) ``` ``` int QTabBar.currentIndex (self) ``` ``` bool QTabBar.documentMode (self) ``` ``` bool QTabBar.drawBase (self) ``` ``` Qt.TextElideMode QTabBar.elideMode (self) ``` [ ``` bool QTabBar.event (self, QEvent) ``` ](qt.html#TextElideMode-enum) [從重新實現](qt.html#TextElideMode-enum)[QObject.event](qobject.html#event)（ ） 。 ``` bool QTabBar.expanding (self) ``` ``` QTabBar.hideEvent (self, QHideEvent) ``` 從重新實現[QWidget.hideEvent](qwidget.html#hideEvent)（ ） 。 ``` QSize QTabBar.iconSize (self) ``` [ ``` QTabBar.initStyleOption (self, QStyleOptionTab?option, int?tabIndex) ``` ](qsize.html) [初始化_option_與在標籤的值_tabIndex_。當他們需要一個這種方法是有用的子類](qsize.html)[QStyleOptionTab](qstyleoptiontab.html)，[QStyleOptionTabV2](qstyleoptiontabv2.html)或[QStyleOptionTabV3](qstyleoptiontabv3.html)但不希望在所有的信息填寫自己。此功能將檢查的版本[QStyleOptionTab](qstyleoptiontab.html)并填寫了附加價值[QStyleOptionTabV2](qstyleoptiontabv2.html)和[QStyleOptionTabV3](qstyleoptiontabv3.html)。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（）和[QTabWidget.initStyleOption](qtabwidget.html#initStyleOption)（ ） 。 ``` int QTabBar.insertTab (self, int?index, QString?text) ``` 插入文本的新選項卡_text_在位置_index_。如果_index_超出范圍，則新的選項卡appened 。返回新的選項卡的索引。 ``` int QTabBar.insertTab (self, int?index, QIcon?icon, QString?text) ``` 這是一個重載函數。 插入帶有圖標的新選項卡_icon_和文本_text_在位置_index_。如果_index_超出范圍，則新的標籤被追加。返回新的選項卡的索引。 如果[QTabBar](qtabbar.html)為空，此函數被調用之前，插入選項卡成為當前選項卡。 插入一個新的選項卡的索引小于或等于當前的索引處將增加目前的指數，但保留當前選項卡。 ``` bool QTabBar.isMovable (self) ``` ``` bool QTabBar.isTabEnabled (self, int?index) ``` 返回True如果在位置標籤_index_被啟用，否則返回False 。 ``` QTabBar.keyPressEvent (self, QKeyEvent) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（ ） 。 ``` QSize QTabBar.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` QTabBar.mouseMoveEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（ ） 。 ``` QTabBar.mousePressEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QTabBar.mouseReleaseEvent (self, QMouseEvent) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（ ） 。 ``` QTabBar.moveTab (self, int?from, int?to) ``` 在索引位置移動項目_from_到索引位置_to_。 此功能被引入Qt的4.5 。 **See also** [tabMoved](qtabbar.html#tabMoved)（）和[tabLayoutChange](qtabbar.html#tabLayoutChange)（ ） 。 ``` QTabBar.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QTabBar.removeTab (self, int?index) ``` 移除選項卡的位置_index_。 **See also** [SelectionBehavior](qtabbar.html#SelectionBehavior-enum)。 ``` QTabBar.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` SelectionBehavior QTabBar.selectionBehaviorOnRemove (self) ``` [ ``` QTabBar.setCurrentIndex (self, int?index) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentIndex(int)`。 ``` QTabBar.setDocumentMode (self, bool?set) ``` ``` QTabBar.setDrawBase (self, bool?drawTheBase) ``` ``` QTabBar.setElideMode (self, Qt.TextElideMode) ``` ``` QTabBar.setExpanding (self, bool?enabled) ``` ``` QTabBar.setIconSize (self, QSize?size) ``` ``` QTabBar.setMovable (self, bool?movable) ``` ``` QTabBar.setSelectionBehaviorOnRemove (self, SelectionBehavior?behavior) ``` ``` QTabBar.setShape (self, Shape?shape) ``` ``` QTabBar.setTabButton (self, int?index, ButtonPosition?position, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 Sets _widget_在選項卡上_index_。該插件被放置在左側或右側取決于_position_。 在任何先前定義插件_position_被隱藏。 標籤欄將窗口小部件的所有權，所以這里設置的所有部件將標籤欄時，它被摧毀，除非你單獨reparent小部件設置一些其他的小部件（或0 ）后刪除。 此功能被引入Qt的4.5 。 ](qtabbar.html#SelectionBehavior-enum) [**See also**](qtabbar.html#SelectionBehavior-enum) [tabButton](qtabbar.html#tabButton)（）和[tabsClosable](qtabbar.html#tabsClosable-prop)（ ） 。 ``` QTabBar.setTabData (self, int?index, QVariant?data) ``` 設置選項卡中的數據的位置_index_至_data_。 **See also** [tabData](qtabbar.html#tabData)（ ） 。 ``` QTabBar.setTabEnabled (self, int?index, bool) ``` If _enabled_為真，則在位置的標籤_index_被啟用，否則在位置的項目_index_被禁用。 **See also** [isTabEnabled](qtabbar.html#isTabEnabled)（ ） 。 ``` QTabBar.setTabIcon (self, int?index, QIcon?icon) ``` 設置選項卡的位置的圖標_index_至_icon_。 **See also** [tabIcon](qtabbar.html#tabIcon)（ ） 。 ``` QTabBar.setTabsClosable (self, bool?closable) ``` ``` QTabBar.setTabText (self, int?index, QString?text) ``` 設置選項卡的位置的文字_index_至_text_。 **See also** [tabText](qtabbar.html#tabText)（ ） 。 ``` QTabBar.setTabTextColor (self, int?index, QColor?color) ``` 在設置選項卡中的文本的顏色與給定_index_到指定的_color_。 如果指定了無效的顏色，選項卡將使用[QTabBar](qtabbar.html)前臺的角色來代替。 **See also** [tabTextColor](qtabbar.html#tabTextColor)（ ） 。 ``` QTabBar.setTabToolTip (self, int?index, QString?tip) ``` 設置選項卡的刀尖位置_index_至_tip_。 **See also** [tabToolTip](qtabbar.html#tabToolTip)（ ） 。 ``` QTabBar.setTabWhatsThis (self, int?index, QString?text) ``` 設置這是什么幫助，位置標籤的文本_index_至_text_。 這個函數是Qt 4.1中引入。 **See also** [tabWhatsThis](qtabbar.html#tabWhatsThis)（ ） 。 ``` QTabBar.setUsesScrollButtons (self, bool?useButtons) ``` ``` Shape QTabBar.shape (self) ``` [ ``` QTabBar.showEvent (self, QShowEvent) ``` ](qtabbar.html#Shape-enum) [從重新實現](qtabbar.html#Shape-enum)[QWidget.showEvent](qwidget.html#showEvent)（ ） 。 ``` QSize QTabBar.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` int QTabBar.tabAt (self, QPoint?pos) ``` 返回該復蓋的標籤的索引_position_或者-1，如果沒有選項卡蓋_position_; 此功能被引入Qt的4.3 。 ``` QWidget QTabBar.tabButton (self, int?index, ButtonPosition?position) ``` [ 返回小部件設置選項卡_index_和_position_或0如果沒有設置。 ](qwidget.html) [**See also**](qwidget.html) [setTabButton](qtabbar.html#setTabButton)（ ） 。 ``` QVariant QTabBar.tabData (self, int?index) ``` 返回標籤的數據在位置_index_如果，或者一個空的變體_index_超出范圍。 **See also** [setTabData](qtabbar.html#setTabData)（ ） 。 ``` QIcon QTabBar.tabIcon (self, int?index) ``` [ 將索引標籤的位置的圖標_index_如果，或者一個空圖標_index_超出范圍。 ](qicon.html) [**See also**](qicon.html) [setTabIcon](qtabbar.html#setTabIcon)（ ） 。 ``` QTabBar.tabInserted (self, int?index) ``` 后一個新的選項卡中添加或插入的位置這個虛擬處理器被調用_index_。 **See also** [tabRemoved](qtabbar.html#tabRemoved)（ ） 。 ``` QTabBar.tabLayoutChange (self) ``` 這種虛擬處理器被調用時該選項卡的布局變化。 **See also** [tabRect](qtabbar.html#tabRect)（ ） 。 ``` QRect QTabBar.tabRect (self, int?index) ``` [ 將索引標籤的位置的可視矩形_index_，或者一個空矩形，如果_index_超出范圍。 ``` QTabBar.tabRemoved (self, int?index) ``` 一個選項卡是從位置移除后，此虛擬處理器被調用_index_。 ](qrect.html) [**See also**](qrect.html) [tabInserted](qtabbar.html#tabInserted)（ ） 。 ``` bool QTabBar.tabsClosable (self) ``` ``` QSize QTabBar.tabSizeHint (self, int?index) ``` [ 返回尺寸暗示的位置的選項卡_index_。 ``` QString QTabBar.tabText (self, int?index) ``` 在位置返回標籤的文本_index_如果，或者一個空字符串_index_超出范圍。 ](qsize.html) [**See also**](qsize.html) [setTabText](qtabbar.html#setTabText)（ ） 。 ``` QColor QTabBar.tabTextColor (self, int?index) ``` [ 返回標籤的文本顏色與給定_index_或無效的顏色，如果_index_超出范圍。 ](qcolor.html) [**See also**](qcolor.html) [setTabTextColor](qtabbar.html#setTabTextColor)（ ） 。 ``` QString QTabBar.tabToolTip (self, int?index) ``` 返回選項卡的刀尖位置_index_如果，或者一個空字符串_index_超出范圍。 **See also** [setTabToolTip](qtabbar.html#setTabToolTip)（ ） 。 ``` QString QTabBar.tabWhatsThis (self, int?index) ``` 返回這是什么幫助，位置標籤的文本_index_如果，或者一個空字符串_index_超出范圍。 這個函數是Qt 4.1中引入。 **See also** [setTabWhatsThis](qtabbar.html#setTabWhatsThis)（ ） 。 ``` bool QTabBar.usesScrollButtons (self) ``` ``` QTabBar.wheelEvent (self, QWheelEvent?event) ``` 從重新實現[QWidget.wheelEvent](qwidget.html#wheelEvent)（ ） 。 ``` QTabBar.__len__ (self) ``` * * * ## Qt Signal Documentation ``` void currentChanged (int) ``` 這是該信號的默認超載。 當標籤欄的當前選項卡改變這個信號被發射。新的當前已給定的_index_或-1 ，如果沒有一個新的（例如，如果有在沒有標籤[QTabBar](qtabbar.html)） ``` void tabCloseRequested (int) ``` 這是該信號的默認超載。 點擊一個選項卡上的關閉按鈕時，這個信號被發射。該_index_是應該被刪除的索引。 此功能被引入Qt的4.5 。 **See also** [setTabsClosable](qtabbar.html#tabsClosable-prop)（ ） 。 ``` void tabMoved (int,int) ``` 這是該信號的默認超載。 這個信號被發射時，選項欄轉移的選項卡索引位置_from_到索引位置_to_。 注意：[QTabWidget](qtabwidget.html)會自動移動頁面時，這個信號是從它的標籤欄發出。 此功能被引入Qt的4.5 。 **See also** [moveTab](qtabbar.html#moveTab)（ ） 。