QAbstractSeries 類

The QAbstractSeries class is a base class for all Qt Graphs for 2D series. 更多...

頭：	#include <QAbstractSeries>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake:	QT += graphs
在 QML：	AbstractSeries
繼承：	QObject and QQmlParserStatus
繼承者：	QAreaSeries , QBarSeries , QPieSeries ，和 QXYSeries

• 所有成員列錶，包括繼承成員
• QAbstractSeries is part of Qt Graphs C++ Classes for 2D .

公共類型

枚舉類	SeriesType { Line, Bar, Scatter, Pie, Spline, Area }

特性

(從 6.10 起) axisX : QAbstractAxis* (從 6.10 起) axisY : QAbstractAxis* hoverable : bool hovered : const bool legendData : const QList<QLegendData> name : QString

opacity : qreal selectable : bool type : const SeriesType valuesMultiplier : qreal visible : bool (從 6.10 起) zValue : int

公共函數

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	A line graph.
QAbstractSeries::SeriesType::Bar	2	A bar graph.
QAbstractSeries::SeriesType::Scatter	4	A scatter graph.
QAbstractSeries::SeriesType::Pie	3	A pie graph.
QAbstractSeries::SeriesType::Spline	5	A spline graph.
QAbstractSeries::SeriesType::Area	1	An area graph.

特性文檔編製

[since 6.10] axisX : QAbstractAxis *

X-axis of this series.

The x-axis used for this series. Creates a separate axis from the one defined in GraphsView showing the user multiple axis per graph.

此特性在 Qt 6.10 引入。

訪問函數：

QAbstractAxis *	axisX () const
void	setAxisX (QAbstractAxis * newAxisX )

通知程序信號：

void	axisXChanged (QAbstractAxis * newAxis )

[since 6.10] axisY : QAbstractAxis *

Y-axis of this series.

The y-axis used for this series. Creates a separate axis from the one defined in GraphsView showing the user multiple axis per graph.

此特性在 Qt 6.10 引入。

訪問函數：

QAbstractAxis *	axisY () const
void	setAxisY (QAbstractAxis * newAxisY )

通知程序信號：

void	axisYChanged (QAbstractAxis * newAxis )

hoverable : bool

Controls if the series is hoverable.

Controls if the series can be hovered with mouse/touch. By default, hoverable 被設為 false .

訪問函數：

bool	isHoverable () const
void	setHoverable (bool newHoverable )

通知程序信號：

void	hoverableChanged ()

[read-only] hovered : const bool

Check whether a series is hovered on.

Can be used to check whether mouse/touch is currently hovering on a series.

訪問函數：

bool	isHovered () const

通知程序信號：

void	hoveredChanged (bool hovered )

另請參閱 QAbstractSeries::hovered.

[read-only] legendData : const QList < QLegendData >

Contains information needed to create a legend marker for a data set in a graph.

訪問函數：

const QList<QLegendData>

legendData () const

通知程序信號：

void	legendDataChanged ()

另請參閱 QLegendData .

名稱 : QString

This property holds the name of the series.

The name is displayed in the legend for the series and it supports HTML formatting.

訪問函數：

QString	名稱 () const
void	setName (const QString & name )

通知程序信號：

void	nameChanged ()

opacity : qreal

This property holds the opacity of the series.

By default, the opacity is 1.0. The valid values range from 0.0 (transparent) to 1.0 (opaque).

訪問函數：

qreal	opacity () const
void	setOpacity (qreal opacity )

通知程序信號：

void	opacityChanged ()

selectable : bool

Controls if the series is selectable.

Controls if the series can be selected with mouse/touch. By default, selectable 被設為 false .

訪問函數：

bool	isSelectable () const
void	setSelectable (bool selectable )

通知程序信號：

void	selectableChanged ()

[read-only] type : const SeriesType

This property holds the type of the series.

訪問函數：

virtual QAbstractSeries::SeriesType

type () const = 0

valuesMultiplier : qreal

Controls the series values effective visible value.

This variable can be used for animating the series values so they scale from 0 to actual value size. By default, the valuesMultiplier is 1.0. The valid values range from 0.0 (height 0) to 1.0 (full value).

訪問函數：

qreal	valuesMultiplier () const
void	setValuesMultiplier (qreal valuesMultiplier )

通知程序信號：

void	valuesMultiplierChanged ()

visible : bool

Visibility of the series.

The visibility used for this series. By default, visible 被設為 true .

訪問函數：

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

通知程序信號：

void	visibleChanged ()

[since 6.10] zValue : int

Controls the order in which the series is drawn

The series list of GraphsView is sorted by the zValue property. Since each series type is rendered at once, the order mostly works as an internal order of each series type. The highest zValue of each series type determines the order of rendering among series types. The default value is 0.

此特性在 Qt 6.10 引入。

訪問函數：

int	zValue () const
void	setZValue (int newDrawOrder )

通知程序信號：

void	zValueChanged (int z )

成員函數文檔編製

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

Virtual destructor for the graph series.

void QAbstractSeries:: hide ()

Sets the visibility of the series to false .

另請參閱 setVisible () 和 isVisible ().

[signal] void QAbstractSeries:: hover (const QString & seriesName , QPointF position , QPointF value )

This signal is emitted when the series hovering changes. The name of the series is in seriesName , the mouse/touch position in position , and the series value in value .

注意： 此信號纔被發射當 hoverable 被設為 true。

注意： For Pie graph, the value represents (angle of position, start angle of hovering slice)

[signal] void QAbstractSeries:: hoverEnter (const QString & seriesName , QPointF position , QPointF value )

This signal is emitted when the series hovering starts. The name of the series is in seriesName , the mouse/touch position in position , and the series value in value .

注意： 此信號纔被發射當 hoverable 被設為 true。

注意： For Pie graph, the value represents (angle of position, start angle of hovering slice)

[signal] void QAbstractSeries:: hoverExit (const QString & seriesName , QPointF position )

This signal is emitted when the series hovering ends. The name of the series is in seriesName , and the mouse/touch position in position .

注意： 此信號纔被發射當 hoverable 被設為 true。

void QAbstractSeries:: show ()

Sets the visibility of the series to true .

另請參閱 setVisible () 和 isVisible ().

內容

1. 公共類型

2. 特性

3. 公共函數

4. 信號

5. 詳細描述