Back to Qt.io
Contact Us Blog Download Qt

GraphsView QML Type

所有Qt Graphs 视图的基本类型。更多

Import Statement: import QtGraphs

属性

方法

详细描述

该类将序列和主题收集在一起并绘制图表。您需要导入Qt Graphs 模块才能使用该类型：

import QtGraphs

之后，您就可以在 qml 文件中使用 GraphsView：

import QtQuick
import QtGraphs

GraphsView {
    anchors.fill: parent
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#E0D080", "#B0A060"]
        borderColors: ["#807040", "#706030"]
        grid.mainColor: "#ccccff"
        grid.subColor: "#eeeeff"
        axisY.mainColor: "#ccccff"
        axisY.subColor: "#eeeeff"
    }
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis {
        min: 0
        max: 10
        subTickCount: 4
    }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
        BarSet {
            values: [9, 8, 6]
        }
    }
}

另请参见 BarSeries,LineSeries,BarCategoryAxis,ValueAxis 和GraphsTheme 。

属性文档

axisX : AbstractAxis

该视图中系列使用的 x 轴。

另请参见 axisY 。


axisXSmoothing : real

控制图形 X 轴平滑（抗锯齿）量。默认情况下，平滑度为1.0 。


axisY : AbstractAxis

该视图中系列所用的 Y 轴。

另请参阅 axisX 。


axisYSmoothing : real

控制图形 Y 轴平滑（抗锯齿）量。默认情况下，平滑度为1.0 。


gridSmoothing : real

控制图形网格平滑（抗锯齿）量。默认情况下，平滑度为1.0 。


marginBottom : real

图表底部的空白量。默认情况下，空白量为 20。


marginLeft : real

图形左侧的空白量。默认情况下，边距为 20。


marginRight : real

图表右侧的空白区域。默认情况下，边距为 20。


marginTop : real

图表顶部的空白空间。默认情况下，边距为 20。


orientation : Qt.Orientation

确定GraphsView 的方向。当方向为Qt.Horizontal 时，axisX 和axisY 将切换位置，使axisX 垂直呈现，axisY 水平呈现。该属性目前由BarSeries 使用。默认值为Qt.Vertical 。


panStyle : enumeration

确定GraphsView 的平移样式。平移通过操作ValueAxis 的平移属性来实现。默认值为GraphsView.PanStyle.None 。

常数说明
GraphsView.PanStyle.None禁用平移。
GraphsView.PanStyle.Drag鼠标和触摸拖动可左右平移视图。

plotArea : rect [read-only, since 6.9]

绘制图形的矩形区域。这是GraphsView 区域减去坐标轴区域和边距。

此属性在 Qt 6.9 中引入。

另请参阅 marginTop,marginBottom,marginLeft, 和marginRight 。


seriesList : list [read-only]

由GraphsView 渲染的系列列表。由GraphsView 的系列类型子系列自动填充。

这是默认属性，因此子元素会自动添加到系列列表中。

另请参阅 BarSeries,LineSeries, 和ScatterSeries 。


shadowBarWidth : real

控制图形网格阴影宽度。默认情况下，阴影宽度设置为2.0 。


shadowColor : color

控制图形网格阴影颜色。默认情况下，阴影颜色设置为black 。


shadowSmoothing : real

控制图形网格阴影平滑（抗锯齿）量。默认情况下，阴影平滑设置为4.0 。


shadowVisible : bool

控制图形网格阴影是否可见。默认情况下，阴影可见度设置为false 。


shadowXOffset : real

控制图形网格阴影 X 偏移量。默认情况下，阴影 X 偏移量设置为0.0 。


shadowYOffset : real

控制图形网格阴影 Y 偏移量。默认情况下，阴影 Y 偏移量设置为0.0 。


theme : GraphsTheme

图形使用的主题。决定着色、轴线、字体等。如果未设置主题，则使用默认主题。


zoomAreaDelegate : Component

确定用户执行拖动动作放大某一区域时绘制的 QML 元素。


zoomAreaEnabled : bool

缩放区域会改变鼠标和触摸拖动，以绘制一个由zoomAreaDelegate 决定的方框。释放后，图形ValueAxis 的缩放和平移属性将被更改，使视图只覆盖所画方框交叉的区域。

另请参阅 zoomAreaDelegate 。


zoomSensitivity : real

确定缩放时缩放值的变化速度。


zoomStyle : enumeration

确定GraphsView 的缩放样式。通过操作ValueAxis 缩放属性实现缩放。默认值为GraphsView.ZoomStyle.None 。

常数说明
GraphsView.ZoomStyle.None禁用缩放。
GraphsView.ZoomStyle.Center捏合缩放和鼠标滚轮缩放都是向图表视图的中心缩放。

方法文档

addSeries(AbstractSeries series)

将series 添加到GraphsView 中。如果series 为空，则不会添加。如果series 已属于图表，则会被移至末尾。


bool hasSeries(AbstractSeries series)

如果series 在图形中，则返回true 。


insertSeries(int index, AbstractSeries series)

在index 指定的位置插入series 。如果series 为空，则不会插入。如果series 已经属于图形，则会被移到index 中。


removeSeries(AbstractSeries series)

从图表中删除series 。


removeSeries(int index)

从图表中删除index 指定的序列。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.