XYSeries QML Type
모든 x 및 y 시리즈 유형에 대한 상위 유형입니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QXYSeries |
| Inherits: | |
| Inherited By: |
- 상속된 멤버를 포함한 모든 멤버 목록
- XYSeries는 Qt Graphs 2D용 QML 타입의 일부입니다.
속성
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
신호
- clicked(point point)
- colorChanged(color color)
- doubleClicked(point point)
- draggableChanged()
- pointMarkerChanged()
- pointReplaced(int index)
- pointsAdded(int start, int end)
(since 6.9) - pointsReplaced()
- pressed(point point)
- released(point point)
- selectedColorChanged(color color)
- selectedPointsChanged()
방법
- void append(list<point> points)
- void append(point point)
- void append(real x, real y)
- point at(int index)
- void clear()
- void deselectAllPoints()
- void deselectPoint(int index)
- void deselectPoints(list<int> indexes)
- int find(point point)
- void insert(int index, point point)
- bool isPointSelected(int index)
- void remove(int index)
- void remove(point point)
- void remove(real x, real y)
- void removeMultiple(int index, int count)
- void replace(list<point> points)
- void replace(int index, point newPoint)
- void replace(point oldPoint, point newPoint)
- void replace(int index, real newX, real newY)
- void replace(real oldX, real oldY, real newX, real newY)
- void selectAllPoints()
- void selectPoint(int index)
- void selectPoints(list<int> indexes)
- void setPointSelected(int index, bool selected)
- bool take(point point)
- void toggleSelection(list<int> indexes)
상세 설명
XYSeries에서 데이터 포인트는 포인트 유형의 목록으로 정의되며, X 및 Y 위치를 정의합니다.
속성 문서
color : color
시리즈의 기본 색상입니다. LineSeries 의 경우 선의 색을 의미하고 ScatterSeries 의 경우 포인트의 색을 의미합니다.
count : int [read-only]
시리즈의 데이터 요소 수를 반환합니다.
draggable : bool
마우스/터치로 시리즈를 끌 수 있는지 여부를 제어합니다. 기본적으로 draggable 은 false 으로 설정되어 있습니다.
pointDelegate : Component
데이터 포인트의 마커로 사용되는 사용자 지정 QML 컴포넌트입니다.
이 컴포넌트에 사용할 수 있는 동적 프로퍼티는 다음과 같습니다:
| 유형 | 이름 | 설명 |
|---|---|---|
| bool | pointSelected | 포인트가 선택되면 이 값은 참입니다. |
| 색 | pointColor | 시리즈의 색상입니다. 이 값은 GraphsTheme 또는 XYSeries 가 색상을 재정의하는 경우 XYSeries::color 에서 가져옵니다. |
| 색 | 포인트 테두리색 | 시리즈의 테두리 색상입니다. 이 값은 GraphsTheme 에서 가져옵니다. |
| 색 | 포인트선택색 | 시리즈의 선택된 색상입니다. 이 값은 GraphsTheme 또는 XYSeries 가 색상을 재정의하는 경우 XYSeries::selectedColor 에서 가져옵니다. |
| real | pointBorderWidth | 시리즈의 테두리 너비입니다. 이 값은 GraphsTheme 에서 가져옵니다. |
| real | pointValueX | 이 위치에서 XYPoint::x 의 값입니다. |
| real | pointValueY | 이 위치에서 XYPoint::y 의 값입니다. |
| int | pointIndex | 포인트의 인덱스(0부터 포인트의 양 - 1까지) [6.9 이후]. |
이 중 하나를 사용하려면 정의된 이름의 프로퍼티를 사용자 정의 컴포넌트에 추가하세요. 예: "property color pointColor" 및 "property real pointValueX".
selectedColor : color
선택한 포인트의 색상입니다.
selectedPoints : list<int> [read-only]
현재 선택된 포인트의 인덱스입니다.
신호 문서
clicked(point point)
이 신호는 사용자가 그래프에서 point 을 클릭하거나 탭할 때 발생합니다.
참고: 해당 핸들러는 onClicked 입니다.
colorChanged(color color)
이 신호는 라인 색상이 color 로 변경될 때 전송됩니다.
참고: 해당 핸들러는 onColorChanged 입니다.
doubleClicked(point point)
이 신호는 사용자가 그래프에서 point 데이터를 두 번 클릭하거나 두 번 탭할 때 발생합니다. point 은 첫 번째 누름이 트리거된 지점입니다. 이 신호는 항상 clicked 이후에 발생합니다.
참고: 해당 핸들러는 onDoubleClicked 입니다.
draggableChanged()
이 신호는 시리즈가 마우스/터치로 드래그할 수 있게 되거나 고정될 때 발생합니다.
참고: 해당 핸들러는 onDraggableChanged 입니다.
pointMarkerChanged()
이 신호는 포인트가 변경될 때 발생합니다.
참고: 해당 핸들러는 onPointMarkerChanged 입니다.
pointReplaced(int index)
이 신호는 index 에 지정된 위치에서 포인트가 교체될 때 발생합니다.
참고: 해당 핸들러는 onPointReplaced 입니다.
[since 6.9] pointsAdded(int start, int end)
이 신호는 포인트 목록이 추가될 때 발생합니다. 새로 추가된 포인트의 인덱스는 start 과 end 사이입니다.
참고: 해당 핸들러는 onPointsAdded 입니다.
이 신호는 Qt 6.9에 도입되었습니다.
pointsReplaced()
이 신호는 모든 포인트가 교체될 때 방출됩니다.
참고: 해당 핸들러는 onPointsReplaced 입니다.
pressed(point point)
이 신호는 사용자가 그래프에서 point 데이터를 누른 상태에서 마우스 버튼이나 제스처를 길게 누르면 발생합니다.
참고: 해당 핸들러는 onPressed 입니다.
released(point point)
이 신호는 사용자가 데이터 point 에서 이전에 누른 마우스 버튼이나 제스처를 놓을 때 발생합니다.
참고: 해당 핸들러는 onReleased 입니다.
selectedColorChanged(color color)
이 신호는 선택한 계열의 색상이 color 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onSelectedColorChanged 입니다.
selectedPointsChanged()
이 신호는 선택한 포인트 집합이 변경될 때 발생합니다.
참고: 해당 핸들러는 onSelectedPointsChanged 입니다.
메서드 문서
void append(list<point> points)
좌표 points 를 가진 점을 계열에 추가합니다.
참고: 데이터 포인트를 하나씩 추가하는 것보다 훨씬 빠릅니다. 포인트가 추가되면 pointsAdded 을 반환합니다.
void append(point point)
좌표 point 를 가진 점을 계열에 추가합니다.
void append(real x, real y)
좌표가 x 및 y 인 점을 계열에 추가합니다.
point at(int index)
index 에 지정된 위치의 지점을 반환합니다. 인덱스가 유효하지 않으면 (0, 0)을 반환합니다.
void clear()
시리즈에서 모든 포인트를 제거합니다.
void deselectAllPoints()
시리즈의 모든 포인트를 선택 해제합니다.
setPointSelected()도 참조하세요 .
void deselectPoint(int index)
지정된 index 지점을 선택 해제합니다.
setPointSelected()도 참조하세요 .
void deselectPoints(list<int> indexes)
indexes 목록에서 전달된 여러 지점을 선택 취소된 것으로 표시합니다.
setPointSelected()도 참조하세요 .
int find(point point)
point 에 정의된 대로 찾은 첫 번째 일치하는 지점의 인덱스를 찾아 반환합니다. 점을 찾지 못하면 -1을 반환합니다.
void insert(int index, point point)
좌표 point 를 가진 점을 계열에서 index 에 지정된 위치에 삽입합니다. 인덱스가 0이거나 0보다 작으면 포인트가 포인트 목록에 앞에 추가됩니다. 인덱스가 계열의 포인트 수보다 크거나 같으면 포인트가 포인트 목록에 추가됩니다.
bool isPointSelected(int index)
지정된 index 의 포인트가 선택된 포인트 중 하나이면 참을 반환하고 그렇지 않으면 거짓을 반환합니다.
참고: 선택된 점이 지정된 경우 선택된 색을 사용하여 그려집니다.
selectedPoints, setPointSelected() 및 selectedColor 를참조하세요 .
void remove(int index)
index 으로 지정한 위치의 점을 계열에서 제거합니다.
void remove(point point)
좌표 point 를 가진 점을 계열에서 제거합니다. 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.
void remove(real x, real y)
좌표가 x 및 y 인 점을 계열에서 제거합니다. 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.
void removeMultiple(int index, int count)
index 에 지정된 위치에서 시작하는 계열에서 count 에 지정된 포인트 수를 제거합니다.
void replace(list<point> points)
현재 포인트를 다음에 지정된 포인트로 바꿉니다. points
참고: 데이터 포인트를 하나씩 바꾸거나 먼저 모든 데이터를 지운 다음 새 데이터를 추가하는 것보다 훨씬 빠릅니다. 포인트가 교체되면 pointsReplaced 을 반환합니다.
void replace(int index, point newPoint)
index 에 지정된 위치의 점을 좌표 newPoint 를 갖는 점으로 바꿉니다.
void replace(point oldPoint, point newPoint)
좌표가 oldPoint 인 점을 좌표가 newPoint 인 점으로 바꿉니다. 이전 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.
void replace(int index, real newX, real newY)
index 에 지정된 위치의 점을 좌표 newX 및 newY 를 갖는 점으로 바꿉니다.
void replace(real oldX, real oldY, real newX, real newY)
좌표가 oldX 및 oldY 인 점을 좌표가 newX 및 newY 인 점으로 바꿉니다. 이전 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.
void selectAllPoints()
시리즈의 모든 점을 선택한 것으로 표시합니다,
setPointSelected()도 참조하세요 .
void selectPoint(int index)
index 을 선택한 것으로 표시합니다.
setPointSelected()도 참조하세요 .
void selectPoints(list<int> indexes)
indexes 목록에서 전달된 여러 지점을 선택한 것으로 표시합니다.
setPointSelected()도 참조하세요 .
void setPointSelected(int index, bool selected)
selected 에서 지정한 대로 주어진 index 점을 선택 또는 선택 해제된 상태로 표시합니다.
참고: 선택된 점이 지정된 경우 선택한 색을 사용하여 그려집니다. Emits QXYSeries::selectedPointsChanged
isPointSelected(), selectAllPoints() 및 selectedColor 를참조하세요 .
bool take(point point)
발견되면 시리즈에서 point 에 지정된 지점을 가져옵니다. 연산이 성공하면 true 을 반환합니다.
void toggleSelection(list<int> indexes)
지정된 indexes 에서 포인트의 선택 상태를 반대쪽으로 변경합니다.
setPointSelected()도 참조하세요 .
© 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.