QXYSeries Class

QXYSeries 클래스는 모든 x 및 y 시리즈 클래스의 상위 클래스입니다. 더 보기...

헤더:	`#include <QXYSeries>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake:	`QT += graphs`
QML에서:	XYSeries
상속합니다:	QAbstractSeries
상속합니다:	QLineSeries, QScatterSeries, 그리고 QSplineSeries

상속된 멤버를 포함한 모든 멤버 목록
QXYSeries는 Qt Graphs 2D용 C++ 클래스의 일부입니다.

속성

color : QColor
count : const qsizetype
draggable : bool

pointDelegate : QQmlComponent*
selectedColor : QColor
selectedPoints : const QList<qsizetype>

공공 기능

void	append(QPointF point)
void	append(const QList<QPointF> &points)
void	append(qreal x, qreal y)
QPointF	at(qsizetype index) const
void	clear()
QColor	color() const
qsizetype	count() const
void	deselectAllPoints()
void	deselectPoint(qsizetype index)
void	deselectPoints(const QList<qsizetype> &indexes)
qsizetype	find(QPointF point) const
void	insert(qsizetype index, QPointF point)
bool	isDraggable() const
bool	isPointSelected(qsizetype index) const
QQmlComponent *	pointDelegate() const
QList<QPointF>	points() const
void	remove(QPointF point)
void	remove(qsizetype index)
void	remove(qreal x, qreal y)
void	removeMultiple(qsizetype index, qsizetype count)
void	replace(const QList<QPointF> &points)
void	replace(QPointF oldPoint, QPointF newPoint)
void	replace(qsizetype index, QPointF newPoint)
void	replace(qsizetype index, qreal newX, qreal newY)
void	replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
void	selectAllPoints()
void	selectPoint(qsizetype index)
void	selectPoints(const QList<qsizetype> &indexes)
QColor	selectedColor() const
QList<qsizetype>	selectedPoints() const
void	setColor(QColor newColor)
void	setDraggable(bool newDraggable)
void	setPointDelegate(QQmlComponent *newPointDelegate)
void	setPointSelected(qsizetype index, bool selected)
void	setSelectedColor(QColor color)
bool	take(QPointF point)
void	toggleSelection(const QList<qsizetype> &indexes)

신호

void	colorChanged(QColor color)
void	countChanged()
void	draggableChanged()
void	pointDelegateChanged()
void	pointReplaced(qsizetype index)
void	pointsReplaced()
void	selectedColorChanged(QColor color)
void	selectedPointsChanged()

상세 설명

QXYSeries에서 데이터 포인트는 X 및 Y 위치를 정의하는 QPointF 의 목록으로 정의됩니다.

QLineSeries 및 QScatterSeries도 참조하세요 .

속성 문서

color : QColor

이 속성은 시리즈의 기본 색상을 보유합니다. QLineSeries 의 경우 선의 색을, QScatterSeries 의 경우 점의 색을 의미합니다.

함수에 액세스합니다:

QColor	color() const
void	setColor(QColor newColor)

알림 신호:

void	colorChanged(QColor color)

`[read-only]` count : const qsizetype

시리즈의 데이터 요소 수를 반환합니다.

함수에 액세스합니다:

qsizetype count() const

알림 신호:

void	countChanged()

draggable : bool

시리즈를 드래그할 수 있는지 여부를 제어합니다.

마우스/터치로 시리즈를 끌 수 있는지 여부를 제어합니다. 기본적으로 draggable 은 false 으로 설정되어 있습니다.

기능에 접근합니다:

bool	isDraggable() const
void	setDraggable(bool newDraggable)

알림 신호:

void	draggableChanged()

pointDelegate : QQmlComponent*

이 속성에는 데이터 포인트의 마커로 사용되는 사용자 지정 QML 컴포넌트가 있습니다.

이 컴포넌트에 사용할 수 있는 동적 프로퍼티는 다음과 같습니다:

유형	이름	설명
bool	pointSelected	포인트가 선택된 경우 이 값은 참이며, 이는 포인트 인덱스가 QXYSeries::selectedPoints 에 있음을 의미합니다.
QColor	pointColor	시리즈의 색상입니다. 이 값은 QGraphsTheme 또는 QXYSeries 가 색상을 재정의하는 경우 QXYSeries::color 에서 가져옵니다.
QColor	pointBorderColor	시리즈의 테두리 색상입니다. 이 값은 QGraphsTheme 에서 가져옵니다.
QColor	포인트선택색	시리즈의 선택된 색상입니다. 이 값은 QGraphsTheme 또는 QXYSeries 가 색을 재정의하는 경우 QXYSeries::selectedColor 에서 가져옵니다.
qreal	pointBorderWidth	계열의 테두리 너비입니다. 이 값은 QGraphsTheme 에서 가져옵니다.
qreal	pointValueX	이 위치에서 QXYPoint::x 의 값입니다.
qreal	pointValueY	이 위치의 QXYPoint::y 값입니다.

이 중 하나를 사용하려면 정의된 이름의 프로퍼티를 사용자 정의 컴포넌트에 추가하세요. 예: "property color pointColor" 및 "property real pointValueX".

함수에 액세스합니다:

QQmlComponent *	pointDelegate() const
void	setPointDelegate(QQmlComponent *newPointDelegate)

알림 신호:

void	pointDelegateChanged()

selectedColor : QColor

이 속성은 선택한 포인트의 색상을 저장합니다.

함수에 액세스합니다:

QColor	selectedColor() const
void	setSelectedColor(QColor color)

알림 신호:

void	selectedColorChanged(QColor color)

`[read-only]` selectedPoints : const QList<qsizetype>

이 속성에는 현재 선택된 포인트의 인덱스가 저장됩니다.

함수에 액세스합니다:

QList<qsizetype> selectedPoints() const

알림 신호:

void	selectedPointsChanged()

멤버 함수 문서

`[invokable]` void QXYSeries::append(QPointF point)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::append(const QList<QPointF> &points)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::append(qreal x, qreal y)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` QPointF QXYSeries::at(qsizetype index) const

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::clear()

시리즈에서 모든 점을 제거합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::deselectAllPoints()

시리즈의 모든 포인트를 선택 해제합니다.

참고: 방출 QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

setPointSelected()도 참조하세요 .

`[invokable]` void QXYSeries::deselectPoint(qsizetype index)

지정된 index 지점을 선택 해제합니다.

참고: Emits QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

setPointSelected()도 참조하세요 .

`[invokable]` void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

indexes 목록에서 전달된 여러 지점을 선택 취소된 것으로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

setPointSelected()도 참조하세요 .

`[invokable]` qsizetype QXYSeries::find(QPointF point) const

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::insert(qsizetype index, QPointF point)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` bool QXYSeries::isPointSelected(qsizetype index) const

지정된 index 의 점이 선택된 점 중 하나에 있으면 참을 반환하고 그렇지 않으면 거짓을 반환합니다.

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

selectedPoints, setPointSelected() 및 setSelectedColor()도 참조하세요 .

`[signal]` void QXYSeries::pointReplaced(qsizetype index)

이 신호는 index 에 지정된 위치에서 포인트가 교체될 때 발생합니다.

replace()도 참조하세요 .

QList<QPointF> QXYSeries::points() const

시리즈의 포인트를 반환합니다.

`[signal]` void QXYSeries::pointsReplaced()

이 신호는 모든 포인트가 교체될 때 방출됩니다.

`[invokable]` void QXYSeries::remove(QPointF point)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::remove(qsizetype index)

시리즈에서 index 에 지정된 위치의 점을 제거합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::remove(qreal x, qreal y)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

index 에 지정된 위치에서 시작하는 계열에서 count 에 지정된 포인트 수를 제거합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::replace(const QList<QPointF> &points)

현재 포인트를 다음에 지정된 포인트로 바꿉니다. points

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::replace(qsizetype index, QPointF newPoint)

index 에 지정된 위치의 점을 좌표 newPoint 를 가진 점으로 바꿉니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::selectAllPoints()

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

참고: 방출 QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

setPointSelected()도 참조하십시오 .

`[invokable]` void QXYSeries::selectPoint(qsizetype index)

index 을 선택한 것으로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

setPointSelected()도 참조하세요 .

`[invokable]` void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

indexes 목록에서 전달된 여러 지점을 선택한 것으로 표시합니다.

참고: 방출 QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

setPointSelected()도 참조하세요 .

QList<qsizetype> QXYSeries::selectedPoints() const

선택됨으로 표시된 포인트 인덱스 목록을 반환합니다. 선택된 포인트는 포인트 표시 여부에 관계없이 표시됩니다.

참고: selectedPoints 속성에 대한 겟터 함수입니다.

setPointSelected()도 참조하세요 .

`[invokable]` void QXYSeries::setPointSelected(qsizetype index, bool selected)

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

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

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

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

`[invokable]` bool QXYSeries::take(QPointF point)

발견되면 시리즈에서 point 에 지정된 지점을 가져옵니다. 연산이 성공하면 true 을 반환합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

`[invokable]` void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

지정된 indexes 에서 포인트의 선택 상태를 반대쪽으로 변경합니다.

참고: Emits QXYSeries::selectedPointsChanged

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

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.

QXYSeries Class

속성

공공 기능

신호

상세 설명

속성 문서

color : QColor

[read-only] count : const qsizetype

draggable : bool

pointDelegate : QQmlComponent*

selectedColor : QColor

[read-only] selectedPoints : const QList<qsizetype>

멤버 함수 문서

[invokable] void QXYSeries::append(QPointF point)

[invokable] void QXYSeries::append(const QList<QPointF> &points)

[invokable] void QXYSeries::append(qreal x, qreal y)

[invokable] QPointF QXYSeries::at(qsizetype index) const

[invokable] void QXYSeries::clear()

[invokable] void QXYSeries::deselectAllPoints()

[invokable] void QXYSeries::deselectPoint(qsizetype index)

[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

[invokable] qsizetype QXYSeries::find(QPointF point) const

[invokable] void QXYSeries::insert(qsizetype index, QPointF point)

[invokable] bool QXYSeries::isPointSelected(qsizetype index) const

[signal] void QXYSeries::pointReplaced(qsizetype index)

QList<QPointF> QXYSeries::points() const

[signal] void QXYSeries::pointsReplaced()

[invokable] void QXYSeries::remove(QPointF point)

[invokable] void QXYSeries::remove(qsizetype index)

[invokable] void QXYSeries::remove(qreal x, qreal y)

[invokable] void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

[invokable] void QXYSeries::replace(const QList<QPointF> &points)

[invokable] void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)

[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

[invokable] void QXYSeries::selectAllPoints()

[invokable] void QXYSeries::selectPoint(qsizetype index)

[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

QList<qsizetype> QXYSeries::selectedPoints() const

[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)

[invokable] bool QXYSeries::take(QPointF point)

[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

`[read-only]` count : const qsizetype

`[read-only]` selectedPoints : const QList<qsizetype>

`[invokable]` void QXYSeries::append(QPointF point)

`[invokable]` void QXYSeries::append(const QList<QPointF> &points)

`[invokable]` void QXYSeries::append(qreal x, qreal y)

`[invokable]` QPointF QXYSeries::at(qsizetype index) const

`[invokable]` void QXYSeries::clear()

`[invokable]` void QXYSeries::deselectAllPoints()

`[invokable]` void QXYSeries::deselectPoint(qsizetype index)

`[invokable]` void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

`[invokable]` qsizetype QXYSeries::find(QPointF point) const

`[invokable]` void QXYSeries::insert(qsizetype index, QPointF point)

`[invokable]` bool QXYSeries::isPointSelected(qsizetype index) const

`[signal]` void QXYSeries::pointReplaced(qsizetype index)

`[signal]` void QXYSeries::pointsReplaced()

`[invokable]` void QXYSeries::remove(QPointF point)

`[invokable]` void QXYSeries::remove(qsizetype index)

`[invokable]` void QXYSeries::remove(qreal x, qreal y)

`[invokable]` void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

`[invokable]` void QXYSeries::replace(const QList<QPointF> &points)

`[invokable]` void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

`[invokable]` void QXYSeries::replace(qsizetype index, QPointF newPoint)

`[invokable]` void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

`[invokable]` void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

`[invokable]` void QXYSeries::selectAllPoints()

`[invokable]` void QXYSeries::selectPoint(qsizetype index)

`[invokable]` void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

`[invokable]` void QXYSeries::setPointSelected(qsizetype index, bool selected)

`[invokable]` bool QXYSeries::take(QPointF point)

`[invokable]` void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)