Класс QStyleOption

Класс QStyleOption хранит параметры, используемые функциями QStyle. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Публичные типы

Публичные функции

Публичные переменные

Связанные нечлены

Подробное описание

Класс QStyleOption хранит параметры, используемые функциями QStyle.

QStyleOption и его подклассы содержат всю информацию, необходимую функциям QStyle для отрисовки графического элемента.

По соображениям производительности, в нём мало функций-членов, и доступ к переменным-членам осуществляется напрямую (т. е. с помощью оператора . или ->). Этот низкоуровневый стиль делает структуры простыми в использовании и подчеркивает, что это просто параметры, используемые функциями стиля.

Вызывающий функцию QStyle обычно создаёт объекты QStyleOption в стеке. Это в сочетании с широким использованием Qt неявного совместного использования для типов, таких как QString, QPalette и QColor, гарантирует, что нет необходимости в выделении памяти.

Следующий фрагмент кода демонстрирует, как использовать конкретный подкласс QStyleOption для отрисовки кнопки:

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);
}

В нашем примере элемент управления является QStyle::CE_PushButton, и, согласно документации QStyle::drawControl(), соответствующим классом является QStyleOptionButton.

При реализации функций QStyle, принимающих параметр QStyleOption, часто необходимо привести QStyleOption к подклассу. Для безопасности можно использовать qstyleoption_cast(), чтобы убедиться, что тип указателя правильный. Например:

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

Функция qstyleoption_cast() вернёт 0, если объект, на который option указывает, не является нужного типа.

Пример использования стилей см. в примере Styles.

См. также QStyle и QStylePainter.

Документация по типам членов

перечисление QStyleOption::OptionType

Это перечисление используется внутри класса QStyleOption, его подклассов и функции qstyleoption_cast() для определения типа опции стиля. Как правило, вам об этом не нужно беспокоиться, если вы не хотите создать собственный подкласс QStyleOption и свои собственные стили.

Следующие значения используются для пользовательских элементов управления:

См. также тип.

перечисление QStyleOption::StyleOptionType

Это перечисление используется для хранения информации о типе параметра стиля и определено для каждого подкласса QStyleOption.

Тип используется внутри QStyleOption, его подклассов и qstyleoption_cast() для определения типа параметра стиля. Как правило, вам не нужно беспокоиться об этом, если вы не хотите создать свой собственный подкласс QStyleOption и свои собственные стили.

См. также StyleOptionVersion.

перечисление QStyleOption::StyleOptionVersion

Это перечисление используется для хранения информации о версии параметра стиля и определено для каждого подкласса QStyleOption.

Версия используется подклассами QStyleOption для реализации расширений без нарушения совместимости. Если вы используете qstyleoption_cast(), вам обычно не нужно его проверять.

См. также StyleOptionType.

Документация по функциям-членам

QStyleOption::QStyleOption(int version = QStyleOption::Version, int type = SO_Default)

Создаёт QStyleOption со специфицированной version и type.

Версия не имеет специального значения для QStyleOption; она может использоваться подклассами для различения различных версий одного и того же типа параметра.

Переменная-член state инициализируется значением QStyle::State_None.

См. также version и type.

QStyleOption::QStyleOption(const QStyleOption &other)

Создаёт копию other.

QStyleOption::~QStyleOption()

Удаляет этот объект параметра стиля.

void QStyleOption::initFrom(const QWidget *widget)

Инициализирует переменные-члены state, direction, rect, palette, fontMetrics и styleObject на основе указанного widget.

Это удобная функция; переменные-члены также можно инициализировать вручную.

Функция была введена в Qt 4.1.

См. также QWidget::layoutDirection(), QWidget::rect(), QWidget::palette(), и QWidget::fontMetrics().

QStyleOption &QStyleOption::operator=(const QStyleOption &other)

Присваивает other этому QStyleOption.

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