Q3DGraphsWidgetItem Class

属性文档

activeTheme : QGraphsTheme*

此属性用于保存图表的活动主题。

将activeTheme 设置为图表的活动主题。隐式调用addTheme() 将主题的所有权转移到此图形。

如果activeTheme 为空，则会创建一个临时默认主题。如果以后显式设置了任何主题，该临时主题将被销毁。即使在设置主题后，也可以修改主题的属性，而且修改会立即生效。

访问功能

通知信号

ambientLightStrength : float

该属性用于保存整个图形的环境光强度。

无论光线位置如何，该值都将决定整个图表中颜色显示的均匀度和亮度。

该值必须介于0.0f 和1.0f 之间。

访问功能：

通知信号：

aspectRatio : qreal

该属性用于保存水平面最长轴与 Y 轴之间的图形缩放比例。

默认为2.0 。

访问功能：

Notifier 信号：

另请参阅 horizontalAspectRatio 。

cameraTargetPosition : QVector3D

此属性将摄像机目标位置保存为三维空间中的矢量或顶点。

默认值为QVector3D(0.0, 0.0, 0.0) 。

有效坐标值介于-1.0...1.0 之间，其中边缘值表示相应坐标轴范围的边缘。任何超出此范围的值都会被箝位到边缘。

访问功能：

通知信号：

cameraXRotation : float

该属性用于保存摄像机绕目标点的 X 旋转角度（单位：度）。

访问功能

通知信号：

cameraYRotation : float

该属性保存摄像机绕目标点的 Y 轴旋转角度（度）。

访问功能

通知信号：

cameraZoomLevel : float

此属性以百分比表示摄像机的缩放级别。

默认值为100.0f ，表示摄像机没有设置放大或缩小。该值受minCameraZoomLevel 和maxCameraZoomLevel 属性的限制。

访问功能：

通知信号：

另请参阅 minCameraZoomLevel 和maxCameraZoomLevel 。

[read-only] currentFps : const int

该属性保存最后一秒的渲染结果。

启用 FPS 测量后，结果将存储在此只读属性中。测量激活后，该值至少需要一秒钟才能更新。

访问功能：

Notifier 信号：

另请参见 measureFps 。

gridLineType : QtGraphs3D::GridLineType

此属性表示网格线类型是QtGraphs3D::GridLineType::Shader 还是QtGraphs3D::GridLineType::Geometry 。

该值会影响所有网格线。

访问功能：

通知信号：

另请参阅 QtGraphs3D::GridLineType 。

horizontalAspectRatio : qreal

该属性表示 x 轴和 z 轴之间的图形缩放比例。

0.0 表示根据坐标轴范围自动缩放。默认值为0.0 。

对Q3DBarsWidgetItem 没有影响，它通过barThickness 和barSpacing 属性处理水平面的缩放。极坐标图形也会忽略此属性。

访问功能：

Notifier 信号：

另请参见 aspectRatio,polar,Q3DBarsWidgetItem::barThickness, 和Q3DBarsWidgetItem::barSpacing 。

labelMargin : float

该属性指定轴标签放置的边距。

负值用于将标签置于绘图区域内，正值用于将标签置于绘图区域外。当值为负数时，标签自动旋转功能将被禁用。默认值为0.1

访问功能：

Notifier 信号：

另请参阅 QAbstract3DAxis::labelAutoAngle 。

lightColor : QColor

该属性用于保存环境光和镜面反射光的颜色。

该值会影响Q3DScene 中指定的光线。

访问功能：

Notifier 信号：

lightStrength : float

该属性用于保存整个图形的镜面反射光强度。

该值必须介于0.0f 和10.0f 之间。

该值会影响Q3DScene 中指定的光线。

访问功能：

通知信号：

locale : QLocale

该属性包含用于格式化各种数字标签的本地语言。

默认为"C" locale。

访问功能：

Notifier 信号：

另请参阅 QValue3DAxis::labelFormat 。

margin : qreal

该属性用于保存可绘图区域边缘与图形背景边缘之间留出的空间的绝对值。

如果边距值为负数，边距将自动确定，并根据系列中项目的大小和图形类型而变化。如果图形纵横比未从默认值中更改，则该值将被解释为 Y 轴范围的一部分。默认值为-1.0 。

访问功能

通知信号

maxCameraXRotation : float

该属性用于保存摄像机围绕目标点的最大 X 旋转角度（单位：度）。默认值为180.0

访问功能：

通知信号：

maxCameraYRotation : float

该属性用于保存摄像机围绕目标点的最大 Y 向旋转角度（单位：度）。默认值为90.0

访问功能：

通知信号：

maxCameraZoomLevel : float

此属性保存允许的最大摄像机缩放级别。

如果最大缩放级别设置为低于现有最小缩放级别的新值，则最小缩放级别也会调整为新的最大值。如果当前的cameraZoomLevel 超出了新的范围，也会进行调整。默认值为500.0f 。

访问功能：

通知信号：

另请参阅 cameraZoomLevel 和minCameraZoomLevel 。

measureFps : bool

该属性表示渲染是否连续进行，而不是按需渲染。

如果true ，渲染将持续进行，并且currentFps 属性的值将被更新。默认为false 。

访问功能：

Notifier 信号：

另请参阅 currentFps 。

minCameraXRotation : float

该属性用于保存摄像机围绕目标点的最小 X 旋转角度（单位：度）。默认值为-180.0

访问功能：

通知信号：

minCameraYRotation : float

该属性用于保存摄像机围绕目标点的最小 Y 旋转角度（单位：度）。默认值为0.0

访问功能：

通知信号：

minCameraZoomLevel : float

此属性用于保存允许的最小摄像机缩放级别。

如果将最小级别设置为高于现有最大级别的新值，则最大级别也会调整为新的最小值。如果当前的 zoomLevel 超出了新的范围，也会进行调整。minCameraZoomLevel 不能设置为低于1.0f 。默认值为10.0f 。

访问功能：

通知信号：

另请参阅 cameraZoomLevel 和maxCameraZoomLevel 。

msaaSamples : int

该属性用于保存 MSAA 中已使用的样本数。

将已使用的 MSAA 采样个数设置为samples 。采样个数可以是 0、2、4 或 8。

访问功能：

通知信号：

optimizationHint : QtGraphs3D::OptimizationHint

指定渲染优化是使用默认模式还是传统模式。

默认模式使用实例渲染，可在大多数系统上以最佳性能提供完整的功能集。静态模式可优化图形渲染，是大型非变化数据集的理想选择。但在动态数据变化和项目旋转的情况下，该模式的运行速度较慢。选择功能未作优化，因此不建议对海量数据集使用静态模式。静态优化仅适用于散点图。传统模式会单独渲染图形中的所有项目，而不会实例化。只有在默认模式不起作用（即目标系统不支持实例化）的情况下才可使用。默认值为QtGraphs3D::OptimizationHint::Default 。

访问功能：

通知信号：

另请参见 QAbstract3DSeries::mesh 。

orthoProjection : bool

此属性表示是否使用正投影法显示图形。

默认为false 。

访问功能：

Notifier 信号：

另请参阅 QAbstract3DAxis::labelAutoAngle 。

polar : bool

水平轴是否变为极轴取决于此属性。

如果true ，则 x 轴变为角度轴，z 轴变为径向轴。极轴模式不适用于条形图。

默认为false 。

访问功能：

Notifier 信号：

另请参阅 orthoProjection 和radialLabelOffset 。

[read-only] queriedGraphPosition : const QVector3D

该属性保存沿各坐标轴最新查询的图形位置值。

此只读属性包含来自Q3DScene::graphPositionQuery 的结果。这些值已归一化为[-1, 1] 的范围。如果查询到的位置超出了图形边界，则该值将不会反映真实位置，而是表示超出[-1, 1] 范围的未定义位置。在进行查询之前，该值都是未定义的。

没有一个正确的三维坐标与特定的屏幕位置相匹配，因此为了保持一致，查询总是针对图形周围的一个不可见框的内侧进行。

访问功能：

通知信号：

另请参见 Q3DScene::graphPositionQuery 。

radialLabelOffset : float

该属性用于保存径向极轴标签的归一化水平偏移量。

0.0 表示标签应绘制在 0 角度角轴网格线旁边。1.0 表示标签绘制在图形背景边缘的常规位置。默认值为1.0 。

如果polar 属性值为false ，该属性将被忽略。

访问功能：

Notifier 信号：

另请参阅 polar 。

rotationEnabled : bool

此属性表示此输入处理程序是否允许图形旋转。

默认为true 。

访问函数：

Notifier 信号：

[read-only] scene : Q3DScene* const

该属性包含Q3DScene 指针，可用于操作场景和访问场景元素。

该属性为只读。

访问功能：

[read-only] selectedElement : const QtGraphs3D::ElementType

该属性用于保存图形中选定的元素。

该属性可用于查询所选元素的类型。该类型一直有效，直到在图形中做出新的选择并发出selectedElementChanged 信号。

例如，该信号可用于实现自定义输入处理程序，如Scatter Graph 标签下的图库示例所示。

访问功能：

Notifier 信号：

另请参阅 selectedLabelIndex(),selectedAxis(),selectedCustomItemIndex(),selectedCustomItem(),Q3DBarsWidgetItem::selectedSeries(),Q3DScatterWidgetItem::selectedSeries(),Q3DSurfaceWidgetItem::selectedSeries() 和Q3DScene::setSelectionQueryPosition().

selectionEnabled : bool

此属性表示此输入处理程序是否允许从图形中进行选择。

默认为true 。

访问功能：

Notifier 信号：

selectionMode : QtGraphs3D::SelectionFlags

项目选择模式。

SelectionFlags 的组合。默认情况下，Item 。不同的图表类型支持不同的选择模式。

访问功能：

通知信号：

另请参见 QtGraphs3D::SelectionFlags 。

shadowQuality : QtGraphs3D::ShadowQuality

此属性表示阴影的质量。

它是 ShadowQuality 枚举值之一。默认情况下，Medium 。

访问功能：

Notifier 信号：

另请参阅 QtGraphs3D::ShadowQuality 。

shadowStrength : float

该属性表示整个图形的阴影强度。

数值越大，阴影越暗。该值必须介于0.0 和100.0 之间。

该值会影响Q3DScene 中指定的光线。

访问功能：

通知信号：

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

指定要使用的透明度技术。默认值为Default 。渲染透明曲面图时，请使用Approximate 或Accurate 。

此属性在 Qt 6.9 中引入。

访问函数：

Notifier 信号：

另请参阅 QtGraphs3D::TransparencyTechnique 。

wrapCameraXRotation : bool

此属性用于设置 X 轴旋转的最小和最大限制。

如果设置为true ，摄像机的 X 轴旋转将从最小值包络到最大值，从最大值包络到最小值。如果设置为false ，摄像机的 X 轴旋转将限制在由最小值和最大值决定的扇形范围内。默认设置为true 。

访问功能：

通知信号：

wrapCameraYRotation : bool

此属性用于设置 Y 轴旋转的最小和最大限制。

如果true ，摄像机的 Y 轴旋转将从最小值到最大值以及从最大值到最小值进行包络。如果设置为false ，摄像机的 Y 轴旋转将限制在由最小值和最大值决定的扇形范围内。默认设置为true 。

访问功能：

通知信号：

zoomAtTargetEnabled : bool

此属性表示缩放是否会改变摄像机目标，以便图形的缩放点在缩放后保持在同一位置。

默认为true 。

访问功能：

通知信号：

zoomEnabled : bool

此属性表示此输入处理程序是否允许图形缩放。

默认为true 。

访问功能：

Notifier 信号：

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);