QAbstractAxis Class

QAbstractAxis 类是用于专门轴类的基类。更多

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

QBarCategoryAxis,QDateTimeAxis, 以及QValueAxis

公共类型

enum class AxisType { Value, BarCategory, DateTime }

属性

公共功能

virtual ~QAbstractAxis() override
Qt::Alignment alignment() const
void hide()
bool isGridVisible() const
bool isLineVisible() const
bool isSubGridVisible() const
bool isTitleVisible() const
bool isVisible() const
QQmlComponent *labelDelegate() const
qreal labelsAngle() const
bool labelsVisible() const
void setAlignment(Qt::Alignment alignment)
void setGridVisible(bool visible = true)
void setLabelDelegate(QQmlComponent *newLabelDelegate)
void setLabelsAngle(qreal angle)
void setLabelsVisible(bool visible = true)
void setLineVisible(bool visible = true)
void setMax(const QVariant &max)
void setMin(const QVariant &min)
void setRange(const QVariant &min, const QVariant &max)
void setSubGridVisible(bool visible = true)
void setTitleColor(QColor color)
void setTitleFont(const QFont &font)
void setTitleText(const QString &title)
void setTitleVisible(bool visible = true)
void setVisible(bool visible = true)
void show()
QColor titleColor() const
QFont titleFont() const
QString titleText() const
virtual QAbstractAxis::AxisType type() const = 0

信号

void alignmentChanged(Qt::Alignment alignment)
void gridVisibleChanged(bool visible)
void labelDelegateChanged()
void labelsAngleChanged(qreal angle)
void labelsVisibleChanged(bool visible)
void lineVisibleChanged(bool visible)
void subGridVisibleChanged(bool visible)
void titleColorChanged(QColor color)
void titleFontChanged(const QFont &font)
void titleTextChanged(const QString &title)
void titleVisibleChanged(bool visible)
void update()
void visibleChanged(bool visible)

详细说明

每个序列只能绑定一个水平轴和垂直轴。

各种轴元素(如轴线、标题、标签和网格线)的属性和可见性均可单独控制。

成员类型文档

enum class QAbstractAxis::AxisType

该枚举类型指定轴对象的类型。

常量
QAbstractAxis::AxisType::Value0
QAbstractAxis::AxisType::BarCategory1
QAbstractAxis::AxisType::DateTime2

属性文档

[since 6.9] alignment : Qt::Alignment

此属性表示轴的对齐方式。

可以是Qt::AlignLeft,Qt::AlignRight,Qt::AlignBottom, 或Qt::AlignTop

此属性在 Qt 6.9 中引入。

访问函数:

Qt::Alignment alignment() const
void setAlignment(Qt::Alignment alignment)

Notifier 信号:

void alignmentChanged(Qt::Alignment alignment)

gridVisible : bool

该属性用于设置网格线的可见性。默认值为true

访问功能:

bool isGridVisible() const
void setGridVisible(bool visible = true)

通知信号:

void gridVisibleChanged(bool visible)

labelDelegate : QQmlComponent*

该属性包含一个自定义 QML 组件,用作轴的标签。该组件应为Text 组件或包含 "property string text"(属性字符串文本),以便为该属性分配标签值。

访问功能:

QQmlComponent *labelDelegate() const
void setLabelDelegate(QQmlComponent *newLabelDelegate)

通知信号:

void labelDelegateChanged()

labelsAngle : qreal

该属性用于保存轴标签的角度(单位:度)。

访问功能:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

通知信号:

void labelsAngleChanged(qreal angle)

labelsVisible : bool

此属性表示轴标签是否可见。默认值为true

访问功能:

bool labelsVisible() const
void setLabelsVisible(bool visible = true)

Notifier 信号:

void labelsVisibleChanged(bool visible)

lineVisible : bool

该属性用于设置轴心线的可见性。默认值为true

访问功能:

bool isLineVisible() const
void setLineVisible(bool visible = true)

通知信号:

void lineVisibleChanged(bool visible)

subGridVisible : bool

此属性表示子网格线的可见性。

仅适用于支持子网格线的坐标轴。默认值为true

访问功能:

bool isSubGridVisible() const
void setSubGridVisible(bool visible = true)

通知信号:

void subGridVisibleChanged(bool visible)

titleColor : QColor

该属性用于保存绘制标题文本的颜色。

访问功能:

QColor titleColor() const
void setTitleColor(QColor color)

Notifier 信号:

void titleColorChanged(QColor color)

titleFont : QFont

该属性用于保存轴标题的字体。

访问功能:

QFont titleFont() const
void setTitleFont(const QFont &font)

通知信号:

void titleFontChanged(const QFont &font)

titleText : QString

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

默认为空。轴标题支持 HTML 格式。

访问功能:

QString titleText() const
void setTitleText(const QString &title)

通知信号:

void titleTextChanged(const QString &title)

titleVisible : bool

该属性用于设置轴标题的可见性。

默认值为true

访问功能:

bool isTitleVisible() const
void setTitleVisible(bool visible = true)

通知信号:

void titleVisibleChanged(bool visible)

visible : bool

此属性表示轴的可见性。默认值为true

访问功能:

bool isVisible() const
void setVisible(bool visible = true)

Notifier 信号:

void visibleChanged(bool visible)

成员函数 文档

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

销毁轴对象。当轴被添加到图形中时,图形对象将拥有轴的所有权。

void QAbstractAxis::hide()

使坐标轴、标签和网格线不可见。

void QAbstractAxis::setLineVisible(bool visible = true)

确定轴线和刻度线是否为visible.

注: 属性lineVisible 的设置函数。

另请参阅 isLineVisible() 。

void QAbstractAxis::setMax(const QVariant &max)

设置轴上显示的最大值。根据实际的轴类型,max 参数将转换为相应的值类型。如果无法转换,函数调用将不起作用。

void QAbstractAxis::setMin(const QVariant &min)

设置轴上显示的最小值。根据实际坐标轴类型,min 参数将转换为相应类型的值。如果无法转换,函数调用将不起作用。

void QAbstractAxis::setRange(const QVariant &min, const QVariant &max)

设置轴上显示的范围。根据实际坐标轴类型,minmax 参数将转换为相应类型的值。如果无法转换,函数调用将不起作用。

void QAbstractAxis::setTitleColor(QColor color)

将用于绘制标题的颜色设置为color

注: 属性titleColor 的设置函数。

另请参阅 titleColor() 。

void QAbstractAxis::setTitleFont(const QFont &font)

将用于绘制标题的字体设置为font

注: 属性titleFont 的设置函数。

另请参阅 titleFont() 。

void QAbstractAxis::setVisible(bool visible = true)

将坐标轴、标签和网格线的可见性设置为visible

注: 属性visible 的设置函数。

另请参阅 isVisible() 。

void QAbstractAxis::show()

使坐标轴、标签和网格线可见。

QColor QAbstractAxis::titleColor() const

返回用于绘制标题的颜色。

注: 属性 titleColor 的获取函数。

另请参阅 setTitleColor()。

QFont QAbstractAxis::titleFont() const

返回用于绘制标题的字体。

注: 属性 titleFont 的获取函数。

另请参阅 setTitleFont()。

[pure virtual] QAbstractAxis::AxisType QAbstractAxis::type() const

返回轴的类型。

[signal] void QAbstractAxis::update()

该信号在轴需要更新时发出。

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