En esta página

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

Métodos

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.

Gráfico de barras con dos barras rellenas con degradado

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.