Класс 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();
    ~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 для пользовательских подклассов QStyle не поддерживаются. Мы планируем решить эту проблему в какой-то будущей версии.

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

Существует несколько способов использования пользовательской темы в приложении 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 для получения дополнительной информации о создании плагина темы.

Скомпилируйте свой плагин и поместите его в директорию Qt plugins/styles. Теперь у нас есть настраиваемая тема, которую 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().

enum QStyle::PrimitiveElement

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

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

enum QStyle::RequestSoftwareInputPanel

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

См. также QInputMethod.

enum QStyle::StandardPixmap

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

Тип State является псевдонимом для QFlags<StateFlag>. Он хранит результат объединения по ИЛИ значений StateFlag.

См. также 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, который содержит флаги стиля, используемые при рисовании. В таблице также описываются флаги, которые устанавливаются при приведении заданного option к соответствующему подклассу.

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

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

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

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

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

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

См. также 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 больше, чем необходимо для рендеринга текста, возвращаемый прямоугольник будет смещён внутри rectangle в соответствии с указанным alignment. Например, если alignment — Qt::AlignCenter, возвращаемый прямоугольник будет центрирован внутри rectangle. Если заданный rectangle меньше, чем необходимо, возвращаемый прямоугольник будет самым маленьким прямоугольником, достаточно большим для рендеринга текста.

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

[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(). Соответствующие преобразования option приведены в таблице ниже:

[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.