QAbstract3DAxis Class

QAbstract3DAxis 类是三维图形轴的基类。更多

Header: #include <QAbstract3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
在 QML 中: Abstract3DAxis
继承: QObject
继承于

QCategory3DAxisQValue3DAxis

公共类型

enum class AxisOrientation { None, X, Y, Z }
enum class AxisType { None, Category, Value }

属性

公共功能

virtual ~QAbstract3DAxis() override
bool isAutoAdjustRange() const
bool isScaleLabelsByCount() const
bool isTitleFixed() const
bool isTitleVisible() const
float labelAutoAngle() const
qreal labelSize() const
QStringList labels() const
bool labelsVisible() const
float max() const
float min() const
QAbstract3DAxis::AxisOrientation orientation() const
void setAutoAdjustRange(bool autoAdjust)
void setLabelAutoAngle(float degree)
void setLabelSize(qreal size)
void setLabels(const QStringList &labels)
void setLabelsVisible(bool visible)
void setMax(float max)
void setMin(float min)
void setRange(float min, float max)
void setScaleLabelsByCount(bool adjust)
void setTitle(const QString &title)
void setTitleFixed(bool fixed)
void setTitleOffset(float offset)
void setTitleVisible(bool visible)
QString title() const
float titleOffset() const
QAbstract3DAxis::AxisType type() const

信号

void autoAdjustRangeChanged(bool autoAdjust)
void labelAutoAngleChanged(float angle)
void labelSizeChanged(qreal size)
void labelVisibleChanged(bool visible)
void labelsChanged()
void maxChanged(float value)
void minChanged(float value)
void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)
void rangeChanged(float min, float max)
void scaleLabelsByCountChanged(bool adjust)
void titleChanged(const QString &newTitle)
void titleFixedChanged(bool fixed)
void titleOffsetChanged(float offset)
void titleVisibleChanged(bool visible)

详细说明

该类指定了图轴共享的枚举、属性和函数。不应直接使用该类,而应使用其子类。

另请参阅 QCategory3DAxisQValue3DAxis

成员类型文档

enum class QAbstract3DAxis::AxisOrientation

轴对象的方向。

常数
QAbstract3DAxis::AxisOrientation::None0
QAbstract3DAxis::AxisOrientation::X1
QAbstract3DAxis::AxisOrientation::Y2
QAbstract3DAxis::AxisOrientation::Z3

enum class QAbstract3DAxis::AxisType

轴对象的类型。

常数
QAbstract3DAxis::AxisType::None0
QAbstract3DAxis::AxisType::Category1
QAbstract3DAxis::AxisType::Value2

属性文档

autoAdjustRange : bool

该属性用于确定轴是否会自动调整范围,以便所有数据都适合该范围。

访问功能:

bool isAutoAdjustRange() const
void setAutoAdjustRange(bool autoAdjust)

Notifier 信号:

void autoAdjustRangeChanged(bool autoAdjust)

另请参见 setRange()、setMin() 和setMax()。

labelAutoAngle : float

当摄像机角度发生变化时,该属性表示标签可以自动旋转的最大角度。

角度范围为 0 至 90(含 90),默认值为 0。默认值为 0。如果值为 0,轴标签不会自动旋转。如果该值大于 0,标签会尝试朝向摄像机,直至达到指定角度。

访问功能:

float labelAutoAngle() const
void setLabelAutoAngle(float degree)

通知信号:

void labelAutoAngleChanged(float angle)

[since 6.9] labelSize : qreal

标签尺寸

标签的大小。该值的默认值是1.0

该属性在 Qt 6.9 中引入。

访问函数:

qreal labelSize() const
void setLabelSize(qreal size)

Notifier 信号:

void labelSizeChanged(qreal size)

另请参阅 scaleLabelsByCount()。

labels : QStringList

此属性用于保存轴的标签。

注意: QValue3DAxis 设置此属性没有任何作用,因为它会自动生成标签。

访问功能:

QStringList labels() const
void setLabels(const QStringList &labels)

通知信号:

void labelsChanged()

labelsVisible : bool

该属性用于确定在主图表视图中坐标轴标签是否可见。

默认值为true

访问功能:

bool labelsVisible() const
void setLabelsVisible(bool visible)

通知信号:

void labelVisibleChanged(bool visible)

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 : const QAbstract3DAxis::AxisOrientation

该属性表示轴的方向。

该值是AxisOrientation 值之一。

访问功能:

QAbstract3DAxis::AxisOrientation orientation() const

通知信号:

void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)

[since 6.9] scaleLabelsByCount : bool

该属性表示标签是否会根据标签总数自动调整大小。

此属性在 Qt 6.9 中引入。

访问函数:

bool isScaleLabelsByCount() const
void setScaleLabelsByCount(bool adjust)

Notifier 信号:

void scaleLabelsByCountChanged(bool adjust)

另请参阅 labelSize().

title : QString

此属性用于保存轴的标题。

访问功能:

QString title() const
void setTitle(const QString &title)

通知信号:

void titleChanged(const QString &newTitle)

另请参阅 titleVisibletitleFixed

titleFixed : bool

此属性用于设置轴标题的旋转。

如果false ,主图视图中的轴标题将与轴标签一样朝摄像机方向旋转。如果true ,轴标题只会绕轴旋转,而不会朝向摄像机。如果labelAutoAngle 属性值为零,则此属性不会有任何影响。默认值为true

访问功能:

bool isTitleFixed() const
void setTitleFixed(bool fixed)

Notifier 信号:

void titleFixedChanged(bool fixed)

另请参阅 labelAutoAngle,title, 和titleVisible

titleOffset : float

轴标题在轴上的位置。该值必须介于-1.0f1.0f

访问功能:

float titleOffset() const
void setTitleOffset(float offset)

通知信号:

void titleOffsetChanged(float offset)

另请参阅 titletitleFixed

titleVisible : bool

该属性用于确定在主图表视图中轴标题是否可见。

默认值为false

访问功能:

bool isTitleVisible() const
void setTitleVisible(bool visible)

Notifier 信号:

void titleVisibleChanged(bool visible)

另请参阅 titletitleFixed

[read-only] type : const QAbstract3DAxis::AxisType

此属性表示轴的类型。

其值为AxisType 值之一。

访问函数:

QAbstract3DAxis::AxisType type() const

成员函数文档

[override virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()

销毁QAbstract3DAxis

[signal] void QAbstract3DAxis::rangeChanged(float min, float max)

当量程发生变化时,发射量程的最小值和最大值minmax

void QAbstract3DAxis::setRange(float min, float max)

设置坐标轴的值范围,从minmax 。设置范围时,必要时会调整最大值,以确保范围有效。

注: 对于QCategory3DAxis ,指定要显示的行或列的索引范围。

© 2025 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.