Класс QStyle

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

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

Типы публичного доступа

Публичные функции

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

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

Qt содержит набор подклассов QStyle, которые эмулируют стили различных платформ, поддерживаемых Qt (QWindowsStyle, QMacStyle и т. д.). По умолчанию эти стили включены в модуль Qt GUI. Также стили могут быть доступны как плагины.

Встроенные виджеты Qt используют QStyle для выполнения практически всей отрисовки, гарантируя, что они выглядят точно так же, как эквивалентные родные виджеты. На диаграмме ниже показан виджет QComboBox в девяти различных стилях.

Темы:

Установка стиля

Стиль всего приложения можно установить с помощью функции QApplication::setStyle(). Его также может указать пользователь приложения, используя опцию командной строки -style:

./myapplication -style windows

Если стиль не указан, Qt выберет наиболее подходящий стиль для платформы или среды рабочего стола пользователя.

Стиль также можно установить на отдельный виджет с помощью функции QWidget::setStyle().

Разработка виджетов, учитывающих стиль

Если вы разрабатываете пользовательские виджеты и хотите, чтобы они выглядели хорошо на всех платформах, вы можете использовать функции QStyle для выполнения части отрисовки виджета, такие как drawItemText(), drawItemPixmap(), drawPrimitive(), drawControl() и drawComplexControl().

Большинство функций отрисовки QStyle принимают четыре аргумента:

• значение перечисления, определяющее графический элемент, который нужно нарисовать
• QStyleOption, определяющий, как и где отобразить этот элемент
• QPainter, который следует использовать для отрисовки элемента
• QWidget, на котором выполняется отрисовка (необязательно)

Например, если вы хотите нарисовать прямоугольник фокуса на вашем виджете, вы можете написать:

void MyWidget::paintEvent(QPaintEvent * /* event */)
{
    QPainter painter(this);

    QStyleOptionFocusRect option;
    option.initFrom(this);
    option.backgroundColor = palette().color(QPalette::Background);

    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}

QStyle получает всю необходимую информацию для отрисовки графического элемента из QStyleOption. Виджет передается в качестве последнего аргумента в случае, если стиль нуждается в нем для выполнения специальных эффектов (например, анимированных кнопок по умолчанию на macOS), но это не обязательно. Фактически, вы можете использовать QStyle для отрисовки на любом устройстве рисования, а не только на виджетах, правильно настроек QPainter.

QStyleOption имеет различные подклассы для различных типов графических элементов, которые могут быть нарисованы. Например, PE_FrameFocusRect ожидает аргумент QStyleOptionFocusRect.

Для обеспечения максимальной скорости операций рисования QStyleOption и его подклассы имеют публичные данные членов. Подробнее о том, как использовать его, см. в документации класса QStyleOption.

Для удобства Qt предоставляет класс QStylePainter, который объединяет QStyle, QPainter и QWidget. Это позволяет написать

    QStylePainter painter(this);
    ...
    painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);

вместо

    QPainter painter(this);
    ...
    style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);

Создание пользовательского стиля

Вы можете создать пользовательский вид и ощущения для своего приложения, создав пользовательский стиль. Существует два подхода к созданию пользовательского стиля. В статическом подходе вы выбираете существующий класс QStyle, подклассируете его и переопределяете виртуальные функции для предоставления пользовательского поведения или создаете полностью новый класс QStyle. В динамическом подходе вы изменяете поведение системного стиля во время выполнения. Статический подход описан ниже. Динамический подход описан в QProxyStyle.

Первый шаг в статическом подходе - выбор одного из стилей, предоставляемых Qt, из которого вы будете создавать свой пользовательский стиль. Ваш выбор класса QStyle будет зависеть от того, какой стиль наиболее похож на желаемый стиль. Самым общим классом, который вы можете использовать в качестве базового, является QCommonStyle (не QStyle). Это связано с тем, что Qt требует, чтобы его стили были QCommonStyle.

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

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

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

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

Чтобы нарисовать свои вверх и вниз стрелки, QSpinBox использует примитивные элементы PE_IndicatorSpinUp и PE_IndicatorSpinDown. Вот как переопределить функцию drawPrimitive() для их различного отображения:

void CustomStyle::drawPrimitive(PrimitiveElement element, const QStyleOption *option,
                                QPainter *painter, const QWidget *widget) const
{
    if (element == PE_IndicatorSpinUp || element == PE_IndicatorSpinDown) {
        QPolygon points(3);
        int x = option->rect.x();
        int y = option->rect.y();
        int w = option->rect.width() / 2;
        int h = option->rect.height() / 2;
        x += (option->rect.width() - w) / 2;
        y += (option->rect.height() - h) / 2;

        if (element == PE_IndicatorSpinUp) {
            points[0] = QPoint(x, y + h);
            points[1] = QPoint(x + w, y + h);
            points[2] = QPoint(x + w / 2, y);
        } else { // PE_SpinBoxDown
            points[0] = QPoint(x, y);
            points[1] = QPoint(x + w, y);
            points[2] = QPoint(x + w / 2, y + h);
        }

        if (option->state & State_Enabled) {
            painter->setPen(option->palette.mid().color());
            painter->setBrush(option->palette.buttonText());
        } else {
            painter->setPen(option->palette.buttonText().color());
            painter->setBrush(option->palette.mid());
        }
        painter->drawPolygon(points);
    } else {
    QProxyStyle::drawPrimitive(element, option, painter, widget);
    }
}

Обратите внимание, что мы не используем аргумент widget, кроме как для его передачи в функцию QWindowStyle::drawPrimitive(). Как упоминалось ранее, информация о том, что должно быть нарисовано и как это должно быть нарисовано, задается объектом QStyleOption, поэтому нет необходимости обращаться к виджету.

Если вам нужно использовать аргумент widget для получения дополнительной информации, будьте внимательны, чтобы убедиться, что он не равен 0 и что он имеет правильный тип перед его использованием. Например:

    const QSpinBox *spinBox = qobject_cast<const QSpinBox *>(widget);
    if (spinBox) {
    ...
    }

При реализации пользовательского стиля вы не можете предполагать, что виджет является QSpinBox только потому, что значение перечисления называется PE_IndicatorSpinUp или PE_IndicatorSpinDown.

Документация примера 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().

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

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

См. также QInputMethod.

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

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

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

перечисление QStyle::StateFlagфлаги QStyle::State

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

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

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

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

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

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

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

enum QStyle::SubControlflags QStyle::SubControls

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

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

См. также ComplexControl.

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

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

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

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

QStyle::QStyle()

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

[virtual] QStyle::~QStyle()

Удаляет объект стиля.

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

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

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

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

controls1 и controls2 — это комбинация по оператору OR нулевых или более типов элементов управления.

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

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

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

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

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

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

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

См. также QIcon.

[pure virtual] QStyle::SubControl QStyle::hitTestComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, const QPoint &position, const QWidget *widget = nullptr) const

Возвращает подконтроль в заданной position в заданном сложном control (с опциями стиля, заданными параметром option).

Обратите внимание, что position выражается в координатах экрана.

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

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

[virtual] QRect QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Возвращает область внутри заданного rectangle, в которой нужно нарисовать указанную pixmap в соответствии с заданным alignment.

[virtual] QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const

Возвращает область внутри заданного rectangle, в которой нужно нарисовать предоставленный text в соответствии с указанными metrics и alignment. Параметр enabled указывает, включен ли соответствующий элемент.

Если заданный rectangle больше, чем необходимо для рендеринга text, возвращаемый прямоугольник будет смещён внутри rectangle в соответствии с указанным alignment. Например, если alignment равен Qt::AlignCenter, возвращаемый прямоугольник будет центрирован внутри rectangle. Если заданный rectangle меньше, чем необходимо, возвращаемый прямоугольник будет наименьшим прямоугольником, достаточным для рендеринга text.

См. также Qt::Alignment.

[pure virtual] int QStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

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

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

Эта функция была введена в 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 = 0, const QWidget *widget = 0) const

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

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

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

[virtual] QPalette QStyle::standardPalette() const

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

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

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

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

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

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

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

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

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

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

[pure virtual] QRect QStyle::subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget = nullptr) const

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

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

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

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

Эта функция является аналогом polish(). Она вызывается для каждого виджета, который был инициализирован, при динамическом изменении стиля; предыдущий стиль должен деинициализировать свои настройки, прежде чем новый стиль сможет их инициализировать заново.

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

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

[virtual] void QStyle::unpolish(QApplication *application)

Это перегруженная функция.

Деинициализирует заданное application.

[static] Qt::Alignment QStyle::visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)

Преобразует выравнивание alignment типа Qt::AlignLeft или Qt::AlignRight без Qt::AlignAbsolute в Qt::AlignLeft или Qt::AlignRight с Qt::AlignAbsolute в соответствии с направлением макета direction. Другие флаги выравнивания остаются без изменений.

Если горизонтальное выравнивание не было указано, функция возвращает значение по умолчанию для данного направления макета direction.

QWidget::layoutDirection

[static] QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)

Возвращает заданную logicalPosition, преобразованную в координаты экрана на основе указанного direction. boundingRectangle используется при выполнении преобразования.

См. также QWidget::layoutDirection.

[static] QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)

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

Эта функция предоставляется для поддержки настольных систем с право-левым порядком следования, и обычно используется в реализациях функции subControlRect().

См. также QWidget::layoutDirection.