En esta página

QLineSeries Class

La clase QLineSeries muestra los datos en gráficos de líneas. Más información...

Encabezado: #include <QLineSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: LineSeries
Heredan de: QXYSeries

Tipos públicos

(since 6.11) enum class LineStyle { Straight, StepLeft, StepRight, StepCenter }
(since 6.11) enum class StrokeStyle { SolidLine, DashLine }

Propiedades

Funciones públicas

Qt::PenCapStyle capStyle() const
qreal dashOffset() const
QList<qreal> dashPattern() const
QPointF dataPointCoordinatesAt(qreal x, qreal y)
Qt::PenJoinStyle joinStyle() const
QLineSeries::LineStyle lineStyle() const
void setCapStyle(Qt::PenCapStyle newCapStyle)
void setDashOffset(qreal newDashOffset)
void setDashPattern(const QList<qreal> &pattern)
void setJoinStyle(Qt::PenJoinStyle newJoinStyle)
void setLineStyle(QLineSeries::LineStyle newLineStyle)
void setStrokeStyle(QLineSeries::StrokeStyle newStrokeStyle)
void setWidth(qreal newWidth)
QLineSeries::StrokeStyle strokeStyle() const
qreal width() const

Señales

void capStyleChanged()
void dashOffsetChanged(qreal newDashOffset)
void dashPatternChanged(const QList<qreal> &newDashPattern)
void joinStyleChanged(Qt::PenJoinStyle newJoinStyle)
void lineStyleChanged(QLineSeries::LineStyle newLineStyle)
void strokeStyleChanged(QLineSeries::StrokeStyle newStrokeStyle)
void widthChanged()

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

Documentación sobre tipos de miembros

[since 6.11] enum class QLineSeries::LineStyle

Representa el estilo de línea de la serie.

ConstanteValorDescripción
QLineSeries::LineStyle::Straight0Los puntos están unidos por una línea recta.
QLineSeries::LineStyle::StepLeft1Los puntos se unen mediante escalones, siendo la altura de cada escalón el valor de la izquierda.
QLineSeries::LineStyle::StepRight2Los puntos están unidos por escalones, siendo la altura de cada escalón el valor de la derecha.
QLineSeries::LineStyle::StepCenter3Los puntos están conectados mediante escalones que varían en el punto medio entre dos valores.

Esta enumeración se introdujo en Qt 6.11.

[since 6.11] enum class QLineSeries::StrokeStyle

Representa el estilo de trazo de la serie. El valor por defecto es StrokeStyle.SolidLine.

ConstanteValorDescripción
QLineSeries::StrokeStyle::SolidLineQt::SolidLineUna línea continua.
QLineSeries::StrokeStyle::DashLineQt::DashLineGuiones separados por unos pocos píxeles.

Esta enumeración se introdujo en Qt 6.11.

Documentación de la propiedad

capStyle : Qt::PenCapStyle

Esta propiedad define el estilo de mayúsculas que se utiliza para los finales de línea.

El valor por defecto es « Qt.SquareCap ».

Funciones de acceso:

Qt::PenCapStyle capStyle() const
void setCapStyle(Qt::PenCapStyle newCapStyle)

Señal de notificación:

void capStyleChanged()

[since 6.11] dashOffset : qreal

Esta propiedad mantiene el desplazamiento del guión cuando la opción « strokeStyle » está configurada en « LineSeries.DashLine ».

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal dashOffset() const
void setDashOffset(qreal newDashOffset)

Señal del notificador:

void dashOffsetChanged(qreal newDashOffset)

[since 6.11] dashPattern : QList<qreal>

Esta propiedad mantiene el patrón de guiones cuando la opción « strokeStyle » está establecida en « LineSeries.DashLine ».

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QList<qreal> dashPattern() const
void setDashPattern(const QList<qreal> &pattern)

Señal del notificador:

void dashPatternChanged(const QList<qreal> &newDashPattern)

[since 6.11] joinStyle : Qt::PenJoinStyle

Esta propiedad define el estilo de unión que se utiliza para los extremos de las líneas.

El valor por defecto es « Qt.BevelJoin ».

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

Qt::PenJoinStyle joinStyle() const
void setJoinStyle(Qt::PenJoinStyle newJoinStyle)

Señal del notificador:

void joinStyleChanged(Qt::PenJoinStyle newJoinStyle)

[since 6.11] lineStyle : QLineSeries::LineStyle

Esta propiedad define el estilo de línea que se utiliza para la representación de las líneas.

El valor por defecto es « LineSeries.Straight ».

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QLineSeries::LineStyle lineStyle() const
void setLineStyle(QLineSeries::LineStyle newLineStyle)

Señal del notificador:

void lineStyleChanged(QLineSeries::LineStyle newLineStyle)

[since 6.11] strokeStyle : QLineSeries::StrokeStyle

Esta propiedad define el estilo del trazo de la serie.

El valor por defecto es « LineSeries.SolidLine ».

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QLineSeries::StrokeStyle strokeStyle() const
void setStrokeStyle(QLineSeries::StrokeStyle newStrokeStyle)

Señal de notificador:

void strokeStyleChanged(QLineSeries::StrokeStyle newStrokeStyle)

width : qreal

Esta propiedad indica el ancho de la línea de la serie.

Esta propiedad contiene el grosor del trazo utilizado para dibujar la línea de la serie.

Funciones de acceso:

qreal width() const
void setWidth(qreal newWidth)

Señal de notificación:

void widthChanged()

Documentación de las funciones de miembro

[invokable] QPointF QLineSeries::dataPointCoordinatesAt(qreal x, qreal y)

Devuelve las coordenadas de renderizado de x y y convertidas en coordenadas de puntos de datos.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

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