CustomSeries QML Type
El tipo `CustomSeries` permite presentar tipos de gráficos personalizados. Más información...
| Import Statement: | import QtGraphs |
| Since: | Qt 6.11 |
| In C++: | QCustomSeries |
Propiedades
- delegate : Component
Métodos
- void append()
- void append(var data)
- void clear()
- void insert(int index)
- void insert(int index, var data)
- real mapX(real x)
- real mapY(real y)
- void remove(int index)
Descripción detallada
Utiliza CustomSeries para crear gráficos personalizados. Piensa en ello como un gráfico de dispersión que te permite acceder a datos personalizados para cada elemento.
CustomSeries define un delegado que se utiliza para representar cada elemento añadido al gráfico. Cada elemento incluye datos definidos por el usuario almacenados en un mapa de datos ( QVariantMap). El índice del elemento en el gráfico también se añade automáticamente al mapa de datos. En el contexto de QML, el mapa de variantes se define mediante un objeto JavaScript. La serie pasa este mapa a cada elemento creado en base al delegado. El delegado determina cómo utilizar los datos.
Para asignar datos a las coordenadas de representación definidas por los ejes de GraphsView, utiliza las funciones mapX y mapY.
Nota: Actualmente , los elementos individuales de una serie personalizada no comparten información entre sí. Por este motivo, no es posible implementar una serie de líneas personalizada.

El código siguiente implementa el gráfico personalizado que se muestra. En este caso, los datos personalizados contienen dos valores: «upper» y «lower». Estos se definen a continuación en el delegado para determinar la altura y la coordenada y del elemento.
import QtQuick
import QtGraphs
Window {
width: 640
height: 480
visible: true
GraphsView {
anchors.fill: parent
axisX: BarCategoryAxis {
categories: ["ABC", "DEF"]
}
axisY: ValueAxis {
max: 8
tickInterval: 1
}
CustomSeries {
id: custom
delegate: Rectangle {
property var data
gradient: Gradient {
GradientStop { position: 0.0; color: "lightsteelblue" }
GradientStop { position: 1.0; color: "blue" }
}
border.width: 1
x: custom.mapX(data.index + 0.5) - width * 0.5
y: custom.mapY((data.upper + data.lower) * 0.5) - height * 0.5
width: Math.abs(custom.mapX(1) - custom.mapX(0)) * 0.5
height: Math.abs(custom.mapY(data.upper) - custom.mapY(data.lower))
}
CustomSeriesData {
data: ({
upper: 5,
lower: 1
})
}
CustomSeriesData {
data: ({
upper: 6,
lower: 4
})
}
}
}
}Documentación de propiedades
delegate : Component
El delegado se utiliza para insertar elementos en QML que se correspondan con los datos personalizados proporcionados. Los datos se definen en el propio ` CustomSeries ` y se pasan a los elementos delegados a través de la propiedad «data».
delegate: Rectangle {
property var data
Rectangle {
color: "tan"
border.color: "black"
border.width: 4
y: series.mapY(data.index + 1) - height / 2 + 1
x: series.mapX(data.median) - width / 2
height: 32
width: Math.abs(series.mapX(data.upperQuartile) - series.mapX(data.lowerQuartile))
}
}
}Documentación del método
void append()
Añade un elemento de datos vacío a la serie.
void append(var data)
Añade a la serie un elemento de datos definido mediante ` data `.
void clear()
Borrar todos los datos.
void insert(int index)
Añade un elemento de datos vacío a la serie en la posición index.
void insert(int index, var data)
Añade un elemento de datos definido por ` data ` a la serie en la posición ` index`.
real mapX(real x)
Devuelve una coordenada del espacio de ejes x convertida al espacio de renderizado.
real mapY(real y)
Devuelve una coordenada del espacio de ejes y convertida al espacio de renderizado.
void remove(int index)
Eliminar un elemento de datos situado en la posición index.
© 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.