LineSeries QML Type
데이터를 선 그래프로 표시합니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QLineSeries |
| Inherits: |
- 상속된 멤버를 포함한 모든 멤버 목록
- LineSeries는 2D용 QML 유형인 ‘Qt Graphs ’의 일부입니다.
속성
- 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);다음과 같은 결과가 나타납니다:

참고: 위 예제의 첫 번째 그래프에서 볼수 있듯이 , 표시되는 pointDelegate
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(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으로 설정됩니다.
Signal 문서
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.