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

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

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

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

enum QStyle::StateFlagflags QStyle::State

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

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

Тип State — это typedef для QFlags<StateFlag>. Он хранит сочетание значений StateFlag.

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

enum QStyle::StyleHint

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

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

enum QStyle::SubControlflags QStyle::SubControls

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

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

См. также ComplexControl.

enum QStyle::SubElement

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

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

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

QStyle::QStyle()

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

[virtual] QStyle::~QStyle()

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

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

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

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

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

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

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

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

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

[pure virtual] void QStyle::drawComplexControl(QStyle::ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget = nullptr) const

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

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

Параметр option — указатель на объект QStyleOptionComplex, который можно привести к нужному подклассу с помощью функции qstyleoption_cast(). Обратите внимание, что член rect указанного option должен быть в логических координатах. При переопределении этой функции следует использовать visualRect() для преобразования логических координат в экранные перед вызовом функций drawPrimitive() или drawControl().

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

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

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

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

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

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

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

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

[virtual] void QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const

Рисует заданную pixmap в указанном rectangle, в соответствии с указанным alignment, с помощью предоставленного painter.

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

[virtual] void QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const

Рисует заданный text в указанном rectangle с помощью предоставленного painter и palette.

Текст рисуется с помощью пера painter, и выравнивается и обрезается в соответствии с указанным alignment. Если задан явный textRole, текст рисуется с использованием цвета palette для данного роли. Параметр enabled указывает, активен ли элемент или нет; при переопределении этой функции параметр enabled должен влиять на способ отрисовки элемента.

См. также Qt::Alignment и drawItemPixmap().

[pure virtual] void QStyle::drawPrimitive(QStyle::PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = nullptr) const

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

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

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

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

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

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

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

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

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

См. также QIcon.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обратите внимание, что реализация по умолчанию ничего не делает. Целесообразные действия в этой функции могут заключаться в вызове функции QWidget::setBackgroundMode() для виджета. Не используйте функцию для установки, например, геометрии. Переопределение этой функции предоставляет «задний ход», позволяющий изменить внешний вид виджета, но в Qt's стилевой системе редко требуется реализовывать эту функцию; вместо этого переопределите drawItemPixmap(), drawItemText(), drawPrimitive() и т. д.

Функция QWidget::inherits() может предоставить достаточно информации, чтобы позволить адаптацию, специфичную для класса. Но поскольку новые подклассы QStyle должны работать приемлемо со всеми текущими и будущими виджетами, рекомендуется ограничить использование жёстко запрограммированных настроек.

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

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

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

Поздняя инициализация данного объекта application.

[virtual] void QStyle::polish(QPalette &palette)

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

Изменяет palette в соответствии со специфичными для стиля требованиями к цветовым палитрам (если таковые имеются).

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

const QStyle *QStyle::proxy() const

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

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

[pure virtual] QSize QStyle::sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &contentsSize, const QWidget *widget = nullptr) const

Возвращает размер элемента, описанного указанным option и type, на основе предоставленного contentsSize.

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

См. таблицу ниже для соответствующих приведений option:

См. также ContentsType и QStyleOption.

[static] int QStyle::sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown = false)

Преобразует заданное logicalValue в пиксельное положение. Параметр min сопоставляется с 0, max — с span, а другие значения распределяются равномерно между ними.

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

По умолчанию эта функция предполагает, что максимальное значение находится справа для горизонтальных элементов и внизу для вертикальных. Установите параметр upsideDown в true, чтобы перевернуть это поведение.

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

[static] int QStyle::sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown = false)

Преобразует заданное пиксельное position в логическое значение. 0 соответствует параметру min, span — max, а другие значения распределяются равномерно между ними.

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

По умолчанию эта функция предполагает, что максимальное значение находится справа для горизонтальных элементов и внизу для вертикальных. Установите параметр upsideDown в true, чтобы перевернуть это поведение.

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

[pure virtual] QIcon QStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = ..., const QWidget *widget = ...) const

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

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

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

[virtual] QPalette QStyle::standardPalette() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Деактивировать отображение заданного widget.

Эта функция является аналогом polish(). Она вызывается для каждого виджета 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.