QStyleOption 类存储的参数用于 QStyle 函数。 更多...
| 头： | #include <QStyleOption> |
| CMake: |
find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 继承者： | QStyleOptionButton , QStyleOptionComplex , QStyleOptionDockWidget , QStyleOptionFocusRect , QStyleOptionFrame , QStyleOptionGraphicsItem , QStyleOptionHeader , QStyleOptionMenuItem , QStyleOptionProgressBar , QStyleOptionRubberBand , QStyleOptionTab , QStyleOptionTabBarBase , QStyleOptionTabWidgetFrame , QStyleOptionToolBar , QStyleOptionToolBox ，和 QStyleOptionViewItem |
| enum | OptionType { SO_Button, SO_ComboBox, SO_Complex, SO_Default, SO_DockWidget, …, SO_ComplexCustomBase } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| QStyleOption (int version = QStyleOption::Version, int type = SO_Default) | |
| QStyleOption (const QStyleOption & other ) | |
| ~QStyleOption () | |
| void | initFrom (const QWidget * widget ) |
| QStyleOption & | operator= (const QStyleOption & other ) |
| Qt::LayoutDirection | direction |
| QFontMetrics | fontMetrics |
| QPalette | palette |
| QRect | rect |
| QStyle::State | state |
| QObject * | styleObject |
| int | type |
| int | version |
| T | qstyleoption_cast (const QStyleOption * option ) |
| T | qstyleoption_cast (QStyleOption * option ) |
QStyleOption 及其子类包含所有信息当 QStyle 函数需要绘制图形元素。
出于性能原因，有很少成员函数，且对成员变量的访问是直接的 (即：使用
.
or
->
运算符)。这使结构易于使用并强调这些只需通过样式函数使用参数。
调用者的 QStyle 函数通常在堆栈中创建 QStyleOption 对象。组合这与 Qt 广泛使用的 隐式共享 对于类型譬如 QString , QPalette ，和 QColor 确保不发生不必要的内存分配。
以下代码片段展示如何使用特定 QStyleOption 子类来描绘按钮：
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); }
范例中，控件是 QStyle::CE_PushButton ，和根据 QStyle::drawControl () 文档编制，相应类是 QStyleOptionButton .
当重实现 QStyle 函数以接受 QStyleOption 参数，经常需要将 QStyleOption 铸造成子类。为安全起见，可以使用 qstyleoption_cast () 以确保指针类型正确。例如：
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) { // ... } } // ... }
The
qstyleoption_cast
() 函数将返回 0 若对象指向的
option
类型不正确。
对于可以如何使用样式选项的演示范例，见 样式 范例。
另请参阅 QStyle and QStylePainter .
此枚举被内部使用，通过 QStyleOption ，其子类，和 qstyleoption_cast () to 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
|
0xf0004
|
QStyleOptionComboBox |
QStyleOption::SO_Complex
|
0xf0000
|
QStyleOptionComplex |
QStyleOption::SO_Default
|
0
|
QStyleOption |
QStyleOption::SO_DockWidget
|
9
|
QStyleOptionDockWidget |
QStyleOption::SO_FocusRect
|
1
|
QStyleOptionFocusRect |
QStyleOption::SO_Frame
|
5
|
QStyleOptionFrame |
QStyleOption::SO_GraphicsItem
|
15
|
QStyleOptionGraphicsItem |
QStyleOption::SO_GroupBox
|
0xf0006
|
QStyleOptionGroupBox |
QStyleOption::SO_Header
|
8
|
QStyleOptionHeader |
QStyleOption::SO_MenuItem
|
4
|
QStyleOptionMenuItem |
QStyleOption::SO_ProgressBar
|
6
|
QStyleOptionProgressBar |
QStyleOption::SO_RubberBand
|
13
|
QStyleOptionRubberBand |
QStyleOption::SO_SizeGrip
|
0xf0007
|
QStyleOptionSizeGrip |
QStyleOption::SO_Slider
|
0xf0001
|
QStyleOptionSlider |
QStyleOption::SO_SpinBox
|
0xf0002
|
QStyleOptionSpinBox |
QStyleOption::SO_Tab
|
3
|
QStyleOptionTab |
QStyleOption::SO_TabBarBase
|
12
|
QStyleOptionTabBarBase |
QStyleOption::SO_TabWidgetFrame
|
11
|
QStyleOptionTabWidgetFrame |
QStyleOption::SO_TitleBar
|
0xf0005
|
QStyleOptionTitleBar |
QStyleOption::SO_ToolBar
|
14
|
QStyleOptionToolBar |
QStyleOption::SO_ToolBox
|
7
|
QStyleOptionToolBox |
QStyleOption::SO_ToolButton
|
0xf0003
|
QStyleOptionToolButton |
QStyleOption::SO_ViewItem
|
10
|
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 |
另请参阅 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
|
提供样式选项的类型 ( SO_Default 对于此类)。 |
类型内部使用通过 QStyleOption ，其子类，和 qstyleoption_cast () to 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 |
版本的使用通过 QStyleOption 子类以实现扩展在不破坏兼容性的情况下。若使用 qstyleoption_cast ()，通常不需要校验它。
另请参阅 StyleOptionType .
构造 QStyleOption 采用指定 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 type.
The state 成员变量被初始化为 QStyle::State_None .
构造副本为 other .
销毁此样式选项对象。
初始化 state , direction , rect , palette , fontMetrics and styleObject 成员变量基于指定的 widget .
这是方便函数；还可以手动初始化成员变量。
另请参阅 QWidget::layoutDirection (), QWidget::rect (), QWidget::palette ()，和 QWidget::fontMetrics ().
赋值 other 到此 QStyleOption .
此变量保持应使用的文本布局方向，当在控件中绘制文本时
默认情况下，布局方向为 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
默认情况下，使用应用程序的默认调色板。
另请参阅 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 ().
此变量保持所使用的样式标志，当绘制控件时
默认值为 QStyle::State_None .
另请参阅 initFrom (), QStyle::drawPrimitive (), QStyle::drawControl (), QStyle::drawComplexControl ()，和 QStyle::State .
此变量保持要样式化的对象
内置样式支持下列类型： QWidget , QGraphicsObject and QQuickItem .
另请参阅 initFrom ().
此变量保持样式选项的选项类型
默认值为 SO_Default .
另请参阅 OptionType .
此变量保存样式选项的版本
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。
返回 T 或
nullptr
从属
type
and
version
为给定
option
.
范例：
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::type and QStyleOption::version .
这是重载函数。
返回 T 或
nullptr
从属类型为给定
option
.
