이 페이지에서

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

공개 유형

(since 6.12) enum class ValueMapping { X, Y }

속성

공개 함수

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)
void setStepSize(qreal stepSize)
void setValueMapping(QXYSeries::ValueMapping newHint)
void setValueMin(qreal newMin)
void setValues(QVariantList values)
qreal stepSize() const
bool take(QPointF point)
void toggleSelection(const QList<qsizetype> &indexes)
QXYSeries::ValueMapping valueMapping() const
qreal valueMin() const
QVariantList values() const

신호

void colorChanged(QColor color)
void countChanged()
void draggableChanged()
void pointDelegateChanged()
void pointReplaced(qsizetype index)
(since 6.9) void pointsAdded(qsizetype start, qsizetype end)
void pointsReplaced()
void selectedColorChanged(QColor color)
void selectedPointsChanged()
void stepSizeChanged(qreal newStepSize)
void valueMappingChanged(QXYSeries::ValueMapping newHint)
void valueMinChanged(qreal newMin)
void valuesChanged(const QVariantList &values)

상세 설명

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

QLineSeries 및 QScatterSeries도 참조하십시오 .

멤버 유형 문서

[since 6.12] enum class QXYSeries::ValueMapping

이 열거형은 ` values `에서 일반 숫자가 어떻게 해석되는지를 설명합니다.

상수상수명설명
QXYSeries::ValueMapping::X0각 숫자는 X 값이며, Y는 인덱스와 stepSize 를 통해 생성됩니다.
QXYSeries::ValueMapping::Y1각 숫자는 Y 값이며, X는 valueMin 및 stepSize 에 따라 생성됩니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

속성 문서

color : QColor

이 속성은 시계의 주 색상을 지정합니다. QLineSeries 의 경우 선 색상을, QScatterSeries 의 경우 점의 색상을 의미합니다.

액세스 함수:

QColor color() const
void setColor(QColor newColor)

알림 신호:

void colorChanged(QColor color)

[read-only] count : qsizetype

시리즈에 포함된 데이터 포인트의 개수를 반환합니다.

액세스 함수:

qsizetype count() const

알림 신호:

void countChanged()

draggable : bool

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

시리즈를 마우스나 터치로 드래그할 수 있는지 여부를 제어합니다. 기본적으로 ` draggable `는 ` false`로 설정되어 있습니다.

액세스 함수:

bool isDraggable() const
void setDraggable(bool newDraggable)

알림 신호:

void draggableChanged()

pointDelegate : QQmlComponent*

이 속성은 데이터 포인트의 마커로 사용되는 사용자 정의 QML 컴포넌트를 포함합니다.

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

유형이름설명
boolpointSelected이 값은 점이 선택되었을 때 true이며, 이는 점 인덱스가 ` QXYSeries::selectedPoints`에 포함됨을 의미합니다.
QColorpointColor시리즈의 색상입니다. 이 값은 QGraphsTheme 에서 가져오거나, QXYSeries 이 색상을 재정의하는 경우 QXYSeries::color 에서 가져옵니다.
QColorpointBorderColor시리즈의 테두리 색상입니다. 이 값은 QGraphsTheme 에서 가져옵니다.
QColorpointSelectedColor시리즈의 선택된 색상입니다. 이 값은 QGraphsTheme 에서 가져오거나, QXYSeries 가 색상을 재정의하는 경우 QXYSeries::selectedColor 에서 가져옵니다.
qrealpointBorderWidth시리즈의 테두리 너비입니다. 이 값은 ` QGraphsTheme`에서 가져옵니다.
qrealpointValueX이 위치에서 QXYPoint::x 의 값입니다.
qrealpointValueY이 위치에서 QXYPoint::y 의 값입니다.
intpointIndex점의 인덱스로, 0부터 점의 총 개수에서 1을 뺀 값까지입니다. [6.9부터]

이 중 하나를 사용하려면 사용자 정의 컴포넌트에 정의된 이름의 속성을 추가하십시오. 예를 들어 ` "property color pointColor" ` 및 ` "property real pointValueX"`과 같이 추가하면 됩니다.

액세스 함수:

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

Notifier 시그널:

void pointDelegateChanged()

selectedColor : QColor

이 속성은 선택된 점의 색상을 저장합니다.

액세스 함수:

QColor selectedColor() const
void setSelectedColor(QColor color)

알림 신호:

void selectedColorChanged(QColor color)

[read-only] selectedPoints : QList<qsizetype>

이 속성은 현재 선택된 점들의 인덱스를 저장합니다.

액세스 함수:

QList<qsizetype> selectedPoints() const

알림 신호:

void selectedPointsChanged()

[since 6.12] stepSize : qreal

이 속성은 values 를 통해 일반 숫자로 시계를 채울 때 자동으로 생성되는 X(또는 Y) 값 간의 간격을 지정합니다.

기본값은 1입니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

qreal stepSize() const
void setStepSize(qreal stepSize)

알림 신호:

void stepSizeChanged(qreal newStepSize)

values, valueMapping 및 valueMin도 참조하십시오 .

[since 6.12] valueMapping : ValueMapping

values 에 포함된 숫자가 어떻게 해석될지 제어합니다.

values 에 ` QPointF ` 값이 아닌 일반 숫자가 포함되어 있을 때, 이 속성은 각 숫자가 점의 X 성분인지 Y 성분인지를 결정합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

QXYSeries::ValueMapping valueMapping() const
void setValueMapping(QXYSeries::ValueMapping newHint)

알림 신호:

void valueMappingChanged(QXYSeries::ValueMapping newHint)

values, valueMin 및 stepSize도 참조하십시오 .

[since 6.12] valueMin : qreal

이 속성은 values 에서 일반 숫자를 사용하여 점을 생성할 때 사용되는 최소 X(또는 Y) 값을 저장합니다.

valueMapping 가 ValueMapping::Y 로 설정된 경우, 각 점의 X 값을 생성하기 위해 stepSize 와 함께 사용됩니다.

기본값은 0입니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

qreal valueMin() const
void setValueMin(qreal newMin)

알림 신호:

void valueMinChanged(qreal newMin)

values, valueMapping 및 stepSize도 참조하십시오 .

[since 6.12] values : QVariantList

이 속성은 선언적으로 설정된 시계의 데이터를 포함합니다.

변형 목록에는 ` QPointF ` 값이나 숫자가 포함될 수 있습니다. 숫자가 지정된 경우, ` valueMapping `는 각 숫자가 X 성분으로 해석될지 Y 성분으로 해석될지를 제어합니다.

이 열거형은 Qt 6.12에서 도입되었습니다.

액세스 함수:

QVariantList values() const
void setValues(QVariantList values)

알림 신호:

void valuesChanged(const QVariantList &values)

valueMapping, valueMin 및 stepSize도 참조하십시오 .

멤버 함수 문서

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

좌표 point 를 가진 점을 시퀀스에 추가합니다.

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

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

좌표 points 를 가진 데이터 포인트를 시계에 추가합니다.

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

참고: 이 함수는 메타 객체 시스템과 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 에서 점을 선택 해제합니다.

참고: 다음을 발생시킵니다 . 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 에 해당하는 점이 선택된 점 중 하나라면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

참고: 선택된 점이 지정된 경우, 해당 점은 지정된 색상으로 그려집니다.

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

selectedPoints, setPointSelected(), setSelectedColor()도 참조하십시오 .

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

이 신호는 ` index`로 지정된 위치의 점이 교체될 때 발생합니다.

replace()도 참조하십시오 .

QList<QPointF> QXYSeries::points() const

시리즈에 포함된 점을 반환합니다.

[signal, since 6.9] void QXYSeries::pointsAdded(qsizetype start, qsizetype end)

이 신호는 점의 목록이 추가될 때 발생합니다. 새로 추가된 점들의 인덱스는 start 과 end 사이입니다.

이 함수는 Qt 6.9에서 도입되었습니다.

[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)

count 로 지정된 점의 수를 index 로 지정된 위치부터 시작하는 시계열에서 제거합니다.

참고: 이 함수는 메타 객체 시스템 및 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)

지정된 ‘ index ’의 각 점을 ‘ selected ’에 명시된 대로 선택된 상태 또는 선택 해제된 상태로 표시합니다.

참고: 선택된 점은 지정된 경우 선택된 색상으로 그려집니다. 다음을 발생시킵니다. 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 에 있는 점의 선택 상태를 반대 상태로 변경합니다.

참고: 다음을 방출합니다 . QXYSeries::selectedPointsChanged

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

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.