Класс QStyle

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

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

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

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

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

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

• 11 статических публичных членов, унаследованных от 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.

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

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

public:
    CustomStyle();
    ~CustomStyle() {}

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

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

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

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

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

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

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

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

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

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

См. также QStyleOption, QStylePainter, Пример стилей, Стили и стилизованные виджеты, QStyledItemDelegate и Стилевание.

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

enum 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

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

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

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

enum QStyle::StyleHint

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

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

enum QStyle::SubControlflags QStyle::SubControls

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

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

См. также ComplexControl.

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)

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

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

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

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

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

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

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

[pure virtual] void QStyle::drawComplexControl(ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = Q_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(ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = Q_NULLPTR) const

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

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

В таблице ниже перечислены элементы управления и соответствующие подклассы параметров стиля. Параметры стиля содержат все параметры, необходимые для отрисовки элементов управления, включая 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(PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = Q_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] SubControl QStyle::hitTestComplexControl(ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = Q_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 = Q_NULLPTR, const QWidget *widget = Q_NULLPTR) const

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

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

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

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

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

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

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

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

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

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

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

Обратите внимание, что реализация по умолчанию ничего не делает. Разумные действия в этой функции могут включать вызов функции QWidget::setBackgroundMode() для виджета. Не используйте функцию для установки, например, геометрии. Переопределение этой функции предоставляет "задний ход", позволяющий изменить внешний вид виджета, но с Qt's style engine редко необходимо реализовывать эту функцию; вместо этого переопределите 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(ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = Q_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(StandardPixmap standardIcon, const QStyleOption *option = Q_NULLPTR, const QWidget *widget = Q_NULLPTR) const

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

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

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

[virtual] QPalette QStyle::standardPalette() const

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

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

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

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

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

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

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

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

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

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

[pure virtual] QRect QStyle::subElementRect(SubElement element, const QStyleOption *option, const QWidget *widget = Q_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.