QAbstractSeries Class
QAbstractSeries 클래스는 모든 Qt Charts 시리즈의 기본 클래스입니다. 더 보기...
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
| Status: | Deprecated |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
속성
공개 함수
| virtual | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
신호
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries 및 QPieSeries도 참조하십시오 .
멤버 유형 문서
enum QAbstractSeries::SeriesType
이 열거형은 시리즈의 유형을 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | 선 차트. |
QAbstractSeries::SeriesTypeArea | 1 | 면형 차트. |
QAbstractSeries::SeriesTypeBar | 2 | 수직 막대 차트. |
QAbstractSeries::SeriesTypeStackedBar | 3 | 수직 누적 막대 차트. |
QAbstractSeries::SeriesTypePercentBar | 4 | 수직 백분율 막대 차트. |
QAbstractSeries::SeriesTypePie | 5 | 원형 차트. |
QAbstractSeries::SeriesTypeScatter | 6 | 산점도. |
QAbstractSeries::SeriesTypeSpline | 7 | 스플라인 차트. |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | 가로 막대 차트. |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | 가로 누적 막대 차트. |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | 가로형 백분율 막대 차트. |
QAbstractSeries::SeriesTypeBoxPlot | 11 | 박스 플롯 차트. |
QAbstractSeries::SeriesTypeCandlestick | 12 | 캔들스틱 차트. |
속성 문서
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() |
[read-only] type : SeriesType
이 속성은 시계의 유형을 나타냅니다.
액세스 함수:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
시리즈 그리기 작업에 OpenGL을 사용하여 가속을 적용할지 여부를 지정합니다.
OpenGL을 이용한 가속은 QLineSeries 및 QScatterSeries에서만 지원됩니다. QAreaSeries의 테두리 시리즈로 사용되는 선 시리즈는 OpenGL 가속을 사용할 수 없습니다. 차트에 OpenGL로 그려지는 시리즈가 하나라도 포함되어 있으면, 차트 플롯 영역 위에 투명한 QOpenGLWidget이 생성됩니다. 가속 처리된 시리즈는 기본 QGraphicsView 상에 그려지는 것이 아니라, 생성된 QOpenGLWidget 위에 그려집니다.
OpenGL을 사용하여 시리즈 그리기를 가속화함으로써 얻는 성능 향상은 기본 하드웨어에 따라 다르지만, 대부분의 경우 상당한 수준입니다. 예를 들어, 표준 데스크톱 컴퓨터에서 시리즈에 대해 OpenGL 가속을 활성화하면 일반적으로 프레임 속도 저하 없이 최소 100배 더 많은 점을 렌더링할 수 있습니다. 또한 차트 크기가 프레임 속도에 미치는 영향도 줄어듭니다.
시리즈 그리기의 OpenGL 가속 기능은 대량의 점을 빠르게 그려야 하는 사용 사례를 위해 고안되었습니다. 이 기능은 효율성을 위해 최적화되어 있으므로, 이를 사용하는 시리즈는 가속되지 않은 시리즈에서 사용할 수 있는 많은 기능을 지원하지 않습니다:
- 가속화된 시리즈에서는 시리즈 애니메이션이 지원되지 않습니다.
- 가속 처리된 시리즈에서는 점 레이블이 지원되지 않습니다.
- 가속화된 시리즈에서는 펜 스타일, 마커 모양 및 밝은 마커가 무시됩니다. 실선과 일반 산점만 지원됩니다. 산점은 기본 그래픽 하드웨어 및 드라이버에 따라 원형 또는 사각형일 수 있습니다.
- 극좌표 차트는 가속화된 시리즈를 지원하지 않습니다.
- 가속 시리즈를 사용할 때는 차트 그림자 효과를 활성화하거나 투명한 차트 배경색을 사용하는 것을 권장하지 않습니다. 이는 프레임 속도를 현저히 저하시킬 수 있기 때문입니다.
이러한 추가적인 제한 사항은 가속 시리즈가 차트 상단의 별도 위젯에 그려진다는 사실에서 기인합니다.
- 가속 시리즈가 포함된 차트 위에 그래픽 항목을 그릴 경우, 가속 시리즈가 해당 항목들 위에 그려집니다.
- QOpenGLWidget을 부분적으로 투명하게 만들려면, 이 위젯을 다른 모든 위젯 위에 겹쳐 배치해야 합니다. 즉, 가속 시리즈를 사용할 때는 다른 위젯이 차트를 부분적으로 가리는 상황이 발생해서는 안 됩니다.
- 그래픽 씬에 두 개 이상의 그래픽 뷰가 연결된 사용 사례에서는 가속 시리즈가 지원되지 않습니다.
- 차트의 기하 구조가 기본값과 다른 사용 사례에서는 가속 시리즈가 지원되지 않습니다. 예를 들어, 그래픽 뷰에 변환을 적용하면 가속 시리즈가 차트에 비해 잘못된 위치에 그려집니다.
기본값은 ` false`입니다.
액세스 함수:
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
알림 신호:
| void | useOpenGLChanged() |
visible : bool
이 속성은 시계가 표시되는지 여부를 나타냅니다.
기본적으로, ` true`입니다.
액세스 함수:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
알림 신호:
| void | visibleChanged() |
멤버 함수 설명서
[virtual noexcept] QAbstractSeries::~QAbstractSeries()
차트 시리즈에 대한 가상 소멸자.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
axis 로 지정된 축을 시계에 연결합니다.
축이 성공적으로 연결된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
참고: 동일한 방향의 여러 축이 동일한 시리즈에 연결된경우 , 이들 축은 동일한 최소값과 최대값을 갖게 됩니다.
QChart::addAxis() 및 QChart::createDefaultAxes()도 참조하십시오 .
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
시리즈에 연결된 축의 목록을 반환합니다. 일반적으로 시리즈에는 x축과 y축이 연결되어 있지만, QPieSeries의 경우 축이 연결되어 있지 않습니다.
attachAxis() 및 detachAxis()도 참조하십시오 .
QChart *QAbstractSeries::chart() const
해당 시계열이 속한 차트를 반환합니다.
시리즈가 차트에 추가되면 자동으로 설정되며, 차트에서 시리즈가 제거되면 설정 해제됩니다.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
axis 로 지정된 축을 시계열에서 분리합니다.
축이 성공적으로 분리된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false `를 반환합니다.
QChart::removeAxis()도 참조하십시오 .
void QAbstractSeries::hide()
시리즈의 표시 상태를 ‘ false ’로 설정합니다.
setVisible() 및 isVisible()도 참조하십시오 .
[signal] void QAbstractSeries::nameChanged()
이 신호는 시리즈 이름이 변경될 때 발생합니다.
참고: 속성 name 에 대한알림 신호입니다.
[signal] void QAbstractSeries::opacityChanged()
이 신호는 시리즈의 불투명도가 변경될 때 발생합니다.
참고: 속성 opacity 에 대한알림 신호입니다.
void QAbstractSeries::show()
시리즈의 표시 여부를 ‘ true ’로 설정합니다.
setVisible() 및 isVisible()도 참조하십시오 .
[signal] void QAbstractSeries::useOpenGLChanged()
이 신호는 OpenGL을 사용하여 시리즈의 렌더링 속도를 높이는 기능이 활성화되거나 비활성화될 때 발생합니다.
참고: 속성 ` useOpenGL`에 대한알림 신호입니다.
[signal] void QAbstractSeries::visibleChanged()
이 신호는 시리얼 가시성이 변경될 때 발생합니다.
참고: 속성 ` visible`에 대한알림 신호입니다.
© 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.
