En esta página

LineSeries QML Type

Presenta los datos en gráficos lineales. Más...

Import Statement: import QtGraphs
In C++: QLineSeries
Inherits:

XYSeries

Propiedades

Señales

Métodos

Descripción detallada

Un gráfico de líneas se utiliza para mostrar información como una serie de puntos de datos conectados por líneas rectas o pasos.

Las series pueden contener huecos utilizando valores NaN como en :

import QtGraphs

GraphsView {
    axisX: ValueAxis {
        max: 5
    }
    axisY: ValueAxis {
        max: 5
    }

    LineSeries {
        color: "#00ff00"
        joinStyle: Qt.RoundJoin

        XYPoint {
            x: 0.5
            y: 0.5
        }

        XYPoint {
            x: 1.1
            y: NaN
        }

        XYPoint {
            x: 1.9
            y: 3.3
        }

        XYPoint {
            x: 2.1
            y: 2.1
        }

        XYPoint {
            x: 5
            y: 4.9
        }
    }
}

o

QLineSeries *series = new QLineSeries();
series->append(0, 2);
series->append(2, 4);
series->append(3, std::numeric_limits<qreal>::quiet_NaN());
series->append(4, 1);
series->append(5, 0);
series->setLineStyle(QLineSeries::LineStyle::StepCenter);
series->setColor(Qt::red);

que dan como resultado :

Nota: Como se ve en el primer gráfico del ejemplo anterior, los puntos aislados (como el primer punto de la serie) no se mostrarán como líneas, a menos que haya una línea visible. pointDelegate

LineSeries utiliza prácticamente la misma API que ScatterSeries, así que consulte la documentación de ScatterSeries para ver más ejemplos de uso.

Véase también ScatterSeries.

Documentación de propiedades

capStyle : Qt::PenCapStyle

Controla el estilo de tapa de la línea. Establece uno de los siguientes valores: Qt.FlatCap, Qt.SquareCap o Qt.RoundCap. Por defecto, el estilo de remate es Qt.SquareCap. Los valores no válidos se ajustan automáticamente al valor por defecto.

Véase también Qt::PenCapStyle.

dashOffset : real [since 6.11]

Esta propiedad define el punto de inicio en el patrón de guiones, medido en unidades utilizadas para especificar el patrón de guiones.

El valor por defecto es 0.

Esta propiedad se introdujo en Qt 6.11.

dashPattern : list<real> [since 6.11]

Esta propiedad define el patrón de guiones cuando strokeStyle se establece en LineSeries::DashLine. El patrón debe especificarse como un número par de entradas positivas donde las entradas 1, 3, 5... son los guiones y 2, 4, 6... son los espacios. El patrón se especifica en unidades del ancho de la línea.

El valor por defecto es (4, 2), lo que significa un guión de 4 * width píxeles seguido de un espacio de 2 * width píxeles.

Esta propiedad se introdujo en Qt 6.11.

joinStyle : Qt::PenJoinStyle [since 6.11]

Controla el estilo de unión de la línea. Establece uno de los siguientes valores: Qt.BevelJoin, Qt.MiterJoin o Qt.RoundJoin. Por defecto, el estilo de unión es Qt.BevelJoin. Los valores no válidos se ajustan automáticamente al valor por defecto.

Esta propiedad se introdujo en Qt 6.11.

Véase también Qt::PenJoinStyle.

lineStyle : QLineSeries::LineStyle [since 6.11]

Controla el estilo de línea de la línea. Seleccione uno de los siguientes valores: LineSeries.Straight, LineSeries.StepLeft, LineSeries.StepRight o LineSeries.StepCenter. Por defecto, el estilo de línea es LineSeries. Recto. Los valores no válidos se ajustan automáticamente al valor por defecto.

Esta propiedad se introdujo en Qt 6.11.

Véase también QLineSeries::LineStyle.

pointDelegate : Component

Marca el punto con el componente QML dado.

pointDelegate: Image {
    source: "images/happy_box.png"
}

strokeStyle : enumeration [since 6.11]

ConstanteDescripción
LineSeries.SolidLineUna línea plana.
LineSeries.DashLineGuiones separados por unos pocos píxeles.

Esta propiedad se introdujo en Qt 6.11.

width : real

La anchura de la línea. Por defecto, el ancho es 2.0. Las anchuras inferiores a 0 no son válidas y se fijan automáticamente en 0.

Documentación de señales

capStyleChanged()

Esta señal se emite cuando cambia el estilo de la tapa de la serie de líneas.

Nota: El manejador correspondiente es onCapStyleChanged.

[since 6.11] dashOffsetChanged(qreal newDashOffset)

Esta señal se emite cuando cambia el desplazamiento del guión de la serie de líneas. El parámetro newDashOffset contiene el nuevo desplazamiento del guión.

Nota: El manejador correspondiente es onDashOffsetChanged.

Esta señal se introdujo en Qt 6.11.

[since 6.11] dashPatternChanged(QList<qreal> newDashPattern)

Esta señal se emite cuando cambia el patrón de guiones de la serie de líneas. El parámetro newDashPattern contiene el nuevo patrón de guiones.

Nota: El manejador correspondiente es onDashPatternChanged.

Esta señal se introdujo en Qt 6.11.

[since 6.11] joinStyleChanged(Qt::PenJoinStyle newJoinStyle)

Esta señal se emite cuando cambia el estilo de la tapa de la serie de líneas. El parámetro newJoinStyle contiene el nuevo estilo de unión.

Nota: El manejador correspondiente es onJoinStyleChanged.

Esta señal se introdujo en Qt 6.11.

[since 6.11] lineStyleChanged(QLineSeries::LineStyle newLineStyle)

Esta señal se emite cuando cambia el estilo de línea de la serie de líneas. El parámetro newLineStyle contiene el nuevo estilo de línea.

Nota: El manejador correspondiente es onLineStyleChanged.

Esta señal se introdujo en Qt 6.11.

[since 6.11] strokeStyleChanged(QLineSeries::StrokeStyle newStrokeStyle)

Esta señal se emite cuando cambia el estilo de trazo de la serie de líneas. El parámetro newStrokeStyle contiene el nuevo estilo de trazo.

Nota: El manejador correspondiente es onStrokeStyleChanged.

Esta señal se introdujo en Qt 6.11.

widthChanged()

Esta señal se emite cuando cambia el ancho de la serie de líneas.

Nota: El manejador correspondiente es onWidthChanged.

Documentación del método

point dataPointCoordinatesAt(real x, real y)

Devuelve las coordenadas de renderización de x y y convertidas en coordenadas de puntos de datos.

© 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.