QAbstractAxis 类
QAbstractAxis 类是一个用于专用轴类的基类。更多...
| 头文件 | #include <QAbstractAxis> | 
| 由此实例化 | AbstractAxis | 
| 继承自 | QObject | 
| 继承对象 | QBarCategoryAxis, QColorAxis, QDateTimeAxis, QLogValueAxis, 和 QValueAxis | 
公共类型
| 枚举 | AxisType { AxisTypeNoAxis, AxisTypeValue, AxisTypeBarCategory, AxisTypeCategory, AxisTypeDateTime, …, AxisTypeColor } | 
| 标志 | AxisTypes | 
属性
| 
 | 
 | 
公共函数
| 虚拟 | ~QAbstractAxis() | 
| Qt::Alignment | alignment() const | 
| QColor | 网格线颜色() | 
| 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 | 次要网格线颜色() | 
| 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 | 显示() | 
| 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) | 
| (自 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) | 
| (自 6.2)void | truncateLabelsChanged(bool truncateLabels) | 
| void | visibleChanged(bool visible) | 
详细说明
每个系列可以绑定到一个或多个水平和垂直轴,但不支持混合轴类型,从而导致不同域的情况,例如,在相同的方向上指定QValueAxis和QLogValueAxis。
可以分别控制各种轴元素的属性和可见性,例如轴线、标题、标签、网格线和阴影。
成员类型文档
枚举 QAbstractAxis::AxisType
标识 QAbstractAxis::AxisTypes
这个枚举类型指定了轴对象的类型。
| 常量 | 值 | 
|---|---|
| QAbstractAxis::AxisTypeNoAxis | 0x0 | 
| QAbstractAxis::AxisTypeValue | 0x1 | 
| QAbstractAxis::AxisTypeBarCategory | 0x2 | 
| QAbstractAxis::AxisTypeCategory | 0x4 | 
| QAbstractAxis::AxisTypeDateTime | 0x8 | 
| QAbstractAxis::AxisTypeLogValue | 0x10 | 
| QAbstractAxis::AxisTypeColor | 0x20 | 
The AxisTypes 类型是 QFlags<AxisType> 的重定义。它存储了 AxisType 值的 OR 组合。
属性文档
[只读] 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 | 网格线颜色() | 
| 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) | 
[只读] 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) | 
通知信号
| void | linePenChanged(const QPen &pen) | 
lineVisible : bool
此属性保存轴线的可见性。
访问函数
| bool | isLineVisible() const | 
| void | setLineVisible(bool visible = true) | 
通知信号
| void | lineVisibleChanged(bool visible) | 
minorGridLineColor : QColor
此属性保存小网格线的颜色。
仅适用于支持小网格线的轴。
访问函数
| QColor | 次要网格线颜色() | 
| 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) | 
[只读] 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) | 
通知信号
| 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) | 
成员函数文档
[虚拟 noexcept] QAbstractAxis::~QAbstractAxis()
销毁轴对象。当轴被添加到图表中时,图表对象将拥有其所有权。
[信号] void QAbstractAxis::colorChanged(QColor color)
当轴的颜色更改为color时,发出该信号。
注意:属性color的通知器信号。
[信号] void QAbstractAxis::gridLineColorChanged(const QColor &color)
当用于绘制网格线的画笔颜色更改为color时,发出该信号。
注意:属性gridLineColor的通知器信号。
QPen QAbstractAxis::gridLinePen() const
返回用于绘制网格的画笔。
注意:属性 gridLinePen 的获取器函数。
另请参阅:setGridLinePen。
[信号] void QAbstractAxis::gridLinePenChanged(const QPen &pen)
当用于绘制网格线的画笔更改到 pen 时,将发出此信号。
注意:属性 gridLinePen 的通知信号。
[信号] void QAbstractAxis::gridVisibleChanged(bool visible)
当轴网格线的可见性更改为 visible 时,会发出此信号。
注意:属性 gridVisible 的通知信号。
void QAbstractAxis::hide()
使轴、阴影、标签和网格线不可见。
[信号] void QAbstractAxis::labelsAngleChanged(int angle)
当轴标签的角度更改为 angle 时,将发出此信号。
注意:属性 labelsAngle 的通知信号。
QBrush QAbstractAxis::labelsBrush() const
返回用于绘制标签的画刷。
注意:属性 labelsBrush 的获取器函数。
另请参阅:setLabelsBrush。
[信号] void QAbstractAxis::labelsBrushChanged(const QBrush &brush)
当用于绘制轴标签的画刷更改到 brush 时,将发出此信号。
注意:属性 labelsBrush 的通知信号。
[信号] void QAbstractAxis::labelsColorChanged(QColor color)
当轴标签的颜色更改为 color 时,将发出此信号。
注意:属性 labelsColor 的通知信号。
bool QAbstractAxis::labelsEditable() const
如果轴标签可编辑,则返回 true。
另请参阅:setLabelsEditable。
[信号] void QAbstractAxis::labelsEditableChanged(bool editable)
当标签的 editable 状态发生变化时,将发出此信号。
QFont QAbstractAxis::labelsFont() const
返回用于绘制标签的字体。
注意:属性 labelsFont 的获取器函数。
另请参阅:setLabelsFont。
[信号] void QAbstractAxis::labelsFontChanged(const QFont &font)
当轴标签的字体更改为字体时,该信号被触发。
注意:属性 labelsFont 的通知信号。
[signal, since 6.2] void QAbstractAxis::labelsTruncatedChanged(bool labelsTruncated)
在两种情况下会触发此信号;当轴从有一个或多个截断标签变为没有截断标签,以及当轴从没有截断标签变为有一个或多个截断标签。当前状态由 labelsTruncated 确定。
注意:属性 labelsTruncated 的通知信号。
此函数自 Qt 6.2 起引入。
[signal] void QAbstractAxis::labelsVisibleChanged(bool visible)
当轴标签的可见性变为 可见 时,该信号被触发。
注意:属性 labelsVisible 的通知信号。
QPen QAbstractAxis::linePen() const
返回用于绘制轴线和刻度线的画笔。
注意:属性 linePen 的获取函数。
另请参阅:setLinePen()。
[signal] void QAbstractAxis::linePenChanged(const QPen &pen)
当用于绘制轴线的画笔更改为 pen 时,该信号被触发。
注意:属性 linePen 的通知信号。
[signal] void QAbstractAxis::lineVisibleChanged(bool 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)
当轴的次要网格线的可见性变为 可见 时,该信号被触发。
注意:属性 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。
[信号] void QAbstractAxis::shadesBorderColorChanged(QColor color)
当轴阴影的边框颜色变为 color 时,会发出此信号。
注意:属性 shadesBorderColor 的通知信号。
QBrush QAbstractAxis::shadesBrush() const
返回用于绘制阴影的画笔。
注意:属性 shadesBrush 的获取函数。
另请参阅:setShadesBrush。
[信号] void QAbstractAxis::shadesBrushChanged(const QBrush &brush)
当用于绘制轴阴影的画笔变为 brush 时,会发出此信号。
注意:属性 shadesBrush 的通知信号。
[信号] void QAbstractAxis::shadesColorChanged(QColor color)
当轴阴影的颜色变为 color 时,会发出此信号。
注意:属性 shadesColor 的通知信号。
QPen QAbstractAxis::shadesPen() const
返回用于绘制阴影的画笔。
注意:属性shadesPen的获取器函数。
另请参阅:setShadesPen()。
[信号] void QAbstractAxis::shadesPenChanged(const QPen &pen)
当用于绘制轴阴影的画笔改为pen时,将发出此信号。
注意:属性shadesPen的通知信号。
[信号] void QAbstractAxis::shadesVisibleChanged(bool visible)
当轴阴影的可见性改为visible时,将发出此信号。
注意:属性shadesVisible的通知信号。
void QAbstractAxis::show()
使轴、阴影、标签和网格线可见。
QBrush QAbstractAxis::titleBrush() const
返回用于绘制标题的画刷。
注意:属性titleBrush的获取器函数。
另请参阅:setTitleBrush()。
[信号] void QAbstractAxis::titleBrushChanged(const QBrush &brush)
当用于绘制轴标题的画刷改为brush时,将发出此信号。
注意:属性titleBrush的通知信号。
QFont QAbstractAxis::titleFont() const
返回用于绘制标题的字体。
注意:属性titleFont的获取器函数。
另请参阅:setTitleFont()。
[信号] void QAbstractAxis::titleFontChanged(const QFont &font)
当轴标题的字体改为font时,将发出此信号。
注意:属性titleFont的通知信号。
[信号] void QAbstractAxis::titleTextChanged(const QString &text)
当轴标题的文本改为text时,将发出此信号。
注意:属性titleText的通知信号。
[信号] void QAbstractAxis::titleVisibleChanged(bool visible)
当轴标题文本的可见性改为visible时,将发出此信号。
注意:属性titleVisible的通知信号。
[信号,自6.2版起] void QAbstractAxis::truncateLabelsChanged(bool truncateLabels)
当标签截断变为 truncateLabels 时,将发出此信号。
注意:属性 truncateLabels 的通知信号。
此函数自 Qt 6.2 起引入。
[纯虚函数] QAbstractAxis::AxisType QAbstractAxis::type() const
返回轴的类型。
[信号] void QAbstractAxis::visibleChanged(bool visible)
当轴的可见性变为 visible 时,将发出此信号。
注意:属性 visible 的通知信号。
© 2024 The Qt Company Ltd. 本文档中的文档贡献是各自所有者的版权。本文档根据自由软件基金会发布的 GNU自由文档许可证版本1.3 的条款进行许可。Qt及其相关标志是The Qt Company Ltd.在芬兰和其他国家/地区的商标。所有其他商标均为其各自所有者的财产。