QStyleOption 类存储的参数，使用通过 QStyle 函数。 更多...
Inherited by QStyleOptionButton , QStyleOptionComplex , QStyleOptionDockWidget , QStyleOptionFocusRect , QStyleOptionFrame , QStyleOptionGraphicsItem , QStyleOptionHeader , QStyleOptionMenuItem , QStyleOptionProgressBar , QStyleOptionRubberBand , QStyleOptionTab , QStyleOptionTabBarBase , QStyleOptionTabWidgetFrame , QStyleOptionToolBar , QStyleOptionToolBox and QStyleOptionViewItem .
QStyleOption 类存储的参数，使用通过 QStyle 函数。
QStyleOption and its subclasses contain all the information that QStyle functions need to draw a graphical 元素。
For performance reasons, there are few member functions and the access to the member variables is direct (i.e., using the . or -> operator). This low-level feel makes the structures straightforward to use and emphasizes that these are simply parameters used by the style functions.
The caller of a QStyle function usually creates QStyleOption objects on the stack. This combined with Qt's extensive use of implicit sharing for types such as QString , QPalette ，和 QColor ensures that no memory allocation needlessly takes place.
The following code snippet shows how to use a specific QStyleOption subclass to paint a push button:
void MyPushButton.paintEvent(QPaintEvent *) { QStyleOptionButton option; option.initFrom(this); option.state = isDown() ? QStyle.State_Sunken : QStyle.State_Raised; if (isDefault()) option.features |= QStyleOptionButton.DefaultButton; option.text = text(); option.icon = icon(); QPainter painter(this); style()->drawControl(QStyle.CE_PushButton, &option, &painter, this); }
In our example, the control is a QStyle.CE_PushButton ，和 according to the QStyle.drawControl () documentation the corresponding class is QStyleOptionButton .
When reimplementing QStyle 函数 that take a QStyleOption parameter, you often need to cast the QStyleOption to a subclass. For safety, you can use qstyleoption_cast () 到 ensure that the pointer type is correct. For example:
void MyStyle.drawPrimitive(PrimitiveElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget) { if (element == PE_FrameFocusRect) { const QStyleOptionFocusRect *focusRectOption = qstyleoption_cast<const QStyleOptionFocusRect *>(option); if (focusRectOption) { // ... } } // ... }
qstyleoption_cast () function will return 0 if the object to which option points is not of the correct type.
For an example demonstrating how style options can be used, see the 样式 范例。
此枚举被内部使用，通过 QStyleOption , its subclasses, and qstyleoption_cast () 到 determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.
| 常量 | 值 | 描述 |
|---|---|---|
| QStyleOption.SO_Button | 2 | QStyleOptionButton |
| QStyleOption.SO_ComboBox | ? | QStyleOptionComboBox |
| QStyleOption.SO_Complex | 0xf0000 | QStyleOptionComplex |
| QStyleOption.SO_Default | 0 | QStyleOption |
| QStyleOption.SO_DockWidget | 10 | QStyleOptionDockWidget |
| QStyleOption.SO_FocusRect | 1 | QStyleOptionFocusRect |
| QStyleOption.SO_Frame | 5 | QStyleOptionFrame QStyleOptionFrameV2 |
| QStyleOption.SO_GraphicsItem | 17 | QStyleOptionGraphicsItem |
| QStyleOption.SO_GroupBox | ? | QStyleOptionGroupBox |
| QStyleOption.SO_Header | 8 | QStyleOptionHeader |
| QStyleOption.SO_MenuItem | 4 | QStyleOptionMenuItem |
| QStyleOption.SO_ProgressBar | 6 | QStyleOptionProgressBar QStyleOptionProgressBarV2 |
| QStyleOption.SO_RubberBand | 15 | QStyleOptionRubberBand |
| QStyleOption.SO_SizeGrip | ? | QStyleOptionSizeGrip |
| QStyleOption.SO_Slider | ? | QStyleOptionSlider |
| QStyleOption.SO_SpinBox | ? | QStyleOptionSpinBox |
| QStyleOption.SO_Tab | 3 | QStyleOptionTab |
| QStyleOption.SO_TabBarBase | 14 | QStyleOptionTabBarBase |
| QStyleOption.SO_TabWidgetFrame | 13 | QStyleOptionTabWidgetFrame |
| QStyleOption.SO_TitleBar | ? | QStyleOptionTitleBar |
| QStyleOption.SO_ToolBar | 16 | QStyleOptionToolBar |
| QStyleOption.SO_ToolBox | 7 | QStyleOptionToolBox |
| QStyleOption.SO_ToolButton | ? | QStyleOptionToolButton |
| QStyleOption.SO_ViewItem | 12 | QStyleOptionViewItem (used in Interviews) |
The following values are used for custom controls:
| 常量 | 值 | 描述 |
|---|---|---|
| QStyleOption.SO_CustomBase | 0xf00 | Reserved for custom QStyleOptions; all custom controls values must be above this value |
| QStyleOption.SO_ComplexCustomBase | 0xf000000 | Reserved for custom QStyleOptions; all custom complex controls values must be above this value |
Some style options are defined for various Qt3Support controls:
| 常量 | 值 | 描述 |
|---|---|---|
| QStyleOption.SO_Q3DockWindow | 9 | QStyleOptionQ3DockWindow |
| QStyleOption.SO_Q3ListView | ? | QStyleOptionQ3ListView |
| QStyleOption.SO_Q3ListViewItem | 11 | QStyleOptionQ3ListViewItem |
另请参阅 type .
This enum is used to hold information about the type of the style option, and is defined for each QStyleOption 子类。
| 常量 | 值 | 描述 |
|---|---|---|
| QStyleOption.Type | SO_Default | The type of style option provided ( SO_Default for this class). |
The type is used internally by QStyleOption , its subclasses, and qstyleoption_cast () 到 determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.
另请参阅 StyleOptionVersion .
This enum is used to hold information about the version of the style option, and is defined for each QStyleOption 子类。
| 常量 | 值 | 描述 |
|---|---|---|
| QStyleOption.Version | 1 | 1 |
The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast (), you normally do not need to check it.
另请参阅 StyleOptionType .
构造 QStyleOption with the specified version and type .
The version has no special meaning for QStyleOption ; it can be used by subclasses to distinguish between different version of the same option 类型。
state member variable is initialized to QStyle.State_None .
构造副本为 other .
初始化 state , direction , rect , palette ，和 fontMetrics member variables based on the specified widget .
This is a convenience function; the member variables can also be initialized manually.
该函数在 Qt 4.1 引入。
另请参阅 QWidget.layoutDirection (), QWidget.rect (), QWidget.palette ()，和 QWidget.fontMetrics ().
This variable holds the text layout direction that should be used when drawing text in the control.
By default, the layout direction is Qt.LeftToRight .
另请参阅 initFrom ().
This variable holds the font metrics that should be used when drawing text in the control.
By default, the application's default font is used.
另请参阅 initFrom ().
This variable holds the palette that should be used when painting the control.
By default, the application's default palette is used.
另请参阅 initFrom ().
This variable holds the area that should be used for various calculations and painting.
This can have different meanings for different types of elements. For example, for a QStyle.CE_PushButton element it would be the rectangle for the entire button, while for a QStyle.CE_PushButtonLabel element it would be just the area for the push button label.
The default value is a null rectangle, i.e. a rectangle with both the width and the height set to 0.
另请参阅 initFrom ().
This variable holds the style flags that are used when drawing the control.
默认值为 QStyle.State_None .
另请参阅 initFrom (), QStyle.drawPrimitive (), QStyle.drawControl (), QStyle.drawComplexControl (), and QStyle.State .
This variable holds the option type of the style option.
默认值为 SO_Default .
另请参阅 OptionType .
This variable holds the version of the style option.
This value can be used by subclasses to implement extensions without breaking compatibility. If you use the qstyleoption_cast () function, you normally do not need to check it.
默认值为 1。
