QTabBar ¶

QTabBar class provides a tab bar, e.g. for use in tabbed dialogs. 更多 …

概要 ¶

函数 ¶

def accessibleTabName (index)
def addTab (icon, text)
def addTab (text)
def autoHide ()
def changeCurrentOnDrag ()
def count ()
def currentIndex ()
def documentMode ()
def drawBase ()
def elideMode ()
def expanding ()
def iconSize ()
def initStyleOption (option, tabIndex)
def insertTab (index, icon, text)
def insertTab (index, text)
def isMovable ()
def isTabEnabled (index)
def isTabVisible (index)
def moveTab (from, to)
def removeTab (index)
def selectionBehaviorOnRemove ()
def setAccessibleTabName (index, name)
def setAutoHide (hide)
def setChangeCurrentOnDrag (change)
def setDocumentMode (set)
def setDrawBase (drawTheBase)
def setElideMode (mode)
def setExpanding (enabled)
def setIconSize (size)
def setMovable (movable)
def setSelectionBehaviorOnRemove (behavior)
def setShape (shape)
def setTabButton (index, position, widget)
def setTabData (index, data)
def setTabEnabled (index, enabled)
def setTabIcon (index, icon)
def setTabText (index, text)
def setTabTextColor (index, color)
def setTabToolTip (index, tip)
def setTabVisible (index, visible)
def setTabWhatsThis (index, text)
def setTabsClosable (closable)
def setUsesScrollButtons (useButtons)
def shape ()
def tabAt (pos)
def tabButton (index, position)
def tabData (index)
def tabIcon (index)
def tabRect (index)
def tabText (index)
def tabTextColor (index)
def tabToolTip (index)
def tabWhatsThis (index)
def tabsClosable ()
def usesScrollButtons ()

虚函数 ¶

def minimumTabSizeHint (index)
def tabInserted (index)
def tabLayoutChange ()
def tabRemoved (index)
def tabSizeHint (index)

槽 ¶

def setCurrentIndex (index)

信号 ¶

def currentChanged (index)
def tabBarClicked (index)
def tabBarDoubleClicked (index)
def tabCloseRequested (index)
def tabMoved (from, to)

详细描述 ¶

QTabBar is straightforward to use; it draws the tabs using one of the predefined shapes ，并发射信号，当选项卡被选中时。它可以被子类化以订制外观和感觉。Qt 还提供现成 QTabWidget .

每个选项卡有 tabText() , an optional tabIcon() , an optional tabToolTip() , optional tabWhatsThis() 和可选 tabData() . The tabs’s attributes can be changed with setTabText() , setTabIcon() , setTabToolTip() , setTabWhatsThis and setTabData() . Each tabs can be enabled or disabled individually with setTabEnabled() .

每个选项卡可以按截然不同颜色显示文本。可以找到当前选项卡的文本颜色采用 tabTextColor() function. Set the text color for a particular tab with setTabTextColor() .

添加选项卡使用 addTab() , or inserted at particular positions using insertTab() . The total number of tabs is given by count() . Tabs can be removed from the tab bar with removeTab() . Combining removeTab() and insertTab() allows you to move tabs to different positions.

shape property defines the tabs’ appearance. The choice of shape is a matter of taste, although tab dialogs (for preferences and similar) invariably use RoundedNorth . Tab controls in windows other than dialogs almost always use either RoundedSouth or TriangularSouth . Many spreadsheets and other tab controls in which all the pages are essentially similar use TriangularSouth ，而 RoundedSouth is used mostly when the pages are different (e.g. a multi-page tool palette). The default in QTabBar is RoundedNorth .

The most important part of QTabBar ‘s API is the currentChanged() signal. This is emitted whenever the current tab changes (even at startup, when the current tab changes from ‘none’). There is also a slot, setCurrentIndex() , which can be used to select a tab programmatically. The function currentIndex() returns the index of the current tab, count holds the number of tabs.

QTabBar creates automatic mnemonic keys in the manner of QAbstractButton ; e.g. if a tab’s label is “&Graphics”, Alt+G becomes a shortcut key for switching to that tab.

The following virtual functions may need to be reimplemented in order to tailor the look and feel or store extra data with each tab:

tabSizeHint() calcuates the size of a tab.

tabInserted() notifies that a new tab was added.

tabRemoved() notifies that a tab was removed.

tabLayoutChange() notifies that the tabs have been re-laid out.

paintEvent() paints all tabs.

对于子类，可能还需要 tabRect() functions which returns the visual geometry of a single tab.

选项卡栏展示在融合 Widget 风格 .

以 Fusion 小部件样式展示截取选项卡栏。

另请参阅

QTabWidget

class QTabBar ( [ parent=None ] ) ¶

param parent

QWidget

创建新的选项卡栏，采用给定 parent .

PySide2.QtWidgets.QTabBar. 形状 ¶

此枚举类型列出了受支持的内置形状，由 QTabBar . Treat these as hints as some styles may not render some of the shapes. However, position should be honored.

常量	描述
QTabBar.RoundedNorth	The normal rounded look above the pages
QTabBar.RoundedSouth	The normal rounded look below the pages
QTabBar.RoundedWest	The normal rounded look on the left side of the pages
QTabBar.RoundedEast	The normal rounded look on the right side the pages
QTabBar.TriangularNorth	在页面上方的三角形选项卡。
QTabBar.TriangularSouth	Triangular tabs similar to those used in the Excel spreadsheet, for example
QTabBar.TriangularWest	Triangular tabs on the left of the pages.
QTabBar.TriangularEast	Triangular tabs on the right of the pages.

PySide2.QtWidgets.QTabBar. ButtonPosition ¶

此枚举类型列表 Widget 在选项卡上的位置。

常量	描述
QTabBar.LeftSide	选项卡的左侧。
QTabBar.RightSide	选项卡的右侧。

PySide2.QtWidgets.QTabBar. SelectionBehavior ¶

此枚举类型列表行为在 QTabBar 当选项卡被移除且被移除选项卡也是当前选项卡时。

常量	描述
QTabBar.SelectLeftTab	选择被移除选项卡左侧的选项卡。
QTabBar.SelectRightTab	选择被移除选项卡右侧的选项卡。
QTabBar.SelectPreviousTab	选择先前选中的选项卡。