Back to Qt.io
Contact Us Blog Download Qt

XYSeries QML Type

모든 x 및 y 시리즈 유형에 대한 상위 유형입니다. 더 보기...

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

AbstractSeries

Inherited By:

LineSeries, ScatterSeries, and SplineSeries

속성

신호

방법

상세 설명

XYSeries에서 데이터 포인트는 포인트 유형의 목록으로 정의되며, X 및 Y 위치를 정의합니다.

속성 문서

color : color

계열의 주 색상입니다. LineSeries 의 경우 선 색, ScatterSeries 의 경우 점의 색을 의미합니다.


count : int [read-only]

계열의 데이터 포인트 수를 반환합니다.


pointDelegate : Component

데이터 포인트의 마커로 사용되는 사용자 지정 QML 컴포넌트입니다.

이 컴포넌트에 사용할 수 있는 동적 속성은 다음과 같습니다:

유형이름설명
boolpointSelected포인트가 선택되면 이 값은 참입니다.
색pointColor시리즈의 색상입니다. 이 값은 GraphsTheme 또는 XYSeries 가 색상을 재정의하는 경우 XYSeries::color 에서 가져옵니다.
색포인트 테두리색시리즈의 테두리 색상입니다. 이 값은 GraphsTheme 에서 가져옵니다.
색포인트선택색시리즈의 선택된 색상입니다. 이 값은 GraphsTheme 또는 XYSeries 가 색상을 재정의하는 경우 XYSeries::selectedColor 에서 가져옵니다.
realpointBorderWidth계열의 테두리 너비입니다. 이 값은 GraphsTheme 에서 가져옵니다.
realpointValueX이 위치에서 XYPoint::x 의 값입니다.
realpointValueY이 위치에서 XYPoint::y 의 값입니다.
intpointIndex포인트의 인덱스(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 입니다.


메서드 문서

append(list<point> points)

좌표 points 를 가진 점을 계열에 추가합니다.

참고: 데이터 포인트를 하나씩 추가하는 것보다 훨씬 빠릅니다. 포인트가 추가되면 pointsAdded 를 반환합니다.


append(point point)

좌표 point 를 가진 점을 계열에 추가합니다.


append(real x, real y)

좌표 x 및 y 의 점을 계열에 추가합니다.


point at(int index)

index 에 지정된 위치의 점을 반환합니다. 인덱스가 유효하지 않으면 (0, 0)을 반환합니다.


clear()

계열에서 모든 점을 제거합니다.


deselectAllPoints()

계열의 모든 점을 선택 취소합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


deselectPoint(int index)

주어진 index 에서 포인트 선택을 취소합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


deselectPoints(list<int> indexes)

indexes 목록에서 전달된 여러 포인트를 선택 취소된 것으로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


int find(point point)

point 에 정의된 대로 찾은 첫 번째 일치하는 지점의 인덱스를 찾아서 반환합니다. 점을 찾을 수 없으면 -1을 반환합니다.


insert(int index, point point)

좌표 point 를 가진 점을 계열에서 index 에 지정된 위치에 삽입합니다. 인덱스가 0이거나 0보다 작으면 점 목록에 해당 점이 앞에 추가됩니다. 인덱스가 급수의 점 수보다 크거나 같으면 점이 점 목록에 추가됩니다.


bool isPointSelected(int index)

주어진 index 의 점이 선택된 점 중 하나이면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

참고: 선택된 점이 지정된 경우 선택한 색을 사용하여 그려집니다.

selectedPoints, setPointSelected() 및 selectedColor 를참조하세요 .


remove(int index)

index 으로 지정된 위치의 점을 계열에서 제거합니다.


remove(point point)

좌표 point 의 점을 계열에서 제거합니다. 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.


remove(real x, real y)

좌표 x 및 y 의 점을 급수에서 제거합니다. 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.


removeMultiple(int index, int count)

index 으로 지정된 위치에서 시작하는 급수에서 count 으로 지정된 수의 점을 제거합니다.


replace(list<point> points)

현재 점을 다음에 지정된 점으로 바꿉니다. points

참고: 이 방법은 데이터 포인트를 하나씩 바꾸거나 먼저 모든 데이터를 지운 다음 새 데이터를 추가하는 것보다 훨씬 빠릅니다. 포인트가 교체되면 pointsReplaced 을 반환합니다.


replace(int index, point newPoint)

index 으로 지정된 위치의 점을 좌표 newPoint 을 갖는 점으로 바꿉니다.


replace(point oldPoint, point newPoint)

좌표 oldPoint 를 가진 점을 좌표 newPoint 를 가진 점으로 바꿉니다. 이전 점이 존재하지 않으면 아무것도 수행하지 않습니다.


replace(int index, real newX, real newY)

index 으로 지정된 위치의 점을 좌표 newX 과 newY 을 갖는 점으로 바꿉니다.


replace(real oldX, real oldY, real newX, real newY)

좌표 oldX 및 oldY 을 가진 점을 좌표 newX 및 newY 을 가진 점으로 바꿉니다. 이전 점이 존재하지 않으면 아무 작업도 수행하지 않습니다.


selectAllPoints()

계열의 모든 점을 선택한 것으로 표시합니다,

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


selectPoint(int index)

index 점을 선택한 대로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()참조 .


selectPoints(list<int> indexes)

indexes 목록에서 전달된 여러 포인트를 선택한 것으로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


setPointSelected(int index, bool selected)

selected 에서 지정한 대로 지정된 index 점을 선택 또는 선택 취소된 것으로 표시합니다.

참고: 선택된 점이 지정된 경우 선택한 색을 사용하여 그려집니다. Emits QXYSeries::selectedPointsChanged

isPointSelected(), selectAllPoints() 및 selectedColor도 참조하세요 .


bool take(point point)

point 에 지정된 점을 발견하면 계열에서 해당 점을 가져옵니다. 연산이 성공하면 true 을 반환합니다.


toggleSelection(list<int> indexes)

지정된 indexes 에서 점의 선택 상태를 반대 상태로 변경합니다.

참고: 방출 QXYSeries::selectedPointsChanged

setPointSelected()도 참조하세요 .


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