class QCategoryAxis#

类 QCategoryAxis 将具有名称的量程放在轴上。 更多…

Inheritance diagram of PySide6.QtCharts.QCategoryAxis

摘要#

属性#

  • categoriesLabelsᅟ - 字符串列表形式的类别标签

  • count - 分类数量

  • labelsPosition - 分类标签的位置。当将标签放置在值位置时，轴的起始和结束处的标签可能与其他轴的标签重叠

  • startValue - 轴上第一个分类的低端值

方法#

信号#

注意

本文档可能包含从C++到Python自动翻译的代码片段。我们始终欢迎对片段翻译的捐献。如果您发现翻译中存在问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单来告知我们

详细描述#

此类可用于通过添加带标签的分类来解释底层数据。与QBarCategoryAxis不同，QCategoryAxis允许自由指定分类范围的宽度。

关于如何使用 QCategoryAxis 的示例代码

../../_images/api_category_axis.png 
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);

QCategoryAxis *axisY = new QCategoryAxis;
axisY->setMin(0);
axisY->setMax(52);
axisY->setStartValue(15);
axisY->append("First", 20);
axisY->append("Second", 37);
axisY->append("Third", 52);
chartView->chart()->setAxisY(axisY, series);
class AxisLabelsPosition#

此枚举描述了类别标签的位置。

常量

描述

QCategoryAxis.AxisLabelsPositionCenter

标签居中对齐到类别。

QCategoryAxis.AxisLabelsPositionOnValue

标签位于类别的端值。

注意

当使用 from __feature__ import true_property 时，可以直接使用属性，否则通过访问器函数执行。

属性 categoriesLabels: 字符串列表#

此属性包含类别标签的字符串列表。

访问函数
属性 count: int#

此属性包含类别的数量。

访问函数
属性 labelsPosition: QCategoryAxis.AxisLabelsPosition#

此属性包含类别标签的位置。当在这些标签上定位时，轴的开始和结束处的标签可能与其他轴的标签重叠。

访问函数
属性 startValue: float#

此属性包含轴上第一个类别的低端。

访问函数
__init__([parent=None])#
参数:

parent – QObject

构建一个父级为 parent 的轴对象。

append(label, categoryEndValue)#
参数:

  • label – str

  • categoryEndValue – float

在轴上附加一个新的类别，标签为categoryLabel。类别标签必须是唯一的。categoryEndValue指定类别的上限。它必须大于前一个类别的上限。否则，该方法将返回而不添加新的类别。

categoriesChanged()#

当轴的类别发生变化时发出此信号。

categoriesLabels()#
返回类型:

字符串列表

返回类别标签的列表。

属性categoriesLabelsᅟ的获取器。

count()#
返回类型:

int

返回类别的数量。

属性countᅟ的获取器。

endValue(categoryLabel)#
参数:

categoryLabel – 字符串

返回类型:

float

返回由categoryLabel指定的类别的上限。

labelsPosition()#
返回类型:

AxisLabelsPosition

另请参阅

setLabelsPosition()

属性labelsPositionᅟ的获取器。

labelsPositionChanged(position)#
参数:

position – AxisLabelsPosition

属性labelsPositionᅟ的通知信号。

remove(label)#
参数:

label – str

从轴中移除由标签categoryLabel指定的类别。

replaceLabel(oldLabel, newLabel)#
参数:

  • oldLabel – 字符串

  • newLabel – 字符串

将指定的旧标签oldLabel替换为新标签newLabel。如果旧标签不存在，则该方法将返回而不进行任何更改。

setLabelsPosition(position)#
参数:

position – AxisLabelsPosition

另请参阅

labelsPosition()

属性 labelsPositionᅟ 的设置器。

setStartValue(min)#
参数:

min – float

将 min 设置为轴上第一个类别的下限。如果轴上已经添加了类别，则传入的值必须小于已定义的第一个类别范围的上限。否则不执行任何操作。

另请参阅

startValue()

属性 startValueᅟ 的设置器。

startValue([categoryLabel=""])#
参数:

categoryLabel – 字符串

返回类型:

float

返回由 categoryLabel 指定的类别的下限。

另请参阅

setStartValue()