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) |
详细说明
每个序列可以绑定到一个或多个水平轴和垂直轴,但不支持混合会导致不同域的轴类型,例如在同一方向上指定QValueAxis 和QLogValueAxis 。
各种轴元素(如轴线、标题、标签、网格线和阴影)的属性和可见性均可单独控制。
成员类型文档
枚举 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> 的类型定义。它存储 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::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) |
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 。
当标签可编辑时,用户可以通过编辑任何标签方便地更改轴的范围。此功能仅支持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 的 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.