Класс QStyleOption

Класс 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(const QStyleOption &other)

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

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

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

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

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

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

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

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

QStyleOption::~QStyleOption()

Уничтожает объект стиля.

void QStyleOption::initFrom(const QWidget *widget)

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

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

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

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