QStyleOptionGraphicsItem Class
QStyleOptionGraphicsItem 类用于描述绘制QGraphicsItem 所需的参数。更多内容...
| 头文件： | #include <QStyleOptionGraphicsItem> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承自： | QStyleOption |
公共类型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
公共函数
| QStyleOptionGraphicsItem() | |
| QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other) | |
| QStyleOptionGraphicsItem & | operator=(const QStyleOptionGraphicsItem &) |
公共变量
| QRectF | exposedRect |
静态公共成员
| qreal | levelOfDetailFromTransform(const QTransform &worldTransform) |
另请参阅 QStyleOption 和QGraphicsItem::paint()。
成员类型文档
enum QStyleOptionGraphicsItem::StyleOptionType
该枚举用于存储有关样式选项类型的信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionGraphicsItem::Type | SO_GraphicsItem | 提供的样式选项的类型（对于此类而言为SO_GraphicsItem ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非你想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。
另请参阅 StyleOptionVersion 。
enum QStyleOptionGraphicsItem::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionGraphicsItem::Version | 1 | 1 |
QStyleOption 子类使用该版本号来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查该值。
另请参阅 StyleOptionType 。
成员函数文档
QStyleOptionGraphicsItem::QStyleOptionGraphicsItem()
创建一个 QStyleOptionGraphicsItem。
QStyleOptionGraphicsItem::QStyleOptionGraphicsItem(const QStyleOptionGraphicsItem &other)
创建other 的副本。
[static] qreal QStyleOptionGraphicsItem::levelOfDetailFromTransform(const QTransform &worldTransform)
返回来自worldTransform 的细节级别。
该值表示 Unity 矩形的高度和宽度的最大值，该矩形是通过绘制该项所使用的绘图器的worldTransform 映射而得的。 默认情况下，如果未应用任何变换，其值为 1。如果缩放比例为 1:2，细节级别将为 0.5；如果缩放比例为 2:1，其值为 2。
另请参阅 QGraphicsScene::minimumRenderSize()。
[noexcept default] QStyleOptionGraphicsItem &QStyleOptionGraphicsItem::operator=(const QStyleOptionGraphicsItem &)
将other 复制并赋值给此QStyleOptionGraphicsItem 实例。
成员变量文档
QRectF QStyleOptionGraphicsItem::exposedRect
该变量存储了暴露的矩形，单位为物品坐标系
当项目仅有一部分暴露在外时，可利用此矩形来加快项目绘制速度。如果整个项目都暴露在外，则该矩形将与 `QGraphicsItem::boundingRect()` 返回的结果相同。
仅当项目设置了QGraphicsItem::ItemUsesExtendedStyleOption 标志时，才会初始化此成员。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
