LineSeries QML Type
Presenta los datos en gráficos lineales. Más...
| Import Statement: | import QtGraphs |
| In C++: | QLineSeries |
| Inherits: |
- Lista de todos los miembros, incluidos los heredados
- LineSeries es parte de Qt Graphs QML Types for 2D.
Propiedades
- capStyle : Qt::PenCapStyle
- dashOffset : real
(since 6.11) - dashPattern : list<real>
(since 6.11) - joinStyle : Qt::PenJoinStyle
(since 6.11) - lineStyle : QLineSeries::LineStyle
(since 6.11) - pointDelegate : Component
- strokeStyle : enumeration
(since 6.11) - width : real
Señales
- capStyleChanged()
- dashOffsetChanged(qreal newDashOffset)
(since 6.11) - dashPatternChanged(QList<qreal> newDashPattern)
(since 6.11) - joinStyleChanged(Qt::PenJoinStyle newJoinStyle)
(since 6.11) - lineStyleChanged(QLineSeries::LineStyle newLineStyle)
(since 6.11) - strokeStyleChanged(QLineSeries::StrokeStyle newStrokeStyle)
(since 6.11) - widthChanged()
Métodos
- point dataPointCoordinatesAt(real x, real y)
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]
| Constante | Descripción |
|---|---|
LineSeries.SolidLine | Una línea plana. |
LineSeries.DashLine | Guiones 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.