Qt:Документация 4.3.2/qstyleoption

Материал из Wiki.crossplatform.ru

Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Image:trolltech-logo.png

Содержание

[править] QStyleOption Class Reference
[модуль QtGui ]

The QStyleOption class stores the parameters used by QStyle functions. More...

 #include <QStyleOption>

Inherited by QStyleOptionButton, QStyleOptionComplex, QStyleOptionDockWidget, QStyleOptionFocusRect, QStyleOptionFrame, QStyleOptionGraphicsItem, QStyleOptionHeader, QStyleOptionMenuItem, QStyleOptionProgressBar, QStyleOptionQ3DockWindow, QStyleOptionQ3ListViewItem, QStyleOptionRubberBand, QStyleOptionTab, QStyleOptionTabBarBase, QStyleOptionTabWidgetFrame, QStyleOptionToolBar, QStyleOptionToolBox, and QStyleOptionViewItem.

[править] Открытые типы

[править] Открытые функции

[править] Public Variables

[править] Связанные не-члены


[править] Подробное описание

The QStyleOption class stores the parameters used by QStyle functions.

QStyleOption and its subclasses contain all the information that QStyle functions need to draw a graphical element.

For performance reasons, there are few member functions and the access to the member variables is direct (i.e., using the . or -> operator). This low-level feel makes the structures straightforward to use and emphasizes that these are simply parameters used by the style functions.

The caller of a QStyle function usually creates QStyleOption objects on the stack. This combined with Qt's extensive use of implicit sharing for types such as QString, QPalette, and QColor ensures that no memory allocation needlessly takes place.

The following code snippet shows how to use a specific QStyleOption subclass to paint a push button:

 void MyPushButton::paintEvent(QPaintEvent *)
 {
     QStyleOptionButton option;
     option.initFrom(this);
     option.state = isDown() ? QStyle::State_Sunken : QStyle::State_Raised;
     if (isDefault())
         option.features |= QStyleOptionButton::DefaultButton;
     option.text = text();
     option.icon = icon();
 
     QPainter painter(this);
     style()->drawControl(QStyle::CE_PushButton, &amp;option, &amp;painter, this);
 }

In our example, the control is a QStyle::CE_PushButton, and according to the QStyle::drawControl() documentation the corresponding class is QStyleOptionButton.

When reimplementing QStyle functions that take a QStyleOption parameter, you often need to cast the QStyleOption to a subclass. For safety, you can use qstyleoption_cast() to ensure that the pointer type is correct. For example:

 void MyStyle::drawPrimitive(PrimitiveElement element,
                             const QStyleOption *option,
                             QPainter *painter,
                             const QWidget *widget)
 {
     if (element == PE_FrameFocusRect) {
         const QStyleOptionFocusRect *focusRectOption =
                 qstyleoption_cast<const QStyleOptionFocusRect *>(option);
         if (focusRectOption) {
             // ...
         }
     }
     // ...
 }

The qstyleoption_cast() function will return 0 if the object to which option points is not of the correct type.

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

See also QStyle and QStylePainter.


[править] Описание типов членов

[править]
enum QStyleOption::OptionType

This enum 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.


Constant Value Description
QStyleOption::SO_Button 2 QStyleOptionButton
QStyleOption::SO_ComboBox  ? QStyleOptionComboBox
QStyleOption::SO_Complex 0xf0000 QStyleOptionComplex
QStyleOption::SO_Default 0 QStyleOption
QStyleOption::SO_DockWidget 10 QStyleOptionDockWidget
QStyleOption::SO_FocusRect 1 QStyleOptionFocusRect
QStyleOption::SO_Frame 5 QStyleOptionFrame QStyleOptionFrameV2
QStyleOption::SO_GraphicsItem 17 QStyleOptionGraphicsItem
QStyleOption::SO_GroupBox  ? QStyleOptionGroupBox
QStyleOption::SO_Header 8 QStyleOptionHeader
QStyleOption::SO_MenuItem 4 QStyleOptionMenuItem
QStyleOption::SO_ProgressBar 6 QStyleOptionProgressBar QStyleOptionProgressBarV2
QStyleOption::SO_RubberBand 15 QStyleOptionRubberBand
QStyleOption::SO_SizeGrip  ? QStyleOptionSizeGrip
QStyleOption::SO_Slider  ? QStyleOptionSlider
QStyleOption::SO_SpinBox  ? QStyleOptionSpinBox
QStyleOption::SO_Tab 3 QStyleOptionTab
QStyleOption::SO_TabBarBase 14 QStyleOptionTabBarBase
QStyleOption::SO_TabWidgetFrame 13 QStyleOptionTabWidgetFrame
QStyleOption::SO_TitleBar  ? QStyleOptionTitleBar
QStyleOption::SO_ToolBar 16 QStyleOptionToolBar
QStyleOption::SO_ToolBox 7 QStyleOptionToolBox
QStyleOption::SO_ToolButton  ? QStyleOptionToolButton
QStyleOption::SO_ViewItem 12 QStyleOptionViewItem (used in Interviews)

The following values are used for custom controls:


Constant Value Description
QStyleOption::SO_CustomBase 0xf00 Reserved for custom QStyleOptions; all custom controls values must be above this value
QStyleOption::SO_ComplexCustomBase 0xf000000 Reserved for custom QStyleOptions; all custom complex controls values must be above this value

Some style options are defined for various Qt3Support controls:


Constant Value Description
QStyleOption::SO_Q3DockWindow 9 QStyleOptionQ3DockWindow
QStyleOption::SO_Q3ListView  ? QStyleOptionQ3ListView
QStyleOption::SO_Q3ListViewItem 11 QStyleOptionQ3ListViewItem

See also type.

[править]
enum QStyleOption::StyleOptionType

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


Constant Value Description
QStyleOption::Type SO_Default The type of style option provided ( SO_Default for this class).

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.

See also StyleOptionVersion.

[править]
enum QStyleOption::StyleOptionVersion

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


Constant Value Description
QStyleOption::Version 1 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.

See also StyleOptionType.


[править] Описание функций-членов

[править]
QStyleOption::QStyleOption ( int version = QStyleOption::Version, int type = SO_Default )

Constructs a QStyleOption with the specified version and type.

The version has no special meaning for QStyleOption; it can be used by subclasses to distinguish between different version of the same option type.

The state member variable is initialized to QStyle::State_None.

See also version and type.

[править]
QStyleOption::QStyleOption ( const QStyleOption & other )

Constructs a copy of other.

[править]
QStyleOption::~QStyleOption ()

Destroys this style option object.

[править]
void QStyleOption::initFrom ( const QWidget * widget )

Initializes the state, direction, rect, palette, and fontMetrics member variables based on the specified widget.

This is a convenience function; the member variables can also be initialized manually.

This function was introduced in Qt 4.1.

See also QWidget::layoutDirection(), QWidget::rect(), QWidget::palette(), and QWidget::fontMetrics().

[править]
QStyleOption & QStyleOption::operator= ( const QStyleOption & other )

Assign other to this QStyleOption.


[править] Member Variable Documentation

[править]
Qt::LayoutDirection QStyleOption::direction

This variable holds the text layout direction that should be used when drawing text in the control.

By default, the layout direction is Qt::LeftToRight.

See also initFrom().

[править]
QFontMetrics QStyleOption::fontMetrics

This variable holds the font metrics that should be used when drawing text in the control.

By default, the application's default font is used.

See also initFrom().

[править]
QPalette QStyleOption::palette

This variable holds the palette that should be used when painting the control.

By default, the application's default palette is used.

See also initFrom().

[править]
QRect QStyleOption::rect

This variable holds the area that should be used for various calculations and painting.

This can have different meanings for different types of elements. For example, for a QStyle::CE_PushButton element it would be the rectangle for the entire button, while for a QStyle::CE_PushButtonLabel element it would be just the area for the push button label.

The default value is a null rectangle, i.e. a rectangle with both the width and the height set to 0.

See also initFrom().

[править]
QStyle::State QStyleOption::state

This variable holds the style flags that are used when drawing the control.

The default value is QStyle::State_None.

See also initFrom(), QStyle::drawPrimitive(), QStyle::drawControl(), QStyle::drawComplexControl(), and QStyle::State.

[править]
int QStyleOption::type

This variable holds the option type of the style option.

The default value is SO_Default.

See also OptionType.

[править]
int QStyleOption::version

This variable holds the version of the style option.

This value can be used by subclasses to implement extensions without breaking compatibility. If you use the qstyleoption_cast() function, you normally don't need to check it.

The default value is 1.


[править] Связанные не-члены

[править]
T qstyleoption_cast ( const QStyleOption * option )

Returns a T or 0 depending on the type and version of the given option.

Example:

 void MyStyle::drawPrimitive(PrimitiveElement element,
                             const QStyleOption *option,
                             QPainter *painter,
                             const QWidget *widget)
 {
     if (element == PE_FrameFocusRect) {
         const QStyleOptionFocusRect *focusRectOption =
                 qstyleoption_cast<const QStyleOptionFocusRect *>(option);
         if (focusRectOption) {
             // ...
         }
     }
     // ...
 }

See also QStyleOption::type and QStyleOption::version.

[править]
T qstyleoption_cast ( QStyleOption * option )

This is an overloaded member function, provided for convenience.

Returns a T or 0 depending on the type of the given option.


Copyright © 2007 Trolltech Trademarks
Qt 4.3.2