このページでは

LineSeries QML Type

データを折れ線グラフで表示する。もっと見る...

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

XYSeries

プロパティ

信号

方法

詳細説明

折れ線グラフは、直線またはステップで接続された一連のデータポイントとして情報を表示するために使用されます。

系列には、:

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

である:

注: 上の例の最初のグラフに見られるように、(系列の最初の点のような)単独の点は、目に見える点がない限り、線として描画されない。pointDelegate

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

ScatterSeriesも参照して ください。

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

capStyle : Qt::PenCapStyle

線のキャップスタイルを制御します。Qt.FlatCapQt.SquareCapQt.RoundCap のいずれかに設定します。デフォルトでは、キャップスタイルは Qt.SquareCap です。無効な値は自動的にデフォルト値に設定されます。

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

dashOffset : real [since 6.11]

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

デフォルト値は0 です。

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

dashPattern : list<real> [since 6.11]

このプロパティは、strokeStyleLineSeries::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.Straightです。無効な値は自動的にデフォルト値に設定されます。

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

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

pointDelegate : Component

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

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

strokeStyle : enumeration [since 6.11]

定数説明
LineSeries.SolidLine無地の線。
LineSeries.DashLine数ピクセルで区切られたダッシュ。

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

width : real

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

シグナル・ドキュメント

capStyleChanged()

このシグナルは、行直列のキャップのスタイルが変更されたときに発せられる。

注意: 対応するハンドラはonCapStyleChanged です。

[since 6.11] dashOffsetChanged(qreal newDashOffset)

このシグナルは、行直列のダッシュオフセットが変更されたときに発せられる。newDashOffset パラメータは新しいダッシュオフセットを保持する。

注: 対応するハンドラはonDashOffsetChanged です。

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

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

このシグナルは、行直列のダッシュパターンが変更されたときに発せられる。newDashPattern パラメータは新しいダッシュパターンを保持する。

注: 対応するハンドラはonDashPatternChanged です。

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

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

このシグナルは、行直列のキャップスタイルが変更されたときに発行される。newJoinStyle パラメータは新しい結合スタイルを保持する。

注意: 対応するハンドラはonJoinStyleChanged です。

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

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

このシグナルは、行系列のラインスタイルが変更されたときに発せられる。newLineStyle パラメータは新しいラインスタイルを保持する。

注: 対応するハンドラはonLineStyleChanged です。

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

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

このシグナルは、線系列のストロークスタイルが変更されたときに発せられる。newStrokeStyle パラメータは新しいストロークスタイルを保持する。

注: 対応するハンドラはonStrokeStyleChanged です。

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

widthChanged()

このシグナルは、行系列の幅が変化したときに発せられる。

注意: 対応するハンドラはonWidthChanged です。

メソッド・ドキュメント

point dataPointCoordinatesAt(real x, real y)

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

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