Qt 4.8
Public Types | Public Functions | Public Variables | Protected Functions | List of all members
QStyleOptionTabV2 Class Reference

The QStyleOptionTabV2 class is used to describe the parameters necessary for drawing a tabs in Qt 4.1 or above. More...

#include <qstyleoption.h>

Inheritance diagram for QStyleOptionTabV2:
QStyleOptionTab QStyleOption QStyleOptionTabV3

Public Types

enum  StyleOptionVersion { Version = 2 }
 This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...
 
- Public Types inherited from QStyleOptionTab
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

QStyleOptionTabV2operator= (const QStyleOptionTab &other)
 Assigns the other style option to this QStyleOptionTabV2. More...
 
 QStyleOptionTabV2 ()
 Constructs a QStyleOptionTabV2. More...
 
 QStyleOptionTabV2 (const QStyleOptionTabV2 &other)
 Constructs a copy of the other style option. More...
 
 QStyleOptionTabV2 (const QStyleOptionTab &other)
 Constructs a QStyleOptionTabV2 copy of the other style option which can be either of the QStyleOptionTabV2 or QStyleOptionTab types. More...
 
- Public Functions inherited from QStyleOptionTab
 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)
 
QStyleOptionoperator= (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

QSize iconSize
 the size for the icons More...
 
- Public Variables inherited from QStyleOptionTab
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

 QStyleOptionTabV2 (int version)
 
- Protected Functions inherited from QStyleOptionTab
 QStyleOptionTab (int version)
 

Additional Inherited Members

Detailed Description

The QStyleOptionTabV2 class is used to describe the parameters necessary for drawing a tabs in Qt 4.1 or above.

Since
4.1

An instance of the QStyleOptionTabV2 class has type SO_Tab and version 2. 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. One way to achieve this is to use the QStyleOptionTabV2 copy constructor. For example:

if (const QStyleOptionTab *tabOption =
qstyleoption_cast<const QStyleOptionTab *>(option)) {
QStyleOptionTabV2 tabV2(*tabOption);
// draw the tab using tabV2
}

In the example above: If tabOption's version is 1, the extra member (iconSize ) will be set to an invalid size for tabV2. If tabOption's version is 2, the constructor will simply copy the tab's iconSize.

For an example demonstrating how style options can be used, see the widgets/styles{Styles} example.

See also
QStyleOptionTab, QStyleOption

Definition at line 333 of file qstyleoption.h.

Enumerations

◆ StyleOptionVersion

This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass.

  • Version 2

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.

See also
StyleOptionType
Enumerator
Version 

Definition at line 336 of file qstyleoption.h.

Constructors and Destructors

◆ QStyleOptionTabV2() [1/4]

QStyleOptionTabV2::QStyleOptionTabV2 ( )

Constructs a QStyleOptionTabV2.

Definition at line 2371 of file qstyleoption.cpp.

2373 {
2374 }
QStyleOptionTab()
Constructs a QStyleOptionTab object, initializing the members variables to their default values...

◆ QStyleOptionTabV2() [2/4]

QStyleOptionTabV2::QStyleOptionTabV2 ( const QStyleOptionTabV2 other)
inline

Constructs a copy of the other style option.

Definition at line 339 of file qstyleoption.h.

339 : QStyleOptionTab(Version) { *this = other; }
QStyleOptionTab()
Constructs a QStyleOptionTab object, initializing the members variables to their default values...

◆ QStyleOptionTabV2() [3/4]

QStyleOptionTabV2::QStyleOptionTabV2 ( const QStyleOptionTab other)

Constructs a QStyleOptionTabV2 copy of the other style option which can be either of the QStyleOptionTabV2 or QStyleOptionTab types.

If the other style option's version is 1, the new style option's iconSize is set to an invalid value. If its version is 2, its iconSize value is simply copied to the new style option.

Definition at line 2402 of file qstyleoption.cpp.

2404 {
2405  if (const QStyleOptionTabV2 *tab = qstyleoption_cast<const QStyleOptionTabV2 *>(&other)) {
2406  *this = *tab;
2407  } else {
2408  *((QStyleOptionTab *)this) = other;
2409  version = Version;
2410  }
2411 }
int version
the version of the style option
Definition: qstyleoption.h:86
The QStyleOptionTabV2 class is used to describe the parameters necessary for drawing a tabs in Qt 4...
Definition: qstyleoption.h:333
QStyleOptionTab()
Constructs a QStyleOptionTab object, initializing the members variables to their default values...
The QStyleOptionTab class is used to describe the parameters for drawing a tab bar.
Definition: qstyleoption.h:304

◆ QStyleOptionTabV2() [4/4]

QStyleOptionTabV2::QStyleOptionTabV2 ( int  version)
protected
Warning
This function is not part of the public interface.

Definition at line 2379 of file qstyleoption.cpp.

2381 {
2382 }
int version
the version of the style option
Definition: qstyleoption.h:86
QStyleOptionTab()
Constructs a QStyleOptionTab object, initializing the members variables to their default values...

Functions

◆ operator=()

QStyleOptionTabV2 & QStyleOptionTabV2::operator= ( const QStyleOptionTab other)

Assigns the other style option to this QStyleOptionTabV2.

The other style option can be either of the QStyleOptionTabV2 or QStyleOptionTab types.

If the other style option's version is 1, this style option's iconSize is set to an invalid size. If its version is 2, its iconSize value is simply copied to this style option.

Definition at line 2422 of file qstyleoption.cpp.

Referenced by QStyleOptionTabV3::operator=(), and QStyleOptionTabV3::QStyleOptionTabV3().

2423 {
2425 
2426  if (const QStyleOptionTabV2 *tab = qstyleoption_cast<const QStyleOptionTabV2 *>(&other))
2427  iconSize = tab->iconSize;
2428  else
2429  iconSize = QSize();
2430  return *this;
2431 }
The QStyleOptionTabV2 class is used to describe the parameters necessary for drawing a tabs in Qt 4...
Definition: qstyleoption.h:333
QStyleOption & operator=(const QStyleOption &other)
Assign other to this QStyleOption.
QSize iconSize
the size for the icons
Definition: qstyleoption.h:337
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53

Properties

◆ iconSize

QStyleOptionTabV2::iconSize

the size for the icons

The default value is QSize(-1, -1), i.e. an invalid size; use QStyle::pixelMetric() to find the default icon size for tab bars.

See also
QTabBar::iconSize()

Definition at line 337 of file qstyleoption.h.

Referenced by QCommonStyle::drawControl(), operator=(), QCommonStylePrivate::tabLayout(), and QTabBar::tabSizeHint().


The documentation for this class was generated from the following files: