Sur cette page

LineSeries QML Type

Présente les données sous forme de graphiques linéaires. Plus d'informations...

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

XYSeries

Propriétés

Signaux

Méthodes

Description détaillée

Un graphique linéaire est utilisé pour présenter des informations sous la forme d'une série de points de données reliés par des lignes droites ou des marches.

Les séries peuvent contenir des lacunes en utilisant des valeurs NaN comme dans :

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
        }
    }
}

ou

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

ce qui donne :

Remarque : comme le montre le premier graphique de l'exemple ci-dessus, les points isolés (comme le premier point de la série) ne seront pas représentés sous forme de lignes, à moins qu'il n'y ait un espace visible entre les points de la série et les points de la série. pointDelegate

LineSeries utilise en grande partie la même API que ScatterSeries. Consultez donc la documentation de ScatterSeries pour d'autres exemples d'utilisation.

Voir également ScatterSeries.

Documentation sur les propriétés

capStyle : Qt::PenCapStyle

Contrôle le style de capuchon de la ligne. La valeur par défaut est Qt.FlatCap, Qt.SquareCap ou Qt.RoundCap. Par défaut, le style de capuchon est Qt.SquareCap. Les valeurs non valides sont automatiquement remplacées par la valeur par défaut.

Voir également Qt::PenCapStyle.

dashOffset : real [since 6.11]

Cette propriété définit le point de départ du motif du tiret, mesuré dans les unités utilisées pour spécifier le motif du tiret.

La valeur par défaut est 0.

Cette propriété a été introduite dans Qt 6.11.

dashPattern : list<real> [since 6.11]

Cette propriété définit le motif des tirets lorsque strokeStyle est défini sur LineSeries::DashLine. Le motif doit être spécifié sous la forme d'un nombre pair d'entrées positives où les entrées 1, 3, 5... sont les tirets et 2, 4, 6... sont les espaces. Le motif est spécifié en unités de largeur de ligne.

La valeur par défaut est (4, 2), ce qui signifie un tiret de 4 * width pixels suivi d'un espace de 2 * width pixels.

Cette propriété a été introduite dans Qt 6.11.

joinStyle : Qt::PenJoinStyle [since 6.11]

Contrôle le style de jointure de la ligne. La valeur par défaut est Qt.BevelJoin, Qt.MiterJoin ou Qt.RoundJoin. Par défaut, le style de jointure est Qt.BevelJoin. Les valeurs non valides sont automatiquement remplacées par la valeur par défaut.

Cette propriété a été introduite dans Qt 6.11.

Voir également Qt::PenJoinStyle.

lineStyle : QLineSeries::LineStyle [since 6.11]

Contrôle le style de la ligne. La valeur par défaut est LineSeries.Straight, LineSeries.StepLeft, LineSeries.StepRight ou LineSeries.StepCenter. Par défaut, le style de ligne est LineSeries.Straight. Les valeurs non valides sont automatiquement remplacées par la valeur par défaut.

Cette propriété a été introduite dans Qt 6.11.

Voir également QLineSeries::LineStyle.

pointDelegate : Component

Marque le point avec le composant QML donné.

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

strokeStyle : enumeration [since 6.11]

ConstantDescription
LineSeries.SolidLineUne ligne simple.
LineSeries.DashLineTirets séparés par quelques pixels.

Cette propriété a été introduite dans Qt 6.11.

width : real

La largeur de la ligne. Par défaut, la largeur est de 2,0. Les largeurs inférieures à 0 ne sont pas valables et sont automatiquement fixées à 0.

Documentation sur les signaux

capStyleChanged()

Ce signal est émis lorsque le style du chapeau de la série de lignes change.

Remarque : le gestionnaire correspondant est onCapStyleChanged.

[since 6.11] dashOffsetChanged(qreal newDashOffset)

Ce signal est émis lorsque le décalage du tiret de la série de lignes est modifié. Le paramètre newDashOffset contient le nouveau décalage du tiret.

Remarque : le gestionnaire correspondant est onDashOffsetChanged.

Ce signal a été introduit dans Qt 6.11.

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

Ce signal est émis lorsque le modèle de tirets de la série de lignes change. Le paramètre newDashPattern contient le nouveau motif de tirets.

Remarque : le gestionnaire correspondant est onDashPatternChanged.

Ce signal a été introduit dans Qt 6.11.

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

Ce signal est émis lorsque le style de chapeau de la série de lignes change. Le paramètre newJoinStyle contient le nouveau style de jointure.

Note : Le gestionnaire correspondant est onJoinStyleChanged.

Ce signal a été introduit dans Qt 6.11.

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

Ce signal est émis lorsque le style de ligne de la série de lignes change. Le paramètre newLineStyle contient le nouveau style de ligne.

Remarque : le gestionnaire correspondant est onLineStyleChanged.

Ce signal a été introduit dans Qt 6.11.

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

Ce signal est émis lorsque le style de trait de la série de lignes change. Le paramètre newStrokeStyle contient le nouveau style de trait.

Remarque : le gestionnaire correspondant est onStrokeStyleChanged.

Ce signal a été introduit dans Qt 6.11.

widthChanged()

Ce signal est émis lorsque la largeur de la série de lignes change.

Remarque : le gestionnaire correspondant est onWidthChanged.

Documentation de la méthode

point dataPointCoordinatesAt(real x, real y)

Renvoie les coordonnées de rendu de x et y converties en coordonnées de points de données.

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