 |
Qt 4.8
|
|
Qt 4.8
|
The QStyleOptionTab class is used to describe the parameters for drawing a tab bar. More...
#include <qstyleoption.h>
Public Types | |
| enum | CornerWidget { NoCornerWidgets = 0x00, LeftCornerWidget = 0x01, RightCornerWidget = 0x02 } |
| These flags indicate the corner widgets in a tab. More... | |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected } |
| This enum describes the position of the selected tab. More... | |
| enum | StyleOptionType { Type = SO_Tab } |
| This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More... | |
| enum | StyleOptionVersion { Version = 1 } |
| This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More... | |
| enum | TabPosition { Beginning, Middle, End, OnlyOneTab } |
| This enum describes the position of the tab. More... | |
 Public Types inherited from QStyleOption | |
| enum | OptionType { SO_Default, SO_FocusRect, SO_Button, SO_Tab, SO_MenuItem, SO_Frame, SO_ProgressBar, SO_ToolBox, SO_Header, SO_Q3DockWindow, SO_DockWidget, SO_Q3ListViewItem, SO_ViewItem, SO_TabWidgetFrame, SO_TabBarBase, SO_RubberBand, SO_ToolBar, SO_GraphicsItem, SO_Complex = 0xf0000, SO_Slider, SO_SpinBox, SO_ToolButton, SO_ComboBox, SO_Q3ListView, SO_TitleBar, SO_GroupBox, SO_SizeGrip, SO_CustomBase = 0xf00, SO_ComplexCustomBase = 0xf000000 } |
| This enum is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. More... | |
| enum | StyleOptionType { Type = SO_Default } |
| This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More... | |
| enum | StyleOptionVersion { Version = 1 } |
| This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More... | |
Public Functions | |
| QStyleOptionTab () | |
| Constructs a QStyleOptionTab object, initializing the members variables to their default values. More... | |
| QStyleOptionTab (const QStyleOptionTab &other) | |
| Constructs a copy of the other style option. More... | |
| Public Functions inherited from QStyleOption | |
| void | init (const QWidget *w) |
| Use initFrom(widget) instead. More... | |
| void | initFrom (const QWidget *w) |
| QStyleOption & | operator= (const QStyleOption &other) |
| Assign other to this QStyleOption. More... | |
| QStyleOption (int version=QStyleOption::Version, int type=SO_Default) | |
| Constructs a QStyleOption with the specified version and type. More... | |
| QStyleOption (const QStyleOption &other) | |
| Constructs a copy of other. More... | |
| ~QStyleOption () | |
| Destroys this style option object. More... | |
Public Variables | |
| CornerWidgets | cornerWidgets |
| an OR combination of CornerWidget values indicating the corner widgets of the tab bar More... | |
| QIcon | icon |
| the icon for the tab More... | |
| TabPosition | position |
| the position of the tab in the tab bar More... | |
| int | row |
| which row the tab is currently in More... | |
| SelectedPosition | selectedPosition |
| the position of the selected tab in relation to this tab More... | |
| QTabBar::Shape | shape |
| the tab shape used to draw the tab; by default QTabBar::RoundedNorth More... | |
| QString | text |
| the text of the tab More... | |
| Public Variables inherited from QStyleOption | |
| Qt::LayoutDirection | direction |
| the text layout direction that should be used when drawing text in the control More... | |
| QFontMetrics | fontMetrics |
| the font metrics that should be used when drawing text in the control More... | |
| QPalette | palette |
| the palette that should be used when painting the control More... | |
| QRect | rect |
| the area that should be used for various calculations and painting More... | |
| QStyle::State | state |
| the style flags that are used when drawing the control More... | |
| int | type |
| the option type of the style option More... | |
| int | version |
| the version of the style option More... | |
Protected Functions | |
| QStyleOptionTab (int version) | |
Additional Inherited Members | |
| Related Functions inherited from QStyleOption | |
| T | qstyleoption_cast (const QStyleOption *option) |
| T | qstyleoption_cast (QStyleOption *option) |
| This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More... | |
The QStyleOptionTab class is used to describe the parameters for drawing a tab bar.
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 do not 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 widgets/styles{Styles} example.
Definition at line 304 of file qstyleoption.h.
These flags indicate the corner widgets in a tab.
| Enumerator | |
|---|---|
| NoCornerWidgets | |
| LeftCornerWidget | |
| RightCornerWidget | |
Definition at line 312 of file qstyleoption.h.
This enum describes the position of the selected tab.
Some styles need to draw a tab differently depending on whether or not it is adjacent to the selected tab.
| Enumerator | |
|---|---|
| NotAdjacent | |
| NextIsSelected | |
| PreviousIsSelected | |
Definition at line 311 of file qstyleoption.h.
This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass.
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.
| Enumerator | |
|---|---|
| Type | |
Definition at line 307 of file qstyleoption.h.
This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass.
The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally do not need to check it.
| Enumerator | |
|---|---|
| Version | |
Definition at line 308 of file qstyleoption.h.
This enum describes the position of the tab.
| Enumerator | |
|---|---|
| Beginning | |
| Middle | |
| End | |
| OnlyOneTab | |
Definition at line 310 of file qstyleoption.h.
| QStyleOptionTab::QStyleOptionTab | ( | ) |
Constructs a QStyleOptionTab object, initializing the members variables to their default values.
Definition at line 2106 of file qstyleoption.cpp.
|
inline |
Constructs a copy of the other style option.
Definition at line 325 of file qstyleoption.h.
|
protected |
Definition at line 2118 of file qstyleoption.cpp.
| QStyleOptionTab::cornerWidgets |
an OR combination of CornerWidget values indicating the corner widgets of the tab bar
The default value is NoCornerWidgets.
Definition at line 322 of file qstyleoption.h.
Referenced by QTabBar::initStyleOption().
| QStyleOptionTab::icon |
the icon for the tab
The default value is an empty icon, i.e. an icon with neither a pixmap nor a filename.
Definition at line 318 of file qstyleoption.h.
Referenced by QCommonStyle::drawControl(), QTabBar::initStyleOption(), QCommonStylePrivate::tabLayout(), and QTabBar::tabSizeHint().
| QStyleOptionTab::position |
the position of the tab in the tab bar
The default value is Beginning , i.e. the tab is the first tab in the tab bar.
Definition at line 320 of file qstyleoption.h.
Referenced by QWindowsMobileStylePrivate::drawTabBarTab(), and QTabBar::initStyleOption().
| QStyleOptionTab::row |
which row the tab is currently in
The default value is 0, indicating the front row. Currently this property can only be 0.
Definition at line 319 of file qstyleoption.h.
Referenced by QTabBar::initStyleOption().
| QStyleOptionTab::selectedPosition |
the position of the selected tab in relation to this tab
The default value is NotAdjacent, i.e. the tab is not adjacent to a selected tab nor is it the selected tab.
Definition at line 321 of file qstyleoption.h.
Referenced by QWindowsMobileStylePrivate::drawTabBarTab(), drawTabShape(), and QTabBar::initStyleOption().
| QStyleOptionTab::shape |
the tab shape used to draw the tab; by default QTabBar::RoundedNorth
Definition at line 316 of file qstyleoption.h.
Referenced by QCommonStyle::drawControl(), QMacStyle::drawControl(), QWindowsMobileStylePrivate::drawTabBarTab(), drawTabShape(), QTabBarPrivate::initStyleBaseOption(), QTabBar::initStyleOption(), QCommonStyle::pixelMetric(), QCommonStyle::subElementRect(), QWindowsXPStyle::subElementRect(), and QCommonStylePrivate::tabLayout().
| QStyleOptionTab::text |
the text of the tab
The default value is an empty string.
Definition at line 317 of file qstyleoption.h.
Referenced by QMacStyle::drawControl(), QTabBar::initStyleOption(), and QTabBar::tabSizeHint().