En esta página

HelloGraphs

Uso de gráficos 2D en una aplicación de Qt Quick.

HelloGraphs muestra cómo crear un sencillo gráfico de barras y un gráfico de líneas en 2D.

Gráfico de barras para el periodo 2024-2026 y gráfico de líneas con dos series de datos

En las siguientes secciones se describe cómo crear un gráfico de barras utilizando BarSeries y un gráfico de líneas utilizando LineSeries.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

BarGraph

El primer gráfico del ejemplo es un gráfico de barras. Para crearlo, se parte de un componente ` GraphsView `, configurando ` X axis`, ` Y axis ` y ` theme`. El eje X es un ` BarCategoryAxis ` con 3 categorías. Tanto la cuadrícula vertical como las líneas de los ejes están ocultas. El eje Y es un ` ValueAxis ` con un rango visible entre 20 y 100. Se mostrarán marcas principales con etiquetas cada 10 valores utilizando tickInterval. Las marcas secundarias se mostrarán cada valor utilizando subTickCount 9 , lo que significa que entre cada marca principal habrá 9 marcas secundarias. Por último, se añade theme, que resulta adecuado para fondos oscuros. Este tema ajusta la cuadrícula de fondo del gráfico, las líneas de los ejes y las etiquetas.

GraphsView {
    anchors.fill: parent
    anchors.margins: 16
    axisX: BarCategoryAxis {
        categories: [2024, 2025, 2026]
        gridVisible: false
        subGridVisible: false
    }
    axisY: ValueAxis {
        min: 20
        max: 100
        tickInterval: 10
        subTickCount: 9
    }
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        theme: GraphsTheme.Theme.QtGreen
    }
    ...

Para convertirlo en un gráfico de barras, añade un BarSeries.

BarSeries {
    ...

A continuación, se añaden los datos a BarSeries utilizando BarSet. Hay tres barras con propiedades personalizadas definidas para el color y el borde. Estas propiedades anularán los posibles valores de seriesColors establecidos para GraphsTheme.

BarSet {
    values: [82, 50, 75]
    borderWidth: 2
    color: "#373F26"
    borderColor: "#DBEB00"
}

Gráfico de líneas

El segundo gráfico del ejemplo es un gráfico de líneas. También comienza definiendo un elemento GraphsView. Se crea un GraphsTheme personalizado para conseguir una apariencia a medida. GraphsTheme ofrece una amplia gama de posibilidades de personalización para la cuadrícula de fondo y los ejes, que se aplican después de theme.

El GraphsView define axisX y axisY adecuados para este gráfico.

GraphsView {
    anchors.fill: parent
    anchors.margins: 16
    theme: GraphsTheme {
        readonly property color c1: "#DBEB00"
        readonly property color c2: "#373F26"
        readonly property color c3: Qt.lighter(c2, 1.5)
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#2CDE85", "#DBEB00"]
        grid.mainColor: c3
        grid.subColor: c2
        axisX.mainColor: c3
        axisY.mainColor: c3
        axisX.subColor: c2
        axisY.subColor: c2
        axisX.labelTextColor: c1
        axisY.labelTextColor: c1
    }
    axisX: ValueAxis {
        max: 5
        tickInterval: 1
        subTickCount: 9
        labelDecimals: 1
    }
    axisY: ValueAxis {
        max: 10
        tickInterval: 1
        subTickCount: 4
        labelDecimals: 1
    }
    ...

Se utiliza el componente personalizado « Delegate » para visualizar los puntos de datos.

component Marker : Rectangle {
    width: 16
    height: 16
    color: "#ffffff"
    radius: width * 0.5
    border.width: 4
    border.color: "#000000"
}

Para convertirlo en un gráfico de líneas, añada un « LineSeries ». Esto configura el « pointDelegate » para que utilice el componente « Delegate » personalizado que se creó anteriormente. Los puntos de datos se añaden mediante elementos « XYPoint ».

LineSeries {
    id: lineSeries1
    width: 4
    pointDelegate: Marker { }
    XYPoint { x: 0; y: 0 }
    XYPoint { x: 1; y: 2.1 }
    XYPoint { x: 2; y: 3.3 }
    XYPoint { x: 3; y: 2.1 }
    XYPoint { x: 4; y: 4.9 }
    XYPoint { x: 5; y: 3.0 }
}

La segunda serie de líneas es similar a la primera. Al tratarse del segundo LineSeries dentro del GraphsView, se selecciona automáticamente el segundo color del seriesColors.

LineSeries {
    id: lineSeries2
    width: 4
    pointDelegate: Marker { }
    XYPoint { x: 0; y: 5.0 }
    XYPoint { x: 1; y: 3.3 }
    XYPoint { x: 2; y: 7.1 }
    XYPoint { x: 3; y: 7.5 }
    XYPoint { x: 4; y: 6.1 }
    XYPoint { x: 5; y: 3.2 }
}

Proyecto de ejemplo en @ code.qt.io

© 2026 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.