XYSeries QML Type (Uncreatable)
모든 x 및 y 시리즈 유형의 상위 유형입니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QXYSeries |
| Inherits: | |
| Inherited By: |
참고: 이 타입은 생성할 수 없는 타입입니다. QML에서 인스턴스화할 수 없습니다.
- 상속된 멤버를 포함한 모든 멤버 목록
- XYSeries는 2D용Qt Graphs QML 타입의 일부입니다.
속성
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
- values : list<variant>
(since 6.12)
신호
- 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 | 점이 선택된 경우 이 값은 true입니다. |
| 색상 | pointColor | 시리즈의 색상입니다. 이 값은 GraphsTheme 에서 가져오거나, XYSeries 가 색상을 재정의하는 경우 XYSeries::color 에서 가져옵니다. |
| 색상 | pointBorderColor | 시리즈의 테두리 색상입니다. 이 값은 GraphsTheme 에서 가져옵니다. |
| 색상 | pointSelectedColor | 시리즈의 선택된 색상입니다. 이 값은 GraphsTheme 에서 가져오거나, XYSeries 가 색상을 재정의하는 경우 XYSeries::selectedColor 에서 가져옵니다. |
| 실수 | pointBorderWidth | 시리즈의 테두리 너비입니다. 이 값은 ` GraphsTheme`에서 가져옵니다. |
| 실수 | pointValueX | 이 위치에서 XYPoint::x 의 값입니다. |
| 실수 | pointValueY | 이 위치에서 XYPoint::y 의 값입니다. |
| int | pointIndex | 점의 인덱스로, 0부터 총 점수에서 1을 뺀 값까지입니다. [6.9부터] |
이 중 하나를 사용하려면 사용자 정의 컴포넌트에 정의된 이름의 속성을 추가하십시오. 예를 들어, ` "property color pointColor" ` 및 ` "property real pointValueX"` 등이 있습니다.
selectedColor : color
선택된 점의 색상.
selectedPoints : list<int> [read-only]
현재 선택된 점들의 인덱스입니다.
values : list<variant> [since 6.12]
이 속성은 ` XYSeries`에 대한 점을 선언적으로 설정하는 데 사용할 수 있습니다. 변수 목록은 점이나 숫자일 수 있습니다. 숫자가 지정된 경우, `valueMapping`을 사용하여 해당 숫자가 점의 X 성분으로 해석될지 Y 성분으로 해석될지를 지정할 수 있습니다.
이 속성은 Qt 6.12에서 도입되었습니다.
신호 문서
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()
시리즈 내의 모든 점을 선택 해제합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
void deselectPoint(int index)
지정된 좌표 index 의 점을 선택 해제합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
void deselectPoints(list<int> indexes)
indexes 목록에서 통과한 여러 지점을 선택 해제된 상태로 표시합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
int find(point point)
point 에 정의된 대로 일치하는 첫 번째 점의 인덱스를 찾아 반환합니다. 해당 점을 찾을 수 없는 경우 -1을 반환합니다.
void insert(int index, point point)
좌표가 ` point `인 점을 시퀀스 내의 ` index `로 지정된 위치에 삽입합니다. 인덱스가 0이거나 0보다 작으면, 해당 점은 점 목록의 맨 앞에 추가됩니다. 인덱스가 시퀀스의 점 개수보다 크거나 같으면, 해당 점은 점 목록의 맨 뒤에 추가됩니다.
bool isPointSelected(int index)
지정된 좌표( index )에 있는 점이 선택된 점 중 하나라면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
참고: 선택된 점이 지정된 경우, 해당 점들은 지정된 색상으로 그려집니다.
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)
count 로 지정된 점 수만큼을 index 로 지정된 위치부터 시작하는 시계열에서 제거합니다.
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()
시리즈의 모든 점을 선택된 상태로 표시하고,
참고: 다음을 출력합니다 QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
void selectPoint(int index)
index 을 선택된 항목으로 표시합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
void selectPoints(list<int> indexes)
indexes 목록에서 통과한 여러 지점을 선택된 상태로 표시합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
setPointSelected()도 참조하십시오 .
void setPointSelected(int index, bool selected)
지정된 index 에 있는 점을 selected 에 명시된 대로 선택 또는 선택 해제 상태로 표시합니다.
참고: 선택된 점은 지정된 경우 선택된 색상을 사용하여 그려집니다. 다음을 반환합니다. QXYSeries::selectedPointsChanged
isPointSelected(), selectAllPoints(), selectedColor도 참조하십시오 .
bool take(point point)
point 로 지정된 지점이 시퀀스에서 발견되면 해당 지점을 제거합니다. 작업이 성공하면 true 를 반환합니다.
void toggleSelection(list<int> indexes)
지정된 좌표 indexes 에 있는 점의 선택 상태를 반대 상태로 변경합니다.
참고: 다음을 발생시킵니다 . QXYSeries::selectedPointsChanged
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.