ChartView QML 类型

管理图表系列、图例和轴的图形表示。更多...

导入声明	import QtCharts 2.7
继承自	PolarChartView

所有成员的列表，包括继承的成员

属性

animationDuration : int
animationEasingCurve : easing
animationOptions : 枚举
axes : list<AbstractAxis>
backgroundColor : 颜色
backgroundRoundness : 实数
count : int
dropShadowEnabled : bool
legend : 图例
locale : locale (自 QtCharts 2.0)
localizeNumbers : bool (自 QtCharts 2.0)
margins : 边距
plotArea : 矩形
plotAreaColor : 颜色
theme : 枚举
title : 字符串
titleColor : 颜色
titleFont : 字体

信号

seriesAdded(AbstractSeries series)
seriesRemoved(AbstractSeries series)

方法

轴线 axisX(AbstractSeries series)
轴线 axisY(AbstractSeries series)
AbstractSeries createSeries(枚举类型 type, 字符串 name, AbstractAxis axisX, AbstractAxis axisY)
是否放大()
点 mapToPosition(点 value, AbstractSeries series)
点 mapToValue(点 position, AbstractSeries series)
移除所有系列()
removeSeries(AbstractSeries series)
scrollDown(实数 pixels)
scrollLeft(实数 pixels)
scrollRight(实数 pixels)
scrollUp(实数 pixels)
摘要系列系列(int index)
摘要系列系列(string name)
setAxisX(AbstractAxis axis, AbstractSeries series)
setAxisY(AbstractAxis axis, AbstractSeries series)
zoom(real factor)
放大()
zoomIn(rect rectangle)
缩小()
重置缩放()

详细描述

ChartView 类型显示不同系列类型作为图表。

本示例展示了如何创建一个简单的折线图

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

属性文档

animationDuration : int

图表动画的持续时间。

animationEasingCurve : easing

图表动画的缓动曲线。

animationOptions : enumeration

图表中启用的动画

常量	描述
`ChartView.NoAnimation`	图表中禁用动画。这是默认值。
`ChartView.GridAxisAnimations`	图表中启用网格轴动画。
`ChartView.SeriesAnimations`	图表中启用系列动画。
`ChartView.AllAnimations`	图表中启用所有动画类型。

axes : list<AbstractAxis>

图表的轴。

backgroundColor : color

图表背景的颜色。默认情况下，背景颜色由图表主题指定。

参见 theme.

backgroundRoundness : real

图表背景角落圆角圆的直径。

count : int

添加到图表中的系列数量。

dropShadowEnabled : bool

是否启用背景阴影效果。

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

legend : Legend

图表的图例。图例列出添加到图表中的所有系列、饼图切片和条形图集。

locale : locale [since QtCharts 2.0]

用于格式化各种图表标签的区域设置。

只有在 localizeNumbers 为 true 时才本地化标签，除了 DateTimeAxis 标签，它们始终使用与本属性设置的 QLocale。

默认为图表构造时应用的默认区域设置。

此属性在 QtCharts 2.0 中引入。

参见 localizeNumbers.

localizeNumbers : bool [since QtCharts 2.0]

是否对数字进行本地化。

当设置为 true 时，根据与 locale 属性一起设置的 QLocale 对各种系列和轴标签中出现的所有生成数字进行本地化。当 false 时， always 使用 C 区域设置。默认为 false。

注意: 此属性不影响 DateTimeAxis 标签，它们始终使用与区域属性设置的 QLocale。

此属性在 QtCharts 2.0 中引入。

另请参阅 区域。

margins : 边距

允许的最小边距，位于图表矩形边缘和绘图区域之间。边距用于绘制标题、轴和图例。

plotArea : 矩形

图表绘制的矩形。

绘图区域不包括由边距定义的区域。默认情况下，如果位于 ChartView 内，则它会调整大小。如果为绘图区域设置了显式的矩形，则它将尊重此设置。要恢复到默认行为，将其设置到 Qt.rect(0, 0, 0, 0) 即可。

另请参阅 边距。

plotAreaColor : 颜色

图表绘图区域背景的颜色。默认情况下，绘图区域背景使用图表的背景颜色，该颜色由图表主题指定。

另请参阅 背景颜色和主题。

theme : 枚举

图表使用的主题。

主题是一组内置的与UI样式相关的设置，应用于图表的所有视觉元素，例如系列的颜色、笔、画笔和字体，以及轴、标题和图例。 Qml Oscilloscope 示例演示了如何设置主题。

注意: 更改主题将覆盖先前应用到的系列的所有自定义设置。

支持以下值

常量	描述
`ChartView.ChartThemeLight`	浅色主题，默认主题。
`ChartView.ChartThemeBlueCerulean`	天蓝色主题。
`ChartView.ChartThemeDark`	深色主题。
`ChartView.ChartThemeBrownSand`	棕色沙子主题。
`ChartView.ChartThemeBlueNcs`	自然颜色系统（NCS）蓝色主题。
`ChartView.ChartThemeHighContrast`	高对比度主题。
`ChartView.ChartThemeBlueIcy`	冰蓝色主题。
`ChartView.ChartThemeQt`	Qt 主题。

title : 字符串

标题显示为图表顶部的标题。图表标题支持HTML格式化。

另请参阅 标题颜色。

titleColor : 颜色

标题文本的颜色。

titleFont : 字体

图表标题的字体。

更多信息，请参阅字体。

信号文档

seriesAdded(AbstractSeries series)

当系列 series 被添加到图表时发出此信号。

注意: 相应处理程序是 onSeriesAdded。

seriesRemoved(AbstractSeries series)

当系列 series 从图表中移除时发出此信号。处理程序完成时，系列对象变得无效。

注意: 相应处理程序是 onSeriesRemoved。

方法文档

轴 axisX(AbstractSeries series)

系列的x轴。

另请参阅setAxisX。

轴 axisY(AbstractSeries series)

系列的y轴。

另请参阅setAxisY。

AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

向图表添加一个类型为type，名为name的系列，并可选择添加轴 axisX 和 axisY。例如：

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

以下枚举值可以用作type的值：

常量	描述
`ChartView.SeriesTypeLine`	一条线系列。
`ChartView.SeriesTypeArea`	一个区域系列。
`ChartView.SeriesTypeBar`	一个条形系列。
`ChartView.SeriesTypeStackedBar`	一个组合条形系列。
`ChartView.SeriesTypePercentBar`	一个百分比条形系列。
`ChartView.SeriesTypeBoxPlot`	一个箱线图系列。
`ChartView.SeriesTypeCandlestick`	一个蜡烛图系列。
`ChartView.SeriesTypePie`	一个饼图系列。
`ChartView.SeriesTypeScatter`	一个散点系列。
`ChartView.SeriesTypeSpline`	一个样条图系列。
`ChartView.SeriesTypeHorizontalBar`	一个水平条形系列。
`ChartView.SeriesTypeHorizontalStackedBar`	一个水平组合条形系列。
`ChartView.SeriesTypeHorizontalPercentBar`	一个水平百分比条形系列。

是否放大()

如果任一系列具有缩放的域，则返回 true。

point mapToPosition(point value, AbstractSeries series)

返回series系列中值value在图表中的位置。

point mapToValue(point position, AbstractSeries series)

返回位于图表位置position的series系列中的值。

移除所有系列()

从图表中移除所有系列并永久删除所有系列对象。

removeSeries(AbstractSeries series)

从图表中移除系列series并永久删除系列对象。

scrollDown(real pixels)

向下滚动由pixels指定的像素数。这是一个适用于键导航等便捷方法的函数。

scrollLeft(real pixels)

向左滚动由pixels指定的像素数。这是一个适用于键导航等便捷方法的函数。

scrollRight(real pixels)

向右滚动由pixels指定的像素数。这是一个适用于键导航等便捷方法的函数。

scrollUp(real pixels)

向上滚动指定像素数。这是一个适合键导航等便捷方法的操作。

AbstractSeries series(int index)

返回图表上索引为index的系列。与图表的count属性一起使用，可以实现遍历图表的系列。

另请参阅count。

AbstractSeries series(string name)

返回名称为name的图表第一个个系列。如果没有该名称的系列，则返回null。

setAxisX(AbstractAxis axis, AbstractSeries series)

将系列series的x轴设置为axis。

另请参阅axisX。

setAxisY(AbstractAxis axis, AbstractSeries series)

将系列series的y轴设置为axis。

另请参阅axisY。

zoom(real factor)

使用自定义因子factor缩小图表。

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

放大()

通过因子2缩小视图。

zoomIn(rect rectangle)

将视图缩小到矩形rectangle完全可见的最大程度。

注意：此功能不支持极坐标图表。

缩小()

通过因子2缩小视图。

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

重置缩放()

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

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