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 。


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

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


方法文档

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.