QAbstractSeries Class
QAbstractSeries 클래스는 2D 시계열을 위한 모든 Qt Graphs 의 기저 클래스입니다. 더 보기...
| 헤더: | #include <QAbstractSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | AbstractSeries |
| 상속: | QObject 그리고 QQmlParserStatus |
| 상속받는 클래스: | QAreaSeries, QBarSeries, QCustomSeries, QPieSeries 및 QXYSeries |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QAbstractSeries는 Qt Graphs 의 2D용 C++ 클래스 집합에 속합니다.
공개 유형
| enum class | SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom } |
속성
|
공개 함수
| virtual | ~QAbstractSeries() override |
| QAbstractAxis * | axisX() const |
| QAbstractAxis * | axisY() const |
| void | hide() |
| bool | isHoverable() const |
| bool | isHovered() const |
| bool | isSelectable() const |
| bool | isVisible() const |
| const QList<QLegendData> | legendData() const |
| QString | name() const |
| qreal | opacity() const |
| QQmlListProperty<QObject> | seriesChildren() |
| void | setAxisX(QAbstractAxis *newAxisX) |
| void | setAxisY(QAbstractAxis *newAxisY) |
| void | setHoverable(bool newHoverable) |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setSelectable(bool selectable) |
| void | setValuesMultiplier(qreal valuesMultiplier) |
| void | setVisible(bool visible = true) |
| void | setZValue(int newDrawOrder) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| qreal | valuesMultiplier() const |
| int | zValue() const |
신호
| void | axisXChanged(QAbstractAxis *newAxis) |
| void | axisYChanged(QAbstractAxis *newAxis) |
| void | hover(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverEnter(const QString &seriesName, QPointF position, QPointF value) |
| void | hoverExit(const QString &seriesName, QPointF position) |
| void | hoverableChanged() |
| void | hoveredChanged(bool hovered) |
| void | legendDataChanged() |
| void | nameChanged() |
| void | opacityChanged() |
| void | selectableChanged() |
| void | valuesMultiplierChanged() |
| void | visibleChanged() |
| void | zValueChanged(int z) |
QLineSeries, QSplineSeries, QScatterSeries, QBarSeries 및 QXYSeries도 참조하십시오 .
멤버 타입 문서
enum class QAbstractSeries::SeriesType
이 열거형은 시리즈의 유형을 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | 선 그래프. |
QAbstractSeries::SeriesType::Bar | 2 | 막대 그래프. |
QAbstractSeries::SeriesType::Scatter | 4 | 산점도. |
QAbstractSeries::SeriesType::Pie | 3 | 원형 그래프. |
QAbstractSeries::SeriesType::Spline | 5 | 스플라인 그래프. |
QAbstractSeries::SeriesType::Area | 1 | 면 그래프. |
QAbstractSeries::SeriesType::Custom | 6 | 사용자 정의 그래프. |
속성 설명서
[since 6.10] axisX : QAbstractAxis*
이 시리즈의 X축.
이 시리즈에 사용되는 x축입니다. GraphsView 에 정의된 축과는 별도로 축을 생성하여, 사용자에게 그래프당 여러 개의 축을 표시합니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Notifier 신호:
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
이 데이터 시리즈의 Y축.
이 계열에 사용되는 y축입니다. GraphsView 에 정의된 축과는 별도로 축을 생성하여, 사용자에게 그래프당 여러 개의 축을 표시합니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Notifier 신호:
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
시리즈에 마우스/터치를 올릴 수 있는지 여부를 제어합니다.
시리즈에 마우스/터치로 커서를 올릴 수 있는지 여부를 제어합니다. 기본적으로 ` hoverable `는 ` false`로 설정되어 있습니다.
액세스 함수:
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
알림 신호:
| void | hoverableChanged() |
[read-only] hovered : bool
시리즈 위에 마우스/터치가 떠 있는지 확인합니다.
마우스 또는 터치 입력이 현재 시리즈 위에 위치해 있는지 확인하는 데 사용할 수 있습니다.
액세스 함수:
| bool | isHovered() const |
Notifier 신호:
| void | hoveredChanged(bool hovered) |
QAbstractSeries ::hovered도 참조하십시오 .
[read-only] legendData : QList<QLegendData>
그래프 내 데이터 세트에 대한 범례 마커를 생성하는 데 필요한 정보를 포함합니다.
액세스 함수:
| const QList<QLegendData> | legendData() const |
알림 신호:
| void | legendDataChanged() |
QLegendData도 참조하십시오 .
name : QString
이 속성에는 시리즈의 이름이 저장됩니다.
이 이름은 해당 시리즈의 범례에 표시되며, HTML 서식을 지원합니다.
액세스 함수:
| QString | name() const |
| void | setName(const QString &name) |
알림 신호:
| void | nameChanged() |
opacity : qreal
이 속성은 시리즈의 불투명도를 지정합니다.
기본적으로 불투명도는 1.0입니다. 유효한 값의 범위는 0.0(투명)부터 1.0(불투명)까지입니다.
액세스 함수:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
알림 신호:
| void | opacityChanged() |
selectable : bool
시리즈를 선택할 수 있는지 여부를 제어합니다.
마우스나 터치로 시계를 선택할 수 있는지 여부를 제어합니다. 기본적으로 ' selectable '는 ' false'로 설정되어 있습니다.
액세스 함수:
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
알림 신호:
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
시리즈의 자식 객체 목록입니다. 이 속성은 QML의 시리즈 요소 내에서 ‘children’ 속성 이름을 명시적으로 사용하지 않고도 자식 객체를 지정할 수 있게 해주는 기본 속성입니다.
액세스 함수:
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
이 속성은 시계의 유형을 나타냅니다.
액세스 함수:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
valuesMultiplier : qreal
시리즈 값의 실제 표시 크기를 제어합니다.
이 변수를 사용하면 시리즈 값이 0에서 실제 값 크기까지 확장되도록 애니메이션을 적용할 수 있습니다. 기본적으로 valuesMultiplier 값은 1.0입니다. 유효한 값의 범위는 0.0(높이 0)부터 1.0(전체 값)까지입니다.
액세스 함수:
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
알림 신호:
| void | valuesMultiplierChanged() |
visible : bool
시리즈의 표시 설정.
이 시리즈에 적용되는 가시성입니다. 기본적으로 ' visible '는 ' true'으로 설정되어 있습니다.
액세스 함수:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
알림 신호:
| void | visibleChanged() |
[since 6.10] zValue : int
시리즈가 그려지는 순서를 제어합니다
GraphsView 의 시리즈 목록은 zValue 속성에 따라 정렬됩니다. 각 시리즈 유형은 한 번에 렌더링되므로, 이 순서는 주로 각 시리즈 유형 내부의 순서로 작동합니다. 각 시리즈 유형에서 zValue 값이 가장 높은 것이 시리즈 유형 간의 렌더링 순서를 결정합니다. 기본값은 0입니다.
이 열거형은 Qt 6.10에서 도입되었습니다.
액세스 함수:
| int | zValue() const |
| void | setZValue(int newDrawOrder) |
알림 신호:
| void | zValueChanged(int z) |
멤버 함수 문서
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
그래프 시퀀스를 위한 가상 소멸자.
void QAbstractSeries::hide()
시리즈의 표시 여부를 ‘ false ’로 설정합니다.
setVisible() 및 isVisible()도 참조하십시오 .
[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)
이 신호는 시리즈의 호버 상태가 변경될 때 발생합니다. 시리즈 이름은 seriesName 에, 마우스/터치 위치는 position 에, 시리즈 값은 value 에 포함됩니다.
참고: 이 신호는 hoverable 이 true로 설정된 경우에만 발생합니다.
참고: 파이 차트의경우 , 이 값은 (위치의 각도, 호버링 슬라이스의 시작 각도)를 나타냅니다.
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
이 신호는 시리즈 호버링이 시작될 때 발생합니다. 시리즈 이름은 ` seriesName`에, 마우스/터치 위치는 ` position`에, 시리즈 값은 ` value`에 담겨 있습니다.
참고: 이 신호는 hoverable 가 true로 설정된 경우에만 발생합니다.
참고: 파이 차트의경우 , 이 값은 (위치 각도, 호버링 슬라이스의 시작 각도)를 나타냅니다.
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
이 신호는 시리즈 호버링이 종료될 때 발생합니다. 시리즈 이름은 ` seriesName`에, 마우스/터치 위치는 ` position`에 포함됩니다.
참고: 이 신호는 hoverable 가 true로 설정된 경우에만 발생합니다.
void QAbstractSeries::show()
시리즈의 표시 상태를 ‘ true ’로 설정합니다.
setVisible() 및 isVisible()도 참조하십시오 .
© 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.
