QAbstractSeries Class
QAbstractSeries 클래스는 모든 Qt 차트 시리즈의 베이스 클래스입니다. 더 보기...
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
공용 유형
| 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
이 열거형은 시리즈의 유형을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
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 : const SeriesType
이 속성은 시리즈의 유형을 보유합니다.
액세스 함수:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
OpenGL을 사용하여 계열 그리기를 가속할지 여부를 지정합니다.
OpenGL을 사용한 가속은 QLineSeries 및 QScatterSeries 에 대해서만 지원됩니다. QAreaSeries 의 가장자리 계열로 사용되는 선 계열은 OpenGL 가속을 사용할 수 없습니다. 차트에 OpenGL로 그려진 계열이 포함되어 있으면 차트 플롯 영역 위에 투명한 QOpenGL위젯이 만들어집니다. 가속화된 계열은 기본 QGraphicsView 에 그려지지 않고 대신 생성된 QOpenGLWidget에 그려집니다.
OpenGL을 사용하여 계열 그리기를 가속화할 때 얻을 수 있는 성능은 기본 하드웨어에 따라 다르지만 대부분의 경우 상당한 수준입니다. 예를 들어, 표준 데스크톱 컴퓨터에서 계열에 대해 OpenGL 가속을 활성화하면 일반적으로 프레임 속도 저하 없이 최소 100배 이상의 점을 렌더링할 수 있습니다. 차트 크기 또한 프레임 속도에 미치는 영향이 적습니다.
계열 그리기의 OpenGL 가속은 많은 수의 포인트를 빠르게 그려야 하는 사용 사례를 위한 것입니다. 효율성을 위해 최적화되어 있으므로 이를 사용하는 계열은 가속되지 않은 계열에서 사용할 수 있는 많은 기능을 지원하지 않습니다:
- 가속 시리즈에는 시리즈 애니메이션이 지원되지 않습니다.
- 가속 시리즈에는 포인트 레이블이 지원되지 않습니다.
- 가속 계열에서는 펜 스타일, 마커 모양 및 라이트 마커가 무시됩니다. 실선과 일반 분산점만 지원됩니다. 스캐터 점은 기본 그래픽 하드웨어 및 드라이버에 따라 원형 또는 직사각형일 수 있습니다.
- 극좌표 차트는 가속화된 계열을 지원하지 않습니다.
- 가속 계열을 사용할 때 차트 그림자를 활성화하거나 투명한 차트 배경색을 사용하면 프레임 속도가 크게 느려질 수 있으므로 권장하지 않습니다.
이러한 추가 제한 사항은 가속화된 계열이 차트 위에 별도의 위젯에 그려지기 때문에 발생합니다:
- 가속화된 계열이 포함된 차트 위에 그래픽 항목을 그리면 가속화된 계열이 해당 항목 위에 그려집니다.
- QOpenGL위젯을 부분적으로 투명하게 하려면 다른 모든 위젯 위에 겹쳐서 배치해야 합니다. 즉, 가속 계열을 사용할 때 다른 위젯이 차트를 부분적으로 덮을 수 없습니다.
- 그래픽 장면에 두 개 이상의 그래픽 보기가 연결된 사용 사례에는 가속화된 계열이 지원되지 않습니다.
- 차트에 기본 지오메트리가 아닌 지오메트리가 있는 사용 사례에는 가속화된 계열이 지원되지 않습니다. 예를 들어 그래픽 보기에 변환을 추가하면 가속화된 계열이 차트와 관련된 잘못된 위치에 그려집니다.
기본값은 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()
계열에 연결된 축의 목록을 반환합니다. 일반적으로 축이 첨부되지 않은 QPieSeries 을 제외하고는 일반적으로 x축과 y축이 계열에 첨부됩니다.
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.
© 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.
