Класс 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.

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

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

См. также 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) {
            // ...
        }
    }
    // ...
}