Класс QPieSeries

Класс QPieSeries представляет данные в виде круговой диаграммы. Подробнее...

• Список всех членов, включая наследуемые

Свойства

• 5 свойств унаследовано от QAbstractSeries
• 1 свойство унаследовано от QObject

Открытые функции

Переопределённые открытые функции

• 15 открытых функций унаследовано от QAbstractSeries
• 32 открытых функции унаследовано от QObject

Сигналы

• 4 сигнала унаследованы от QAbstractSeries
• 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

• 1 общедоступный слот унаследован от QObject
• 11 статических общедоступных членов унаследованы от QObject
• 9 защищённых функций унаследованы от QObject

Подробное описание

Класс QPieSeries представляет данные в круговых диаграммах.

Серия круговых диаграмм состоит из секторов, определённых как объекты QPieSlice. Сектора могут иметь любые значения, поскольку объект QPieSeries вычисляет процент сектора по сравнению со суммой всех секторов в серии, чтобы определить фактический размер сектора на диаграмме.

Размер и положение секторов на диаграмме контролируются с помощью относительных значений, которые варьируются от 0,0 до 1,0. Эти значения относятся к фактической области диаграммы.

По умолчанию круговая диаграмма определена как полная. Частичную круговую диаграмму можно создать, задав начальный угол и размах угла для серии. Полная круговая диаграмма — 360 градусов, где 0 находится в 12 часов.

Чтобы узнать, как использовать QPieSeries, см. пример круговой диаграммы https://doc.qt.io/qt-5.9/qtcharts-piechart-example.html или пример диаграммы с кольцами https://doc.qt.io/qt-5.9/qtcharts-donutchart-example.html.

См. также QPieSlice и QChart.

Документация по членам функций

QPieSeries::QPieSeries(QObject *parent = Q_NULLPTR)

Создаёт объект ряда, который является дочерним по отношению к parent.

[virtual] QPieSeries::~QPieSeries()

Удаляет ряд круговой диаграммы и его сегменты.

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

Этот сигнал генерируется при добавлении сегментов, указанных в slices, к ряду.

См. также append() и insert().

bool QPieSeries::append(QPieSlice *slice)

Добавляет сегмент, указанный в slice, в конец ряда. Владение сегментом передаётся ряду.

Возвращает true если добавление прошло успешно.

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

Добавляет массив сегментов, указанных в slices, в конец ряда. Владение сегментами передаётся ряду.

Возвращает true если добавление прошло успешно.

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

Добавляет отдельный сегмент со значением value и меткой label в ряд. Владение сегментом передаётся ряду. Возвращает null, если value NaN, Inf, или -Inf, и ничего не добавляет в ряд.

void QPieSeries::clear()

Очищает все сегменты из ряда.

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

Этот сигнал генерируется при щелчке на сегменте, указанном в slice.

См. также QPieSlice::clicked().

int QPieSeries::count() const

Возвращает количество сегментов в данном ряду.

Примечание: Функция-получатель для свойства count.

[signal] void QPieSeries::countChanged()

Этот сигнал генерируется при изменении количества сегментов.

Примечание: Сигнал уведомления для свойства count.

См. также count.

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

Этот сигнал генерируется при двойном щелчке на сегменте, указанном в slice.

См. также QPieSlice::doubleClicked().

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

Этот сигнал генерируется при наведении курсора на сегмент, указанный в slice. При наведении курсора на сегмент, state становится true, а при перемещении курсора обратно — false.

См. также QPieSlice::hovered().

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

Вставляет сегмент, указанный в slice, в ряд перед сегментом на позиции, указанной в index. Владение сегментом передаётся ряду.

Возвращает true если вставка прошла успешно.

bool QPieSeries::isEmpty() const

Возвращает true если ряд пуст.

qreal QPieSeries::pieEndAngle() const

Возвращает конечный угол сектора.

Полный сектор равен 360 градусам, где 0 градусов соответствует 12 часам.

Примечание: Функция-геттер для свойства endAngle.

См. также setPieEndAngle(), pieStartAngle() и setPieStartAngle().

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

Этот сигнал излучается, когда пользователь нажимает на сектор, указанный параметром slice, и удерживает нажатой кнопку мыши.

См. также QPieSlice::pressed().

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

Этот сигнал излучается, когда пользователь отпускает кнопку мыши, нажатую на секторе, указанном параметром slice.

См. также QPieSlice::released().

bool QPieSeries::remove(QPieSlice *slice)

Удаляет отдельный сектор, указанный параметром slice, из серии и удаляет его навсегда.

На этот указатель нельзя ссылаться после этого вызова.

Возвращает true в случае успешного удаления.

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

Этот сигнал излучается, когда секторы, указанные в slices, удаляются из серии.

См. также remove().

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

Устанавливает положение всех меток секторов в position.

Примечание: Эта функция влияет только на текущие секторы в серии. Если новый сектор добавлен, то положение метки по умолчанию — QPieSlice::LabelOutside.

См. также QPieSlice::labelPosition() и QPieSlice::setLabelPosition().

void QPieSeries::setLabelsVisible(bool visible = true)

Устанавливает видимость всех меток секторов в visible.

Примечание: Эта функция влияет только на текущие секторы в серии. Если новый сектор добавлен, то видимость метки по умолчанию — false.

См. также QPieSlice::isLabelVisible() и QPieSlice::setLabelVisible().

qreal QPieSeries::setPieEndAngle(qreal angle)

Устанавливает конечный угол сектора.

Полный сектор равен 360 градусам, где 0 градусов соответствует 12 часам.

angle должен быть больше начального угла.

Примечание: Функция-сеттер для свойства endAngle.

См. также pieEndAngle(), pieStartAngle() и setPieStartAngle().

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

Возвращает список секторов, принадлежащих этой серии.

qreal QPieSeries::sum() const

Возвращает сумму значений всех секторов в этой серии.

Примечание: Функция-геттер для свойства sum.

См. также QPieSlice::value(), QPieSlice::setValue() и QPieSlice::percentage().

[signal] void QPieSeries::sumChanged()

Этот сигнал излучается, когда сумма всех секторов изменяется.

Примечание: Сигнал-уведомление для свойства sum.

См. также sum.

bool QPieSeries::take(QPieSlice *slice)

Извлекает отдельный сектор, указанный параметром slice, из серии. Объект сектора не удаляется.

Примечание: Серия остается родительским объектом сектора. Необходимо установить родительский объект для полной ответственности за сектор.

Возвращает true в случае успешного извлечения.

[virtual] QAbstractSeries::SeriesType QPieSeries::type() const

Переопределено из QAbstractSeries::type().

Возвращает тип серии.

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

Добавляет сектор, указанный параметром slice, в серию и возвращает ссылку на серию. Владение сектором передается серии.