Класс QStyle

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

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

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

Общедоступные функции

• 31 общедоступные функции унаследованы от QObject

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

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

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

• 1 свойство, унаследованное от QObject
• 1 публичный слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 9 защищённых функций, унаследованных от 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.

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

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

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

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

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

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

enum QStyle::PrimitiveElement

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

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

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

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

См. также QInputMethod.

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

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

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

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

enum QStyle::StyleHint

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

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

enum QStyle::SubControlflags QStyle::SubControls

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

Тип SubControls — это typedef для 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 равен 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().

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

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

Преобразует выравнивание 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.