本页内容

QAbstractAxis Class

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

Header: #include <QAbstractAxis>
In QML: AbstractAxis
Inherits: QObject
Inherited By:

QBarCategoryAxis, QColorAxis, QDateTimeAxis, QLogValueAxis, and QValueAxis

Status: Deprecated

该类已弃用。我们强烈建议不要在新代码中使用它。

公共类型

enum AxisType { AxisTypeNoAxis, AxisTypeValue, AxisTypeBarCategory, AxisTypeCategory, AxisTypeDateTime, …, AxisTypeColor }
flags AxisTypes

属性

公共函数

virtual ~QAbstractAxis()
Qt::Alignment alignment() const
QColor gridLineColor()
QPen gridLinePen() const
void hide()
bool isGridLineVisible() const
bool isLineVisible() const
bool isMinorGridLineVisible() const
bool isReverse() const
bool isTitleVisible() const
bool isVisible() const
int labelsAngle() const
QBrush labelsBrush() const
QColor labelsColor() const
bool labelsEditable() const
QFont labelsFont() const
bool labelsTruncated() const
bool labelsVisible() const
QPen linePen() const
QColor linePenColor() const
QColor minorGridLineColor()
QPen minorGridLinePen() const
Qt::Orientation orientation() const
void setGridLineColor(const QColor &color)
void setGridLinePen(const QPen &pen)
void setGridLineVisible(bool visible = true)
void setLabelsAngle(int angle)
void setLabelsBrush(const QBrush &brush)
void setLabelsColor(QColor color)
void setLabelsEditable(bool editable = true)
void setLabelsFont(const QFont &font)
void setLabelsVisible(bool visible = true)
void setLinePen(const QPen &pen)
void setLinePenColor(QColor color)
void setLineVisible(bool visible = true)
void setMax(const QVariant &max)
void setMin(const QVariant &min)
void setMinorGridLineColor(const QColor &color)
void setMinorGridLinePen(const QPen &pen)
void setMinorGridLineVisible(bool visible = true)
void setRange(const QVariant &min, const QVariant &max)
void setReverse(bool reverse = true)
void setShadesBorderColor(QColor color)
void setShadesBrush(const QBrush &brush)
void setShadesColor(QColor color)
void setShadesPen(const QPen &pen)
void setShadesVisible(bool visible = true)
void setTitleBrush(const QBrush &brush)
void setTitleFont(const QFont &font)
void setTitleText(const QString &title)
void setTitleVisible(bool visible = true)
void setTruncateLabels(bool truncateLabels = true)
void setVisible(bool visible = true)
QColor shadesBorderColor() const
QBrush shadesBrush() const
QColor shadesColor() const
QPen shadesPen() const
bool shadesVisible() const
void show()
QBrush titleBrush() const
QFont titleFont() const
QString titleText() const
bool truncateLabels() const
virtual QAbstractAxis::AxisType type() const = 0

信号

void colorChanged(QColor color)
void gridLineColorChanged(const QColor &color)
void gridLinePenChanged(const QPen &pen)
void gridVisibleChanged(bool visible)
void labelsAngleChanged(int angle)
void labelsBrushChanged(const QBrush &brush)
void labelsColorChanged(QColor color)
void labelsEditableChanged(bool editable)
void labelsFontChanged(const QFont &font)
(since 6.2) void labelsTruncatedChanged(bool labelsTruncated)
void labelsVisibleChanged(bool visible)
void linePenChanged(const QPen &pen)
void lineVisibleChanged(bool visible)
void minorGridLineColorChanged(const QColor &color)
void minorGridLinePenChanged(const QPen &pen)
void minorGridVisibleChanged(bool visible)
void reverseChanged(bool reverse)
void shadesBorderColorChanged(QColor color)
void shadesBrushChanged(const QBrush &brush)
void shadesColorChanged(QColor color)
void shadesPenChanged(const QPen &pen)
void shadesVisibleChanged(bool visible)
void titleBrushChanged(const QBrush &brush)
void titleFontChanged(const QFont &font)
void titleTextChanged(const QString &text)
void titleVisibleChanged(bool visible)
(since 6.2) void truncateLabelsChanged(bool truncateLabels)
void visibleChanged(bool visible)

详细说明

每个系列都可以绑定到一个或多个水平轴和垂直轴,但不支持混合会导致不同定义域的轴类型,例如在同一方向上指定QValueAxis 和QLogValueAxis 。

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

成员类型文档

enum QAbstractAxis::AxisType
flags QAbstractAxis::AxisTypes

此枚举类型指定了轴对象的类型。

常量值
QAbstractAxis::AxisTypeNoAxis0x0
QAbstractAxis::AxisTypeValue0x1
QAbstractAxis::AxisTypeBarCategory0x2
QAbstractAxis::AxisTypeCategory0x4
QAbstractAxis::AxisTypeDateTime0x8
QAbstractAxis::AxisTypeLogValue0x10
QAbstractAxis::AxisTypeColor0x20

AxisTypes 类型是QFlags<AxisType> 的 typedef 定义。它存储 AxisType 值的“或”组合。

属性文档

[read-only] alignment : Qt::Alignment

该属性用于指定轴的对齐方式。

取值可以是Qt::AlignLeft 、Qt::AlignRight 、Qt::AlignBottom 或Qt::AlignTop 。

访问函数:

Qt::Alignment alignment() const

color : QColor

该属性用于设置坐标轴和刻度的颜色。

访问函数:

QColor linePenColor() const
void setLinePenColor(QColor color)

通知信号:

void colorChanged(QColor color)

gridLineColor : QColor

该属性用于设置网格线的颜色。

访问函数:

QColor gridLineColor()
void setGridLineColor(const QColor &color)

通知信号:

void gridLineColorChanged(const QColor &color)

gridLinePen : QPen

该属性存储用于绘制网格线的画笔。

访问函数:

QPen gridLinePen() const
void setGridLinePen(const QPen &pen)

通知器信号:

void gridLinePenChanged(const QPen &pen)

gridVisible : bool

该属性控制网格线的可见性。

访问函数:

bool isGridLineVisible() const
void setGridLineVisible(bool visible = true)

通知器信号:

void gridVisibleChanged(bool visible)

labelsAngle : int

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

访问函数:

int labelsAngle() const
void setLabelsAngle(int angle)

通知信号:

void labelsAngleChanged(int angle)

labelsBrush : QBrush

该属性存储用于绘制标签的画笔。

仅画笔的颜色与之相关。

访问函数:

QBrush labelsBrush() const
void setLabelsBrush(const QBrush &brush)

通知信号:

void labelsBrushChanged(const QBrush &brush)

labelsColor : QColor

该属性用于设置坐标轴标签的颜色。

访问函数:

QColor labelsColor() const
void setLabelsColor(QColor color)

通知信号:

void labelsColorChanged(QColor color)

labelsFont : QFont

该属性用于指定坐标轴标签的字体。

访问函数:

QFont labelsFont() const
void setLabelsFont(const QFont &font)

通知信号:

void labelsFontChanged(const QFont &font)

[read-only] labelsTruncated : bool

如果轴上至少有一个标签被截断,则返回true 。

在轴显示之前,返回值将不准确。

访问函数:

bool labelsTruncated() const

通知信号:

void labelsTruncatedChanged(bool labelsTruncated)

labelsVisible : bool

该属性控制轴标签是否可见。

访问函数:

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

通知信号:

void labelsVisibleChanged(bool visible)

linePen : QPen

该属性保存了用于绘制该线的画笔。

访问函数:

QPen linePen() const
void setLinePen(const QPen &pen)

通知信号:

void linePenChanged(const QPen &pen)

lineVisible : bool

该属性控制坐标轴线的可见性。

访问函数:

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

通知信号:

void lineVisibleChanged(bool visible)

minorGridLineColor : QColor

此属性用于指定次要网格线的颜色。

仅适用于支持次要网格线的坐标轴。

访问函数:

QColor minorGridLineColor()
void setMinorGridLineColor(const QColor &color)

通知信号:

void minorGridLineColorChanged(const QColor &color)

minorGridLinePen : QPen

该属性存储用于绘制次要网格线的笔。

仅适用于支持次要网格线的坐标轴。

访问函数:

QPen minorGridLinePen() const
void setMinorGridLinePen(const QPen &pen)

通知信号:

void minorGridLinePenChanged(const QPen &pen)

minorGridVisible : bool

此属性控制次要网格线的可见性。

仅适用于支持次级网格线的坐标轴。

访问函数:

bool isMinorGridLineVisible() const
void setMinorGridLineVisible(bool visible = true)

通知信号:

void minorGridVisibleChanged(bool visible)

[read-only] orientation : Qt::Orientation

该属性存储坐标轴的方向。

当坐标轴被添加到图表时,该属性被固定为Qt::Horizontal 或Qt::Vertical 。

访问函数:

Qt::Orientation orientation() const

reverse : bool

该属性控制是否使用反向坐标轴。

默认情况下,该值为false 。

线型、样条线和散点系列以及笛卡尔坐标系中的面积系列均支持反向坐标轴。如果同一系列中存在一个反向坐标轴,则该系列上所有方向相同的坐标轴都必须反向,否则行为将无法确定。

访问函数:

bool isReverse() const
void setReverse(bool reverse = true)

通知信号:

void reverseChanged(bool reverse)

shadesBorderColor : QColor

该属性用于指定坐标轴阴影的边框(笔触)颜色。

访问函数:

QColor shadesBorderColor() const
void setShadesBorderColor(QColor color)

通知信号:

void shadesBorderColorChanged(QColor color)

shadesBrush : QBrush

该属性存储用于绘制坐标轴阴影(网格线之间的区域)的画笔。

访问函数:

QBrush shadesBrush() const
void setShadesBrush(const QBrush &brush)

通知器信号:

void shadesBrushChanged(const QBrush &brush)

shadesColor : QColor

该属性用于指定坐标轴阴影的填充(笔刷)颜色。

访问函数:

QColor shadesColor() const
void setShadesColor(QColor color)

通知信号:

void shadesColorChanged(QColor color)

shadesPen : QPen

该属性存储用于绘制坐标轴阴影(网格线之间的区域)的画笔。

访问函数:

QPen shadesPen() const
void setShadesPen(const QPen &pen)

通知信号:

void shadesPenChanged(const QPen &pen)

shadesVisible : bool

该属性控制坐标轴阴影的可见性。

访问函数:

bool shadesVisible() const
void setShadesVisible(bool visible = true)

通知信号:

void shadesVisibleChanged(bool visible)

titleBrush : QBrush

该属性存储用于绘制标题文本的画笔。

仅画笔的颜色相关。

访问函数:

QBrush titleBrush() const
void setTitleBrush(const QBrush &brush)

通知器信号:

void titleBrushChanged(const QBrush &brush)

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 &text)

titleVisible : bool

该属性控制轴标题的可见性。

默认情况下,该值为true 。

访问函数:

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

通知信号:

void titleVisibleChanged(bool visible)

truncateLabels : bool

此属性用于存储标签的截断状态。

用于指定当空间不足以显示完整文本时,是否应截断标签。默认值为true 。

访问函数:

bool truncateLabels() const
void setTruncateLabels(bool truncateLabels = true)

通知信号:

void truncateLabelsChanged(bool truncateLabels)

visible : bool

该属性控制坐标轴的可见性。

访问函数:

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

通知器信号:

void visibleChanged(bool visible)

成员函数文档

[virtual noexcept] QAbstractAxis::~QAbstractAxis()

销毁该轴对象。当该轴被添加到图表中时,图表对象将接管其所有权。

[signal] void QAbstractAxis::colorChanged(QColor color)

当坐标轴的颜色变为color 时,会发出此信号。

注意: 这是属性color 的通知器 信号。

[signal] void QAbstractAxis::gridLineColorChanged(const QColor &color)

当用于绘制网格线的笔颜色变为color 时,会触发此信号。

注意: 这是属性gridLineColor 的Notifier 信号。

QPen QAbstractAxis::gridLinePen() const

返回用于绘制网格的画笔。

注意: 这是属性 gridLinePen 的获取 函数。

另请参阅 setGridLinePen()。

[signal] void QAbstractAxis::gridLinePenChanged(const QPen &pen)

当用于绘制网格线的画笔切换为pen 时,会发出此信号。

注意: 这是属性gridLinePen的通知器 信号。

[signal] void QAbstractAxis::gridVisibleChanged(bool visible)

当坐标轴网格线的可见性变为visible 时,会发出此信号。

注意: 这是属性 `gridVisible`的通知器 信号。

void QAbstractAxis::hide()

将坐标轴、阴影、标签和网格线设为不可见。

[signal] void QAbstractAxis::labelsAngleChanged(int angle)

当坐标轴标签的角度变为angle 时,将发出此信号。

注意: 这是属性labelsAngle的通知 信号。

QBrush QAbstractAxis::labelsBrush() const

返回用于绘制标签的画笔。

注意: 这是 labelsBrush 属性的获取 函数。

另请参阅 setLabelsBrush()。

[signal] void QAbstractAxis::labelsBrushChanged(const QBrush &brush)

当用于绘制坐标轴标签的画笔更改为brush 时,将发出此信号。

注意: 这是属性labelsBrush的通知器 信号。

[signal] void QAbstractAxis::labelsColorChanged(QColor color)

当坐标轴标签的颜色变为color 时,会发出此信号。

注意: 这是属性labelsColor 的Notifier 信号。

bool QAbstractAxis::labelsEditable() const

如果坐标轴标签可编辑,则返回true 。

另请参阅 setLabelsEditable()。

[signal] void QAbstractAxis::labelsEditableChanged(bool editable)

当标签的“editable ”状态发生变化时,会触发此信号。

QFont QAbstractAxis::labelsFont() const

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

注意: 这是 labelsFont 属性的获取 函数。

另请参阅 ` setLabelsFont()`。

[signal] void QAbstractAxis::labelsFontChanged(const QFont &font)

当坐标轴标签的字体更改为font 时,会发出此信号。

注意: 这是属性labelsFont的通知器 信号。

[signal, since 6.2] void QAbstractAxis::labelsTruncatedChanged(bool labelsTruncated)

该信号在以下两种情况下触发:当轴的状态从“有一个或多个被截断的标签”变为“没有被截断的标签”时,以及当轴的状态从“没有被截断的标签”变为“有一个或多个被截断的标签”时。当前状态由labelsTruncated 标识。

注意: 这是属性labelsTruncated 的通知器 信号。

该函数在 Qt 6.2 中引入。

[signal] void QAbstractAxis::labelsVisibleChanged(bool visible)

当坐标轴标签的可见性变为visible 时,会发出此信号。

注意: 这是属性labelsVisible的通知 信号。

QPen QAbstractAxis::linePen() const

返回用于绘制坐标轴线和刻度的画笔。

注意: 这是 linePen 属性的获取 函数。

另请参阅 setLinePen()。

[signal] void QAbstractAxis::linePenChanged(const QPen &pen)

当用于绘制坐标轴线的画笔切换为pen 时,会发出此信号。

注意: 这是属性linePen的通知器 信号。

[signal] void QAbstractAxis::lineVisibleChanged(bool visible)

当坐标轴线的可见性变为visible 时,会发出此信号。

注意: 这是属性lineVisible 的Notifier 信号。

[signal] void QAbstractAxis::minorGridLineColorChanged(const QColor &color)

当用于绘制次要网格线的笔的颜色变为color 时,会发出此信号。

注意: 这是属性minorGridLineColor的通知器 信号。

[signal] void QAbstractAxis::minorGridLinePenChanged(const QPen &pen)

当用于绘制次要网格线的画笔切换为pen 时,会发出此信号。

注意: 这是属性minorGridLinePen的通知器 信号。

[signal] void QAbstractAxis::minorGridVisibleChanged(bool visible)

当坐标轴的次要网格线的可见性变为visible 时,会发出此信号。

注意: 这是属性minorGridVisible的通知器 信号。

Qt::Orientation QAbstractAxis::orientation() const

返回轴的方向(垂直或水平)。

注意: 这是 orientation 属性的获取 函数。

void QAbstractAxis::setGridLinePen(const QPen &pen)

将用于绘制网格线的画笔设置为pen 。

注意: 这是属性 `gridLinePen`的设置 函数。

另请参阅 gridLinePen()。

void QAbstractAxis::setLabelsBrush(const QBrush &brush)

将用于绘制标签的画笔设置为brush 。

注意: 这是属性labelsBrush 的设置 函数。

另请参阅 labelsBrush()。

void QAbstractAxis::setLabelsEditable(bool editable = true)

将坐标轴标签的可编辑性设置为editable 。

当标签可编辑时,用户可以通过编辑任意一个标签来方便地更改坐标轴的范围。此功能仅支持 QValueAxis 和 QDateTimeAxis。

默认情况下,标签不可编辑。

另请参阅 labelsEditable()。

void QAbstractAxis::setLabelsFont(const QFont &font)

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

注意: 这是属性labelsFont 的设置 函数。

另请参阅 labelsFont()。

void QAbstractAxis::setLinePen(const QPen &pen)

将用于绘制坐标轴线和刻度的画笔设置为pen 。

注意: 这是属性 `linePen`的设置 函数。

另请参阅 linePen()。

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)

设置轴上显示的范围。根据实际的轴类型,min 和max 参数将被转换为相应类型的值。如果无法进行转换,则该函数调用不执行任何操作。

void QAbstractAxis::setShadesBrush(const QBrush &brush)

将用于绘制阴影的画笔设置为brush 。

注意: 这是属性 `shadesBrush`的设置 函数。

另请参阅 shadesBrush()。

void QAbstractAxis::setShadesPen(const QPen &pen)

将用于绘制阴影的画笔设置为pen 。

注意: 这是属性shadesPen 的设置 函数。

另请参阅 shadesPen()。

void QAbstractAxis::setTitleBrush(const QBrush &brush)

将用于绘制标题的画笔设置为brush 。

注意: 这是属性titleBrush 的设置 函数。

另请参阅 titleBrush()。

void QAbstractAxis::setTitleFont(const QFont &font)

将绘制标题时使用的字体设置为font 。

注意: 这是属性titleFont 的设置 函数。

另请参阅 titleFont()。

void QAbstractAxis::setVisible(bool visible = true)

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

注意: 这是属性visible 的设置 函数。

另请参阅 isVisible()。

[signal] void QAbstractAxis::shadesBorderColorChanged(QColor color)

当坐标轴阴影的边框颜色变为color 时,会发出此信号。

注意: 这是属性shadesBorderColor的通知器 信号。

QBrush QAbstractAxis::shadesBrush() const

返回用于绘制阴影的画笔。

注意: 这是 shadesBrush 属性的获取函数 。

另请参阅 setShadesBrush()。

[signal] void QAbstractAxis::shadesBrushChanged(const QBrush &brush)

当用于绘制坐标轴阴影的画笔切换为brush 时,会发出此信号。

注意: 这是属性shadesBrush的通知器 信号。

[signal] void QAbstractAxis::shadesColorChanged(QColor color)

当坐标轴填充色的颜色变为color 时,会发出此信号。

注意: 这是属性shadesColor 的通知器 信号。

QPen QAbstractAxis::shadesPen() const

返回用于绘制阴影的画笔。

注意: 这是属性 shadesPen 的获取器 函数。

另请参阅 setShadesPen()。

[signal] void QAbstractAxis::shadesPenChanged(const QPen &pen)

当用于绘制坐标轴阴影的画笔切换为pen 时,将触发此信号。

注意: 这是属性shadesPen的通知器 信号。

[signal] void QAbstractAxis::shadesVisibleChanged(bool visible)

当坐标轴阴影的可见性变为visible 时,会发出此信号。

注意: 这是属性shadesVisible 的通知器 信号。

void QAbstractAxis::show()

显示坐标轴、阴影、标签和网格线。

QBrush QAbstractAxis::titleBrush() const

返回用于绘制标题的画笔。

注意: 此为 titleBrush 属性的获取 函数。

另请参阅 setTitleBrush()。

[signal] void QAbstractAxis::titleBrushChanged(const QBrush &brush)

当用于绘制坐标轴标题的画笔更改为brush 时,会发出此信号。

注意: 这是属性titleBrush的通知器 信号。

QFont QAbstractAxis::titleFont() const

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

注意: 这是 titleFont 属性的获取 函数。

另请参阅 setTitleFont()。

[signal] void QAbstractAxis::titleFontChanged(const QFont &font)

当坐标轴标题的字体更改为font 时,会发出此信号。

注意: 这是属性titleFont的通知器 信号。

[signal] void QAbstractAxis::titleTextChanged(const QString &text)

当坐标轴标题的文本变为text 时,会发出此信号。

注意: 这是属性titleText的通知 信号。

[signal] void QAbstractAxis::titleVisibleChanged(bool visible)

当坐标轴标题文本的可见性变为visible 时,会发出此信号。

注意: 这是属性titleVisible的通知 信号。

[signal, since 6.2] void QAbstractAxis::truncateLabelsChanged(bool truncateLabels)

当标签的截断方式变为truncateLabels 时,会发出此信号。

注意: 这是属性truncateLabels的通知器 信号。

该函数在 Qt 6.2 中引入。

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

返回轴的类型。

[signal] void QAbstractAxis::visibleChanged(bool visible)

当坐标轴的可见性变为“visible ”时,会发出此信号。

注意: 这是属性visible 的Notifier 信号。

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