QAbstractAxis Class

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

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

QBarCategoryAxis, QColorAxis, QDateTimeAxis, QLogValueAxis, and QValueAxis

公共类型

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)

详细说明

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

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

成员类型文档

枚举 QAbstractAxis::AxisType
flags QAbstractAxis::AxisTypes

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

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

AxisTypes 类型是QFlags<AxisType> 的类型定义。它存储 AxisType 值的 OR 组合。

属性文档

[read-only] alignment : const 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)

Notifier 信号:

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 : const 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)

Notifier 信号:

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 : const Qt::Orientation

此属性表示坐标轴的方向。

当坐标轴添加到图表时,固定为Qt::HorizontalQt::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)

Notifier 信号:

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)

Notifier 信号:

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 的通知信号。

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 的通知信号。

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 的通知信号。

[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

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

注: 属性方向的获取函数。

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

当标签可编辑时,用户可以通过编辑任何标签方便地更改轴的范围。此功能仅支持QValueAxisQDateTimeAxis

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

另请参阅 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)

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

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 的 Notifier 信号。

此函数在 Qt 6.2 中引入。

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

返回轴的类型。

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

当坐标轴的可见性更改为visible 时,将发出该信号。

注: 属性visible 的通知信号。

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