Класс QStyle

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

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

Типы

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

• 31 открытая функция унаследованная от 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.

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

./myapplication -style custom

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

Рабочие столы с правосторонней ориентацией

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

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

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

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

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

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

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

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

См. также QInputMethod.

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

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

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

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

enum QStyle::StyleHint

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

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

enum QStyle::SubControlflags QStyle::SubControls

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

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

См. также ComplexControl.

enum QStyle::SubElement

Это перечисление представляет собой подобласть виджета. Реализации стиля используют эти области для рисования различных частей виджета.

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

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

QStyle::QStyle()

Создаёт объект стиля.

[virtual] QStyle::~QStyle()

Уничтожает объект стиля.

[static] QRect QStyle::alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)

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

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 представляют собой логическое ИЛИ (OR) сочетание одного или нескольких типов элементов управления.

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

В таблице ниже перечислены элементы сложных элементов управления и соответствующие им подклассы QStyleOptionComplex. Параметры стиля содержат все необходимые параметры для отрисовки элементов управления, включая QStyleOption::state, который содержит флаги стиля, используемые при отрисовке. Таблица также описывает флаги, которые устанавливаются при приведении указанного option к соответствующему подклассу.

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

[pure virtual] void QStyle::drawControl(ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = Q_NULLPTR) const

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

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

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

Рисует заданный примитивный элемент element с помощью painter, используя параметры стиля, указанные в option.

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

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

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

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

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

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

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

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

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

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

Обратите внимание, что unpolish() будет вызвана только если widget уничтожен. Это может вызвать проблемы в некоторых случаях, например, если вы удалите widget из пользовательского интерфейса, сохраните его в кэше, а затем снова вставите его после изменения стиля; некоторые классы Qt кэшируют свои widget.

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