LineSeries QML Type

Présente les données sous forme de graphiques linéaires. En savoir plus…

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

Liste de tous les membres, y compris les membres hérités
LineSeries fait partie des types QML 2D d'Qt Graphs .

Propriétés

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

Signaux

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éthodes

point dataPointCoordinatesAt(real x, real y)

Description détaillée

Un graphique linéaire sert à représenter des informations sous la forme d'une série de points de données reliés par des lignes droites ou des paliers.

Graphique linéaire en angle sur une grille

Les séries peuvent comporter des lacunes utilisant des valeurs NaN, comme dans l'exemple suivant :

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

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 :

Deux grilles : à gauche, une ligne angulaire verte ; à droite, une ligne en escalier rouge

Remarque : comme le montre le premier graphique de l'exemple ci-dessus, les points isolés (tels que le premier point de la série) ne seront pas représentés sous forme de lignes, à moins qu'il n'y ait un 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

Définit le style d'extrémité de la ligne. Doit être défini sur l'une des valeurs suivantes : Qt.FlatCap, Qt.SquareCap ou Qt.RoundCap. Par défaut, le style d'extrémité 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 de tirets, mesuré dans les unités utilisées pour spécifier ce motif.

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 de 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… correspondent aux tirets et les entrées 2, 4, 6… aux espaces. Le motif est spécifié en unités correspondant à la largeur de la ligne.

La valeur par défaut est (4, 2), ce qui correspond à 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 jonction de la ligne. Doit être défini sur l’une des valeurs suivantes : Qt.BevelJoin, Qt.MiterJoin ou Qt.RoundJoin. Par défaut, le style de jonction 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. À définir sur l’une des valeurs suivantes : LineSeries.Straight, LineSeries.StepLeft, LineSeries.StepRight ou LineSeries.StepCenter. Par défaut, le style de la 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 à l'aide du composant QML indiqué.

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

strokeStyle : enumeration `[since 6.11]`

Constante	Description
`LineSeries.SolidLine`	Une ligne simple.
`LineSeries.DashLine`	Des tirets séparés de 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 valides et sont automatiquement définies sur 0.

Documentation sur Signal

capStyleChanged()

Ce signal est émis lorsque le style de capuchon 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 des traits et des lignes de la série de lignes change. Le paramètre newDashOffset contient le nouveau décalage des traits.

Remarque : le gestionnaire correspondant est onDashOffsetChanged.