Класс 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) {
            // ...
        }
    }
    // ...
}