內容

特性
公共函數
重實現公共函數
信號
靜態公共成員
詳細描述

QPieSeries Class

The QPieSeries class presents data in pie charts. 更多...

頭：	#include <QPieSeries>
實例化：	PieSeries
繼承：	QAbstractSeries

特性

count : const int
endAngle : qreal
holeSize : qreal
horizontalPosition : qreal

size : qreal
startAngle : qreal
sum : const qreal
verticalPosition : qreal

5 特性繼承自 QAbstractSeries
1 特性繼承自 QObject

公共函數

	QPieSeries (QObject * parent = nullptr)
virtual	~QPieSeries ()
bool	append (QPieSlice * slice )
bool	append (QList<QPieSlice > slices* )
QPieSlice *	append (QString label , qreal value )
void	clear ()
int	count () const
qreal	holeSize () const
qreal	horizontalPosition () const
bool	insert (int index , QPieSlice * slice )
bool	isEmpty () const
qreal	pieEndAngle () const
qreal	pieSize () const
qreal	pieStartAngle () const
bool	remove (QPieSlice * slice )
void	setHoleSize (qreal holeSize )
void	setHorizontalPosition (qreal relativePosition )
void	setLabelsPosition (QPieSlice::LabelPosition position )
void	setLabelsVisible (bool visible = true)
void	setPieEndAngle (qreal angle )
void	setPieSize (qreal relativeSize )
void	setPieStartAngle (qreal startAngle )
void	setVerticalPosition (qreal relativePosition )
QList<QPieSlice *>	slices () const
qreal	sum () const
bool	take (QPieSlice * slice )
qreal	verticalPosition () const
QPieSeries &	operator<< (QPieSlice * slice )

重實現公共函數

virtual QAbstractSeries::SeriesType

type () const

15 公共函數繼承自 QAbstractSeries
31 公共函數繼承自 QObject

信號

void	added (QList<QPieSlice > slices* )
void	clicked (QPieSlice * slice )
void	countChanged ()
void	doubleClicked (QPieSlice * slice )
void	hovered (QPieSlice * slice , bool state )
void	pressed (QPieSlice * slice )
void	released (QPieSlice * slice )
void	removed (QList<QPieSlice > slices* )
void	sumChanged ()

4 信號繼承自 QAbstractSeries
2 信號繼承自 QObject

靜態公共成員

const QMetaObject

staticMetaObject

9 靜態公共成員繼承自 QObject

額外繼承成員

1 公共槽繼承自 QObject
9 保護函數繼承自 QObject

詳細描述

The QPieSeries class presents data in pie charts.

A pie series consists of slices that are defined as QPieSlice objects. The slices can have any values as the QPieSeries object calculates the percentage of a slice compared with the sum of all slices in the series to determine the actual size of the slice in the chart.

Pie size and position on the chart are controlled by using relative values that range from 0.0 to 1.0. These relate to the actual chart rectangle.

By default, the pie is defined as a full pie. A partial pie can be created by setting a starting angle and angle span for the series. A full pie is 360 degrees, where 0 is at 12 a'clock.

見 pie chart example or donut chart example to learn how to use QPieSeries .

另請參閱 QPieSlice and QChart .

特性文檔編製

count : const int

This property holds the number of slices in the series.

訪問函數：

int	count () const

通知程序信號：

void	countChanged ()

endAngle : qreal

This property holds the ending angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

The default value is 360.

訪問函數：

qreal	pieEndAngle () const
void	setPieEndAngle (qreal angle )

holeSize : qreal

This property holds the donut hole size.

The value is relative to the chart rectangle, so that:

0.0 is the minimum size (full pie drawn without a hole).
1.0 is the maximum size that can fit the chart (the donut has no width).

當設置此特性時， size property is adjusted if necessary, to ensure that the hole size is not greater than the pie size.

The default value is 0.0.

訪問函數：

qreal	holeSize () const
void	setHoleSize (qreal holeSize )

horizontalPosition : qreal

This property holds the horizontal position of the pie.

The value is relative to the chart rectangle, so that:

0.0 is the absolute left.
1.0 is the absolute right.

The default value is 0.5 (center).

訪問函數：

qreal	horizontalPosition () const
void	setHorizontalPosition (qreal relativePosition )

另請參閱 verticalPosition .

size : qreal

This property holds the pie size.

The value is relative to the chart rectangle, so that:

0.0 is the minimum size (pie not drawn).
1.0 is the maximum size that can fit the chart.

當設置此特性時， holeSize property is adjusted if necessary, to ensure that the hole size is not greater than the pie size.

The default value is 0.7.

訪問函數：

qreal	pieSize () const
void	setPieSize (qreal relativeSize )

startAngle : qreal

This property holds the starting angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

默認值為 0。

訪問函數：

qreal	pieStartAngle () const
void	setPieStartAngle (qreal startAngle )

sum : const qreal

This property holds the sum of all slices.

The series keeps track of the sum of all the slices it holds.

訪問函數：

qreal

sum () const

通知程序信號：

void	sumChanged ()

verticalPosition : qreal

This property holds the vertical position of the pie.

The value is relative to the chart rectangle, so that:

0.0 is the absolute top.
1.0 is the absolute bottom.

The default value is 0.5 (center).

訪問函數：

qreal	verticalPosition () const
void	setVerticalPosition (qreal relativePosition )

另請參閱 horizontalPosition .

成員函數文檔編製

QPieSeries:: QPieSeries ( QObject * parent = nullptr)

Constructs a series object that is a child of parent .

`[虛擬]` QPieSeries:: ~QPieSeries ()

Removes the pie series and its slices.

`[signal]` void QPieSeries:: added ( QList < QPieSlice > slices* )

This signal is emitted when the slices specified by slices are added to the series.

另請參閱 append () 和 insert ().

bool QPieSeries:: append ( QPieSlice * slice )

Appends the slice specified by slice to the series. Slice ownership is passed to the series.

返迴 true if appending succeeds.

bool QPieSeries:: append ( QList < QPieSlice > slices* )

Appends the array of slices specified by slices to the series. Slice ownership is passed to the series.

返迴 true if appending succeeds.

QPieSlice QPieSeries:: append ( QString label* , qreal value )

Appends a single slice with the specified value and label to the series. Slice ownership is passed to the series. Returns null if value is NaN , Inf ，或 -Inf and adds nothing to the series.

void QPieSeries:: clear ()

Clears all slices from the series.

`[signal]` void QPieSeries:: clicked ( QPieSlice * slice )

This signal is emitted when the slice specified by slice 被點擊。

另請參閱 QPieSlice::clicked ().

int QPieSeries:: count () const

Returns the number of the slices in this series.

注意： getter 函數對於特性 count .

`[signal]` void QPieSeries:: countChanged ()

This signal is emitted when the slice count changes.

注意： 通知程序信號對於特性 count .

另請參閱 count .

`[signal]` void QPieSeries:: doubleClicked ( QPieSlice * slice )

This signal is emitted when the slice specified by slice is double-clicked.

另請參閱 QPieSlice::doubleClicked ().

`[signal]` void QPieSeries:: hovered ( QPieSlice * slice , bool state )

This signal is emitted when a mouse is hovered over the slice specified by slice . When the mouse moves over the slice, state turns true , and when the mouse moves away again, it turns false .

另請參閱 QPieSlice::hovered ().

bool QPieSeries:: insert ( int index , QPieSlice * slice )

Inserts the slice specified by slice to the series before the slice at the position specified by index . Slice ownership is passed to the series.

返迴 true if inserting succeeds.

bool QPieSeries:: isEmpty () const

返迴 true if the series is empty.

qreal QPieSeries:: pieEndAngle () const

Returns the end angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

注意： getter 函數對於特性 endAngle .

另請參閱 setPieEndAngle (), pieStartAngle ()，和 setPieStartAngle ().

`[signal]` void QPieSeries:: pressed ( QPieSlice * slice )

This signal is emitted when the user clicks the slice specified by slice and holds down the mouse button.

另請參閱 QPieSlice::pressed ().

`[signal]` void QPieSeries:: released ( QPieSlice * slice )

This signal is emitted when the user releases the mouse press on the slice specified by slice .

另請參閱 QPieSlice::released ().

bool QPieSeries:: remove ( QPieSlice * slice )

Removes a single slice, specified by slice , from the series and deletes it permanently.

The pointer cannot be referenced after this call.

返迴 true if the removal succeeds.

`[signal]` void QPieSeries:: removed ( QList < QPieSlice > slices* )

This signal is emitted when the slices specified by slices are removed from the series.

另請參閱 remove ().

void QPieSeries:: setLabelsPosition ( QPieSlice::LabelPosition position )

Sets the position of all the slice labels to position .

注意： This function affects only the current slices in the series. If a new slice is added, the default label position is QPieSlice::LabelOutside .

另請參閱 QPieSlice::labelPosition () 和 QPieSlice::setLabelPosition ().

void QPieSeries:: setLabelsVisible ( bool visible = true)

Sets the visibility of all slice labels to visible .

注意： This function affects only the current slices in the series. If a new slice is added, the default label visibility is false .

另請參閱 QPieSlice::isLabelVisible () 和 QPieSlice::setLabelVisible ().

void QPieSeries:: setPieEndAngle ( qreal angle )

Sets the end angle of the pie.

A full pie is 360 degrees, where 0 degrees is at 12 a'clock.

angle must be greater than the start angle.

注意： setter 函數對於特性 endAngle .

另請參閱 pieEndAngle (), pieStartAngle ()，和 setPieStartAngle ().

QList < QPieSlice *> QPieSeries:: slices () const

Returns a list of slices that belong to this series.

qreal QPieSeries:: sum () const

Returns the sum of all slice values in this series.

注意： getter 函數對於特性 sum .

另請參閱 QPieSlice::value (), QPieSlice::setValue ()，和 QPieSlice::percentage ().

`[signal]` void QPieSeries:: sumChanged ()

This signal is emitted when the sum of all slices changes.

注意： 通知程序信號對於特性 sum .

另請參閱 sum .

bool QPieSeries:: take ( QPieSlice * slice )

Takes a single slice, specified by slice , from the series. Does not delete the slice object.

注意： The series remains the slice's parent object. You must set the parent object to take full ownership.

返迴 true if the take operation was successful.

`[虛擬]` QAbstractSeries::SeriesType QPieSeries:: type () const

重實現自 QAbstractSeries::type ().

Returns the type of the series.

QPieSeries &QPieSeries:: operator<< ( QPieSlice * slice )

Appends the slice specified by slice to the series and returns a reference to the series. Slice ownership is passed to the series.

內容

QPieSeries Class

特性

公共函數

重實現公共函數

信號

靜態公共成員

額外繼承成員

詳細描述

特性文檔編製

count : const int

endAngle : qreal

holeSize : qreal

horizontalPosition : qreal

size : qreal

startAngle : qreal

sum : const qreal

verticalPosition : qreal

成員函數文檔編製

QPieSeries:: QPieSeries ( QObject * parent = nullptr)

[虛擬] QPieSeries:: ~QPieSeries ()

[signal] void QPieSeries:: added ( QList < QPieSlice *> slices )

bool QPieSeries:: append ( QPieSlice * slice )

bool QPieSeries:: append ( QList < QPieSlice *> slices )

QPieSlice *QPieSeries:: append ( QString label , qreal value )

void QPieSeries:: clear ()

[signal] void QPieSeries:: clicked ( QPieSlice * slice )

int QPieSeries:: count () const

[signal] void QPieSeries:: countChanged ()

[signal] void QPieSeries:: doubleClicked ( QPieSlice * slice )

[signal] void QPieSeries:: hovered ( QPieSlice * slice , bool state )

bool QPieSeries:: insert ( int index , QPieSlice * slice )

bool QPieSeries:: isEmpty () const

qreal QPieSeries:: pieEndAngle () const

[signal] void QPieSeries:: pressed ( QPieSlice * slice )

[signal] void QPieSeries:: released ( QPieSlice * slice )

bool QPieSeries:: remove ( QPieSlice * slice )

[signal] void QPieSeries:: removed ( QList < QPieSlice *> slices )

void QPieSeries:: setLabelsPosition ( QPieSlice::LabelPosition position )

void QPieSeries:: setLabelsVisible ( bool visible = true)

void QPieSeries:: setPieEndAngle ( qreal angle )

QList < QPieSlice *> QPieSeries:: slices () const

qreal QPieSeries:: sum () const

[signal] void QPieSeries:: sumChanged ()

bool QPieSeries:: take ( QPieSlice * slice )

[虛擬] QAbstractSeries::SeriesType QPieSeries:: type () const

QPieSeries &QPieSeries:: operator<< ( QPieSlice * slice )

`[虛擬]` QPieSeries:: ~QPieSeries ()

`[signal]` void QPieSeries:: added ( QList < QPieSlice > slices* )

bool QPieSeries:: append ( QList < QPieSlice > slices* )

QPieSlice QPieSeries:: append ( QString label* , qreal value )

`[signal]` void QPieSeries:: clicked ( QPieSlice * slice )

`[signal]` void QPieSeries:: countChanged ()

`[signal]` void QPieSeries:: doubleClicked ( QPieSlice * slice )

`[signal]` void QPieSeries:: hovered ( QPieSlice * slice , bool state )

`[signal]` void QPieSeries:: pressed ( QPieSlice * slice )

`[signal]` void QPieSeries:: released ( QPieSlice * slice )

`[signal]` void QPieSeries:: removed ( QList < QPieSlice > slices* )

`[signal]` void QPieSeries:: sumChanged ()

`[虛擬]` QAbstractSeries::SeriesType QPieSeries:: type () const