QAbstract3DAxis Class
QAbstract3DAxis 类是图形坐标轴的基类。更多内容...
| 头文件： | #include <QAbstract3DAxis> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake： | QT += datavisualization |
| 自： | QtDataVisualization 1.0 |
| 在 QML 中： | AbstractAxis3D |
| 继承自： | QObject |
| 被继承类： | |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | AxisOrientation { AxisOrientationNone, AxisOrientationX, AxisOrientationY, AxisOrientationZ } |
| enum | AxisType { AxisTypeNone, AxisTypeCategory, AxisTypeValue } |
属性
|
|
公共函数
| virtual | ~QAbstract3DAxis() |
| bool | isAutoAdjustRange() const |
| bool | isTitleFixed() const |
| bool | isTitleVisible() const |
| float | labelAutoRotation() const |
| QStringList | labels() const |
| float | max() const |
| float | min() const |
| QAbstract3DAxis::AxisOrientation | orientation() const |
| void | setAutoAdjustRange(bool autoAdjust) |
| void | setLabelAutoRotation(float angle) |
| void | setLabels(const QStringList &labels) |
| void | setMax(float max) |
| void | setMin(float min) |
| void | setRange(float min, float max) |
| void | setTitle(const QString &title) |
| void | setTitleFixed(bool fixed) |
| void | setTitleVisible(bool visible) |
| QString | title() const |
| QAbstract3DAxis::AxisType | type() const |
信号
| void | autoAdjustRangeChanged(bool autoAdjust) |
| void | labelAutoRotationChanged(float angle) |
| void | labelsChanged() |
| void | maxChanged(float value) |
| void | minChanged(float value) |
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
| void | rangeChanged(float min, float max) |
| void | titleChanged(const QString &newTitle) |
| void | titleFixedChanged(bool fixed) |
| void | titleVisibilityChanged(bool visible) |
另请参阅 QCategory3DAxis 和QValue3DAxis 。
成员类型文档
enum QAbstract3DAxis::AxisOrientation
轴对象的方向。
| 常量 | 值 |
|---|---|
QAbstract3DAxis::AxisOrientationNone | 0 |
QAbstract3DAxis::AxisOrientationX | 1 |
QAbstract3DAxis::AxisOrientationY | 2 |
QAbstract3DAxis::AxisOrientationZ | 4 |
enum QAbstract3DAxis::AxisType
轴对象的类型。
| 常量 | 值 |
|---|---|
QAbstract3DAxis::AxisTypeNone | 0 |
QAbstract3DAxis::AxisTypeCategory | 1 |
QAbstract3DAxis::AxisTypeValue | 2 |
属性文档
autoAdjustRange : bool
此属性决定坐标轴是否会自动调整范围，以使所有数据都能显示在其中。
访问函数：
| bool | isAutoAdjustRange() const |
| void | setAutoAdjustRange(bool autoAdjust) |
通知信号：
| void | autoAdjustRangeChanged(bool autoAdjust) |
另请参阅 setRange()、setMin() 以及setMax()。
labelAutoRotation : float
该属性用于指定当摄像机角度发生变化时，标签可自动旋转的最大角度。
该角度的取值范围为0到90（含0和90）。默认值为0。若值为0，坐标轴标签不会自动旋转。若值大于零，标签将尝试朝向摄像头调整方向，最大旋转角度不超过指定值。
访问函数：
| float | labelAutoRotation() const |
| void | setLabelAutoRotation(float angle) |
通知信号：
| void | labelAutoRotationChanged(float angle) |
labels : QStringList
该属性用于存储坐标轴的标签。
注意： 为 QValue3DAxis设置 此属性不会产生任何效果，因为它会自动生成标签。
访问函数：
| QStringList | labels() const |
| void | setLabels(const QStringList &labels) |
通知器信号：
| void | labelsChanged() |
max : float
该属性存储轴上的最大值。
设置此属性时，系统会根据需要调整最小值，以确保范围保持有效。
注意：对于 QCategory3DAxis，该属性指定要显示的最后一行或列的索引。
访问函数：
| float | max() const |
| void | setMax(float max) |
通知信号：
| void | maxChanged(float value) |
min : float
该属性存储了轴上的最小值。
设置此属性时，系统会根据需要调整最大值，以确保范围保持有效。
注意：对于 QCategory3DAxis，指定要显示的第一行或第一列的索引。
访问函数：
| float | min() const |
| void | setMin(float min) |
通知信号：
| void | minChanged(float value) |
[read-only] orientation : AxisOrientation
该属性存储轴的方向。
该值是AxisOrientation 中的一个值。
访问函数：
| QAbstract3DAxis::AxisOrientation | orientation() const |
通知信号：
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
title : QString
该属性用于指定坐标轴的标题。
访问函数：
| QString | title() const |
| void | setTitle(const QString &title) |
通知信号：
| void | titleChanged(const QString &newTitle) |
另请参阅 titleVisible 和titleFixed 。
titleFixed : bool
该属性控制坐标轴标题的旋转角度。
如果true ，主图表视图中的坐标轴标题将像坐标轴标签一样朝向摄像机旋转。如果false ，坐标轴标题仅围绕其轴线旋转，但不会朝向摄像机。如果labelAutoRotation 属性的值为零，则此属性无任何效果。默认值为true 。
访问函数：
| bool | isTitleFixed() const |
| void | setTitleFixed(bool fixed) |
通知器信号：
| void | titleFixedChanged(bool fixed) |
另请参阅 labelAutoRotation 、title 和titleVisible 。
titleVisible : bool
该属性控制轴标题在主图表视图中是否可见。
默认值为false 。
访问函数：
| bool | isTitleVisible() const |
| void | setTitleVisible(bool visible) |
通知信号：
| void | titleVisibilityChanged(bool visible) |
另请参阅 title 和titleFixed 。
[read-only] type : const AxisType
该属性存储轴的类型。
该值是AxisType 值之一。
访问函数：
| QAbstract3DAxis::AxisType | type() const |
成员函数文档
[virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()
销毁QAbstract3DAxis 。
[signal] void QAbstract3DAxis::rangeChanged(float min, float max)
当范围发生变化时，会发出该范围的最小值和最大值，即min 和max 。
void QAbstract3DAxis::setRange(float min, float max)
将坐标轴的取值范围设置为min 至max 。设置范围时，系统会根据需要调整最大值，以确保该范围始终有效。
注意：对于 QCategory3DAxis，指定要显示的行或列的索引范围。
© 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.
