QTabWidget Class Reference

[QtGui module]

该QTabWidget类提供了一个堆栈标籤小部件。More…

继承QWidget。

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）和用于显示与每个标籤页的“页内” 。默认情况下，标籤栏上面显示的页面区域，但不同的配置可供选择（参见TabPosition） 。每个选项卡都与一个不同的窗口小部件（称为页）相关联。只有在当前页面中显示的页面区域，所有的其他页面是隐藏的。用户可以通过单击其选项卡或按下其ALT +显示不同的页面letter快捷方式（如果有） 。

正常的方式来使用QTabWidget是要做到以下几点：

  1. 创建QTabWidget 。
  2. 创建QWidget每个在选项卡对话框的页面，但不指定父窗口部件他们。
  3. 将子控件到页面窗口小部件，使用布局将它们定位为正常。
  4. Call addTab（）或insertTab（ ）把页面控件到标籤控件，给每个标籤有一个可选的键盘快捷键一个合适的标籤。

翼片的位置被定义为tabPosition，它们的形状由tabShape。

信号currentChanged（）当用户选择一个页面被发射。

当前页面的索引可作为currentIndex（ ） ，当前页面与小部件currentWidget（ ） 。可以使用检索指针的页插件与给定的索引widget（） ，并且可以找到一个插件的索引位置与indexOf（ ） 。使用setCurrentWidget（）或setCurrentIndex（）来显示一个特定的页面。

您可以使用更改标籤的文字和图标setTabText（）或setTabIcon（ ） 。一个标籤和它相关联的页面可以被删除removeTab（ ） 。

每个选项卡是启用或在任何特定时间禁止它们（见setTabEnabled（））。如果标籤被激活，标籤文本通常绘制，用户可以选择该选项卡。如果它被禁用，该选项卡绘制以不同的方式，用户可以不选择该选项卡。请注意，即使一个选项卡被禁用，页面仍然可以看到，例如，如果所有选项卡碰巧被禁用。

标籤部件可以是一个很好的方式来分割一个复杂的对话框。一个替代方案是使用一个QStackedWidget要为其提供页之间导航的一些装置，例如，一个QToolBar或QListWidget。

大部分在QTabWidget的功能是由一个提供QTabBar（在顶部，提供了制表符）和一个QStackedWidget（大部分面积，组织各页） 。

| Screenshot of a Windows XP style tab widget | Screenshot of a Macintosh style tab widget | Screenshot of a Plastique style tab widget | | A Windows XP style tab widget. | A Macintosh style tab widget. | A Plastique style tab widget. |

Type Documentation

  1. QTabWidget.TabPosition

该枚举类型定义了QTabWidget绘制选项卡行：

Constant Value Description
QTabWidget.North 0 该选项卡上的页面绘制。
QTabWidget.South 1 该标籤绘制下面的页面。
QTabWidget.West 2 翼片被吸引到页面的左边。
QTabWidget.East 3 翼片被吸引到页的右侧。 
  1. QTabWidget.TabShape

这个枚举类型定义了标籤的形状：

Constant Value Description
QTabWidget.Rounded 0 该选项卡绘制一个圆角的外观。这是默认的形状。
QTabWidget.Triangular 1 的制表符绘制一个三角的外观。

Method Documentation

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

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

构造一个标籤控件与父parent。

  1. int QTabWidget.addTab (self, QWidget widget, QString)

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

增加了一个选项卡与给定page和label在选项卡控件，并返回在标籤栏上的选项卡的索引。

如果选项卡的label包含一个符号，继符号的字母是用来作为标籤的快捷方式，例如：如果标籤是“弟兄与WSE ”然后按Alt + W成为这将焦点移动到该选项卡的快捷方式。

Note:如果调用addTab （ ）后show（ ） ，布局系统将尝试调整的变化，其部件的层次结构，并可能导致闪烁。为了避免这种情况，可以设置QWidget.updatesEnabled属性为False更改之前，记得将属性设置为True ，当更改完成，使得小部件再次收到paint事件。

See also insertTab（ ） 。

  1. int QTabWidget.addTab (self, QWidget widget, QIcon icon, QString label)

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

这是一个重载函数。

增加了一个选项卡与给定page，icon和label在选项卡控件，并返回在标籤栏上的选项卡的索引。

这个功能是相同的addTab（），但带有附加icon。

  1. QTabWidget.changeEvent (self, QEvent)

从重新实现QWidget.changeEvent（ ） 。

  1. QTabWidget.clear (self)

删除所有的页面，但不删除它们。调用此函数相当于调用removeTab（ ），直到选项卡控件是空的。

  1. QWidget QTabWidget.cornerWidget (self, Qt.Corner corner = Qt.TopRightCorner)

[

返回图中所示的部件corner的选项卡控件或0 。

]($docs-qwidget.html)

See also setCornerWidget（ ） 。

  1. int QTabWidget.count (self)
  1. int QTabWidget.currentIndex (self)
  1. QWidget QTabWidget.currentWidget (self)

[

返回一个指针，当前正显示的标籤对话框的网页。该选项卡对话框会尽力确保这个值是永远不为0 （但如果你足够努力，也可以是） 。

]($docs-qwidget.html)

See also currentIndex（）和setCurrentWidget（ ） 。

  1. bool QTabWidget.documentMode (self)
  1. Qt.TextElideMode QTabWidget.elideMode (self)

[

  1. bool QTabWidget.event (self, QEvent)

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

从重新实现QObject.event（ ） 。

  1. int QTabWidget.heightForWidth (self, int width)

从重新实现QWidget.heightForWidth（ ） 。

此功能被引入Qt的4.8 。

  1. QSize QTabWidget.iconSize (self)

[

  1. int QTabWidget.indexOf (self, QWidget widget)

返回该页面的索引位置的小窗口佔用w，或-1，如果小部件不能被发现。

  1. QTabWidget.initStyleOption (self, QStyleOptionTabWidgetFrame option)

]($docs-qsize.html)

初始化option与其它的值QTabWidget。当他们需要一个这种方法是有用的子类QStyleOptionTabWidgetFrame，但不希望在所有的信息填写自己。

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

  1. int QTabWidget.insertTab (self, int index, QWidget widget, QString)

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

插入制表符与给定label和page成的标籤窗口小部件在指定的index，并返回在标籤栏的插入选项卡的索引。

的标籤被显示在选项卡中，并且可以在外观上发生变化取决于标籤插件的配置。

如果选项卡的label包含一个符号，继符号的字母是用来作为标籤的快捷方式，例如：如果标籤是“弟兄与WSE ”然后按Alt + W成为这将焦点移动到该选项卡的快捷方式。

If index超出范围时，标籤只是简单地追加。否则，它会插入到指定位置。

如果QTabWidget为空，此函数被调用之前，新的页面成为当前页面。插入一个新的选项卡的索引小于或等于当前的索引处将增加目前的指数，但保留当前页面。

Note:如果调用insertTab （ ）后show（ ） ，布局系统将尝试调整的变化，其部件的层次结构，并可能导致闪烁。为了避免这种情况，可以设置QWidget.updatesEnabled属性为False更改之前，记得将属性设置为True ，当更改完成，使得小部件再次收到paint事件。

See also addTab（ ） 。

  1. int QTabWidget.insertTab (self, int index, QWidget widget, QIcon icon, QString label)

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

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

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

See also setTabEnabled（）和QWidget.isEnabled（ ） 。

  1. QTabWidget.keyPressEvent (self, QKeyEvent)

从重新实现QWidget.keyPressEvent（ ） 。

  1. QSize QTabWidget.minimumSizeHint (self)

从重新实现QWidget.minimumSizeHint（ ） 。

返回一个合适的最小尺寸为选项卡控件。

  1. QTabWidget.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（ ） 。

描绘了标籤控件的标籤栏响应漆event。

  1. QTabWidget.removeTab (self, int index)

移除选项卡的位置index从这个堆栈窗口小部件。在网页插件本身不会被删除。

See also addTab（）和insertTab（ ） 。

  1. QTabWidget.resizeEvent (self, QResizeEvent)

从重新实现QWidget.resizeEvent（ ） 。

  1. QTabWidget.setCornerWidget (self, QWidget widget, Qt.Corner corner = Qt.TopRightCorner)

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

设置给定widget在指定要显示corner的选项卡控件。小部件的几何形状是基于Widget的决定sizeHint（ ）和style（ ） 。

唯一的水平元素corner将被使用。

路过0显示没有插件的角落里。

任何以前设置的角落widget被隐藏。

这里设置的所有部件将由选项卡控件时，它被摧毁，除非你单独reparent小部件设置一些其他角落部件（或0 ）后删除。

注：角部件是专为North和South标籤的位置，其他方位已知无法正常工作。

See also cornerWidget（）和setTabPosition（ ） 。

  1. QTabWidget.setCurrentIndex (self, int index)

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

  1. QTabWidget.setCurrentWidget (self, QWidget widget)

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

品牌widget当前的窗口小部件。该widget使用的必须是一个页面在此选项卡控件。

See also addTab（ ）setCurrentIndex（）和currentWidget（ ） 。

  1. QTabWidget.setDocumentMode (self, bool set)
  1. QTabWidget.setElideMode (self, Qt.TextElideMode)
  1. QTabWidget.setIconSize (self, QSize size)
  1. QTabWidget.setMovable (self, bool movable)
  1. QTabWidget.setTabBar (self, QTabBar)

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

替换对话框的QTabBar与标籤栏标题tb。请注意，这必须调用before任何标籤已被添加，或行为是未定义的。

See also tabBar（ ） 。

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

If enable诚然，在位置页面index被启用，否则在位置页面index被禁用。页面的选项卡进行适当重绘。

QTabWidget uses QWidget.setEnabled（ ）内部，而不是保持一个独立的标志。

请注意，即使已禁用选项卡/页可能是可见的。如果页面已经可见，QTabWidget不会隐藏它，如果所有页面都禁用，QTabWidget将显示其中之一。

See also isTabEnabled（）和QWidget.setEnabled（ ） 。

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

这是一个重载函数。

设置icon对于位置的选项卡index。

See also tabIcon（ ） 。

  1. QTabWidget.setTabPosition (self, TabPosition)
  1. QTabWidget.setTabsClosable (self, bool closeable)
  1. QTabWidget.setTabShape (self, TabShape s)
  1. QTabWidget.setTabText (self, int index, QString)

定义了一个新label对于位置的页面index的标籤。

如果提供的文字包含符号字符（ ‘＆’ ） ，一个快捷方式自动为其创建。后面的“＆”将被用来作为快捷键的字符。任何先前的快捷方式将被复盖，或者如果没有快捷方式是通过文本中的定义清除。请参阅QShortcut有关详细信息的文档（显示的实际符号，使用“\u0026\u0026” ） 。

See also tabText（ ） 。

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

设置选项卡工具提示位置的页面index至tip。

See also tabToolTip（ ） 。

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

设置这是什么帮助文本位置的页面index至text。

这个函数是Qt 4.1中引入。

See also tabWhatsThis（ ） 。

  1. QTabWidget.setUsesScrollButtons (self, bool useButtons)
  1. QTabWidget.showEvent (self, QShowEvent)

从重新实现QWidget.showEvent（ ） 。

  1. QSize QTabWidget.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

  1. QTabBar QTabWidget.tabBar (self)

返回当前QTabBar。

See also setTabBar（ ） 。

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

[

返回图标位置的页面上的标籤index。

]($docs-qicon.html)

See also setTabIcon（ ） 。

  1. QTabWidget.tabInserted (self, int index)

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

See also tabRemoved（ ） 。

  1. TabPosition QTabWidget.tabPosition (self)

[

  1. QTabWidget.tabRemoved (self, int index)

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

]($docs-qtabwidget.html#TabPosition-enum)

See also tabInserted（ ） 。

  1. bool QTabWidget.tabsClosable (self)
  1. TabShape QTabWidget.tabShape (self)

[

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

返回的标籤文本在位置页面上的选项卡index。

]($docs-qtabwidget.html#TabShape-enum)

See also setTabText（ ） 。

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

返回标籤工具提示位置的页面index或空字符串，如果没有刀尖已定。

See also setTabToolTip（ ） 。

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

返回这是什么帮助文本位置的页面index，或一个空字符串，如果没有帮助文本已定。

这个函数是Qt 4.1中引入。

See also setTabWhatsThis（ ） 。

  1. bool QTabWidget.usesScrollButtons (self)
  1. QWidget QTabWidget.widget (self, int index)

[

返回标籤页的索引位置index或者0，如果index超出范围。

  1.  QTabWidget.__len__ (self)

Qt Signal Documentation

  1. void currentChanged (int)

这是该信号的默认超载。

]($docs-qwidget.html)

这个信号被发射时在当前页面的索引变化。该参数是当前新页面index位置，或-1 ，如果没有一个新的（例如，如果没有部件在QTabWidget）

See also currentWidget（）和currentIndex。

  1. void tabCloseRequested (int)

这是该信号的默认超载。

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

此功能被引入Qt的4.5 。

See also setTabsClosable（ ） 。