Класс 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::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().

bool QPieSeries::take(QPieSlice *slice)

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

Примечание: Серия остаётся родительским объектом сектора. Вы должны установить родительский объект, чтобы получить полное владение.

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

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

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

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

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

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