QStyle Class Reference

[QtGui module]

该的QStyle类是封装了图形用户界面的外观和感觉的抽象基类。More…

继承QObject。

通过继承QCommonStyle。

Types

• enum ComplexControl { CC_SpinBox, CC_ComboBox, CC_ScrollBar, CC_Slider, ..., CC_CustomBase }
• enum ContentsType { CT_PushButton, CT_CheckBox, CT_RadioButton, CT_ToolButton, ..., CT_CustomBase }
• enum ControlElement { CE_PushButton, CE_PushButtonBevel, CE_PushButtonLabel, CE_CheckBox, ..., CE_CustomBase }
• enum PixelMetric { PM_ButtonMargin, PM_ButtonDefaultIndicator, PM_MenuButtonIndicator, PM_ButtonShiftHorizontal, ..., PM_CustomBase }
• enum PrimitiveElement { PE_Q3CheckListController, PE_Q3CheckListExclusiveIndicator, PE_Q3CheckListIndicator, PE_Q3DockWindowSeparator, ..., PE_CustomBase }
• enum RequestSoftwareInputPanel { RSIP_OnMouseClickAndAlreadyFocused, RSIP_OnMouseClick }
• enum StandardPixmap { SP_TitleBarMenuButton, SP_TitleBarMinButton, SP_TitleBarMaxButton, SP_TitleBarCloseButton, ..., SP_CustomBase }
• class **[State]($docs-index.htm)**
• enum StateFlag { State_None, State_Enabled, State_Raised, State_Sunken, ..., State_Mini }
• enum StyleHint { SH_EtchDisabledText, SH_DitherDisabledText, SH_ScrollBar_MiddleClickAbsolutePosition, SH_ScrollBar_ScrollWhenPointerLeavesControl, ..., SH_CustomBase }
• enum SubControl { SC_None, SC_ScrollBarAddLine, SC_ScrollBarSubLine, SC_ScrollBarAddPage, ..., SC_All }
• class **[SubControls]($docs-index.htm)**
• enum SubElement { SE_PushButtonContents, SE_PushButtonFocusRect, SE_CheckBoxIndicator, SE_CheckBoxContents, ..., SE_CustomBase }

Methods

• __init__ (self)
• int combinedLayoutSpacing (self, QSizePolicy.ControlTypes controls1, QSizePolicy.ControlTypes controls2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)
• drawComplexControl (self, ComplexControl cc, QStyleOptionComplex opt, QPainter p, QWidget widget = None)
• drawControl (self, ControlElement element, QStyleOption opt, QPainter p, QWidget widget = None)
• drawItemPixmap (self, QPainter painter, QRect rect, int alignment, QPixmap pixmap)
• drawItemText (self, QPainter painter, QRect rectangle, int alignment, QPalette palette, bool enabled, QString text, QPalette.ColorRole textRole = QPalette.NoRole)
• drawPrimitive (self, PrimitiveElement pe, QStyleOption opt, QPainter p, QWidget widget = None)
• QPixmap generatedIconPixmap (self, QIcon.Mode iconMode, QPixmap pixmap, QStyleOption opt)
• SubControl hitTestComplexControl (self, ComplexControl cc, QStyleOptionComplex opt, QPoint pt, QWidget widget = None)
• QRect itemPixmapRect (self, QRect r, int flags, QPixmap pixmap)
• QRect itemTextRect (self, QFontMetrics fm, QRect r, int flags, bool enabled, QString text)
• int layoutSpacing (self, QSizePolicy.ControlType control1, QSizePolicy.ControlType control2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)
• int layoutSpacingImplementation (self, QSizePolicy.ControlType control1, QSizePolicy.ControlType control2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)
• int pixelMetric (self, PixelMetric metric, QStyleOption option = None, QWidget widget = None)
• polish (self, QWidget)
• polish (self, QApplication)
• QPalette polish (self, QPalette)
• QStyle proxy (self)
• QSize sizeFromContents (self, ContentsType ct, QStyleOption opt, QSize contentsSize, QWidget widget = None)
• QIcon standardIcon (self, StandardPixmap standardIcon, QStyleOption option = None, QWidget widget = None)
• QIcon standardIconImplementation (self, StandardPixmap standardIcon, QStyleOption option = None, QWidget widget = None)
• QPalette standardPalette (self)
• QPixmap standardPixmap (self, StandardPixmap standardPixmap, QStyleOption option = None, QWidget widget = None)
• int styleHint (self, StyleHint stylehint, QStyleOption option = None, QWidget widget = None, QStyleHintReturn returnData = None)
• QRect subControlRect (self, ComplexControl cc, QStyleOptionComplex opt, SubControl sc, QWidget widget = None)
• QRect subElementRect (self, SubElement subElement, QStyleOption option, QWidget widget = None)
• unpolish (self, QWidget)
• unpolish (self, QApplication)

Static Methods

• QRect alignedRect (Qt.LayoutDirection direction, Qt.Alignment alignment, QSize size, QRect rectangle)
• int sliderPositionFromValue (int min, int max, int logicalValue, int span, bool upsideDown = False)
• int sliderValueFromPosition (int min, int max, int position, int span, bool upsideDown = False)
• Qt.Alignment visualAlignment (Qt.LayoutDirection direction, Qt.Alignment alignment)
• QPoint visualPos (Qt.LayoutDirection direction, QRect boundingRect, QPoint logicalPos)
• QRect visualRect (Qt.LayoutDirection direction, QRect boundingRect, QRect logicalRect)

Detailed Description

该的QStyle类是封装了图形用户界面的外观和感觉的抽象基类。

Qt的包含一组的QStyle子类，模拟的Qt所支持的不同平台的风格（QWindowsStyle，QMacStyle，QMotifStyle等）。默认情况下，这些样式都内置在QtGui库。样式也可制成可作为插件。

Qt的内建窗体使用的QStyle来执行几乎所有的图纸，确保它们看起来确实很像相当于原生窗口部件。下图显示了一个QComboBox在八个不同的风格。

主题：

Setting a Style

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

 ./myapplication -style motif

如果没有指定样式， Qt会选择最合适的风格，为用户的平台或桌面环境。

对单个部件使用的样式，也可以设置在QWidget.setStyle（）函数。

Developing Style-Aware Custom Widgets

如果您正在开发自定义的小部件，并要他们好看在所有平台上，你可以使用的QStyle函数来执行部件的部件图纸，如drawItemText（ ）drawItemPixmap（ ）drawPrimitive（ ）drawControl（）和drawComplexControl（ ） 。

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

• an enum value specifying which graphical element to draw
• a QStyleOption specifying how and where to render that element
• a QPainter that should be used to draw the element
• a QWidget on which the drawing is performed (optional)

例如，如果你想画一个焦点矩形上的小部件，你可以这样写：

 void MyWidget.paintEvent([QPaintEvent](qpaintevent.html) * /* event */)
 {
     [QPainter]($docs-qpainter.html) painter(this);
     [QStyleOptionFocusRect]($docs-qstyleoptionfocusrect.html) option;
     option.initFrom(this);
     option.backgroundColor = palette().color([QPalette]($docs-qpalette.html).Background);
     style()->drawPrimitive(QStyle.PE_FrameFocusRect, &option, &painter, this);
 }

的QStyle得到所有它需要从渲染的图形元素的信息QStyleOption。窗口小部件是通过作为在壳体的最后一个参数的样式需要它来执行特殊效果（例如Mac OS X上的动画默认的按钮），但它不是必需的。事实上，你可以使用的QStyle绘制在任何绘图设备，不只是小部件，通过设置QPainter正常。

QStyleOption具有各种子类的各种类型的图形元素可以被绘制。例如，PE_FrameFocusRect预计QStyleOptionFocusRect的说法。

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

为方便起见， Qt提供了QStylePainter类，它结合了的QStyle ，一QPainter和QWidget。这使得它可以写

     [QStylePainter]($docs-qstylepainter.html) painter(this);
     ...
     painter.drawPrimitive(QStyle.PE_FrameFocusRect, option);

而不是

     [QPainter]($docs-qpainter.html) painter(this);
     ...
     style()->drawPrimitive(QStyle.PE_FrameFocusRect, &option, &painter, this);

Creating a Custom Style

您可以创建自定义的外观，并通过创建一个自定义样式感觉为您的应用。有两种方法可以创建一个自定义样式。在静态方法中，您既可以选择一个现有的QStyle类，继承它，并重新实现虚函数提供自定义行为，或者你从头创建一个完整的QStyle类。在动态的方法，你修改你的系统风格在运行时的行为。下方的静电的方法进行说明。动态方法的描述QProxyStyle。

在静态方法的第一步是挑选而提供的Qt从中你将建立您的自定义样式的样式之一。您选择的QStyle类将取决于其风格酷似你想要的风格最。你可以作为一个基地使用最普遍的类是QCommonStyle（不是的QStyle ） 。这是因为Qt的要求它的风格是QCommonStyle秒。

这取决于你想改变的基本样式的哪些部分，你必须重新实现用来绘制界面的部分功能。为了说明这一点，我们将通过修改绘制的旋转框箭头的外观QWindowsStyle。箭在primitive elements由该画drawPrimitive（ ）函数，所以我们需要重新实现该功能。我们需要下面的类声明：

 class CustomStyle : public [QWindowsStyle]($docs-index.htm)
 {
     Q_OBJECT
 public:
     CustomStyle()
     ~CustomStyle() {}
     void drawPrimitive(PrimitiveElement element, const [QStyleOption]($docs-qstyleoption.html) *option,
                        [QPainter]($docs-qpainter.html) *painter, const [QWidget]($docs-qwidget.html) *widget) const;
 };

要绘制它的向上和向下箭头，QSpinBox使用PE_IndicatorSpinUp和PE_IndicatorSpinDown基本元素。以下是如何重新实现drawPrimitive（ ）函数以不同的方式吸引他们：

 void CustomStyle.drawPrimitive(PrimitiveElement element, const [QStyleOption]($docs-qstyleoption.html) *option,
                                 [QPainter]($docs-qpainter.html) *painter, const [QWidget]($docs-qwidget.html) *widget) const
 {
     if (element == PE_IndicatorSpinUp || element == PE_IndicatorSpinDown) {
         [QPolygon](qpolygon.html) 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]($docs-qpoint.html)(x, y + h);
             points[1] = [QPoint]($docs-qpoint.html)(x + w, y + h);
             points[2] = [QPoint]($docs-qpoint.html)(x + w / 2, y);
         } else { // PE_SpinBoxDown
             points[0] = [QPoint]($docs-qpoint.html)(x, y);
             points[1] = [QPoint]($docs-qpoint.html)(x + w, y);
             points[2] = [QPoint]($docs-qpoint.html)(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 {
         [QWindowsStyle]($docs-index.htm).drawPrimitive(element, option, painter, widget);
     }
 }

请注意，我们不使用widget的说法，除了它传递给QWindowStyle.drawPrimitive （ ）函数。如前所述，关于什么是要绘制的信息和应该如何被绘制由指定QStyleOption对象，所以没有必要问窗口小部件。

如果你需要使用widget参数以获得更多的信息，请小心，以确保它不为0 ，并且它是正确类型的使用它。例如：

     [QSpinBox]($docs-qspinbox.html) *spinBox = qobject_cast<[QSpinBox]($docs-qspinbox.html) *>(widget);
     if (spinBox) {
     ...
     }

在实现自定义风格，你不能假设的部件是一个QSpinBox只是因为枚举值称为PE_IndicatorSpinUp or PE_IndicatorSpinDown。

该文档为Styles例如涵盖更详细这个话题。

Warning:目前不支持Qt的样式表定制的QStyle子类。我们计划在未来的版本解决这个问题。

Using a Custom Style

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

 #include <QtGui>
 #include "customstyle.h"
 int main(int argc, char *argv[])
 {
     [QApplication]($docs-qapplication.html).setStyle(new CustomStyle);
     [QApplication]($docs-qapplication.html) app(argc, argv);
     [QSpinBox]($docs-qspinbox.html) spinBox;
     spinBox.show();
     return app.exec();
 }

您可以致电QApplication.setStyle（ ）在任何时间，而是由构造函数之前调用它，可以确保用户的喜好，使用设置-style命令行选项，被尊重。

您可能想使你的自定义样式可用于其他应用程序，这可能不是你的，因此不适用于你重新编译使用。 Qt的插件系统，使得它可以创建样式的插件。创建为插件样式加载在运行时共享对象由Qt本身。请参阅Qt Plugin文档以获取有关如何去创造一个风格插件的更多信息。

编译你的插件，并把它放到Qt的plugins/styles目录。我们现在有一个可插拔的风格， Qt可以自动加载。使用新的风格与现有的应用程序，只需启动该应用程序具有以下参数：

 ./myapplication -style custom

该应用程序将使用的外观和你实现的自定义样式感觉。

Right-to-Left Desktops

由右至左（如阿拉伯语和希伯来语）的书面语言通常也反映部件的整体布局，并要求光来自于屏幕的右上角，而不是左上角。

如果您创建自定义样式，你应该绘制对称元素时，确保他们也期待正确的镜像布局要特别小心。一个简单的方法来测试你的风格是运行的应用程序-reverse命令行选项或致电QApplication.setLayoutDirection（ ）在你的main()功能。

这里有一些事情在一个从右到左的环境使得一个良好的工作作风时要牢记：

• subControlRect() and subElementRect() return rectangles in screen coordinates
• QStyleOption.direction indicates in which direction the item should be drawn in
• If a style is not right-to-left aware it will display items as if it were left-to-right
• visualRect(), visualPos(), and visualAlignment() are helpful functions that will translate from logical to screen representations.
• alignedRect() will return a logical rect aligned for the current direction

Styles in Item Views

项目的意见，这幅画是由委讬进行的。 Qt的默认的委讬，QStyledItemDelegate，也可用于为计算项的边界矩形，并且其子元素的各种项目类data roles QStyledItemDelegate支持。请参阅QStyledItemDelegate类的描述，以找出哪些数据类型和角色的支持。你可以阅读更多有关项目数据的角色Model/View Programming。

When QStyledItemDelegate描绘它的项目，它吸引CE_ItemViewItem，并计算其大小与CT_ItemViewItem。还需要注意的是，它使用SE_ItemViewItemText设置编辑器的大小。当实现一个风格来定制的项目视图绘制，你需要检查的实施QCommonStyle（以及任何其他子类从它自己的风格继承） 。这样，你找出哪些以及如何等风格元素都画，然后就可以重新实现元素的绘画，应该可以得出不同。

我们有一个小例子，我们自定义的项目背景的绘制。

     switch (element) {
         case (PE_PanelItemViewItem): {
             painter->save();
             [QPoint]($docs-qpoint.html) topLeft = option->rect.topLeft();
             [QPoint]($docs-qpoint.html) bottomRight = option->rect.topRight();
             [QLinearGradient](qlineargradient.html) backgroundGradient(topLeft, bottomRight);
             backgroundGradient.setColorAt(0.0, [QColor](qcolor.html)([Qt](qt.html).yellow).lighter(190));
             backgroundGradient.setColorAt(1.0, [Qt](qt.html).white);
             painter->fillRect(option->rect, [QBrush](qbrush.html)(backgroundGradient));
             painter->restore();
         break;
         }
         default:
             [QWindowsStyle]($docs-index.htm).drawPrimitive(element, option, painter, widget);
     }

原始元素PE_PanelItemViewItem负责绘制项目的背景，并从被称为QCommonStyle的实施CE_ItemViewItem。

以添加新的数据类型和项目数据绘制角色的支持，就必须创建一个自定义的委讬。但是如果你只需要支持默认的委讬实现的数据类型，自定义样式并不需要一个伴随委讬。该QStyledItemDelegate类的描述给出了自定义的委讬的更多信息。

项目视图标题的图纸也由式进行，得到过的标题项目以及行和列的尺寸的尺寸控制。

Type Documentation

QStyle.ComplexControl

这个枚举变量描述了可用的复杂控制。复杂的控件具有不同的行为取决于所在的用户点击他们或哪个键被按下。

See also SubControl和drawComplexControl（ ） 。

QStyle.ContentsType

这个枚举变量描述了可用的内容类型。这些被用于计算尺寸为各种部件的内容。

See also sizeFromContents（ ） 。

QStyle.ControlElement

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

See also drawControl（ ） 。

QStyle.PixelMetric

这个枚举变量描述了各种可用的像素指标。像素度量是由一个单一的像素值所代表的风格取决于大小。

下面的值已过时：

See also pixelMetric（ ） 。

QStyle.PrimitiveElement

这个枚举变量描述的各种基本元素。一个基本元素是一种常见的GUI元素，如复选框指示器或按钮斜角。

See also drawPrimitive（ ） 。

QStyle.RequestSoftwareInputPanel

在什么情况下一个软件输入面板将能够输入部件要求该枚举描述。

See also QEvent.RequestSoftwareInputPanel和QInputContext。

QStyle.StandardPixmap

这个枚举变量描述了可用的标准像素图。一个标准的像素图是一个可以遵循一些现有的GUI风格或指引一个像素图。

See also standardIcon（ ） 。

QStyle.StateFlag

这个枚举介绍了绘制基本元素时使用的标志。

请注意，并非所有的原语使用所有这些标志，而该标志可能意味着不同的事情不同的项目。

国家类型是一个typedef为QFlags\u003cStateFlag\u003e 。它存储StateFlag值的或组合。

See also drawPrimitive（ ） 。

QStyle.StyleHint

这个枚举变量描述了可用的样式提示。样式提示是一般的外观和/或感觉的暗示。

See also styleHint（ ） 。

QStyle.SubControl

这个枚举变量描述了可用的子控件。一个子控件是一个复杂的控制范围之内的控制元件（ComplexControl） 。

该子控件的类型是一个typedef为QFlags\u003cSubControl\u003e 。它存储子控件的值的OR组合。

See also ComplexControl。

QStyle.SubElement

该枚举表示插件的一个子区域。风格实现使用这些区域来绘制控件的不同部分。

See also subElementRect（ ） 。

Method Documentation

QStyle.__init__ (self)

构造一个样式对象。

QRect QStyle.alignedRect (Qt.LayoutDirection direction, Qt.Alignment alignment, QSize size, QRect rectangle)

[

返回指定的一个新的矩形size这是相一致的定rectangle根据指定的alignment和direction。

int QStyle.combinedLayoutSpacing (self, QSizePolicy.ControlTypes controls1, QSizePolicy.ControlTypes controls2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)

返回应之间使用间隔controls1和controls2在一个布局。orientation指定控制是否进行布局并排或垂直堆叠。该option参数可用于传递有关的父窗口部件的额外信息。该widget参数是可选的，也可以使用如option为0。

]($docs-qrect.html)

controls1和controls2是零个或多个或组合control types。

这个函数被调用布局系统。它仅用于PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing返回一个负值。

此功能被引入Qt的4.3 。

See also layoutSpacing（）和layoutSpacingImplementation（ ） 。

QStyle.drawComplexControl (self, ComplexControl cc, QStyleOptionComplex opt, QPainter p, QWidget widget = None)

这种方法是抽象的，应在任何子类中重新实现。

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

该widget参数是可选的，可以作为援助绘制控件。

该option参数是一个指向QStyleOptionComplex可以使用强制转换为正确的子类对象的qstyleoption_cast（）函数。注意，这个rect指定的成员option必须是逻辑坐标。此函数的重新实现应该使用visualRect（ ）调用之前改变逻辑坐标到屏幕坐标drawPrimitive（）或drawControl（）函数。

下表是列出复杂的控制元件及其相关样式选项的子类。在样式选项包含所有绘制控件所需的参数，包括QStyleOption.state其持有的style flags被绘制时使用。该表还描述了标志，是铸造给定的设定时，option到适当的子类。

See also drawPrimitive（）和drawControl（ ） 。

QStyle.drawControl (self, ControlElement element, QStyleOption opt, QPainter p, QWidget widget = None)

这种方法是抽象的，应在任何子类中重新实现。

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

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

下表列出被控制元件及其相关样式选项的子类。在样式选项包含所有绘制控件所需的参数，包括QStyleOption.state它认为，绘制时所使用的风格标志。该表还描述了被投给定的选项，以适当的子类时设置的标志。

需要注意的是，如果一个控制元件没有列在这里，这是因为它使用的是普通QStyleOption对象。

See also drawPrimitive（）和drawComplexControl（ ） 。

QStyle.drawItemPixmap (self, QPainter painter, QRect rect, int alignment, QPixmap pixmap)

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

See also drawItemText（ ） 。

QStyle.drawItemText (self, QPainter painter, QRect rectangle, int alignment, QPalette palette, bool enabled, QString text, QPalette.ColorRole textRole = QPalette.NoRole)

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

根据指定的使用画家的画笔绘制文本，并对齐和包裹alignment。如果明确textRole被指定的，文字是用画的palette的颜色在给定的角色。该enabled参数指示是否该项目已启用，重新实现此功能时，该enabled参数应该如何影响该项目的结论。

See also Qt.Alignment和drawItemPixmap（ ） 。

QStyle.drawPrimitive (self, PrimitiveElement pe, QStyleOption opt, QPainter p, QWidget widget = None)

这种方法是抽象的，应在任何子类中重新实现。

绘制给定的原始element用所提供的painter通过使用指定的样式选项option。

该widget参数是可选的，可能包含在绘图的基本元素可以帮助一个小部件。

如下表列出的基本元素及其相关样式选项的子类。在样式选项包含所有绘制的元素所需的参数，包括QStyleOption.state它认为，绘制时所使用的风格标志。该表还描述了被投给定的选项，以适当的子类时设置的标志。

需要注意的是，如果一个原始的元素不在此列，这是因为它采用了纯QStyleOption对象。

See also drawComplexControl（）和drawControl（ ） 。

QPixmap QStyle.generatedIconPixmap (self, QIcon.Mode iconMode, QPixmap pixmap, QStyleOption opt)

[

这种方法是抽象的，应在任何子类中重新实现。

返回给定的一个副本pixmap，风格以符合规定iconMode并考虑到所指定的调色板option。

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

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

]($docs-qpixmap.html)

See also QIcon。

SubControl QStyle.hitTestComplexControl (self, ComplexControl cc, QStyleOptionComplex opt, QPoint pt, QWidget widget = None)

[

这种方法是抽象的，应在任何子类中重新实现。

返回子控制在给定的position在给定的复control（由指定的样式选项option） 。

注意，这个position表现在屏幕坐标。

]($docs-qstyle.html#SubControl-enum)

该option参数是一个指针，指向一个QStyleOptionComplex对象（或它的子类） 。该对象可以使用强制转换为适当的类型qstyleoption_cast（）函数。看drawComplexControl（ ）了解详情。该widget参数是可选的，并且可以包含其他信息的功能。

See also drawComplexControl（）和subControlRect（ ） 。

QRect QStyle.itemPixmapRect (self, QRect r, int flags, QPixmap pixmap)

[

于给定的返回区rectangle在其中绘制指定pixmap根据所定义的alignment。

]($docs-qrect.html)

QRect QStyle.itemTextRect (self, QFontMetrics fm, QRect r, int flags, bool enabled, QString text)

[

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

]($docs-qrect.html)

如果给定的rectangle比来呈现所需要的面积大的text，返回的矩形将中的偏移量rectangle根据指定的alignment。例如，如果alignment is Qt.AlignCenter，返回的矩形将内居中rectangle。如果给定的rectangle比所需要的面积小，则返回的矩形将是最小的矩形大到足以使该text。

See also Qt.Alignment。

int QStyle.layoutSpacing (self, QSizePolicy.ControlType control1, QSizePolicy.ControlType control2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)

返回应之间使用间隔control1和control2在一个布局。orientation指定控制是否进行布局并排或垂直堆叠。该option参数可用于传递有关的父窗口部件的额外信息。该widget参数是可选的，也可以使用如option为0。

这个函数被调用布局系统。它仅用于PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing返回一个负值。

对于二进制兼容性的原因，这个功能是不是虚拟的。如果你想在一个指定自定义布局间距QStyle子类，实现了一个名为槽layoutSpacingImplementation（ ） 。QStyle会发现槽在运行时（使用Qt的meta-object system）和直接所有调用layoutSpacing （）来layoutSpacingImplementation（ ） 。

此功能被引入Qt的4.3 。

See also combinedLayoutSpacing（）和layoutSpacingImplementation（ ） 。

int QStyle.layoutSpacingImplementation (self, QSizePolicy.ControlType control1, QSizePolicy.ControlType control2, Qt.Orientation orientation, QStyleOption option = None, QWidget widget = None)

这种方法也是一个Qt槽与C + +的签名int layoutSpacingImplementation(QSizePolicy::ControlType,QSizePolicy::ControlType,Qt::Orientation,const QStyleOption * = 0,const QWidget * = 0) const。

这个槽被调用者layoutSpacing（）来确定应该之间使用间隔control1和control2在一个布局。orientation指定控制是否进行布局并排或垂直堆叠。该option参数可用于传递有关的父窗口部件的额外信息。该widget参数是可选的，也可以使用如option为0。

如果您想提供自定义布局间距的QStyle子类，在子类实现一个名为layoutSpacingImplementation插槽（ ） 。请注意，此插槽将仅在被调用PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing返回一个负值。

默认实现返回-1 。

此功能被引入Qt的4.3 。

See also layoutSpacing（）和combinedLayoutSpacing（ ） 。

int QStyle.pixelMetric (self, PixelMetric metric, QStyleOption option = None, QWidget widget = None)

这种方法是抽象的，应在任何子类中重新实现。

返回给定像素的值metric。

指定option和widget可用于计算所述度量。在一般情况下，widget参数不使用。该option可以使用强制转换为适当的类型qstyleoption_cast（）函数。注意，这个option可能为零甚至为PixelMetrics ，可以使的它的使用。请参阅下表为适当option施放：

一些像素指标正在从所谓的小部件和一些仅由风格内部调用。如果度量标准不调用一个小部件，它的风格作者的自由裁量权，使的它的使用。对于一些样式，这可能并不合适。

QStyle.polish (self, QWidget)

初始化给定的外观widget。

这个函数被调用的每个部件在某些时候它已经完全建立之后，但只是before它显示的是第一次。

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

该QWidget.inherits（ ）函数可以提供足够的信息，使类特定的自定义设置。但由于新QStyle子类都必须给予所有当前和合理的工作future小部件，有限使用硬编码的定制建议。

See also unpolish（ ） 。

QStyle.polish (self, QApplication)

这是一个重载函数。

给定的晚初始化application对象。

QPalette QStyle.polish (self, QPalette)

[

这是一个重载函数。

更改palette根据样式调色板的具体要求（如果有的话） 。

]($docs-qpalette.html)

See also QPalette和QApplication.setPalette（ ） 。

QStyle QStyle.proxy (self)

[

该函数返回这种风格目前代理。默认情况下，大多数款式将返回自己。然而，当一个代理样式是在使用中，它将使风格回调到其代理。

此功能被引入Qt的4.6 。

]($docs-qstyle.html)

QSize QStyle.sizeFromContents (self, ContentsType ct, QStyleOption opt, QSize contentsSize, QWidget widget = None)

[

这种方法是抽象的，应在任何子类中重新实现。

返回由指定所描述的元件的尺寸option和type的基础上，提供contentsSize。

]($docs-qsize.html)

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

请参阅下表为适当option施放：

See also ContentsType和QStyleOption。

int QStyle.sliderPositionFromValue (int min, int max, int logicalValue, int span, bool upsideDown = False)

转换给定的logicalValue到的像素位置。该min参数映射到0 ，max映射到span和其他值都均匀地分布在两者之间。

此功能可以处理整个整数范围内无溢出，前提是span小于4096 。

默认情况下，这个函数假设的最大值是上水平的项目的权利，并在底部垂直项目。设置upsideDown参数设置为True来扭转这种行为。

See also sliderValueFromPosition（ ） 。

int QStyle.sliderValueFromPosition (int min, int max, int position, int span, bool upsideDown = False)

在给定的像素变换position到一个逻辑值。 0映射到min参数，span映射到max和其他值都均匀地分布在两者之间。

此功能可以处理整个整数范围内无溢出。

默认情况下，这个函数假设的最大值是上水平的项目的权利，并在底部垂直项目。设置upsideDown参数设置为True来扭转这种行为。

See also sliderPositionFromValue（ ） 。

QIcon QStyle.standardIcon (self, StandardPixmap standardIcon, QStyleOption option = None, QWidget widget = None)

[

对于给定的返回一个图标standardIcon。

该standardIcon是一个标准的像素图，可以遵循一些现有的GUI风格或指引。该option参数可以定义相应的图标时，用于传递所需的额外信息。该widget参数是可选的，也可以用来帮助图标的决心。

]($docs-qicon.html)

Warning:因为二进制兼容性的限制，这个功能是不是虚拟的。如果你想提供自己的图标了QStyle子类，重新实现standardIconImplementation（）槽在你的子类来代替。该standardIcon （ ）函数将动态检测插槽，并调用它。

这个函数是Qt 4.1中引入。

See also standardIconImplementation（ ） 。

QIcon QStyle.standardIconImplementation (self, StandardPixmap standardIcon, QStyleOption option = None, QWidget widget = None)

[

这种方法也是一个Qt槽与C + +的签名QIcon standardIconImplementation(QStyle::StandardPixmap,const QStyleOption * = 0,const QWidget * = 0) const。

对于给定的返回一个图标standardIcon。

]($docs-qicon.html)

重新实现这个插槽来提供自己的图标了QStyle子类，因为二进制兼容性的限制，standardIcon（ ）函数（ Qt 4.1中引入的）是不是虚拟的。相反，standardIcon（ ）将动态检测并调用this插槽。

该standardIcon是一个标准的像素图，可以遵循一些现有的GUI风格或指引。该option参数可以定义相应的图标时，用于传递所需的额外信息。该widget参数是可选的，也可以用来帮助图标的决心。

这个函数是Qt 4.1中引入。

See also standardIcon（ ） 。

QPalette QStyle.standardPalette (self)

[

返回样式的标准调色板。

需要注意的是在支持系统颜色系统中，不使用样式的标准调色板。特别是，在Windows XP ，Vista和Mac的样式不使用标准的调色板，但使用原生主题引擎。有了这些款式，你不应该设置QApplication.setStandardPalette （ ）的调色板。

]($docs-qpalette.html)

QPixmap QStyle.standardPixmap (self, StandardPixmap standardPixmap, QStyleOption option = None, QWidget widget = None)

[

这种方法是抽象的，应在任何子类中重新实现。

int QStyle.styleHint (self, StyleHint stylehint, QStyleOption option = None, QWidget widget = None, QStyleHintReturn returnData = None)

这种方法是抽象的，应在任何子类中重新实现。

返回表示指定样式的整数hint对于给定的widget由提供的样式描述option。

]($docs-qpixmap.html)

returnData用于当查询部件需要比整数， styleHint （）返回的更详细的数据。请参阅QStyleHintReturn类描述的细节。

QRect QStyle.subControlRect (self, ComplexControl cc, QStyleOptionComplex opt, SubControl sc, QWidget widget = None)

[

这种方法是抽象的，应在任何子类中重新实现。

返回指定包含矩形subControl在给定的复杂control（由指定的样式option） 。该矩形的屏幕坐标定义。

]($docs-qrect.html)

该option参数是一个指向QStyleOptionComplex或它的一个子类，并可以使用强制转换为适当的类型qstyleoption_cast（）函数。看drawComplexControl（ ）了解详情。该widget是可选的，可以包含其他信息的功能。

See also drawComplexControl（ ） 。

QRect QStyle.subElementRect (self, SubElement subElement, QStyleOption option, QWidget widget = None)

[

这种方法是抽象的，应在任何子类中重新实现。

返回子区为给定的element在所提供的样式描述option。返回矩形的屏幕坐标定义。

]($docs-qrect.html)

该widget参数是可选的并且可以用来辅助确定的区域。该QStyleOption对象可以使用强制转换为适当的类型qstyleoption_cast（）函数。请参阅下表为适当option施放：

QStyle.unpolish (self, QWidget)

取消初始化给定的widget的外观。

此功能是对应到polish（ ） 。这就是所谓的每一个部件打磨每当风格是动态变化的，前者的风格有unpolish其设置之前，新的样式可以再次擦亮他们。

注意， unpolish （）将只如果窗口部件被破坏调用。这可能会导致问题在某些情况下，例如，如果你从UI中删除一个小部件，对其进行缓存，然后重新插入它的风格已经改变之后，一些Qt的类的缓存其部件。

See also polish（ ） 。

QStyle.unpolish (self, QApplication)

这是一个重载函数。

取消初始化给定的application。

Qt.Alignment QStyle.visualAlignment (Qt.LayoutDirection direction, Qt.Alignment alignment)

术将alignment的Qt.AlignLeft or Qt.AlignRight无Qt.AlignAbsolute成Qt.AlignLeft or Qt.AlignRight同Qt.AlignAbsolute根据布局direction。其他的对齐标志保持不变。

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

QWidget.layoutDirection

QPoint QStyle.visualPos (Qt.LayoutDirection direction, QRect boundingRect, QPoint logicalPos)

[

返回给定logicalPosition转换到基于指定的屏幕坐标direction。该boundingRectangle执行转换时使用。

]($docs-qpoint.html)

See also QWidget.layoutDirection。

QRect QStyle.visualRect (Qt.LayoutDirection direction, QRect boundingRect, QRect logicalRect)

[

返回给定logicalRectangle转换到基于指定的屏幕坐标direction。该boundingRectangle执行转换时使用。

]($docs-qrect.html)

这个功能被提供以支持从右到左的桌面，并且通常用在该实施subControlRect（）函数。

See also QWidget.layoutDirection。