Класс QPieSeries

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

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

Свойства

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

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

Сигналы

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

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

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

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

См. пример круговой диаграммы или пример диаграммы с кольцом, чтобы узнать, как использовать QPieSeries.

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

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

QPieSeries::QPieSeries(QObject *parent = nullptr)

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

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

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

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

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

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

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

[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().

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

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

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

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

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

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

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

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

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

[signal] void QPieSeries::sumChanged()

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

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

См. также sum.

[virtual] QPieSeries::~QPieSeries()

Удаляет ряд сектора и его куски.

bool QPieSeries::append(QPieSlice *slice)

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

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

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

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

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

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

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

void QPieSeries::clear()

Очищает все сектора из серии.

int QPieSeries::count() const

Возвращает количество секторов в этой серии.

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

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().

bool QPieSeries::remove(QPieSlice *slice)

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

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

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

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

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

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

void QPieSeries::setLabelsVisible(bool visible = true)

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

См. также 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().

bool QPieSeries::take(QPieSlice *slice)

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

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

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

Переопределяет функцию доступа к свойству: QAbstractSeries::type.

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

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

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