LineSeries QML Type
Muestra los datos en gráficos lineales. Más...
| Import Statement: | import QtGraphs |
| In C++: | QLineSeries |
| Inherits: |
- Lista de todos los miembros, incluidos los miembros heredados
- LineSeries forma parte de los tipos QML para 2D deQt Graphs .
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 en forma de una serie de puntos de datos conectados por líneas rectas o escalones.

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:

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]
| Constante | Descripción |
|---|---|
LineSeries.SolidLine | Una línea simple. |
LineSeries.DashLine | Guiones 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.