Класс QStyle

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

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

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

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

• 34 открытые функции, унаследованные от QObject

Статические открытые члены

• 10 статических публичных членов, унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 публичный слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 1 публичная переменная, унаследованная от QObject
• 9 защищённых функций, унаследованных от QObject
• 2 защищённые переменные, унаследованные от QObject

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

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

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

Предупреждение: В настоящее время таблицы стилей 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, также используется для вычисления ограничивающих прямоугольников элементов и их вложенных элементов для различных типов ролей данных элементов data roles, которые поддерживает QStyledItemDelegate. См. описание класса QStyledItemDelegate, чтобы узнать, какие типы данных и роли поддерживаются. Вы можете узнать больше о ролях данных элементов в разделе Программирование Model/View.

Когда 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 и Стилизация.

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

enum QStyle::ComplexControl

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

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

enum QStyle::ContentsType

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

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

enum QStyle::ControlElement

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

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

enum QStyle::PixelMetric

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

Следующие значения устарели:

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

enum QStyle::PrimitiveElement

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

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

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

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

См. также QInputMethod.

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

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

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

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

enum QStyle::StyleHint

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

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

перечисление QStyle::SubControlфлаги 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 равен 0.

controls1 и controls2 представляют собой комбинацию по оператору ИЛИ одного или нескольких типов элементов управления.

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

Эта функция была добавлена в Qt 4.3.

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

Обратите внимание, что если примитивный элемент не указан здесь, это потому, что он использует простой объект 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 = ..., const QWidget *widget = ...) const

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

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

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

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

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

Эта функция была добавлена в Qt 4.6.

[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 = ..., const QWidget *widget = ...) const

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

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

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

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