LineSeries QML Type
Stellt Daten in Liniendiagrammen dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QLineSeries |
| Inherits: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- LineSeries ist Teil von Qt Graphs QML Types for 2D.
Eigenschaften
- 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
Signale
- 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()
Methoden
- point dataPointCoordinatesAt(real x, real y)
Detaillierte Beschreibung
Ein Liniendiagramm wird verwendet, um Informationen als eine Reihe von Datenpunkten darzustellen, die durch gerade Linien oder Stufen verbunden sind.

Reihen können Lücken enthalten, indem NaN-Werte wie in :
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 } } }
oder
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);
was zu :

Hinweis: Wie im ersten Diagramm des obigen Beispiels zu sehen ist, werden einzelne Punkte (wie der erste Punkt der Serie) nicht als Linien dargestellt, es sei denn, es gibt eine sichtbare pointDelegate
LineSeries verwendet größtenteils die gleiche API wie ScatterSeries. Weitere Anwendungsbeispiele finden Sie in der Dokumentation von ScatterSeries.
Siehe auch ScatterSeries.
Dokumentation der Eigenschaft
capStyle : Qt::PenCapStyle
Steuert den Stil der Kappe für die Linie. Stellen Sie einen der Werte Qt.FlatCap, Qt.SquareCap oder Qt.RoundCap ein. Standardmäßig ist der Kappenstil Qt.SquareCap. Ungültige Werte werden automatisch auf den Standardwert gesetzt.
Siehe auch Qt::PenCapStyle.
dashOffset : real [since 6.11]
Diese Eigenschaft definiert den Startpunkt des Strichmusters, gemessen in den Einheiten, die zur Festlegung des Strichmusters verwendet werden.
Der Standardwert ist 0.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
dashPattern : list<real> [since 6.11]
Diese Eigenschaft definiert das Strichmuster, wenn strokeStyle auf LineSeries::DashLine gesetzt ist. Das Muster muss als eine gerade Anzahl von positiven Einträgen angegeben werden, wobei die Einträge 1, 3, 5... die Striche und 2, 4, 6... die Leerzeichen sind. Das Muster wird in Einheiten der Zeilenbreite angegeben.
Der Standardwert ist (4, 2), d.h. ein Strich von 4 * width Pixel gefolgt von einem Leerzeichen von 2 * width Pixel.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
joinStyle : Qt::PenJoinStyle [since 6.11]
Steuert den Verbindungsstil der Linie. Stellen Sie einen der Werte Qt.BevelJoin, Qt.MiterJoin oder Qt.RoundJoin ein. Standardmäßig ist der Verbindungsstil Qt.BevelJoin. Ungültige Werte werden automatisch auf den Standardwert gesetzt.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
Siehe auch Qt::PenJoinStyle.
lineStyle : QLineSeries::LineStyle [since 6.11]
Steuert den Linienstil der Linie. Stellen Sie einen der folgenden Werte ein: LineSeries.Straight, LineSeries.StepLeft, LineSeries.StepRight oder LineSeries.StepCenter. Standardmäßig ist der Linienstil LineSeries.Straight. Ungültige Werte werden automatisch auf den Standardwert gesetzt.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
Siehe auch QLineSeries::LineStyle.
pointDelegate : Component
Markiert den Punkt mit der angegebenen QML-Komponente.
pointDelegate: Image {
source: "images/happy_box.png"
}strokeStyle : enumeration [since 6.11]
| Konstante | Beschreibung |
|---|---|
LineSeries.SolidLine | Eine einfache Linie. |
LineSeries.DashLine | Striche, die durch ein paar Pixel getrennt sind. |
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
width : real
Die Breite der Linie. Standardmäßig ist die Breite 2,0. Breiten kleiner als 0 sind ungültig und werden automatisch auf 0 gesetzt.
Signal Dokumentation
capStyleChanged()
Dieses Signal wird ausgegeben, wenn sich der Stil der Zeilenkappe ändert.
Hinweis: Der entsprechende Handler ist onCapStyleChanged.
[since 6.11] dashOffsetChanged(qreal newDashOffset)
Dieses Signal wird ausgegeben, wenn sich der Versatz der Striche in den Zeilen ändert. Der Parameter newDashOffset enthält den neuen Strichversatz.
Hinweis: Der entsprechende Handler ist onDashOffsetChanged.
Dieses Signal wurde in Qt 6.11 eingeführt.
[since 6.11] dashPatternChanged(QList<qreal> newDashPattern)
Dieses Signal wird ausgegeben, wenn sich das Strichmuster der Zeilenserie ändert. Der Parameter newDashPattern enthält das neue Strichmuster.
Hinweis: Der entsprechende Handler ist onDashPatternChanged.
Dieses Signal wurde in Qt 6.11 eingeführt.
[since 6.11] joinStyleChanged(Qt::PenJoinStyle newJoinStyle)
Dieses Signal wird ausgegeben, wenn sich der Stil der Zeilenverknüpfung ändert. Der Parameter newJoinStyle enthält den neuen Verbindungsstil.
Hinweis: Der entsprechende Handler ist onJoinStyleChanged.
Dieses Signal wurde in Qt 6.11 eingeführt.
[since 6.11] lineStyleChanged(QLineSeries::LineStyle newLineStyle)
Dieses Signal wird ausgegeben, wenn sich der Linienstil der Serie ändert. Der Parameter newLineStyle enthält den neuen Linienstil.
Hinweis: Der entsprechende Handler ist onLineStyleChanged.
Dieses Signal wurde in Qt 6.11 eingeführt.
[since 6.11] strokeStyleChanged(QLineSeries::StrokeStyle newStrokeStyle)
Dieses Signal wird ausgegeben, wenn sich der Linienstil ändert. Der Parameter newStrokeStyle enthält den neuen Linienstil.
Hinweis: Der entsprechende Handler ist onStrokeStyleChanged.
Dieses Signal wurde in Qt 6.11 eingeführt.
widthChanged()
Dieses Signal wird ausgegeben, wenn sich die Breite der Zeilenreihe ändert.
Hinweis: Der entsprechende Handler ist onWidthChanged.
Dokumentation der Methode
point dataPointCoordinatesAt(real x, real y)
Gibt die in Datenpunktkoordinaten umgewandelten Renderkoordinaten x und y zurück.
© 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.