QCustomSeries Class
La clase QCustomSeries permite presentar tipos de gráficos personalizados. Más información...
| Encabezado: | #include <QCustomSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| Desde: | Qt 6.11 |
| En QML: | CustomSeries |
| Heredan de: | QAbstractSeries |
Propiedades
- delegate : QQmlComponent*
Funciones públicas
| void | append() |
| void | append(const QVariantMap &data) |
| QQmlComponent * | delegate() const |
| void | insert(qsizetype index) |
| void | insert(qsizetype index, const QVariantMap &data) |
| qreal | mapX(qreal x) |
| qreal | mapY(qreal y) |
| void | remove(qsizetype index) |
| void | setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter) |
| void | setDelegate(QQmlComponent *newDelegate) |
Ranuras públicas
| void | clear() |
Señales
| void | delegateChanged() |
Funciones protegidas
| virtual void | updateDelegate(QQuickItem *item, qsizetype index) |
Descripción detallada
Utiliza QCustomSeries para crear gráficos personalizados. Piensa en él como un gráfico de dispersión que te permite acceder a datos personalizados para cada elemento.
QCustomSeries 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. La serie pasa este mapa a cada elemento creado en función del delegado. El delegado determina cómo utilizar los datos.
Para asignar datos a las coordenadas de representación definidas por los ejes de QGraphsView, 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.
Documentación de propiedades
delegate : QQmlComponent*
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».
Funciones de acceso:
| QQmlComponent * | delegate() const |
| void | setDelegate(QQmlComponent *newDelegate) |
Señal del notificador:
| void | delegateChanged() |
Documentación de las funciones miembro
[invokable] void QCustomSeries::append()
Añade un elemento de datos vacío a la serie.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QCustomSeries::append(const QVariantMap &data)
Añade a la serie un elemento de datos definido mediante ` data `.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[slot] void QCustomSeries::clear()
Borrar todos los datos.
[invokable] void QCustomSeries::insert(qsizetype index)
Añade un elemento de datos vacío a la serie en la posición index.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QCustomSeries::insert(qsizetype index, const QVariantMap &data)
Añade un elemento de datos definido por ` data ` a la serie en la posición ` index`.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapX(qreal x)
Devuelve una coordenada del espacio de ejes de x convertida al espacio de renderizado.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapY(qreal y)
Devuelve una coordenada del espacio de ejes y convertida al espacio de renderizado.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QCustomSeries::remove(qsizetype index)
Elimina un elemento de datos en la posición index.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QCustomSeries::setCustomSeriesPainter(QCustomSeriesCanvasRenderer *painter)
Establece ` painter ` como el renderizador del pintor de lienzo utilizado para dibujar esta serie cuando se utiliza el backend de alto rendimiento del pintor de lienzo.
QCustomSeries Asume la propiedad de ` painter`. El renderizador del backend de CanvasPainter lo adopta la próxima vez que se sincronice esta serie, tras lo cual solo lo destruye el renderizador, en el hilo de renderizado; nunca lo hace directamente ` QCustomSeries `. Si ` painter ` se sustituye o se borra antes de esa primera sincronización, o si esta serie se destruye antes de ella, ` QCustomSeries ` lo elimina por sí mismo.
[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)
El renderizador de gráficos lo invoca para dar acceso a la instancia de ` item ` que representa los datos y a la instancia de ` index ` correspondiente al elemento de datos.
Sobrescríbela para implementar valores de propiedad personalizados para las instancias de ` QQuickItem `.
© 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.