Класс QProxyStyle

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

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

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

Переопределённые открытые функции

Переопределённые защищённые функции

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

Класс QProxyStyle оборачивает QStyle (обычно, стандартную системную тему) для динамического переопределения отрисовки или другого конкретного поведения темы.

Следующий пример показывает, как переопределить поведение подчёркивания ярлыка на любой платформе:

#include "textedit.h"
#include <QApplication>
#include <QProxyStyle>

class MyProxyStyle : public QProxyStyle
{
  public:
    int styleHint(StyleHint hint, const QStyleOption *option = nullptr,
                  const QWidget *widget = nullptr, QStyleHintReturn *returnData = nullptr) const override
    {
        if (hint == QStyle::SH_UnderlineShortcut)
            return 0;
        return QProxyStyle::styleHint(hint, option, widget, returnData);
    }
};

int main(int argc, char **argv)
{
    Q_INIT_RESOURCE(textedit);

    QApplication a(argc, argv);
    a.setStyle(new MyProxyStyle);
    TextEdit mw;
    mw.resize(700, 800);
    mw.show();
    //...
}

Предупреждение: стандартные темы, предоставляемые Qt, будут учитывать эту подсказку, так как они вызывают QStyle::proxy(), но нет гарантии, что QStyle::proxy() будет вызван для пользовательских или системных тем. Например, это не сработает на Mac, где меню обрабатываются операционной системой.

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

...
auto proxy = new MyProxyStyle(QApplication::style()->name());
proxy->setParent(widget);   // take ownership to avoid memleak
widget->setStyle(proxy);
...

См. также QStyle.

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

QProxyStyle::QProxyStyle(const QString &key)

Конструктор QProxyStyle для переопределения поведения в базовой теме, указанной ключом key, или в текущем стиле приложения, если указанный ключ key не распознан.

См. также QStyleFactory::create().

QProxyStyle::QProxyStyle(QStyle *style = nullptr)

Конструктор QProxyStyle для переопределения поведения в указанном стиле style или в стандартном родном стиле, если style не указан.

Владение style передаётся QProxyStyle.

[virtual] QProxyStyle::~QProxyStyle()

Деструктор объекта QProxyStyle.

QStyle *QProxyStyle::baseStyle() const

Возвращает базовый стиль прокси. Если базовый стиль не задан для прокси-стиля, QProxyStyle создаст экземпляр стиля приложения.

См. также setBaseStyle() и QStyle.

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

Переопределяет: QCommonStyle::drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex *opt, QPainter *p, const QWidget *widget) const.

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

Переопределяет: QCommonStyle::drawControl(QStyle::ControlElement element, const QStyleOption *opt, QPainter *p, const QWidget *widget) const.

[override virtual] void QProxyStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, const QPixmap &pixmap) const

Переопределяет: QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment, const QPixmap &pixmap) const.

[override virtual] void QProxyStyle::drawItemText(QPainter *painter, const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) const

Переопределяет: QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString &text, QPalette::ColorRole textRole) const.

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

Переопределяет: QCommonStyle::drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption *opt, QPainter *p, const QWidget *widget) const.

[override virtual protected] bool QProxyStyle::event(QEvent *e)

Переопределяет: QObject::event(QEvent *e).

[override virtual] QPixmap QProxyStyle::generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *opt) const

Переопределяет: QCommonStyle::generatedIconPixmap(QIcon::Mode iconMode, const QPixmap &pixmap, const QStyleOption *opt) const.

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

Переопределяет: QCommonStyle::hitTestComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex *opt, const QPoint &pt, const QWidget *widget) const.

[override virtual] QRect QProxyStyle::itemPixmapRect(const QRect &r, int flags, const QPixmap &pixmap) const

Переопределяет: QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const.

[override virtual] QRect QProxyStyle::itemTextRect(const QFontMetrics &fm, const QRect &r, int flags, bool enabled, const QString &text) const

Переопределяет: QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const.

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

Переопределяет: QCommonStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2, Qt::Orientation orientation, const QStyleOption *option, const QWidget *widget) const.

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

Реализация по умолчанию возвращает -1.

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

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

Переопределяет: QCommonStyle::pixelMetric(QStyle::PixelMetric m, const QStyleOption *opt, const QWidget *widget) const.

[override virtual] void QProxyStyle::polish(QWidget *widget)

Переопределяет: QCommonStyle::polish(QWidget *widget).

[override virtual] void QProxyStyle::polish(QPalette &pal)

Переопределяет: QCommonStyle::polish(QPalette &pal).

[override virtual] void QProxyStyle::polish(QApplication *app)

Переопределяет: QCommonStyle::polish(QApplication *app).

void QProxyStyle::setBaseStyle(QStyle *style)

Устанавливает базовый стиль, который необходимо проксировать.

Владение style передается QProxyStyle.

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

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

[override virtual] QSize QProxyStyle::sizeFromContents(QStyle::ContentsType type, const QStyleOption *option, const QSize &size, const QWidget *widget) const

Переопределяет: QCommonStyle::sizeFromContents(QStyle::ContentsType ct, const QStyleOption *opt, const QSize &csz, const QWidget *widget) const.

[override virtual] QIcon QProxyStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option = nullptr, const QWidget *widget = nullptr) const

Переопределяет: QStyle::standardIcon(QStyle::StandardPixmap standardIcon, const QStyleOption *option, const QWidget *widget) const.

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

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

[override virtual] QPalette QProxyStyle::standardPalette() const

Переопределяет: QStyle::standardPalette() const.

[override virtual] QPixmap QProxyStyle::standardPixmap(QStyle::StandardPixmap standardPixmap, const QStyleOption *opt, const QWidget *widget = nullptr) const

Переопределяет: QCommonStyle::standardPixmap(QStyle::StandardPixmap sp, const QStyleOption *option, const QWidget *widget) const.

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

Переопределяет: QCommonStyle::styleHint(QStyle::StyleHint sh, const QStyleOption *opt, const QWidget *widget, QStyleHintReturn *hret) const.

[override virtual] QRect QProxyStyle::subControlRect(QStyle::ComplexControl cc, const QStyleOptionComplex *option, QStyle::SubControl sc, const QWidget *widget) const

Переопределяет: QCommonStyle::subControlRect(QStyle::ComplexControl cc, const QStyleOptionComplex *opt, QStyle::SubControl sc, const QWidget *widget) const.

[override virtual] QRect QProxyStyle::subElementRect(QStyle::SubElement element, const QStyleOption *option, const QWidget *widget) const

Переопределяет: QCommonStyle::subElementRect(QStyle::SubElement sr, const QStyleOption *opt, const QWidget *widget) const.

[override virtual] void QProxyStyle::unpolish(QWidget *widget)

Переопределяет: QCommonStyle::unpolish(QWidget *widget).

[override virtual] void QProxyStyle::unpolish(QApplication *app)

Переопределяет: QCommonStyle::unpolish(QApplication *application).