Класс QStyle

Класс QStyle — это абстрактный базовый класс, который инкапсулирует внешний вид и ощущения графического интерфейса пользователя. Подробнее...

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

Открытые типы

Открытые функции

Статические публичные члены

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

Qt содержит набор подклассов QStyle, которые эмулируют стили различных платформ, поддерживаемых Qt (QWindowsStyle, QMacStyle и т. д.). По умолчанию эти стили встроенны в модуль Qt GUI. Также стили могут быть доступны как плагины.

Встроенные виджеты Qt используют QStyle для практически всех операций отрисовки, гарантируя, что они выглядят точно так же, как эквивалентные нативные виджеты. На диаграмме ниже показан QComboBox в девяти различных стилях.

Темы:

Установка стиля

Стиль всего приложения можно установить, используя функцию QApplication::setStyle(). Также его можно указать пользователю приложения с помощью параметра командной строки -style:

./myapplication -style windows

Если стиль не указан, Qt выберет наиболее подходящий стиль для платформы или среды рабочего стола пользователя.

Стиль также можно установить для отдельного виджета, используя функцию QWidget::setStyle().

Разработка виджетов с поддержкой стиля

Если вы разрабатываете пользовательские виджеты и хотите, чтобы они выглядели хорошо на всех платформах, вы можете использовать функции QStyle для выполнения части отрисовки виджета, такие как drawItemText(), drawItemPixmap(), drawPrimitive(), drawControl() и drawComplexControl().

Большинство функций отрисовки QStyle принимают четыре аргумента:

• значение перечисления, указывающее, какой графический элемент нужно нарисовать
• QStyleOption, определяющий, как и где нужно отобразить этот элемент
• QPainter, который должен использоваться для отрисовки элемента
• QWidget, на котором выполняется отрисовка (необязательно)

Например, если вы хотите нарисовать прямоугольник фокуса на своём виджете, вы можете написать:

void MyWidget::paintEvent(QPaintEvent * /* event */)
{
    QPainter painter(this);

    QStyleOptionFocusRect option;
    option.initFrom(this);
    option.backgroundColor = palette().color(QPalette::Background);

    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}

QStyle получает всю необходимую информацию для отрисовки графического элемента из QStyleOption. Виджет передаётся в качестве последнего аргумента, в случае, если стилю нужно выполнить специальные эффекты (например, анимированные кнопки по умолчанию на macOS), но это необязательно. Фактически, вы можете использовать QStyle для отрисовки на любом устройстве рисования, а не только на виджетах, правильно установив QPainter.

QStyleOption имеет различные подклассы для разных типов графических элементов, которые можно рисовать. Например, PE_FrameFocusRect ожидает аргумент QStyleOptionFocusRect.

Для того чтобы операции рисования были максимально быстрыми, QStyleOption и его подклассы имеют открытые члены данных. Подробные сведения о том, как их использовать, см. в документации класса QStyleOption.

Для удобства Qt предоставляет класс QStylePainter, который объединяет QStyle, QPainter и QWidget. Это позволяет писать

    QStylePainter painter(this);
    ...
    painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);

вместо

    QPainter painter(this);
    ...
    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);

Создание пользовательской темы

Вы можете создать пользовательский вид и ощущения для вашего приложения, создав пользовательскую тему. Существует два подхода к созданию пользовательской темы. В статическом подходе вы либо выбираете существующий класс QStyle, наследуете от него и переопределяете виртуальные функции для предоставления пользовательского поведения, либо создаёте класс QStyle с нуля. В динамическом подходе вы изменяете поведение системной темы во время выполнения. Статический подход описан ниже. Динамический подход описан в QProxyStyle.

Первый шаг в статическом подходе — выбрать одну из тем, предоставляемых Qt, на основе которой вы будете создавать свою пользовательскую тему. Ваш выбор класса QStyle будет зависеть от того, какая тема наиболее похожа на желаемую. Самый общий класс, который можно использовать в качестве базового, — QCommonStyle (а не QStyle). Это связано с тем, что Qt требует, чтобы его темы были QCommonStyle.

В зависимости от тех частей базовой темы, которые вы хотите изменить, вам необходимо переопределить функции, которые используются для рисования этих частей интерфейса. Для иллюстрации этого мы изменим вид стрелок поля ввода, нарисованных QWindowsStyle. Стрелки являются примитивными элементами, которые рисуются функцией drawPrimitive(), поэтому нам нужно переопределить эту функцию. Нам нужна следующая декларация класса:

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

public:
    CustomStyle(const QWidget *widget);
    ~CustomStyle() {}

    void drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                       QPainter *painter, const QWidget *widget) const override;
};

Для рисования стрелок вверх и вниз QSpinBox использует примитивные элементы PE_IndicatorSpinUp и PE_IndicatorSpinDown. Вот как переопределить функцию drawPrimitive() для их рисования по-другому:

void CustomStyle::drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                                QPainter *painter, const QWidget *widget) const
{
    if (element == PE_IndicatorSpinUp || element == PE_IndicatorSpinDown) {
        QPolygon points(3);
        int x = option->rect.x();
        int y = option->rect.y();
        int w = option->rect.width() / 2;
        int h = option->rect.height() / 2;
        x += (option->rect.width() - w) / 2;
        y += (option->rect.height() - h) / 2;

        if (element == PE_IndicatorSpinUp) {
            points[0] = QPoint(x, y + h);
            points[1] = QPoint(x + w, y + h);
            points[2] = QPoint(x + w / 2, y);
        } else { // PE_SpinBoxDown
            points[0] = QPoint(x, y);
            points[1] = QPoint(x + w, y);
            points[2] = QPoint(x + w / 2, y + h);
        }

        if (option->state & State_Enabled) {
            painter->setPen(option->palette.mid().color());
            painter->setBrush(option->palette.buttonText());
        } else {
            painter->setPen(option->palette.buttonText().color());
            painter->setBrush(option->palette.mid());
        }
        painter->drawPolygon(points);
    } else {
    QProxyStyle::drawPrimitive(element, option, painter, widget);
    }
}

Обратите внимание, что мы не используем аргумент widget, за исключением передачи его функции QWindowStyle::drawPrimitive(). Как уже упоминалось ранее, информация о том, что должно быть нарисовано и как оно должно быть нарисовано, задаётся объектом QStyleOption, поэтому нет необходимости обращаться к виджету.

Если вам нужно использовать аргумент widget для получения дополнительной информации, будьте внимательны, чтобы убедиться, что он не равен 0 и что он имеет правильный тип перед использованием. Например:

    const QSpinBox *spinBox = qobject_cast<const QSpinBox *>(widget);
    if (spinBox) {
    ...
    }

При реализации пользовательской темы нельзя предполагать, что виджет является QSpinBox только потому, что значение перечисления называется PE_IndicatorSpinUp или PE_IndicatorSpinDown.

Документация для примера Темы более подробно освещает эту тему.

Использование пользовательской темы

Существует несколько способов использования пользовательской темы в приложении Qt. Самый простой способ — передать пользовательскую тему статической функции QApplication::setStyle() до создания объекта QApplication:

#include <QtWidgets>

#include "customstyle.h"

int main(int argc, char *argv[])
{
    QApplication::setStyle(new CustomStyle);
    QApplication app(argc, argv);
    QSpinBox spinBox;
    spinBox.show();
    return app.exec();
}

Вы можете вызвать QApplication::setStyle() в любое время, но вызывая её до конструктора, вы гарантируете, что будут учтены предпочтения пользователя, установленные с помощью -style командной строки.

Возможно, вы захотите сделать свою пользовательскую тему доступной для использования в других приложениях, которые могут не быть вашими, а значит, не доступны для перекомпиляции. Система плагинов Qt позволяет создавать темы как плагины. Темы, созданные как плагины, загружаются как общие объекты во время выполнения самим Qt. Обратитесь к документации Плагина Qt для получения дополнительной информации о создании плагина темы.

Скомпилируйте свой плагин и поместите его в каталог plugins/styles Qt. У нас теперь есть подключаемая тема, которую Qt может загрузить автоматически. Чтобы использовать новую тему с существующими приложениями, просто запустите приложение со следующим аргументом:

./myapplication -style custom

Приложение будет использовать вид и ощущения от реализованной вами пользовательской темы.

Рабочие столы с правосторонним расположением

Языки, написанные справа налево (такие как арабский и иврит), обычно также отображают всю структуру виджетов и требуют, чтобы свет исходил из верхнего правого угла экрана, а не из верхнего левого.

Если вы создаёте пользовательскую тему, следует уделить особое внимание при рисовании асимметричных элементов, чтобы они также выглядели корректно в зеркальном макете. Простой способ проверить ваши темы — запустить приложения с -reverse аргументом командной строки или вызвать QApplication::setLayoutDirection() в вашей main() функции.

Вот несколько моментов, которые следует учитывать при создании темы, которая будет хорошо работать в правостороннем окружении:

• subControlRect() и subElementRect() возвращают прямоугольники в координатах экрана
• QStyleOption::direction указывает, в каком направлении элемент должен быть нарисован
• Если тема не учитывает правостороннее расположение, она будет отображать элементы так, как будто это левостороннее расположение
• visualRect(), visualPos() и visualAlignment() являются полезными функциями, которые преобразуют логическое представление в экранное.
• alignedRect() вернёт логический прямоугольник, выровненный для текущего направления

Темы в представлениях элементов

Рисование элементов в представлениях выполняется делегатом. По умолчанию Qt использует делегат QStyledItemDelegate, который также используется для расчёта границ элементов и их подэлементов для различных видов ролей данных элементов ItemDataRole, поддерживаемых QStyledItemDelegate. См. описание класса QStyledItemDelegate, чтобы узнать, какие типы данных и роли поддерживаются. Более подробно о ролях данных элементов см. в разделе Моделирование/Представление.

Когда QStyledItemDelegate рисует свои элементы, он рисует CE_ItemViewItem и рассчитывает их размер с помощью CT_ItemViewItem. Также обратите внимание, что он использует SE_ItemViewItemText для установки размера редакторов. При реализации темы для настройки рисования представлений элементов вам необходимо проверить реализацию QCommonStyle (и любых других подклассов, от которых наследуется ваша тема). Таким образом, вы узнаете, какие и как рисуются другие элементы темы, и тогда вы можете переопределить рисование элементов, которые должны быть нарисованы по-другому.

Мы включаем небольшой пример, где мы настраиваем рисование фонов элементов.

    switch (element) {
        case (PE_PanelItemViewItem): {
            painter->save();

            QPoint topLeft = option->rect.topLeft();
            QPoint bottomRight = option->rect.topRight();
            QLinearGradient backgroundGradient(topLeft, bottomRight);
            backgroundGradient.setColorAt(0.0, QColor(Qt::yellow).lighter(190));
            backgroundGradient.setColorAt(1.0, Qt::white);
            painter->fillRect(option->rect, QBrush(backgroundGradient));

            painter->restore();
        break;
        }
        default:
            QProxyStyle::drawPrimitive(element, option, painter, widget);
    }

Примитивный элемент PE_PanelItemViewItem отвечает за рисование фона элементов и вызывается из реализации QCommonStyle для CE_ItemViewItem.

Для добавления поддержки рисования новых типов данных и ролей данных элементов необходимо создать пользовательский делегат. Но если вам нужно поддерживать только типы данных, реализованные стандартным делегатом, для пользовательской темы не требуется сопровождающий делегат. В описании класса QStyledItemDelegate есть дополнительная информация о пользовательских делегатах.

Рисование заголовков представления элементов также выполняется темой, предоставляя управление размером элементов заголовка и размерами строк и столбцов.

См. также QStyleOption, QStylePainter, Пример тем, Темы и темы-осознающие виджеты, QStyledItemDelegate и Стиль.

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

перечисление QStyle::ComplexControl

Это перечисление описывает доступные сложные элементы управления. Сложные элементы управления ведут себя по-разному в зависимости от того, где пользователь нажимает или какие клавиши нажаты.

См. также SubControl и drawComplexControl().

перечисление QStyle::ContentsType

Это перечисление описывает доступные типы содержимого. Они используются для вычисления размеров содержимого различных виджетов.

См. также sizeFromContents().

перечисление QStyle::ControlElement

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

См. также drawControl().

Перечисление QStyle::PixelMetric

Это перечисление описывает различные доступные пиксельные метрики. Пиксельная метрика — это зависимая от стиля величина размера, представленная одним пиксельным значением.

См. также pixelMetric().

перечисление QStyle::PrimitiveElement

Это перечисление описывает различные примитивные элементы. Примитивный элемент — это общий элемент пользовательского интерфейса, такой как индикатор флажка или скос кнопки.

См. также drawPrimitive().

enum QStyle::RequestSoftwareInputPanel

Этот перечисление описывает условия, при которых виджет, поддерживающий ввод, запросит программную панель ввода.

См. также QInputMethod.

enum QStyle::StandardPixmap

Это перечисление описывает доступные стандартные пиктограммы. Стандартная пиктограмма — это пиктограмма, которая может следовать существующему стилю или руководству GUI.

См. также standardIcon().

enum QStyle::StateFlagflags QStyle::State

Этот перечисление описывает флаги, используемые при рисовании примитивных элементов.

Обратите внимание, что не все примитивы используют все эти флаги, и что флаги могут иметь разное значение для различных элементов.

Тип State является псевдонимом для QFlags<StateFlag>. Он хранит комбинацию значений StateFlag, соединённых операцией OR.

См. также drawPrimitive().

enum QStyle::StyleHint

Это перечисление описывает доступные подсказки стиля. Подсказка стиля — это общая подсказка по внешнему виду и/или стилю.

См. также styleHint().

enum QStyle::SubControlflags QStyle::SubControls

Это перечисление описывает доступные подэлементы управления. Подэлемент управления — это элемент управления внутри сложного элемента управления (ComplexControl).

Тип SubControls — это псевдоним для QFlags<SubControl>. Он хранит логическое ИЛИ сочетание значений SubControl.

См. также ComplexControl.

Перечисление QStyle::SubElement

Это перечисление представляет собой подобласть виджета. Реализации стилей используют эти области для рисования различных частей виджета.

См. также subElementRect().

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

QStyle::QStyle()

Создает объект стиля.

[virtual] QStyle::~QStyle()

Удаляет объект стиля.

[static] QRect QStyle::alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)

Возвращает новый прямоугольник заданного размера size, выровненный относительно заданного прямоугольника rectangle в соответствии с заданным выравниванием alignment и направлением direction.

int QStyle::combinedLayoutSpacing(QSizePolicy::ControlTypes controls1, QSizePolicy::ControlTypes controls2, Qt::Orientation orientation, QStyleOption *option = nullptr, QWidget *widget = nullptr) const

Возвращает отступ, который следует использовать между элементами управления controls1 и controls2 в макете. orientation указывает, расположены ли элементы управления рядом или друг под другом. Параметр option может быть использован для передачи дополнительной информации о родительском виджете. Параметр widget является необязательным и также может быть использован, если option nullptr.

controls1 и controls2 — это битовое ИЛИ-соединение нуля или более типов элементов управления.

Эта функция вызывается системой макета. Она используется только в том случае, если PM_LayoutHorizontalSpacing или PM_LayoutVerticalSpacing возвращают отрицательное значение.

См. также layoutSpacing().

[pure virtual] void QStyle::drawComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = nullptr) const

Рисует заданный элемент управления control с помощью указанного painter со стилистическими параметрами, заданными в option.

Аргумент widget является необязательным и может быть использован как помощь при рисовании элемента управления.

Параметр option — указатель на объект QStyleOptionComplex, который можно привести к соответствующему подклассу с помощью функции qstyleoption_cast(). Обратите внимание, что член rect указанного option должен быть в логических координатах. При переопределении этой функции следует использовать visualRect() для преобразования логических координат в экранные координаты перед вызовом функции drawPrimitive() или drawControl().

В таблице ниже перечислены сложные элементы управления и соответствующие подклассы стилистических опций. Стилистические опции содержат все параметры, необходимые для рисования элементов управления, включая QStyleOption::state, который содержит флаги стиля, используемые при рисовании. Таблица также описывает флаги, которые устанавливаются при приведении указанного option к соответствующему подклассу.

См. также drawPrimitive() и drawControl().

[pure virtual] void QStyle::drawControl(QStyle::ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

Рисует заданный элемент управления element с помощью указанного painter со стилистическими параметрами, заданными в option.

Аргумент widget является необязательным и может быть использован как помощь при рисовании элемента управления. Параметр option — указатель на объект QStyleOption, который можно привести к соответствующему подклассу с помощью функции qstyleoption_cast().

В таблице ниже перечислены элементы управления и соответствующие подклассы стилистических опций. Стилистические опции содержат все параметры, необходимые для рисования элементов управления, включая QStyleOption::state, который содержит флаги стиля, используемые при рисовании. Таблица также описывает флаги, которые устанавливаются при приведении указанного option к соответствующему подклассу.

Обратите внимание, что если элемент управления не указан в таблице, то он использует обычный объект QStyleOption.

См. также drawPrimitive() и drawComplexControl().

[virtual] void QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Отрисовывает заданный pixmap в указанном rectangle в соответствии с заданным alignment с помощью предоставленного painter.

См. также drawItemText().

[virtual] void QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const

Отрисовывает заданный text в указанном rectangle с помощью предоставленного painter и palette.

Текст отрисовывается с помощью пера painter и выравнивается и обрезается в соответствии с заданным alignment. Если задан явный textRole, текст отрисовывается с использованием цвета palette для заданной роли. Параметр enabled указывает, активирован ли элемент или нет; при переопределении этой функции параметр enabled должен влиять на способ отрисовки элемента.

См. также Qt::Alignment и drawItemPixmap().

[pure virtual] void QStyle::drawPrimitive(QStyle::PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

Отрисовывает заданный примитивный элемент element с помощью предоставленного painter, используя параметры стиля, указанные в option.

Аргумент widget является необязательным и может содержать виджет, который может помочь в отрисовке примитивного элемента.

В таблице ниже перечислены примитивные элементы и соответствующие подклассы опций стиля. Опции стиля содержат все параметры, необходимые для отрисовки элементов, включая QStyleOption::state, который содержит флаги стиля, используемые при отрисовке. В таблице также описываются флаги, которые устанавливаются при приведении заданной опции к соответствующему подклассу.

Обратите внимание, что если примитивный элемент здесь не указан, это потому, что он использует обычный объект QStyleOption.

См. также drawComplexControl() и drawControl().

[pure virtual] QPixmap QStyle::generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *option) const

Возвращает копию заданной pixmap, стилизованной в соответствии с указанным iconMode и с учетом палитры, заданной option.

Параметр option может передавать дополнительную информацию, но он должен содержать палитру.

Обратите внимание, что не все изображения будут соответствовать стилю, в этом случае возвращаемое изображение является простой копией.

См. также QIcon.

[pure virtual] QStyle::SubControl QStyle::hitTestComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = nullptr) const

Возвращает подконтроль в указанной position в указанном сложном control (со стилями, указанными в option).

Обратите внимание, что position выражается в координатах экрана.

Аргумент option — указатель на объект QStyleOptionComplex (или один из его подклассов). Объект можно привести к нужному типу, используя функцию qstyleoption_cast(). См. drawComplexControl() для получения подробностей. Аргумент widget необязателен и может содержать дополнительную информацию для функции.

См. также drawComplexControl() и subControlRect().

[virtual] QRect QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Возвращает область внутри заданного rectangle, в которой следует нарисовать указанное pixmap в соответствии с определенным alignment.

[virtual] QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const

Возвращает область внутри заданного rectangle, в которой необходимо нарисовать предоставленный text в соответствии с указанным metrics и alignment. Параметр enabled указывает, включен ли соответствующий элемент.

Если заданный rectangle больше, чем необходимо для рендеринга text, возвращаемый прямоугольник будет смещен внутри rectangle в соответствии с указанным alignment. Например, если alignment равен Qt::AlignCenter, возвращаемый прямоугольник будет центрирован внутри rectangle. Если заданный rectangle меньше, чем необходимо, возвращаемый прямоугольник будет самым маленьким прямоугольником, достаточно большим для рендеринга text.

См. также Qt::Alignment.

[pure virtual] int QStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Возвращает интервал, который следует использовать между control1 и control2 в макете. orientation указывает, выстроены ли элементы управления бок о бок или вертикально. Параметр option может использоваться для передачи дополнительной информации о родительском виджете. Параметр widget необязателен и также может использоваться, если option nullptr.

Эта функция вызывается системой макета. Она используется только в том случае, если PM_LayoutHorizontalSpacing или PM_LayoutVerticalSpacing возвращает отрицательное значение.

См. также combinedLayoutSpacing().

[since 6.1] QString QStyle::name() const

Возвращает имя стиля.

Это значение можно использовать для создания стиля с помощью QStyleFactory::create().

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

См. также QStyleFactory::create().

[pure virtual] int QStyle::pixelMetric(QStyle::PixelMetric metric, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Возвращает значение заданного пиксельного metric.

Указанные option и widget могут использоваться для вычисления метрики. Как правило, аргумент widget не используется. option можно привести к нужному типу, используя функцию qstyleoption_cast(). Обратите внимание, что option может быть нулевым даже для PixelMetrics, которые могут его использовать. В таблице ниже приведены соответствующие преобразования option:

Некоторые метрики пикселей вызываются виджетами, а некоторые только внутренне стилем. Если метрика не вызывается виджетом, автору стиля предоставляется право использовать её. В некоторых стилях это может быть неуместно.

[virtual] void QStyle::polish(QWidget *widget)

Инициализирует вид данного widget.

Эта функция вызывается для каждого виджета в какой-то момент после его полного создания, но непосредственно перед его первым отображением.

Обратите внимание, что реализация по умолчанию ничего не делает. Разумные действия в этой функции могут заключаться в вызове функции QWidget::setBackgroundMode() для виджета. Не используйте функцию для установки, например, геометрии. Переопределение этой функции предоставляет «заднюю дверь», через которую можно изменить внешний вид виджета, но с движком стилей Qt это редко необходимо; вместо этого переопределите drawItemPixmap(), drawItemText(), drawPrimitive() и т.д.

Функция QWidget::inherits() может предоставить достаточно информации, чтобы позволить настраивать вид класса. Но поскольку ожидается, что новые подклассы QStyle будут работать должным образом со всеми текущими и будущими виджетами, рекомендуется ограничить использование жёстко заданной настройки.

См. также unpolish().

[virtual] void QStyle::polish(QApplication *application)

Это перегруженная функция.

Поздняя инициализация данного объекта application.

[virtual] void QStyle::polish(QPalette &palette)

Это перегруженная функция.

Изменяет palette в соответствии со специфическими требованиями стиля к цветовым палитрам (если таковые имеются).

См. также QPalette и QApplication::setPalette().

const QStyle *QStyle::proxy() const

Эта функция возвращает текущего прокси для данного стиля. По умолчанию большинство стилей вернут себя. Однако при использовании прокси-стиля он позволит стилю вызвать обратный прокси.

[pure virtual] QSize QStyle::sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = nullptr) const

Возвращает размер элемента, описанного указанным option и type, на основе предоставленного contentsSize.

Аргумент option — указатель на QStyleOption или один из его подклассов. option можно привести к соответствующему типу, используя функцию qstyleoption_cast(). Аргумент widget — необязательный аргумент и может содержать дополнительную информацию, используемую для вычисления размера.

Смотрите таблицу ниже для соответствующих преобразований option:

См. также ContentsType и QStyleOption.

[static] int QStyle::sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown = false)

Преобразует заданное logicalValue в позицию в пикселях. Параметр min сопоставляется с 0, max сопоставляется с span, а другие значения распределяются равномерно между ними.

Эта функция может обрабатывать весь диапазон целых чисел без переполнения, при условии, что span меньше 4096.

По умолчанию эта функция предполагает, что максимальное значение находится справа для горизонтальных элементов и внизу для вертикальных элементов. Установите параметр upsideDown в значение true, чтобы изменить это поведение.

См. также sliderValueFromPosition().

[static] int QStyle::sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown = false)

Преобразует заданную позицию в пикселях position в логическое значение. 0 сопоставляется с параметром min, span сопоставляется с max, а другие значения распределяются равномерно между ними.

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

По умолчанию эта функция предполагает, что максимальное значение находится справа для горизонтальных элементов и внизу для вертикальных элементов. Установите параметр upsideDown в значение true, чтобы изменить это поведение.

См. также sliderPositionFromValue().

[pure virtual] QIcon QStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Возвращает значок для данного standardIcon.

standardIcon — это стандартное пиктографическое изображение, которое может следовать определённому стилю или руководству пользовательского интерфейса. Аргумент option может быть использован для передачи дополнительной информации, необходимой при определении соответствующей иконки. Аргумент widget необязателен и также может быть использован для определения иконки.

[virtual] QPalette QStyle::standardPalette() const

Возвращает стандартную палитру стиля.

Обратите внимание, что на системах, поддерживающих системные цвета, стандартная палитра стиля не используется. В частности, стили Windows Vista и Mac не используют стандартную палитру, а используют собственные движки темы. При использовании этих стилей вы не должны устанавливать палитру с помощью QApplication::setPalette().

См. также QApplication::setPalette().

[pure virtual] int QStyle::styleHint(QStyle::StyleHint hint, const QStyleOption *option = nullptr, const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const

Возвращает целое число, представляющее указанный стиль hint для данного widget, описанного предоставленным стилем option.

returnData используется, когда запросившему виджету требуется более подробная информация, чем целое число, возвращаемое styleHint(). Подробности см. в описании класса QStyleHintReturn.

[pure virtual] QRect QStyle::subControlRect(QStyle::ComplexControl control, const QStyleOptionComplex *option, QStyle::SubControl subControl, const QWidget *widget = nullptr) const

Возвращает прямоугольник, содержащий указанный subControl заданного сложного control (со стилем, указанным в option). Прямоугольник определён в координатах экрана.

Аргумент option — указатель на QStyleOptionComplex или один из его подклассов, и может быть приведён к соответствующему типу с помощью функции qstyleoption_cast(). Подробнее см. drawComplexControl(). Аргумент widget необязателен и может содержать дополнительную информацию для функции.

См. также drawComplexControl().

[pure virtual] QRect QStyle::subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget = nullptr) const

Возвращает подобласть для данного element, как описано в предоставленном стиле option. Возвращаемый прямоугольник определён в координатах экрана.

Аргумент widget необязателен и может быть использован для определения области. Объект QStyleOption может быть приведён к соответствующему типу с помощью функции qstyleoption_cast(). Ниже приведена таблица соответствий:

[virtual] void QStyle::unpolish(QWidget *widget)

Деактивирует отображение заданного widget.

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

Обратите внимание, что unpolish() будет вызываться только при уничтожении виджета. Это может вызвать проблемы в некоторых случаях, например, если вы удаляете виджет из пользовательского интерфейса, кэшируете его, а затем снова вставляете после изменения стиля; некоторые классы Qt кэшируют свои виджеты.

См. также polish().

[virtual] void QStyle::unpolish(QApplication *application)

Это перегруженная функция.

Деактивирует заданное application.

[static] Qt::Alignment QStyle::visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)

Преобразует выравнивание alignment типа Qt::AlignLeft или Qt::AlignRight без Qt::AlignAbsolute в Qt::AlignLeft или Qt::AlignRight с Qt::AlignAbsolute в соответствии с направлением макета direction. Другие флаги выравнивания остаются без изменений.

Если горизонтальное выравнивание не было указано, функция возвращает значение по умолчанию для данного направления макета direction.

QWidget::layoutDirection

[static] QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)

Возвращает заданную logicalPosition, преобразованную в экранные координаты на основе указанного direction. Прямоугольник boundingRectangle используется при выполнении преобразования.

См. также QWidget::layoutDirection.

[static] QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)

Возвращает заданный logicalRectangle, преобразованный в экранные координаты на основе указанного direction. Прямоугольник boundingRectangle используется при выполнении преобразования.

Эта функция предназначена для поддержки столов с расположением справа налево и обычно используется в реализациях функции subControlRect().

См. также QWidget::layoutDirection.