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::AxisTypeNoAxis | 0x0 |
QAbstractAxis::AxisTypeValue | 0x1 |
QAbstractAxis::AxisTypeBarCategory | 0x2 |
QAbstractAxis::AxisTypeCategory | 0x4 |
QAbstractAxis::AxisTypeDateTime | 0x8 |
QAbstractAxis::AxisTypeLogValue | 0x10 |
QAbstractAxis::AxisTypeColor | 0x20 |
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.