Qt 5.10.1
QCommonStyle继承于QStyle QProxyStyle 继承于QCommonStyle

QStyle Class

QStyle类是一个抽象基类，它封装了GUI的外观。

Qt包含一组QStyle子类，它们模拟Qt支持的不同平台的样式（QWindowsStyle，QMacStyle等）。 默认情况下，这些样式内置于Qt GUI模块中。 样式也可以作为插件提供。

Qt的内置小部件使用QStyle执行几乎所有的绘图，确保它们看起来与等效的本机小部件完全相同。 下图显示了九种不同风格的QComboBox。

设置样式

可以使用QApplication :: setStyle（）函数设置整个应用程序的样式。 它也可以由应用程序的用户使用-style命令行选项指定：

./myapplication -style windows

如果未指定样式，Qt将为用户的平台或桌面环境选择最合适的样式。

也可以使用QWidget::setStyle（）函数在单个小部件上设置样式。

开发Style-Aware的自定义小部件

如果您正在开发自定义小部件并希望它们在所有平台上看起来都很好，您可以使用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上的动画默认按钮），但它不是必需的。 实际上，通过正确设置QPainter，您可以使用QStyle在任何绘图设备上绘制，而不仅仅是小部件。

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类将取决于哪种风格最符合您所期望的风格。您可以用作基础的最通用的类是QCommonStyles（不是QStyle）。这是因为Qt要求其样式为QCommonStyles。

根据要更改的基本样式的哪些部分，必须重新实现用于绘制界面的这些部分的函数。为了说明这一点，我们将修改QWindowsStyle绘制的spinbox箭头的外观。箭头是由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);
    }
}

请注意，除了将它传递给QWindowStyle::drawPrimitive（）函数之外，我们不使用widget参数。 如前所述，QStyleOption对象指定了有关绘制内容以及绘制方式的信息，因此无需询问窗口小部件。

如果您需要使用widget参数来获取其他信息，请在使用它之前注意确保它不是0并且它的类型正确。 例如：

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

实现自定义样式时，您不能仅仅因为枚举值称为PE_IndicatorSpinUp或PE_IndicatorSpinDown而假设窗口小部件是QSpinBox。

样式示例的文档更详细地介绍了此主题。

警告：自定义QStyle子类当前不支持Qt样式表。 我们计划在将来的某个版本中解决这个问题。

使用自定义样式

在Qt应用程序中有几种使用自定义样式的方法。 最简单的方法是在创建QApplication对象之前将自定义样式传递给QApplication::setStyle（）静态函数：

#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的插件/样式目录中。 我们现在有一个Qt可以自动加载的可插拔样式。 要将新样式与现有应用程序一起使用，只需使用以下参数启动应用程序：

./myapplication -style custom

应用程序将使用您实现的自定义样式的外观。

从右到左的桌面

从右到左书写的语言（例如阿拉伯语和希伯来语）通常也反映了小部件的整个布局，并要求光线来自屏幕的右上角而不是左上角。

如果创建自定义样式，则在绘制非对称元素时应特别小心，以确保它们在镜像布局中看起来也正确。 测试样式的简单方法是使用-reverse命令行选项运行应用程序或在main（）函数中调用QApplication::setLayoutDirection（）。

在从右到左的环境中使样式运行良好时，请记住以下几点：

• 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和样式。

成员类型文档

QStyle::ComplexControl

此枚举描述了可用的复杂控件。 复杂控件具有不同的行为，具体取决于用户单击它们的位置或按下了哪些键。

QStyle::ContentsType

此枚举描述了可用的内容类型。 这些用于计算各种小部件内容的大小。

QStyle::ControlElement

此枚举表示控件元素。 控件元素是窗口小部件的一部分，用于执行某些操作或向用户显示信息。

QStyle::PixelMetric

此枚举描述了各种可用的像素指标。 像素度量是由单个像素值表示的样式相关大小。

已弃用的枚举变量：

QStyle::PrimitiveElement

这个枚举描述了各种原始元素。 原始元素是常见的GUI元素，例如复选框指示符或按钮斜角。

QStyle::RequestSoftwareInputPanel

此枚举描述了在什么情况下，具有输入功能的小部件将请求软件输入面板。

QStyle::StandardPixmap

此枚举描述了可用的标准像素图。 标准像素图是一种像素图，可以遵循一些现有的GUI样式或指南。

QStyle::StateFlag

flags QStyle::State

此枚举描述了绘制基元元素时使用的标志。

请注意，并非所有基元都使用所有这些标志，并且标志可能对不同的项目意味着不同的东西。

State类型是QFlags 的typedef。 它存储StateFlag值的OR组合。

QStyle::StyleHint

此枚举描述了可用的样式提示。 样式提示是一般外观或感觉提示。

QStyle::SubControl

flags QStyle::SubControls

此枚举描述了可用的子控件。 子控件是复杂控件（ComplexControl）中的控件元素。

SubControls类型是QFlags 的typedef。 它存储SubControl值的OR组合。

QStyle::SubElement

此枚举表示窗口小部件的子区域。 样式实现使用这些区域来绘制窗口小部件的不同部分。

成员函数文档

drawComplexControl

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

使用提供的painter使用指定的样式选项绘制控件。

widget参数是可选的，可用作绘制控件的辅助工具。

option参数是一个指向QStyleOptionComplex对象的指针，可以使用qstyleoption_cast（）函数将其强制转换为正确的子类。请注意，指定选项的rect成员必须位于逻辑坐标中。 重新实现此函数应使用visualRect（）在调用drawPrimitive（）或drawControl（）函数之前将逻辑坐标更改为屏幕坐标。

下表列出了复杂的控件元素及其关联的样式选项子类。 样式选项包含绘制控件所需的所有参数，包括QStyleOption::state，其中包含绘制时使用的样式标志。 该表还描述了在将给定选项强制转换为适当的子类时设置的标志。

drawControl

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

painter使用指定的样式选项绘制给定元素。

widget参数是可选的，可用作绘制控件的辅助工具。 option参数是一个指向QStyleOption对象的指针，可以使用qstyleoption_cast（）函数将其强制转换为正确的子类。

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

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

drawItemPixmap

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

使用提供的painter，根据指定的alignment，在指定的矩形中绘制给定的像素图。

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在指定的矩形中绘制给定文本。

使用painter绘制文本，并根据指定的对齐方式对齐。 如果指定了显式textRole，则使用给定角色的调色板颜色绘制文本。 enabled参数指示项目是否已启用; 重新实现此功能时，启用的参数会影响项目的绘制方式。

drawPrimitive

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

painter使用指定的样式选项绘制给的基础元素。

小部件参数是可选的，可以包含可以帮助绘制基础元素的小部件。

下表列出了原始元素及其关联的样式选项子类。 样式选项包含绘制元素所需的所有参数，包括QStyleOption::state，其中包含绘制时使用的样式标志。 该表还描述了在将给定选项强制转换为适当的子类时设置的标志。

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

pixelMetric

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

返回给定像素度量的值。

指定的选项和窗口小部件可用于计算度量标准。 通常，不使用widget参数。 可以使用qstyleoption_cast（）函数将该选项强制转换为适当的类型。 请注意，即使可以使用它的PixelMetrics，该选项也可能为零。 请参阅下表以了解相应的选项转换：

sizeFromContents

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

根据提供的contentsSize返回指定选项和类型描述的元素的大小。

option参数是指向QStyleOption或其子类之一的指针。 可以使用qstyleoption_cast（）函数将该选项强制转换为适当的类型。 窗口小部件是可选参数，可以包含用于计算大小的额外信息。

请参阅下表以了解相应的选项转换：

subElementRect

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

返回给定元素的子区域，如提供的样式选项中所述。 返回的矩形在屏幕坐标中定义。

小部件参数是可选的，可用于帮助确定区域。 可以使用qstyleoption_cast（）函数将QStyleOption对象强制转换为适当的类型。 请参阅下表以了解相应的选项转换：

动态改变样式(QSS)

polish

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

初始化给定小部件的外观。

每个小部件在完全创建之后但在它第一次显示之前的某个时刻调用此函数。

请注意，默认实现不执行任何操作。此函数中的合理操作可能是为窗口小部件调用QWidget::setBackgroundMode（）函数。 不要使用该功能来设置例如几何体。 重新实现此功能提供了一个后门，通过它可以更改窗口小部件的外观，但使用Qt的样式引擎，很少需要实现此功能; 相反，重新实现drawItemPixmap（），drawItemText（），drawPrimitive（）等。

QWidget::inherits（）函数可以提供足够的信息以允许特定于类的自定义。 但是，由于新的QStyle子类有望与所有当前和未来的小部件合理地工作，因此建议使用硬编码的自定义。

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

给应用程序对象初始化样式。

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

根据调色板的样式要求，更改调色板。

unpolish

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

取消小部件的样式。

此函数与polish（）相对应。 每当动态改变样式时，都会为每个已经生效样式的小部件调用它; 之前的风格必须在新样式再次生效之前取消其设置。

请注意，只有在窗口小部件被销毁时才会调用unpolish（）。 在某些情况下，这可能会导致问题，例如，如果从UI中删除窗口小部件，将其缓存，然后在样式更改后重新插入; 一些Qt的类缓存它们的小部件。

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

取消应用程序样式

实例

QSS样式

QLineEdit[change=true] {
  color: red;
}

动态设置QSS

lineEdit->setProperty("change", true);
lineEdit->style()->unpolish(lineEdit);
lineEdit->style()->polish(lineEdit);

QCommonStyle class

QCommonStyle类封装了GUI的常见外观。
这个抽象类实现了一些小部件的外观，这是所有GUI样式所共有的，这些样式是作为Qt的一部分提供的。
由于QCommonStyle继承了QStyle，因此其所有功能都在QStyle文档中完整记录。

QProxyStyle class

QProxyStyle类是一个简便的类，可以简化QStyle元素。

QProxyStyle包装QStyle（通常是默认的系统样式），用于动态绘制或其他特定样式行为。

以下示例显示如何在任何平台上重写快捷方式下划线行为：

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

class MyProxyStyle : public QProxyStyle
{
public:
      int styleHint(StyleHint hint, const QStyleOption *option = 0,const QWidget *widget = 0, QStyleHintReturn *returnData = 0) const
      {
          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上运行。