QStyle Class

./myapplication -style windows

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);
}

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

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

class CustomStyle : public QProxyStyle
{
    Q_OBJECT

public:
    CustomStyle(const QWidget *widget);
    ~CustomStyle() {}

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

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);
    }
}

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

#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();
}

./myapplication -style custom

    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);
    }

成员函数文档

QStyle::QStyle()

构造一个样式对象。

[virtual noexcept] QStyle::~QStyle()

销毁样式对象。

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

返回指定size 的新矩形，该矩形根据指定的alignment 和direction 与给定的rectangle 对齐。

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 和 是零个或多个 的 OR 组合。controls2 control types

该函数由布局系统调用。只有在PM_LayoutHorizontalSpacing 或PM_LayoutVerticalSpacing 返回负值时才会使用。

另请参阅 layoutSpacing() 。

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

使用提供的painter 和option 指定的样式选项绘制给定的control 。

widget 参数是可选参数，可用于辅助绘制控件。

option 参数是指向QStyleOptionComplex 对象的指针，可使用qstyleoption_cast() 函数将其转换为正确的子类。请注意，指定rect 成员的option 必须是逻辑坐标。在调用drawPrimitive() 或drawControl() 函数前，应使用visualRect() 将逻辑坐标转换为屏幕坐标。

下表列出了复杂控制元素及其相关样式选项子类。样式选项包含绘制控件所需的所有参数，其中QStyleOption::state 保存了绘制时使用的style flags 。该表还描述了将给定的option 转换为相应子类时要设置的标志。

另请参阅 drawPrimitive() 和drawControl()。

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

使用提供的painter 和option 指定的样式选项绘制给定的element 。

widget 参数是可选参数，可用于辅助绘制控件。option 参数是指向QStyleOption 对象的指针，可使用qstyleoption_cast() 函数将其转换为正确的子类。

下表列出了控件元素及其相关的样式选项子类。样式选项包含绘制控件所需的所有参数，其中QStyleOption::state 保存了绘制时使用的样式标志。该表还描述了将给定选项转换为相应子类时要设置的标志。

请注意，如果此处未列出控件元素，那是因为它使用的是QStyleOption 对象。

另请参阅 drawPrimitive() 和drawComplexControl()。

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

根据指定的alignment ，使用提供的painter ，在指定的rectangle 中绘制给定的pixmap 。

另请参阅 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

使用提供的painter 和palette 在指定的rectangle 中绘制给定的text 。

文本使用画笔绘制，并根据指定的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

使用option 指定的样式选项，用提供的painter 绘制给定的基元element 。

widget 参数是可选的，可以包含一个辅助绘制基元元素的 widget。

下表列出了基元元素及其相关的样式选项子类。样式选项包含绘制元素所需的所有参数，其中QStyleOption::state 保存了绘制时使用的样式标志。该表还描述了将给定选项转换为相应子类时要设置的标志。

请注意，如果这里没有列出原始元素，那是因为它使用的是QStyleOption 对象。

另请参阅 drawComplexControl() 和drawControl()。

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

返回给定pixmap 的副本，样式与指定的iconMode 一致，并考虑option 指定的调色板。

option 参数可以传递额外信息，但必须包含调色板。

请注意，并非所有像素图都符合要求，在这种情况下，返回的像素图只是一个普通副本。

另请参阅 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

根据定义的alignment ，返回指定rectangle 中绘制指定pixmap 的区域。

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

根据指定的字体metrics 和alignment 返回在给定的rectangle 中绘制所提供的text 的区域。enabled 参数表示是否启用了相关项目。

如果给定的rectangle 大于渲染text 所需的区域，返回的矩形将根据指定的alignment 在rectangle 内偏移。例如，如果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 返回负值时才会使用。

另请参阅 combinedLayoutSpacing()。

[since 6.1] QString QStyle::name() const

返回样式的名称。

该值可用于使用QStyleFactory::create() 创建样式。

此函数在 Qt 6.1 中引入。

另请参阅 QStyleFactory::create()。

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

返回给定像素metric 的值。

指定的option 和widget 可用于计算度量值。可以使用qstyleoption_cast() 函数将option 转换为适当的类型。请注意，即使是可以使用option 的 PixelMetrics，其值也可能为零。有关适当的option 转换，请参见下表：

有些像素度量值是由部件调用的，有些则仅由样式内部调用。如果该度量没有被部件调用，则由样式作者自行决定是否使用。对于某些样式，这可能并不合适。

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

初始化给定widget 的外观。

每个窗口部件在完全创建后、首次显示前的某个时刻都会调用该函数。

请注意，默认实现不做任何操作。该函数中的合理操作可能是调用 widget 的 QWidget::setBackgroundMode() 函数。请勿使用该函数设置几何图形等。重新实现该函数提供了一个后门，通过它可以改变 widget 的外观，但在 Qt XML 的样式引擎中，很少有必要实现该函数；取而代之的是重新实现drawItemPixmap(),drawItemText(),drawPrimitive() 等函数。

QWidget::inherits() 函数可以提供足够的信息，允许对特定类进行定制。但是，由于新的QStyle 子类有望与所有当前和未来的widget 合理地协同工作，因此建议有限度地使用硬编码定制。

另请参阅 unpolish()。

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

这是一个重载函数。

对给定的application 对象进行后期初始化。

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

这是一个重载函数。

根据样式对调色板的特定要求（如果有）更改palette 。

另请参阅 QPalette 和QApplication::setPalette()。

const QStyle *QStyle::proxy() const

此函数返回此样式的当前代理。默认情况下，大多数样式都会返回自己。不过，当使用代理样式时，它将允许样式回调到其代理。

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

根据提供的contentsSize ，返回指定的option 和type 所描述元素的大小。

option 参数是指向QStyleOption 或其子类之一的指针。可以使用qstyleoption_cast() 函数将option 转换为适当的类型。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 = nullptr, const QWidget *widget = nullptr) const

返回给定standardIcon 的图标。

standardIcon 是一个标准的像素图，可以遵循现有的图形用户界面风格或指南。option 参数可用于传递定义适当图标时所需的额外信息。widget 参数是可选参数，也可用于帮助确定图标。

[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

Returns an integer representing the specified stylehint for the givenwidget described by the provided styleoption 。

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

按照所提供的样式option ，返回给定element 的子区域。返回的矩形以屏幕坐标定义。

widget 参数是可选参数，可用于帮助确定区域。可以使用qstyleoption_cast() 函数将QStyleOption 对象转换为相应类型。有关适当的option 转换，请参见下表：

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

取消初始化widget 的外观。

该函数与polish() 相对应。每当动态更改样式时，每个已抛光的 widget 都会调用该函数；在新样式再次抛光之前，旧样式必须取消抛光其设置。

请注意，unpolish() 只有在部件被销毁时才会被调用。这在某些情况下可能会造成问题，例如，如果您从用户界面中移除一个 widget，将其缓存，然后在样式改变后重新插入；Qt 的某些类会缓存它们的 widget。

另请参见 polish()。

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

这是一个重载函数。

取消初始化给定的application 。

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

根据布局direction ，将alignment 中不包含Qt::AlignAbsolute 的Qt::AlignLeft 或Qt::AlignRight 转换为包含Qt::AlignAbsolute 的Qt::AlignLeft 或Qt::AlignRight 。其他对齐标志保持不变。

如果没有指定水平对齐方式，函数将返回给定布局的默认对齐方式direction 。

QWidget::layoutDirection

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

返回根据指定direction 转换为屏幕坐标的给定logicalPosition 。执行转换时将使用boundingRectangle 。

另请参阅 QWidget::layoutDirection 。

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

返回根据指定direction 转换为屏幕坐标的给定logicalRectangle 。执行转换时将使用boundingRectangle 。

该函数用于支持从右向左的桌面，通常用于subControlRect() 函数的实现。

另请参阅 QWidget::layoutDirection 。