QStyleOption Class

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, &option, &painter, this);
}

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) {
            // ...
        }
    }
    // ...
}

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.

QObject *QStyleOption::styleObject

This variable holds the object being styled

The built-in styles support the following types: QWidget, QGraphicsObject and QQuickItem.

See also initFrom().

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 do not need to check it.

The default value is 1.

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) {
            // ...
        }
    }
    // ...
}