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

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

./myapplication -style custom

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

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

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

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

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

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

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

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

При отрисовке элементов 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().

enum QStyle::ContentsType

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

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

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

enum 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 — это результат объединения по оператору OR одного или нескольких типов элементов управления.

Эта функция вызывается системой макетов. Она используется только в том случае, если 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().

В таблице ниже перечислены сложные элементы управления и соответствующие подклассы QStyleOptionComplex. Параметры стиля содержат все параметры, необходимые для отрисовки элементов управления, включая 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. Параметры стиля содержат все параметры, необходимые для отрисовки элементов управления, включая QStyleOption::state, который хранит флаги стиля, используемые при отрисовке.

Обратите внимание, что если элемент управления не указан здесь, это означает, что он использует обычный объект 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 больше, чем область, необходимая для отображения 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(). См. таблицу ниже для соответствующих преобразований 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.