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.

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:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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.
© 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.