Home · All Classes · Modules

QStyleOptionTab Class Reference
^{[QtGui module]}

The QStyleOptionTab class is used to describe the parameters for drawing a tab bar. More...

Inherits QStyleOption.

Inherited by QStyleOptionTabV2.

Types

• enum CornerWidget { NoCornerWidgets, LeftCornerWidget, RightCornerWidget }
• class CornerWidgets
• enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected }
• enum TabPosition { Beginning, Middle, End, OnlyOneTab }

Methods

• __init__ (self)
• __init__ (self, QStyleOptionTab other)

Members

• CornerWidgets cornerWidgets
• QIcon icon
• TabPosition position
• int row
• SelectedPosition selectedPosition
• QTabBar.Shape shape
• QString text

Static Members

• int Type
• int Version

The QStyleOptionTab class is used for drawing several built-in Qt widgets including QTabBar and the panel for QTabWidget. Note that to describe the parameters necessary for drawing a frame in Qt 4.1 or above, you must use the QStyleOptionFrameV2 subclass.

An instance of the QStyleOptiontabV2 class has type SO_Tab and version 1. The type is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles. The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally don't need to check it.

If you create your own QStyle subclass, you should handle both QStyleOptionTab and QStyleOptionTabV2.

For an example demonstrating how style options can be used, see the Styles example.

See also QStyleOptionTabV2 and QStyleOption.

Type Documentation

QStyleOptionTab.CornerWidget

These flags indicate the corner widgets in a tab.

The CornerWidgets type is a typedef for QFlags<CornerWidget>. It stores an OR combination of CornerWidget values.

See also cornerWidgets.

QStyleOptionTab.SelectedPosition

See also selectedPosition.

QStyleOptionTab.TabPosition

See also position.

Method Documentation

QStyleOptionTab.__init__ (self)

Constructs a QStyleOptionTab object. The members variables are initialized to default values.

QStyleOptionTab.__init__ (self, QStyleOptionTab other)

Constructs a copy of the other style option.

Member Documentation

CornerWidgets cornerWidgets

This variable holds information on the cornerwidgets of the tab bar.

See also CornerWidget.

QIcon icon

This variable holds the icon for the tab.

TabPosition position

This variable holds the position of the tab in the tab bar.

int row

This variable holds which row the tab is currently in.

SelectedPosition selectedPosition

This variable holds the position of the selected tab in relation to this tab. Some styles need to draw a tab differently depending on whether or not it is adjacent to the selected tab.

QTabBar.Shape shape

This variable holds the tab shape used to draw the tab.

See also QTabBar.Shape.

QString text

This variable holds the text of the tab.

int Type

This member should be treated as a constant.

Equals SO_Tab.

The type is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.

int Version

This member should be treated as a constant.

Equals 1.

The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally don't need to check it.