En esta página

LineSeries QML Type

Muestra 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 en forma de una serie de puntos de datos conectados por líneas rectas o escalones.

Gráfico lineal con ángulos en una cuadrícula

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);

lo que da como resultado:

Dos cuadrículas con una línea angular verde a la izquierda y una línea escalonada roja a la derecha

Nota: Como se aprecia en el primer gráfico del ejemplo anterior, los puntos aislados (como el primer punto de la serie) no se representarán como líneas, a menos que haya un pointDelegate

LineSeries utiliza en su mayor parte la misma API que ScatterSeries, así que consulta 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 remate de la línea. Se debe establecer en 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 sustituyen automáticamente por el valor por defecto.

Véase también Qt::PenCapStyle.

dashOffset : real [since 6.11]

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

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, en las que las entradas 1, 3, 5... son los guiones y las entradas 2, 4, 6... son los espacios. El patrón se especifica en unidades equivalentes al ancho de la línea.

El valor por defecto es (4, 2), lo que significa un guion 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. Se puede establecer en 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 sustituyen automáticamente por el 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 la línea. Se puede establecer en uno de los siguientes valores: LineSeries.Straight, LineSeries.StepLeft, LineSeries.StepRight o LineSeries.StepCenter. Por defecto, el estilo de la línea es LineSeries. Recta. Los valores no válidos se sustituyen automáticamente por el 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 indicado.

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

strokeStyle : enumeration [since 6.11]

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

Esta propiedad se introdujo en Qt 6.11.

width : real

El ancho de la línea. Por defecto, el ancho es 2,0. Los anchos inferiores a 0 no son válidos y se establecen automáticamente en 0.

Documentación de Signal

capStyleChanged()

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

Nota: El controlador correspondiente es onCapStyleChanged.

[since 6.11] dashOffsetChanged(qreal newDashOffset)

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

Nota: El controlador 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 líneas y trazos de la serie de líneas. El parámetro newDashPattern contiene el nuevo patrón de trazos.

Nota: El controlador 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 remate de la serie de líneas. El parámetro newJoinStyle contiene el nuevo estilo de unión.

Nota: El controlador 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 controlador 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 controlador correspondiente es onStrokeStyleChanged.

Esta señal se introdujo en Qt 6.11.

widthChanged()

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

Nota: El controlador correspondiente es onWidthChanged.

Documentación del método

point dataPointCoordinatesAt(real x, real y)

Devuelve las coordenadas de renderizado 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.