QTabBar Class Reference

[QtGui module]

该QTabBar类提供了一个标籤栏，例如在标籤对话框中使用。More…

继承QWidget。

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，并发射时，所选择的标籤的信号。它可以被子类化定制的外观和感觉。 Qt还提供了一个现成的QTabWidget。

每个标籤都有一个tabText（） ，可选tabIcon（） ，可选tabToolTip（ ），可选tabWhatsThis（）和可选tabData（ ） 。的标籤的属性可以被改变setTabText（ ）setTabIcon（ ）setTabToolTip（ ） ， setTabWhatsThis和setTabData（ ） 。每个选项卡可以启用或禁用单独setTabEnabled（ ） 。

每个选项卡都可以在不同的颜色显示文本。目前的文本颜色选项卡可以与发现tabTextColor（）函数。设置文字的颜色与特定标籤setTabTextColor（ ） 。

标籤使用添加addTab（），或者使用插入在特定位置insertTab（ ） 。片的总数由下式给出count（ ） 。标籤可以从与标籤栏被移除removeTab（ ） 。结合removeTab（）和insertTab（）允许您移动标籤到不同的位置。

该shape属性定义的选项卡’的出现。形状的选择是一个品味的问题，虽然选项卡对话框（对于喜好和类似的）总是使用RoundedNorth。在windows对话框比其他选项卡控件几乎总是使用任RoundedSouth or TriangularSouth。许多电子表格和其他选项卡控件中的所有页面都基本类似用途TriangularSouth，而RoundedSouth大多采用在页面是不同的（例如，一个多页的工具选项板） 。在QTabBar默认为RoundedNorth。

的QTabBar的API中最重要的部分是currentChanged（）信号。这是发射时在当前选项卡的变化（即使在启动时，当在当前选项卡的“无”的变化） 。还有一个槽，setCurrentIndex（ ） ，它可以用来以编程方式选择一个选项卡。该功能currentIndex（ ）返回当前选项卡的索引，count保持标籤的数量。

QTabBar在创建的方式自动记忆键QAbstractButton;如如果一个选项卡的标籤是“与图形” ， Alt + G键变成了快捷键切换到该选项卡。

下面的虚函数可能需要以重新实现来定制外观和感觉或存储额外的数据与每个选项卡：

对于子类，你可能还需要tabRect（ ）函数返回一个标籤的视觉几何形状。

| Screenshot of a Plastique style tab bar | A tab bar shown in the Plastique widget style. | | Screenshot of a truncated Plastique tab bar | A truncated tab bar shown in the Plastique widget style. |

Type Documentation

  1. QTabBar.ButtonPosition

该枚举类型列出一个选项卡上的窗口小部件的位置。

Constant Value Description
QTabBar.LeftSide 0 该选项卡的左侧。
QTabBar.RightSide 1 该选项卡的右侧。

这个枚举被引入或修改的Qt 4.5 。

  1. QTabBar.SelectionBehavior

该枚举类型列出的行为QTabBar当一个标籤被删除，被删除的标籤也是当前选项卡。

Constant Value Description
QTabBar.SelectLeftTab 0 选择标籤，以一个被删除的左侧。
QTabBar.SelectRightTab 1 选择标籤，以一个被删除的权利。
QTabBar.SelectPreviousTab 2 选择先前选定的选项卡。

这个枚举被引入或修改的Qt 4.5 。

  1. QTabBar.Shape

该枚举类型列出了所支持的内建的形状QTabBar。把这些作为提示一些样式可能不会呈现一些形状。然而，位置应该履行。

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

  1. QTabBar.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

创建具有给定一个新的标籤栏parent。

  1. int QTabBar.addTab (self, QString text)

增加了文本的新选项卡text。返回新的选项卡的索引。

  1. int QTabBar.addTab (self, QIcon icon, QString text)

这是一个重载函数。

添加带有图标的新选项卡icon和文本text。返回新的选项卡的索引。

  1. QTabBar.changeEvent (self, QEvent)

从重新实现QWidget.changeEvent（ ） 。

  1. int QTabBar.count (self)
  1. int QTabBar.currentIndex (self)
  1. bool QTabBar.documentMode (self)
  1. bool QTabBar.drawBase (self)
  1. Qt.TextElideMode QTabBar.elideMode (self)

[

  1. bool QTabBar.event (self, QEvent)

]($docs-qt.html#TextElideMode-enum)

从重新实现QObject.event（ ） 。

  1. bool QTabBar.expanding (self)
  1. QTabBar.hideEvent (self, QHideEvent)

从重新实现QWidget.hideEvent（ ） 。

  1. QSize QTabBar.iconSize (self)

[

  1. QTabBar.initStyleOption (self, QStyleOptionTab option, int tabIndex)

]($docs-qsize.html)

初始化option与在标籤的值tabIndex。当他们需要一个这种方法是有用的子类QStyleOptionTab，QStyleOptionTabV2或QStyleOptionTabV3但不希望在所有的信息填写自己。此功能将检查的版本QStyleOptionTab并填写了附加价值QStyleOptionTabV2和QStyleOptionTabV3。

See also QStyleOption.initFrom（）和QTabWidget.initStyleOption（ ） 。

  1. int QTabBar.insertTab (self, int index, QString text)

插入文本的新选项卡text在位置index。如果index超出范围，则新的选项卡appened 。返回新的选项卡的索引。

  1. int QTabBar.insertTab (self, int index, QIcon icon, QString text)

这是一个重载函数。

插入带有图标的新选项卡icon和文本text在位置index。如果index超出范围，则新的标籤被追加。返回新的选项卡的索引。

如果QTabBar为空，此函数被调用之前，插入选项卡成为当前选项卡。

插入一个新的选项卡的索引小于或等于当前的索引处将增加目前的指数，但保留当前选项卡。

  1. bool QTabBar.isMovable (self)
  1. bool QTabBar.isTabEnabled (self, int index)

返回True如果在位置标籤index被启用，否则返回False 。

  1. QTabBar.keyPressEvent (self, QKeyEvent)

从重新实现QWidget.keyPressEvent（ ） 。

  1. QSize QTabBar.minimumSizeHint (self)

从重新实现QWidget.minimumSizeHint（ ） 。

  1. QTabBar.mouseMoveEvent (self, QMouseEvent)

从重新实现QWidget.mouseMoveEvent（ ） 。

  1. QTabBar.mousePressEvent (self, QMouseEvent)

从重新实现QWidget.mousePressEvent（ ） 。

  1. QTabBar.mouseReleaseEvent (self, QMouseEvent)

从重新实现QWidget.mouseReleaseEvent（ ） 。

  1. QTabBar.moveTab (self, int from, int to)

在索引位置移动项目from到索引位置to。

此功能被引入Qt的4.5 。

See also tabMoved（）和tabLayoutChange（ ） 。

  1. QTabBar.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（ ） 。

  1. QTabBar.removeTab (self, int index)

移除选项卡的位置index。

See also SelectionBehavior。

  1. QTabBar.resizeEvent (self, QResizeEvent)

从重新实现QWidget.resizeEvent（ ） 。

  1. SelectionBehavior QTabBar.selectionBehaviorOnRemove (self)

[

  1. QTabBar.setCurrentIndex (self, int index)

这种方法也是一个Qt槽与C + +的签名void setCurrentIndex(int)。

  1. QTabBar.setDocumentMode (self, bool set)
  1. QTabBar.setDrawBase (self, bool drawTheBase)
  1. QTabBar.setElideMode (self, Qt.TextElideMode)
  1. QTabBar.setExpanding (self, bool enabled)
  1. QTabBar.setIconSize (self, QSize size)
  1. QTabBar.setMovable (self, bool movable)
  1. QTabBar.setSelectionBehaviorOnRemove (self, SelectionBehavior behavior)
  1. QTabBar.setShape (self, Shape shape)
  1. QTabBar.setTabButton (self, int index, ButtonPosition position, QWidget widget)

该widget说法有它的所有权转移给Qt的。

Sets widget在选项卡上index。该插件被放置在左侧或右侧取决于position。

在任何先前定义插件position被隐藏。

标籤栏将窗口小部件的所有权，所以这里设置的所有部件将标籤栏时，它被摧毁，除非你单独reparent小部件设置一些其他的小部件（或0 ）后删除。

此功能被引入Qt的4.5 。

]($docs-qtabbar.html#SelectionBehavior-enum)

See also tabButton（）和tabsClosable（ ） 。

  1. QTabBar.setTabData (self, int index, QVariant data)

设置选项卡中的数据的位置index至data。

See also tabData（ ） 。

  1. QTabBar.setTabEnabled (self, int index, bool)

If enabled为真，则在位置的标籤index被启用，否则在位置的项目index被禁用。

See also isTabEnabled（ ） 。

  1. QTabBar.setTabIcon (self, int index, QIcon icon)

设置选项卡的位置的图标index至icon。

See also tabIcon（ ） 。

  1. QTabBar.setTabsClosable (self, bool closable)
  1. QTabBar.setTabText (self, int index, QString text)

设置选项卡的位置的文字index至text。

See also tabText（ ） 。

  1. QTabBar.setTabTextColor (self, int index, QColor color)

在设置选项卡中的文本的颜色与给定index到指定的color。

如果指定了无效的颜色，选项卡将使用QTabBar前台的角色来代替。

See also tabTextColor（ ） 。

  1. QTabBar.setTabToolTip (self, int index, QString tip)

设置选项卡的刀尖位置index至tip。

See also tabToolTip（ ） 。

  1. QTabBar.setTabWhatsThis (self, int index, QString text)

设置这是什么帮助，位置标籤的文本index至text。

这个函数是Qt 4.1中引入。

See also tabWhatsThis（ ） 。

  1. QTabBar.setUsesScrollButtons (self, bool useButtons)
  1. Shape QTabBar.shape (self)

[

  1. QTabBar.showEvent (self, QShowEvent)

]($docs-qtabbar.html#Shape-enum)

从重新实现QWidget.showEvent（ ） 。

  1. QSize QTabBar.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

  1. int QTabBar.tabAt (self, QPoint pos)

返回该复盖的标籤的索引position或者-1，如果没有选项卡盖position;

此功能被引入Qt的4.3 。

  1. QWidget QTabBar.tabButton (self, int index, ButtonPosition position)

[

返回小部件设置选项卡index和position或0如果没有设置。

]($docs-qwidget.html)

See also setTabButton（ ） 。

  1. QVariant QTabBar.tabData (self, int index)

返回标籤的数据在位置index如果，或者一个空的变体index超出范围。

See also setTabData（ ） 。

  1. QIcon QTabBar.tabIcon (self, int index)

[

将索引标籤的位置的图标index如果，或者一个空图标index超出范围。

]($docs-qicon.html)

See also setTabIcon（ ） 。

  1. QTabBar.tabInserted (self, int index)

后一个新的选项卡中添加或插入的位置这个虚拟处理器被调用index。

See also tabRemoved（ ） 。

  1. QTabBar.tabLayoutChange (self)

这种虚拟处理器被调用时该选项卡的布局变化。

See also tabRect（ ） 。

  1. QRect QTabBar.tabRect (self, int index)

[

将索引标籤的位置的可视矩形index，或者一个空矩形，如果index超出范围。

  1. QTabBar.tabRemoved (self, int index)

一个选项卡是从位置移除后，此虚拟处理器被调用index。

]($docs-qrect.html)

See also tabInserted（ ） 。

  1. bool QTabBar.tabsClosable (self)
  1. QSize QTabBar.tabSizeHint (self, int index)

[

返回尺寸暗示的位置的选项卡index。

  1. QString QTabBar.tabText (self, int index)

在位置返回标籤的文本index如果，或者一个空字符串index超出范围。

]($docs-qsize.html)

See also setTabText（ ） 。

  1. QColor QTabBar.tabTextColor (self, int index)

[

返回标籤的文本颜色与给定index或无效的颜色，如果index超出范围。

]($docs-qcolor.html)

See also setTabTextColor（ ） 。

  1. QString QTabBar.tabToolTip (self, int index)

返回选项卡的刀尖位置index如果，或者一个空字符串index超出范围。

See also setTabToolTip（ ） 。

  1. QString QTabBar.tabWhatsThis (self, int index)

返回这是什么帮助，位置标籤的文本index如果，或者一个空字符串index超出范围。

这个函数是Qt 4.1中引入。

See also setTabWhatsThis（ ） 。

  1. bool QTabBar.usesScrollButtons (self)
  1. QTabBar.wheelEvent (self, QWheelEvent event)

从重新实现QWidget.wheelEvent（ ） 。

  1.  QTabBar.__len__ (self)

Qt Signal Documentation

  1. void currentChanged (int)

这是该信号的默认超载。

当标籤栏的当前选项卡改变这个信号被发射。新的当前已给定的index或-1 ，如果没有一个新的（例如，如果有在没有标籤QTabBar）

  1. void tabCloseRequested (int)

这是该信号的默认超载。

点击一个选项卡上的关闭按钮时，这个信号被发射。该index是应该被删除的索引。

此功能被引入Qt的4.5 。

See also setTabsClosable（ ） 。

  1. void tabMoved (int,int)

这是该信号的默认超载。

这个信号被发射时，选项栏转移的选项卡索引位置from到索引位置to。

注意：QTabWidget会自动移动页面时，这个信号是从它的标籤栏发出。

此功能被引入Qt的4.5 。

See also moveTab（ ） 。