class QChart#

QChart 类管理图表系列、图例和坐标系的图形表示。 更多…

Inheritance diagram of PySide6.QtCharts.QChart

继承自： QPolarChart

摘要#

属性#

方法#

信号#

备注

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

详细描述#

《QChart》是一个可以在《QGraphicsScene》中显示的`QGraphicsWidget`。它管理着不同类型系列以及其他图表相关对象（如图例和坐标轴）的图形表示。为了在布局中简单地显示图表，可以使用便利类《QChartView》代替《QChart》。此外，通过使用《QPolarChart》类，可以将线形、样条线、面积和散点序列表示为极坐标图表。

class ChartType#

此枚举描述了图表类型。

常量

描述

QChart.ChartTypeUndefined

图表类型未定义。

QChart.ChartTypeCartesian

笛卡尔图表。

QChart.ChartTypePolar

极坐标图表。
class ChartTheme#

此枚举描述了图表使用的主题。

主题是一种内置的UI样式相关设置集合，应用于图表的视觉元素，例如系列的颜色、画笔、刷子和字体，以及坐标轴、标题和图例。《图表与小部件画廊》说明了如何使用主题。

备注

更改主题将覆盖之前应用于系列的所有自定义设置。

常量

描述

QChart.ChartThemeLight

浅色主题，这是默认主题。

QChart.ChartThemeBlueCerulean

天蓝色主题。

QChart.ChartThemeDark

深色主题。

QChart.ChartThemeBrownSand

棕沙色主题。

QChart.ChartThemeBlueNcs

自然色系统（NCS）蓝色主题。

QChart.ChartThemeHighContrast

高对比度主题。

QChart.ChartThemeBlueIcy

冰蓝色主题。

QChart.ChartThemeQt

Qt主题。
class AnimationOption#

(继承自 enum.Flag) 此枚举描述了图表中启用的动画。

常量

描述

QChart.NoAnimation

图表中禁用动画。这是默认值。

QChart.GridAxisAnimations

图表中启用网格坐标轴动画。

QChart.SeriesAnimations

图表中启用系列动画。

QChart.AllAnimations

图表中启用所有动画类型。

备注

可以使用属性直接使用或者通过访问函数来使用。

property animationDuration: int#

此属性保持图表动画的持续时间。

访问函数
属性 animationEasingCurveᅟ： QEasingCurve#

此属性保持图表动画的缓动曲线。

访问函数
属性 animationOptionsᅟ： QChart(animationOption) 的集合#

此属性保持图表的动画选项。

动画的启用或禁用基于此设置。

访问函数
属性 backgroundRoundnessᅟ： float#

此属性保持图表背景角落的圆形圆度。

访问函数
属性 backgroundVisibleᅟ： bool#

此属性保持图表背景是否可见。

参见

setBackgroundBrush() setBackgroundPen() plotAreaBackgroundVisible

访问函数
属性 chartTypeᅟ： QChart.ChartType#

此属性保持图表是笛卡尔图表还是极坐标图表。

此属性由内部设置，它只读。

参见

QPolarChart

访问函数
属性 dropShadowEnabledᅟ： bool#

此属性保持背景阴影效果是否启用。

如果设置为 true，则启用背景阴影效果。如果设置为 false，则禁用。

备注

阴影效果取决于主题，因此如果更改了主题，设置可能会更改。

访问函数
属性 localeᅟ： QLocale#

此属性保持用于格式化各种图表标签的本地化设置。

标签仅在 localizeNumbers 设置为 true 时才会本地化，但 QDateTimeAxis 标签除外，它们始终使用与该属性关联的 QLocale。

默认为图表构建时的应用程序默认区域设置。

访问函数
属性 localizeNumbersᅟ: bool#

此属性表示是否本地化数字。

当设置为 true 时，所有在各个系列和轴标签中出现的生成的数字将使用与 locale 属性关联的 QLocale 进行本地化。当设置为 false 时，始终使用 C 区域。默认值为 false。

备注

此属性不影响 QDateTimeAxis 标签，它们始终使用带有区域属性的 QLocale。

参见

locale

访问函数
属性 marginsᅟ: QMargins#

此属性存储图表矩形边缘与绘图区域之间允许的最小边距。

边距用于绘制标题、轴和图例。

访问函数
属性 plotAreaᅟ: QRectF#

此属性存储绘制图表的矩形。

绘图区域不包括由边距定义的区域。默认情况下，如果它在 QChartView 内，则将调整大小。如果为绘图区域设置了显式大小，则将遵守此设置。要切换回默认行为，则调用 setPlotArea(QRectF()); 可实现。

访问函数
属性 plotAreaBackgroundVisibleᅟ: bool#

此属性表示图表绘图区域背景是否可见。

备注

默认情况下，绘图区域背景不可见，绘图区域使用总体图表背景。

参见

setPlotAreaBackgroundBrush() setPlotAreaBackgroundPen() backgroundVisible

访问函数
property theme: QChart.ChartTheme#

此属性用于指定图表的主题。

访问函数
property title: str#

此属性用于指定图表标题。

标题显示在图表顶部的标题栏中。图表标题支持HTML格式。

访问函数
__init__([parent=None[, wFlags=Qt.WindowFlags()]])#
参数：

构造一个图表对象，它是 parent 的子对象。将 wFlags 指定的属性传递给 QGraphicsWidget 构造函数。

__init__(type, parent, wFlags)
参数：
animationDuration()#
返回类型：:

int

参见

setAnimationDuration()

属性 animationDuration attribute 的获取器。

animationEasingCurve()#
返回类型：:

QEasingCurve

参见

setAnimationEasingCurve()

属性 animationEasingCurve attribute 的获取器。

animationOptions()#
返回类型：:

属性 AnimationOption 组合

参见

setAnimationOptions()

属性 animationOptions 的获取器。

backgroundBrush()#
返回类型：:

QBrush

获取用于绘制图表区域背景的画笔。

backgroundPen()#
返回类型：:

QPen

获取用于绘制图表区域背景的笔。

backgroundRoundness()#
返回类型：:

float

参见

setBackgroundRoundness()

属性 backgroundRoundness 的获取器。

chartType()#
返回类型：:

ChartType

属性 chartType 的获取器。

createDefaultAxes()#

根据已添加到图表中的系列创建图表的坐标轴。之前已添加到图表中的任何坐标轴将被删除。

备注

必须在所有系列都添加到图表后调用此函数。由此函数创建的坐标轴不会自动附加到在此函数调用之后添加到图表中的任何系列。如果一个系列没有附加任何坐标轴，则默认将其缩放以利用整个图表的绘图区域，如果在其他系列中也存在正确附加了坐标轴的情况，则可能会造成混淆。

系列类型

水平轴（X）

垂直轴（Y）

QXYSeries

QValueAxis

QValueAxis

QBarSeries

QBarCategoryAxis

QValueAxis

QPieSeries

None

None

如果在图表中添加了多个 QXYSeries 派生系列且没有添加其他类型的系列，则只创建一对坐标轴。如果向图表中添加了多个不同类型的系列，则每个系列都将获得其自己的坐标轴对。

可以稍后通过将系列作为参数提供给 axes() 函数调用来获取特定于系列的坐标轴。 QPieSeries 不创建任何坐标轴。

参见

axes() attachAxis()

isBackgroundVisible()#
返回类型：:

bool

属性 backgroundVisible 的获取器。

isDropShadowEnabled()#
返回类型：:

bool

属性 `dropShadowEnabled` 的获器。

isPlotAreaBackgroundVisible()#
返回类型：:

bool

属性 `plotAreaBackgroundVisible` 的获器。

isZoomed()#
返回类型：:

bool

如果任何序列有缩放域，则返回 true。

legend()#
返回类型：:

QLegend

返回图表的图例对象。所有权属于图表。

locale()#
返回类型：:

QLocale

参见

setLocale()

属性 `locale` 的获器。

localizeNumbers()#
返回类型：:

bool

参见

setLocalizeNumbers()

属性 `localizeNumbers` 的获器。

mapToPosition(value)#
参数：

value – QPointF

返回类型：:

QPointF

mapToValue(position)#
参数：

position – QPointF

返回类型：:

QPointF

margins()#
返回类型：:

QMargins

参见

setMargins()

属性 `margins` 的获器。

plotArea()#
返回类型：:

QRectF

参见

setPlotArea()

属性 `plotArea` 的获器。

plotAreaBackgroundBrush()#
返回类型：:

QBrush

返回用于填充图表绘图区域背景的画笔。

plotAreaBackgroundPen()#
返回类型：:

QPen

返回用于绘制图表绘图区域背景的画笔。

plotAreaChanged(plotArea)#
参数：

plotArea – QRectF

plotArea 属性的信号通知。

removeAllSeries()#

从图表中移除并删除所有已添加的系列对象。

参见

addSeries() removeSeries()

scroll(dx, dy)#
参数：

  • dx – float

  • dy – float

通过 드IA 경도와 높이를 지정한 비율로 차트의 보이는 구역을 스크롤합니다.

극 차트에서는 dx는 상수 방면 대신 각도의 지름으로 표시됩니다.

setAnimationDuration(msecs)#
参数：

msecs – int

参见

animationDuration()

animationDuration 属性的设置器。

setAnimationEasingCurve(curve)#
参数：

curve – QEasingCurve

参见

animationEasingCurve()

animationEasingCurve 属性的设置器。

setAnimationOptions(options)#
参数：

options – AnimationOption 조합

参见

animationOptions()

animationOptions 属性的设置器。

setBackgroundBrush(刷子)#
参数：

刷子 – QBrush

将用于绘制图表区域背景的刷子设置为 刷子。

setBackgroundPen(画笔)#
参数：

画笔 – QPen

将用于绘制图表区域背景的画笔设置为 画笔。

setBackgroundRoundness(直径)#
参数：

直径 – float

参见

backgroundRoundness()

属性 backgroundRoundnessᅟ 的设置器。

setBackgroundVisible([visible=true])#
参数：

visible – bool

参见

isBackgroundVisible()

属性 backgroundVisibleᅟ 的设置器。

setDropShadowEnabled([enabled=true])#
参数：

enabled – bool

参见

isDropShadowEnabled()

属性 dropShadowEnabledᅟ 的设置器。

setLocale(区域设置)#
参数：

区域设置 – QLocale

参见

locale()

属性 localeᅟ 的设置器。

setLocalizeNumbers(localize)#
参数：

localize – bool

参见

localizeNumbers()

属性 localizeNumbersᅟ 的设置器。

setMargins(边界)#
参数：

边界 – QMargins

参见

margins()

属性 margins 的设置器。

setPlotArea(rect)#
参数：

rect – QRectF

参见

plotArea()

属性 plotArea 的设置器。

setPlotAreaBackgroundBrush(brush)#
参数：

刷子 – QBrush

设置用于填充图表绘图区域背景的画笔为 brush。

setPlotAreaBackgroundPen(pen)#
参数：

画笔 – QPen

设置用于绘制图表绘图区域背景的画笔为 pen。

setPlotAreaBackgroundVisible([visible=true])#
参数：

visible – bool

参见

isPlotAreaBackgroundVisible()

属性 plotAreaBackgroundVisible 的设置器。

setTheme(theme)#
参数：

theme – ChartTheme

参见

theme()

属性 theme 的设置器。

setTitle(title)#
参数：

title – str

参见

title()

属性 title 的设置器。

setTitleBrush(brush)#
参数：

刷子 – QBrush

设置用于绘制标题文本的画笔为 brush。

参见

titleBrush()

setTitleFont(font)#
参数：

font – QFont

设置用于绘制图表标题的字体为 font。

参见

titleFont()

theme()#
返回类型：:

ChartTheme

参见

setTheme()

属性 themeᅟ 的获取器。

title()#
返回类型：:

str

参见

setTitle()

属性 titleᅟ 的获取器。

titleBrush()#
返回类型：:

QBrush

返回用于绘制标题文本的画笔。

titleFont()#
返回类型：:

QFont

获取用于绘制图表标题的字体。

zoom(factor)#
参数：

factor – float

通过自定义因子 factor 缩放视图。

因子大于 1.0 时放大视图，介于 0.0 和 1.0 之间时缩小视图。

zoomIn()#

以两倍因子放大视图。

zoomIn(rect)
参数：

rect – QRectF

将视图缩放到最大级别，此时矩形 rect 仍然完全可见。

备注

缩放可能会修改附加轴的属性，例如 QAbstractAxis::min 和 QAbstractAxis::max。

备注

此功能不支持极坐标图。

zoomOut()#

以两倍因子缩小视图。

备注

如果结果包含无效的对数轴范围，则不会执行任何操作。

zoomReset()#

将序列域重置为在调用任何缩放方法之前的值。

备注

这还将重置从第一次缩放操作到调用此方法之间指定的滚动和显式轴范围设置。如果没有执行过缩放操作，此方法将不执行任何操作。