QCustomSeries Class
La clase QCustomSeries permite presentar tipos de gráficos personalizados. Más...
| Cabecera: | #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 |
| Hereda: | 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 | 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 renderizar cada elemento añadido al gráfico. Cada elemento incluye datos definidos por el usuario almacenados en 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 base al delegado. El delegado determina cómo utilizar los datos.
Para mapear los datos a las coordenadas de renderización definidas por los ejes de QGraphsView, utilice las funciones mapX y mapY.
Nota: Actualmente, los elementos individuales de una serie personalizada no comparten información entre sí. Por esta razón, no se puede implementar una serie lineal personalizada.
Documentación de propiedades
delegate : QQmlComponent*
El delegado se utiliza para insertar en QML elementos correspondientes a los datos personalizados proporcionados. Los datos se definen en el propio CustomSeries y se proporcionan 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 funciones miembro
[invokable] void QCustomSeries::append()
Añade un dato vacío a la serie.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QCustomSeries::append(const QVariantMap &data)
Añade un elemento de datos definido por data a la serie.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[slot] void QCustomSeries::clear()
Borra todos los datos.
[invokable] void QCustomSeries::insert(qsizetype index)
Añade un dato vacío a la serie en la posición index.
Nota: Esta función puede invocarse 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapX(qreal x)
Devuelve x coordenada eje-espacio convertida a render-espacio.
Nota: Esta función puede invocarse a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[invokable] qreal QCustomSeries::mapY(qreal y)
Devuelve y coordenada eje-espacio convertida a render-espacio.
Nota: Esta función puede invocarse a través del sistema de meta-objetos 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[virtual protected] void QCustomSeries::updateDelegate(QQuickItem *item, qsizetype index)
Llamada por el renderizador del gráfico para dar acceso a item que representa los datos, y a index correspondiente al elemento de datos.
Anular para implementar valores de propiedad personalizados para la(s) instancia(s) 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.
