LineSeries QML Type

Stellt Daten in Liniendiagrammen dar. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente
• „LineSeries“ ist Teil der „Qt Graphs “-QML-Typen für 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)

Ausführliche Beschreibung

Ein Liniendiagramm dient dazu, Informationen als eine Reihe von Datenpunkten darzustellen, die durch gerade Linien oder Stufen miteinander verbunden sind.

Reihen können Lücken enthalten, die mit NaN-Werten ausgefüllt werden, 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 folgendem Ergebnis führt:

„LineSeries“ verwendet größtenteils dieselbe API wie „ ScatterSeries “; weitere Anwendungsbeispiele finden Sie daher in der Dokumentation unter ScatterSeries.

Siehe auch ScatterSeries.

Dokumentation zu den Eigenschaften

capStyle : Qt::PenCapStyle

Steuert den Endstil der Linie. Setzen Sie den Wert auf einen der folgenden Werte: Qt.FlatCap, Qt.SquareCap oder Qt.RoundCap. Standardmäßig ist der Endstil „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 lautet „ 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 gerade Anzahl positiver Einträge angegeben werden, wobei die Einträge 1, 3, 5… die Striche und 2, 4, 6… die Leerzeichen darstellen. Das Muster wird in Einheiten der Zeilenbreite angegeben.

Der Standardwert ist (4, 2), was einen Strich von 4 * width Pixeln bedeutet, gefolgt von einem Leerzeichen von 2 * width Pixeln.

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

joinStyle : Qt::PenJoinStyle [since 6.11]

Steuert den Verbindungsstil der Linie. Setzen Sie den Wert auf einen der folgenden Werte: „ Qt.BevelJoin “, „ Qt.MiterJoin “ oder „ Qt.RoundJoin “. 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. Setzen Sie den Wert auf einen der folgenden Werte: „ 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]

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

width : real

Die Breite der Linie. Standardmäßig beträgt die Breite 2,0. Breiten unter 0 sind ungültig und werden automatisch auf 0 gesetzt.

Signal-Dokumentation

capStyleChanged()

Dieses Signal wird ausgegeben, wenn sich der Stil der Zeilenreihen-Kappe ändert.

[since 6.11] dashOffsetChanged(qreal newDashOffset)

Dieses Signal wird ausgegeben, wenn sich der Strich-Strich-Versatz der Linienreihe ändert. Der Parameter „ newDashOffset “ enthält den neuen Strich-Versatz.

Dieses Signal wurde in Qt 6.11 eingeführt.

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

Dieses Signal wird ausgegeben, wenn sich das Strich-Strich-Muster der Linienreihe ändert. Der Parameter „ newDashPattern “ enthält das neue Strichmuster.

Dieses Signal wurde in Qt 6.11 eingeführt.

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

Dieses Signal wird ausgelöst, wenn sich der Stil der Linienverbindung ändert. Der Parameter „ newJoinStyle “ enthält den neuen Verbindungsstil.

Dieses Signal wurde in Qt 6.11 eingeführt.

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

Dieses Signal wird ausgelöst, wenn sich der Linienstil der Linienreihe ändert. Der Parameter „ newLineStyle “ enthält den neuen Linienstil.

Dieses Signal wurde in Qt 6.11 eingeführt.

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

Dieses Signal wird ausgelöst, wenn sich der Strichstil der Linienreihe ändert. Der Parameter „ newStrokeStyle “ enthält den neuen Strichstil.

Dieses Signal wurde in Qt 6.11 eingeführt.

widthChanged()

Dieses Signal wird ausgegeben, wenn sich die Breite der Linienreihe ändert.

Methodendokumentation

point dataPointCoordinatesAt(real x, real y)

Gibt die in Datenpunktkoordinaten umgewandelten Renderkoordinaten von „ x “ und „ y “ zurück.