QAbstractSeries Class

QAbstractSeries 클래스는 모든 2D 시리즈용 Qt Graphs 의 기본 클래스입니다. 더 보기...

Header: #include <QAbstractSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: AbstractSeries
상속합니다: QObjectQQmlParserStatus
상속받는 사람

QAreaSeries, QBarSeries, QPieSeries, 그리고 QXYSeries

공용 유형

enum class SeriesType { Line, Bar, Scatter, Pie, Spline, Area }

속성

공공 기능

virtual ~QAbstractSeries() override
QGraphsView *graph() const
void hide()
bool isHoverable() const
bool isSelectable() const
bool isVisible() const
const QList<QLegendData> legendData() const
QString name() const
qreal opacity() const
QQmlListProperty<QObject> seriesChildren()
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 show()
virtual QAbstractSeries::SeriesType type() const = 0
qreal valuesMultiplier() const

신호

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 legendDataChanged()
void nameChanged()
void opacityChanged()
void selectableChanged()
void valuesMultiplierChanged()
void visibleChanged()

상세 설명

일반적으로 기본 클래스 대신 시리즈 유형별 상속 클래스가 사용됩니다.

QLineSeries, QSplineSeries, QScatterSeries, QBarSeries, QXYSeries참조하세요 .

멤버 유형 문서

enum class QAbstractSeries::SeriesType

이 열거형은 시리즈의 유형을 설명합니다.

Constant설명
QAbstractSeries::SeriesType::Line0선 그래프.
QAbstractSeries::SeriesType::Bar2막대 그래프.
QAbstractSeries::SeriesType::Scatter4분산형 그래프.
QAbstractSeries::SeriesType::Pie3파이 그래프.
QAbstractSeries::SeriesType::Spline5스플라인 그래프.
QAbstractSeries::SeriesType::Area1면적 그래프.

속성 문서

hoverable : bool

시리즈를 호버링할 수 있는지 여부를 제어합니다.

마우스/터치로 시리즈를 가리킬 수 있는지 여부를 제어합니다. 기본적으로 hoverablefalse 으로 설정되어 있습니다.

기능에 액세스합니다:

bool isHoverable() const
void setHoverable(bool newHoverable)

알림 신호:

void hoverableChanged()

[read-only] legendData : const 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

시리즈를 선택할 수 있는지 여부를 제어합니다.

마우스/터치로 시리즈를 선택할 수 있는지 여부를 제어합니다. 기본적으로 selectablefalse 으로 설정되어 있습니다.

기능에 액세스합니다:

bool isSelectable() const
void setSelectable(bool selectable)

알림 신호:

void selectableChanged()

[read-only] type : const SeriesType

이 속성은 시리즈의 유형을 보유합니다.

액세스 함수:

virtual QAbstractSeries::SeriesType type() const = 0

valuesMultiplier : qreal

시리즈 값의 유효 표시 값을 제어합니다.

이 변수는 0에서 실제 값 크기까지 스케일링되도록 계열 값을 애니메이션하는 데 사용할 수 있습니다. 기본적으로 값배율은 1.0입니다. 유효한 값의 범위는 0.0(높이 0)에서 1.0(최대값)입니다.

함수에 액세스합니다:

qreal valuesMultiplier() const
void setValuesMultiplier(qreal valuesMultiplier)

알림 신호:

void valuesMultiplierChanged()

visible : bool

시리즈의 가시성.

이 시리즈에 사용되는 가시성입니다. 기본적으로 visibletrue 으로 설정됩니다.

기능에 액세스합니다:

bool isVisible() const
void setVisible(bool visible = true)

알림 신호:

void visibleChanged()

멤버 함수 문서

[override virtual noexcept] QAbstractSeries::~QAbstractSeries()

그래프 계열을 위한 가상 소멸자.

QGraphsView *QAbstractSeries::graph() const

계열이 속한 그래프를 반환합니다.

계열이 그래프에 추가되면 자동으로 설정되고, 계열이 그래프에서 제거되면 설정이 해제됩니다.

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()도 참조하세요 .

© 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.