ChartView QML Type

管理图表中数据系列、图例和坐标轴的图形显示。更多...

此类型已弃用。我们强烈建议不要在新代码中使用它。

• 所有成员列表（包括继承的成员）

属性

• animationDuration : int
• animationEasingCurve : easing
• animationOptions : enumeration
• axes : list<AbstractAxis>
• backgroundColor : color
• backgroundRoundness : real
• count : int
• dropShadowEnabled : bool
• legend : Legend
• locale : locale (since QtCharts 2.0)
• localizeNumbers : bool (since QtCharts 2.0)
• margins : Margins
• plotArea : rect
• plotAreaColor : color
• theme : enumeration
• title : string
• titleColor : color
• titleFont : font

信号

• seriesAdded(AbstractSeries series)
• seriesRemoved(AbstractSeries series)

方法

• Axis axisX(AbstractSeries series)
• Axis axisY(AbstractSeries series)
• AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
• bool isZoomed()
• point mapToPosition(point value, AbstractSeries series)
• point mapToValue(point position, AbstractSeries series)
• void removeAllSeries()
• void removeSeries(AbstractSeries series)
• void scrollDown(real pixels)
• void scrollLeft(real pixels)
• void scrollRight(real pixels)
• void scrollUp(real pixels)
• AbstractSeries series(int index)
• AbstractSeries series(string name)
• void setAxisX(AbstractAxis axis, AbstractSeries series)
• void setAxisY(AbstractAxis axis, AbstractSeries series)
• void zoom(real factor)
• void zoomIn()
• void zoomIn(rect rectangle)
• void zoomOut()
• void zoomReset()

详细说明

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

图表中启用的动画效果：

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 时，始终使用C语言环境。默认值为false 。

该属性在 QtCharts 2.0 中引入。

另请参阅 locale 。

margins : Margins

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

plotArea : rect

绘制图表所处的矩形区域。

绘图区域不包括由边距定义的区域。默认情况下，若位于ChartView 内部，该区域会自动调整大小。如果为绘图区域显式设置了矩形，则会遵循该设置；若要恢复默认行为，可将其设置为Qt.rect(0, 0, 0, 0) 。

另请参阅 margins 。

plotAreaColor : color

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

另请参阅 backgroundColor 和theme 。

theme : enumeration

图表所使用的主题。

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

支持以下值：

title : string

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

另请参阅 titleColor 。

titleColor : color

标题文本的颜色。

titleFont : font

图表的标题字体。

有关详细信息，请参阅font 。

Signal 文档

seriesAdded(AbstractSeries series)

当将序列series 添加到图表时，会发出此信号。

seriesRemoved(AbstractSeries series)

当时间序列series 从图表中移除时，会触发此信号。当信号处理程序执行完毕后，该时间序列对象将失效。

方法文档

Axis axisX(AbstractSeries series)

series 的 x 轴。

另请参阅 setAxisX()。

Axis axisY(AbstractSeries series)

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 的取值：

bool isZoomed()

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

point mapToPosition(point value, AbstractSeries series)

返回在数据集series 中，值value 在图表中的位置。

point mapToValue(point position, AbstractSeries series)

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

void removeAllSeries()

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

void removeSeries(AbstractSeries series)

从图表中移除序列series ，并永久删除该序列对象。

void scrollDown(real pixels)

向下滚动pixels 指定的像素数。这是一个便捷方法，例如适用于键盘导航。

void scrollLeft(real pixels)

向左滚动pixels 指定的像素数。这是一个便捷方法，适用于例如键盘导航等场景。

void scrollRight(real pixels)

向右滚动pixels 指定的像素数。这是一个便捷方法，适用于例如按键导航等场景。

void scrollUp(real pixels)

向上滚动pixels 指定的像素数。这是一个便捷方法，例如适用于键盘导航。

AbstractSeries series(int index)

返回图表中索引为index 的系列。结合图表的count 属性，可实现对图表中各系列的遍历。

另请参阅 count 。

AbstractSeries series(string name)

返回图表中名称为name 的第一个系列。如果不存在该名称的系列，则返回null。

void setAxisX(AbstractAxis axis, AbstractSeries series)

将series 的x轴设置为axis 。

另请参阅 axisX()。

void setAxisY(AbstractAxis axis, AbstractSeries series)

将series 的y轴设置为axis 。

另请参阅 axisY()。

void zoom(real factor)

按自定义缩放因子factor 放大图表。

放大倍数大于 1.0 时，视图会放大；放大倍数在 0.0 到 1.0 之间时，视图会缩小。

void zoomIn()

将视图放大两倍。

void zoomIn(rect rectangle)

将视图放大到最大级别，此时矩形rectangle 仍能完全显示。

void zoomOut()

将视图缩小至原来的二分之一。

void zoomReset()

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