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 |
| 상속받는 클래스: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QXYSeries는 Qt Graphs 의 2D용 C++ 클래스 중 하나입니다.
공개 유형
(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::X | 0 | 각 숫자는 X 값이며, Y는 인덱스와 stepSize 를 통해 생성됩니다. |
QXYSeries::ValueMapping::Y | 1 | 각 숫자는 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 컴포넌트를 포함합니다.
이 컴포넌트에서 사용할 수 있는 동적 속성은 다음과 같습니다:
| 유형 | 이름 | 설명 |
|---|---|---|
| bool | pointSelected | 이 값은 점이 선택되었을 때 true이며, 이는 점 인덱스가 ` QXYSeries::selectedPoints`에 포함됨을 의미합니다. |
| QColor | pointColor | 시리즈의 색상입니다. 이 값은 QGraphsTheme 에서 가져오거나, QXYSeries 이 색상을 재정의하는 경우 QXYSeries::color 에서 가져옵니다. |
| QColor | pointBorderColor | 시리즈의 테두리 색상입니다. 이 값은 QGraphsTheme 에서 가져옵니다. |
| QColor | pointSelectedColor | 시리즈의 선택된 색상입니다. 이 값은 QGraphsTheme 에서 가져오거나, QXYSeries 가 색상을 재정의하는 경우 QXYSeries::selectedColor 에서 가져옵니다. |
| qreal | pointBorderWidth | 시리즈의 테두리 너비입니다. 이 값은 ` QGraphsTheme`에서 가져옵니다. |
| qreal | pointValueX | 이 위치에서 QXYPoint::x 의 값입니다. |
| qreal | pointValueY | 이 위치에서 QXYPoint::y 의 값입니다. |
| int | pointIndex | 점의 인덱스로, 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.