LineSeries QML Type

データを折れ線グラフで表示します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• LineSeriesは、Qt Graphs の2D用QMLタイプの一部です。

プロパティ

• 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

信号

• 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()

方法

• point dataPointCoordinatesAt(real x, real y)

詳細な説明

折れ線グラフは、直線や階段状の線で結ばれた一連のデータポイントとして情報を表示するために使用されます。

次のように、NaN 値を使用して系列に空白を含めることができます：

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

その結果、次のようになります：

LineSeriesはScatterSeries とほぼ同じAPIを使用しているため、その他の使用例についてはScatterSeries のドキュメントを参照してください。

ScatterSeriesも参照してください 。

プロパティのドキュメント

capStyle : Qt::PenCapStyle

線の端のスタイルを制御します。Qt.FlatCap 、Qt.SquareCap 、またはQt.RoundCap のいずれかに設定します。デフォルトでは、端のスタイルはQt.SquareCapです。無効な値が指定された場合は、自動的にデフォルト値に設定されます。

Qt::PenCapStyleも参照してください 。

dashOffset : real [since 6.11]

このプロパティは、ダッシュパターンの開始点を定義するもので、その値はダッシュパターンを指定するために使用される単位で測定されます。

デフォルト値は0 です。

このプロパティはQt 6.11で導入されました。

dashPattern : list<real> [since 6.11]

このプロパティは、strokeStyle がLineSeries::DashLine に設定された場合のダッシュパターンを定義します。パターンは、偶数の正の要素数で指定する必要があります。ここで、要素の1、3、5…がダッシュ、2、4、6…がスペースとなります。パターンは、行の幅を単位として指定されます。

デフォルト値は (4, 2) であり、これは 4 *width ピクセルのダッシュの後に、2 *width ピクセルのスペースが続くことを意味します。

このプロパティは Qt 6.11 で導入されました。

joinStyle : Qt::PenJoinStyle [since 6.11]

線の接合スタイルを制御します。Qt.BevelJoin 、Qt.MiterJoin 、Qt.RoundJoin のいずれかに設定します。デフォルトの接合スタイルは Qt.BevelJoin です。無効な値は自動的にデフォルト値に設定されます。

このプロパティは Qt 6.11 で導入されました。

Qt::PenJoinStyleも参照してください 。

lineStyle : QLineSeries::LineStyle [since 6.11]

線の線種を制御します。LineSeries.Straight 、LineSeries.StepLeft 、LineSeries.StepRight 、またはLineSeries.StepCenter のいずれかに設定します。デフォルトの線種はLineSeries （直線）です。無効な値は自動的にデフォルト値に設定されます。

このプロパティは Qt 6.11 で導入されました。

QLineSeries::LineStyleも参照してください 。

pointDelegate : Component

指定されたQMLコンポーネントでその位置をマークします。

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

strokeStyle : enumeration [since 6.11]

このプロパティは Qt 6.11 で導入されました。

width : real

線の幅。デフォルトでは、幅は 2.0 です。0 より小さい値は無効であり、自動的に 0 に設定されます。

Signal ドキュメント

capStyleChanged()

このシグナルは、ライン系列のキャップスタイルが変更されたときに発信されます。

[since 6.11] dashOffsetChanged(qreal newDashOffset)

この信号は、線系列の線と破線のオフセットが変更されたときに発信されます。newDashOffset パラメータには、新しい破線のオフセットが格納されます。

このシグナルは Qt 6.11 で導入されました。

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

この信号は、線シリーズの線と破線のパターンが変更されたときに発信されます。newDashPattern パラメータには、新しい破線パターンが格納されます。

このシグナルはQt 6.11で導入されました。

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

このシグナルは、ライン系列のキャップスタイルが変更されたときに発行されます。newJoinStyle パラメータには、新しい結合スタイルが格納されます。

このシグナルは Qt 6.11 で導入されました。

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

このシグナルは、線の系列の線種が変更されたときに発火します。newLineStyle パラメータには、新しい線種が格納されます。

このシグナルは Qt 6.11 で導入されました。

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

このシグナルは、線の系列のストロークスタイルが変更されたときに発火します。newStrokeStyle パラメータには、新しいストロークスタイルが格納されます。

このシグナルは Qt 6.11 で導入されました。

widthChanged()

このシグナルは、ラインの系列幅が変化したときに発信されます。

メソッドのドキュメント

point dataPointCoordinatesAt(real x, real y)

x およびy のレンダリング座標を、データポイント座標に変換して返します。