前言

本文翻译自Qt官方文档，详细介绍了各成员/类型的作用，包含部分示例代码。

QStyle类的内容非常庞大，如需快速了解类成员和使用简介，请参见 QStyle简介。

一、QStyle Class

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

Qt包含一组QStyle子类，这些子类模拟了Qt支持的不同平台的样式（QWindowStyle、QMacStyle等）。默认情况下，这些样式内置在Qt GUI模块中。样式也可以作为插件提供。Qt的内置小部件使用 QStyle来执行几乎所有的绘图操作 （这意味着几乎所有内置控件的部分，都有可能通过样式来控制），确保它们看起来与原生小部件完全相同。

下图显示了一个QComboBox在九种不同样式下的外观。

1. 设置Style

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

./myapplication -style windows

如果未指定样式，Qt将为用户的平台或桌面环境选择最合适的样式。也可以使用QWidget::setStyle()函数在单个小部件上设置样式。

2. 创建样式感知的自定义Widgets

如果您正在开发自定义小部件并希望它们在所有平台上看起来都很好，可以使用QStyle函数来执行小部件绘图的部分操作，例如drawItemText()、drawItemPixmap()、drawPrimitive()、drawControl()和drawComplexControl()。

大多数QStyle绘图函数需要四个参数：

1. 一个枚举值。
   • 用于指定要绘制的图形元素。
2. 一个QStyleOption
   • 指定如何、在何处渲染元素。
3. 一个QPainter
   • 用于绘制元素。
4. 一个QWidget（可选的）
   • 在其上执行绘制操作。

举个例子，如果你想在控件上画一个焦点矩形框，可以这样写：

	void paintEvent (QPaintEvent *event) override
	{
		QPainter painter (this);
		QStyleOptionFocusRect option;
		option.initFrom (this);
		option.backgroundColor = palette().color (QPalette::Background);

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

QStyle从QStyleOption获取渲染图形元素所需的所有信息。widget作为最后一个参数传递，以防样式需要它来执行特殊效果（例如macOS上的动画默认按钮），但这不是强制的。实际上，通过正确设置QPainter，您可以使用QStyle在任何绘图设备上绘图，而不仅仅是小部件。

QStyleOption有各种各样的子类，用于不同类型的可绘制图形元素。例如，PE_FrameFocusRect需要一个QStyleOptionFocusRect参数。

为了确保绘图操作尽可能快，QStyleOption及其子类具有公共数据成员。有关如何使用它的详细信息，请参阅QStyleOption类文档。

为了方便起见，Qt提供了QStylePainter类，它结合了QStyle、QPainter和QWidget。这使得编写以下代码成为可能：

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

而不是：

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

3. 创建一个自定义Style

您可以创建自定义样式，来为您的应用程序创建自定义外观。

创建自定义样式有两种方法：

1. 静态方法
   • 可以选择现有的QStyle类，子类化它，并重新实现虚函数以提供自定义行为，或者从头开始创建整个QStyle类。
2. 动态方法
   • 可以在运行时修改系统样式的行为。

下面描述了静态方法。

动态方法在QProxyStyle中描述。

静态方法的第一步是选择一个Qt提供的样式，作为构建您的自定义样式的基础。您选择的QStyle类将取决于哪个样式最接近您想要的样式。您可以使用的最通用的类是QCommonStyle（而不是QStyle）。这是因为Qt要求其样式是QCommonStyles。

根据想要更改的基样式的那些部分，必须重新实现用于绘制这些界面部分的函数。为了说明这一点，我们将修改由QWindowsStyle绘制的微调框箭头的外观。箭头是由drawPrimitive()函数绘制的原始元素，因此我们需要重新实现该函数。我们需要以下类声明：

class CustomStyle : public QProxyStyle {
	Q_OBJECT
public:
	CustomStyle();
	~CustomStyle(){}
	void drawPrimitive (PrimitiveElement element,
						const QStyleOption *option,
						QPainter *painter,
						const QWidget *wodget) 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参数，除了将其传递给QCommonStyle::drawPrimitive()函数。正如前面提到的，有关要绘制的内容和绘制方式的信息由QStyleOption对象指定，因此不需要询问小部件。

如果您需要使用widget参数来获取其他信息，请确保它不是空指针，并且它是正确的类型，然后再使用它。例如：

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

在实现自定义样式时，不能仅仅因为枚举值被称为PE_IndicatorSpinUp或PE_IndicatorSpinDown就假定该小部件是QSpinBox`。

关于这个主题的更多细节，请参阅The documentation for the Styles example 。

4. 使用自定义Style

在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 Plugin documentation 。

编译您的插件并将其放入Qt的plugins/styles目录。现在，我们有一个可插拔的样式，Qt可以自动加载。要在现有应用程序中使用您的新样式，只需使用以下参数启动应用程序：

./myapplication -style custom

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

5. Item Views中的Styles

视图中项目的绘制由委托完成。Qt的默认委托QStyledItemDelegate也用于计算项目的边界矩形及其子元素的各种项目数据角色。

请参阅QStyledItemDelegate类描述，以了解支持哪些数据类型和角色。您可以在Model/View编程中阅读更多关于项目数据角色的信息。

当QStyledItemDelegate绘制它的项目时，它会绘制CE_ItemViewItem，并使用CT_ItemViewItem计算它们的大小。

此外，它使用SE_ItemViewItemText来设置编辑器的大小。在实现用于自定义Item Views绘制的样式时，您需要检查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实现中被调用。

要支持对新数据类型和项目数据角色的绘制，有必要创建一个自定义委托（Custom Delegate）。但如果您只需要支持默认委托实现的数据类型，自定义样式则不需要再伴随一个委托。

QStyledItemDelegate类描述提供了有关自定义委托的更多信息。

Item View的headers的绘制也是由样式完成的，这使得可以控制标题项的大小以及行和列的大小。

另外可以看看 QStyleOption, QStylePainter, Styles Example, Styles and Style Aware Widgets, QStyledItemDelegate, and Styling.

二、QStyle Member Type文档

1. enum QStyle::ComplexControl

enum QStyle::ComplexControl

此枚举描述了可用的复杂控件。复杂控件会因用户点击的位置或按下的键而表现不同行为。

可以看看 SubControl and drawComplexControl().

2. enum QStyle::ContentsType

enum QStyle::ContentsType

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

可以看看 sizeFromContents()。

3. enum QStyle::ControlElement

enum QStyle::ControlElement

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

可以看看drawControl()

4. enum QStyle::PixelMetric

enum QStyle::PixelMetric

这个枚举描述了各种可用的像素度量。像素度量是一种与样式相关的尺寸，由单个像素值表示。

5. enum QStyle::PrimitiveElement

enum QStyle::PrimitiveElement

这个枚举描述了各种原始元素。原始元素是常见的图形用户界面元素，例如复选框指示器或按钮斜角。

可以看看drawPrimitive();

6. enum QStyle::RequestSoftwareInputPanel

enum QStyle::RequestSoftwareInputPanel

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

7. enum QStyleStandardPixmap

enum QStyle::StandardPixmap

这个枚举描述了可用的标准像素图。标准像素图是可以遵循某些现有GUI样式或指南的像素图。

可以看看 standardIcon().

8. enum QStyle::StateFlag

enum QStyle::StateFlag
flags QStyle::State

这个枚举描述了绘制原始元素（Primitive Elements）时使用的flags。

请注意，并不是所有原始元素都会使用所有这些标志，并且这些标志对不同的项目可能有不同的含义。

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

可以看看 drawPrimitive()

9. enum QStyle::StyleHint

enum QStyle::StyleHint

这句话描述了可用的样式hints。样式提示是一种整体外观和/或feel的提示。

可以看看styleHint().

10. enum QStyle::SubControl

enum QStyle::SubControl
flags QStyle::SubControls

这个枚举类型描述了可用的子控件枚举类型。子控件是复合控件（ComplexControl）中的控件元素。

SubControls类型是 QFlags<SubControl>的typedef，存储了 SubControl值的OR运算集合。

可以看看 ComplexControl

11. enum QStyle::SubElement

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

可以看看subElementRect()

三、QStyle Member Function文档

1. alignedRect()

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

返回一个指定大小的矩形，大小由size指定。
该矩形会根据指定的对齐方式alignment和方向direction与给定的矩形rectangle对齐。

2. combinedLayoutSpacing()

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

返回在布局中应该用于 controls1 和 controls2 之间的间距。

1. orientation 指定控件是并排布置还是垂直堆叠。
2. option 参数可以用来传递有关父小部件的额外信息。
3. widget 参数是可选的，如果 option 为 nullptr，也可以使用 widget 参数。
4. controls1 和 controls2 是一个或多个控件类型的（enum QSizePolicy::ControlType） OR 组合。

此函数由布局系统调用。仅当 PM_LayoutHorizontalSpacing 或 PM_LayoutVerticalSpacing 返回负值时使用此函数。

此函数在 Qt 4.3 中引入。

可以看看layoutSpacing()

3. drawComplexControl()

void
QStyle::drawComplexControl (
	QStyle::ComplexControl control,
	const QStyleOptionComplex *option,
	QPainter *painter,
	const QWidget *widget = nullptr
) const;

使用所提供的painter和指定的option样式选项绘制给定的控件。
widget参数是可选的，可以在绘制控件时作为辅助使用。
option参数是指向QStyleOptionComplex对象的指针，可以使用 qstyleoption_cast()函数将其转换为正确的子类。

请注意，指定的option的rect成员必须是逻辑坐标。此函数的重新实现应使用visualRect()将逻辑坐标转换为屏幕坐标，然后调用drawPrimitive()或drawControl()函数。

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

可以看看 drawPrimitive() and drawControl().

4. drawControl()

void
QStyle::drawControl (
	QStyle::ControlElement element,
	const QStyleOption *option,
	QPainter *painter,
	const QWidget *widget = nullptr
) const;

使用所提供的painter和指定的option样式选项绘制给定的元素。
widget参数是可选的，可以在绘制控件时作为辅助使用。
option参数是指向QStyleOption对象的指针，可以使用qstyleoption_cast()函数将其转换为正确的子类。

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

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

可以看看 drawPrimitive() and drawComplexControl().

5. drawItemPixmap()

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

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

另请参见drawItemText()。

6. 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）绘制给定的文本。

1. 文本使用painter的笔绘制，并根据指定的对齐方式进行对齐和换行。
2. 如果指定了明确的文本角色（textRole），则使用调色板中该角色的颜色绘制文本。
3. 启用参数（enabled）表示项目是否启用；在重新实现此函数时，启用参数应影响项目的绘制方式。

7. drawPrimitive()

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

使用提供的painter和指定的样式选项（option）绘制给定的基本元素（primitive element）。

widget参数是可选的，可能持有一个在绘制基本元素时有帮助的窗口部件。

下表列出了基本元素（primitive element）及其相关的样式选项子类。样式选项（option）包含绘制元素所需的所有参数，包括 QStyleOption::state，它包含在绘制时使用的样式标志。表格还描述了当将给定的选项转换为适当的子类时设置了哪些标志。

请注意，如果基本元素未在此处列出，则是因为它使用的是普通的 QStyleOption 对象。

另请参考 drawComplexControl() and drawControl().

8. generatedIconPixmap()

virtual QPixmap
generatedIconPixmap (
	QIcon::Mode iconMode,
	const QPixmap &pixmap, 
	const QStyleOption *option
) const = 0;

返回给定图像（pixmap）的副本，该副本经过样式化以符合指定的图标模式（iconMode），并考虑由option指定的调色板（palette）。

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

请注意，并非所有的图像都会符合这种样式化，在这种情况下，返回的图像是一个普通的副本。

另请参见 QIcon

9. hitTestComplexControl()

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

返回给定复杂控件（complex control）中指定位置（position）的子控件，使用由option指定的样式选项。

请注意，位置是以屏幕坐标表示的。

option参数是一个指向QStyleOptionComplex对象（或其子类之一）的指针。可以使用qstyleoption_cast()函数将对象转换为适当的类型。详情请参见drawComplexControl()。

widget参数是可选的，可以为该函数提供额外的信息。

另请参见 drawComplexControl() and subControlRect().

10. itemPixmapRect()

virtual QRect
itemPixmapRect (
	const QRect &rectangle, 
	int alignment,
	const QPixmap &pixmap
) const;

返回在给定矩形内根据定义的对齐方式绘制指定图像（pixmap）的矩形区域。

11. itemTextRect()

virtual QRect
itemTextRect (
	const QFontMetrics &metrics,
	const QRect &rectangle,
	int alignment, 
	bool enabled, 
	const QString &text
) const;

返回在给定矩形内根据指定的字体度量（font metrics）和对齐方式绘制提供的文本（text）的区域。

enabled参数表示相关项目是否启用。

如果给定的矩形大于渲染文本所需的区域，则返回的矩形将根据指定的对齐方式在矩形内偏移。例如，如果对齐方式是Qt::AlignCenter，返回的矩形将在矩形内居中。

如果给定的矩形小于所需的区域，返回的矩形将是足够渲染文本的最小矩形。

12. layoutSpacing()

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

返回在布局中控制项control1和control2之间应使用的间距。

orientation指定控件是并排布置还是垂直堆叠。

option参数可以用于传递有关父窗口部件的额外信息。如果option为nullptr，也可以使用widget参数。

此函数由布局系统调用。仅当PM_LayoutHorizontalSpacing或PM_LayoutVerticalSpacing返回负值时才使用此函数。

此函数在Qt 4.3中引入。

另请参见 combinedLayoutSpacing().

13. pixelMetric()

virtual int
pixelMetric (
	QStyle::PixelMetric metric, 
	const QStyleOption *option = nullptr, 
	const QWidget *widget = nullptr
)const =0;

返回给定像素度量（pixel metric）的值。

指定的option和widget可以用于计算该度量。一般来说，widget参数不使用。可以使用qstyleoption_cast()函数将option转换为适当的类型。

请注意，即使对于可以使用的PixelMetrics，option也可能为零。请参见下表了解适当的option转换：

一些pixel metrics是从widgets调用的，而有些则仅由样式内部调用。如果metric不是由一个widget调用的，是否使用它由样式作者自行决定。对于某些样式，可能不适合使用这个方法。

14. polish()

virtual void polish (QWidget *widget);

初始化给定窗口部件（widget）的外观。

此函数在每个窗口部件完全创建之后但在首次显示之前的某个时间点被调用。

请注意，默认实现不执行任何操作。在此函数中合理的操作可能是调用QWidget::setBackgroundMode()函数来设置widget的背景模式。不要使用此函数来设置例如几何形状。重新实现此函数提供了一种更改窗口部件外观的后门，但由于Qt的样式引擎，通常不需要实现此函数；而是重新实现drawItemPixmap()、drawItemText()、drawPrimitive()等函数。

QWidget::inherits()函数可能提供足够的信息来允许特定类的自定义。但是，由于新的QStyle子类预计会与所有当前和未来的窗口部件合理地配合使用，建议有限地使用硬编码的自定义。

另请参见unpolish()。

重载版本

virtual void polish(QApplication *application);

延迟初始化给定的应用程序对象。

virtual void polish(QPalette &palette);

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

15. proxy()

const QStyle *QStyle::proxy() const;

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

16. sizeFromContents()

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

返回由指定的option和type描述的元素的大小，基于提供的contentsSize。

option参数是指向QStyleOption或其子类之一的指针。可以使用qstyleoption_cast()函数将option转换为适当的类型。

widget是一个可选参数，可以包含用于计算大小的额外信息。
请参见下表了解适当的option转换：

另请参见 ContentsType and QStyleOption.

16. sliderPositionFromValue()

static int
sliderPositionFromValue (
	int min, 
	int max, 
	int logicalValue,
	int span, 
	bool upsideDown = false
);

将给定的逻辑值（logicalValue）转换为像素位置。
min参数映射到0，max参数映射到span，其他值在两者之间均匀分布。

此函数可以处理整个整数范围而不会溢出，前提是span小于4096。

默认情况下，此函数假定最大值位于水平项的右侧和垂直项的底部。将upsideDown参数设置为true以反转此行为。

另请参见 sliderValueFromPosition()。

17. sliderValueFromPosition()

static int
sliderValueFromPosition(
	int min,
	int max,
	int position, 
	int span, 
	bool upsideDown = false
);

将给定的像素位置转换为逻辑值。0 映射到 min 参数，span 映射到 max，其他值则在两者之间均匀分布。

此函数可以处理整个整数范围而不会发生溢出。

默认情况下，此函数假设最大值位于水平项目的右侧和垂直项目的底部。将 upsideDown 参数设置为 true 可逆转此行为。

另请参见 sliderPositionFromValue()。

18. standardIcon()

virtual QIcon
standardIcon (
	QStyle::StandardPixmap standardIcon, 
	const QStyleOption *option = 0,
	const QWidget *widget = 0
)const =0;

返回给定标准图标（standardIcon）的图标。

standardIcon是一个标准图像，可以遵循某些现有的GUI样式或指南。

option参数可以用于传递定义适当图标时所需的额外信息。

widget参数是可选的，也可以用于帮助确定图标。

此函数在Qt 4.1中引入。

19. standardPalette()

virtual QPalette standardPalette() const;

返回样式的标准调色板。

请注意，在支持系统颜色的系统上，不使用样式的标准调色板。特别是，Windows Vista和Mac样式不使用标准调色板，而是使用本地主题引擎。在这些样式中，不应使用QApplication::setPalette()设置调色板。

另请参见QApplication::setPalette()。

20. styleHint()

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

返回一个整数，表示由提供的样式选项描述的给定窗口部件的指定样式提示（style hint）。

当查询窗口部件需要比styleHint()返回的整数更详细的数据时，使用returnData。有关详细信息，请参阅QStyleHintReturn类描述。

21. subControlRect()

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

返回包含给定复杂控件（complex control）的指定子控件（subControl）的矩形（使用由option指定的样式）。该矩形以屏幕坐标定义。

option参数是指向QStyleOptionComplex或其子类之一的指针，可以使用qstyleoption_cast()函数将其转换为适当的类型。详情请参见drawComplexControl()。

widget参数是可选的，可以为该函数提供额外的信息。

另请参见drawComplexControl()。

22. subElementRect()

virtual QRect
subElementRect (
	QStyle::SubElement element,
	const QStyleOption *option,
	const QWidget *widget = nullptr
) const =0;

返回给定元素（element）的子区域，如提供的样式选项（style option）中所描述。返回的矩形以屏幕坐标定义。

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

23. unpolish()

virtual void unpolish(QWidget *widget);

取消初始化给定窗口部件的外观。

此函数是polish()的对立面。每当样式动态更改时，它会为每个已初始化的窗口部件调用；之前的样式必须取消其设置，然后新样式才能再次初始化它们。

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

另请参见polish()。

重载版本

virtual void unpolish(QApplication *application);

取消对给定的应用程序的初始化。

24. visualAlignment()

static Qt::Alignment
visualAlignment (
	Qt::LayoutDirection direction, 
	Qt::Alignment alignment
);

根据布局方向，将不带Qt::AlignAbsolute的Qt::AlignLeft或Qt::AlignRight对齐方式转换为带Qt::AlignAbsolute的Qt::AlignLeft或Qt::AlignRight对齐方式。其他对齐标志保持不变。

如果未指定水平对齐方式，该函数将返回给定布局方向的默认对齐方式。

另请参见 QWidget::layoutDirection

25. visualPos()

static QPoint
visualPos (
	Qt::LayoutDirection direction, 
	const QRect &boundingRectangle, 
	const QPoint &logicalPosition
);

根据指定方向（direction），返回将给定的逻辑位置（logicalPosition）转换为屏幕坐标后的结果。转换时使用boundingRectangle。

另请参见QWidget::layoutDirection。

26. visualRect()

virtual QRect
visualRect (
	Qt::LayoutDirection direction,
	const QRect &boundingRectangle,
	const QRect &logicalRectangle
);

根据指定方向（direction），返回将给定的逻辑矩形（logicalRectangle）转换为屏幕坐标后的结果。转换时使用boundingRectangle。

提供此函数是为了支持从右到左的桌面，通常在实现subControlRect()函数时使用。

另请参见QWidget::layoutDirection。