Класс QPieSlice
Класс QPieSlice представляет собой один срез в серии круговых диаграмм. Подробнее...
| Заголовок: | #include <QPieSlice> |
| Создается из: | PieSlice |
| Наследует от: | QObject |
Типы public
| Перечисление | LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal } |
Свойства
|
|
Открытые функции
| QPieSlice(QString метка, qreal значение, QObject *parent = nullptr) | |
| QPieSlice(QObject *parent = nullptr) | |
| virtual | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | цветГраницы() |
| int | толщинаГраницы() |
| QBrush | заливка() const |
| QColor | цвет() |
| qreal | коэффициентРадиусаРазрыва() const |
| bool | isExploded() const |
| bool | isLabelVisible() const |
| QString | метка() const |
| qreal | коэффициентДлинаРукиМетки() const |
| QBrush | заливкаМетки() const |
| QColor | цветМетки() |
| QFont | шрифтМетки() const |
| QPieSlice::LabelPosition | положениеМетки() |
| QPen | контур() const |
| qreal | процент() const |
| QPieSeries * | series() const |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(int width) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setExplodeDistanceFactor(qreal factor) |
| void | setExploded(bool exploded = true) |
| void | setLabel(QString label) |
| void | setLabelArmLengthFactor(qreal factor) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setLabelFont(const QFont &font) |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
| void | setLabelVisible(bool visible = true) |
| void | setPen(const QPen &pen) |
| void | setValue(qreal value) |
| qreal | startAngle() const |
| qreal | значение() const |
Сигналы
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| void | valueChanged() |
Подробное описание
У сегмента круговой диаграммы есть значение и метка. Когда сегмент добавляется в серию круговой диаграммы, объект QPieSeries вычисляет процент сегмента по отношению к сумме всех сегментов в серии, чтобы определить фактический размер сегмента на диаграмме.
По умолчанию метка скрыта. Если она видна, она может быть расположена снаружи сегмента и соединена с ним плечом или расположена по центру внутри сегмента, либо по горизонтали, либо параллельно касательной или нормали дуги сегмента.
По умолчанию внешний вид сегмента задаётся темой, но тема может быть переопределена путём указания свойств сегмента. Однако, если тема изменяется после настройки сегментов, все настройки будут утеряны.
Для включения взаимодействия пользователя с круговой диаграммой, при нажатии на сегменты круговой диаграммы или наведении курсора мыши на них, генерируются некоторые базовые сигналы.
См. также QPieSeries.
Документация по типам членов
Перечисление QPieSlice::LabelPosition
Это перечисление описывает положение метки сегмента.
| Константа | Значение | Описание |
|---|---|---|
QPieSlice::LabelOutside |
0 |
Метка расположена вне сегмента, соединённая с ним плечом. Это значение по умолчанию. |
QPieSlice::LabelInsideHorizontal |
1 |
Метка расположена по центру внутри сегмента и выровнена по горизонтали. |
QPieSlice::LabelInsideTangential |
2 |
Метка расположена по центру внутри сегмента и повернута параллельно касательной дуги сегмента. |
QPieSlice::LabelInsideNormal |
3 |
Метка расположена по центру внутри сегмента и повернута параллельно нормали дуги сегмента. |
Документация свойств
[read-only] angleSpan : const qreal
Это свойство содержит угол сектора в градусах. Полный круг составляет 360 градусов, где 0 градусов находится в 12 часов. Обновляется автоматически после добавления сектора в серию.
Функции доступа:
| qreal | angleSpan() const |
Сигнал уведомления:
| void | angleSpanChanged() |
borderColor : QColor
Это свойство содержит цвет, используемый для рисования границы сектора. Это свойство для удобства изменения пера сектора.
Функции доступа:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Сигнал уведомления:
| void | borderColorChanged() |
См. также pen и borderWidth.
borderWidth : int
Это свойство содержит ширину границы сектора. Это свойство для удобства изменения пера сектора.
Функции доступа:
| int | borderWidth() |
| void | setBorderWidth(int width) |
Сигнал уведомления:
| void | borderWidthChanged() |
См. также pen и borderColor.
brush : QBrush
Это свойство содержит кисть, используемую для заполнения сектора.
Функции доступа:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
Сигнал уведомления:
| void | brushChanged() |
color : QColor
Это свойство содержит цвет заливки (кисти) сектора. Это свойство для удобства изменения кисти сектора.
Функции доступа:
| QColor | color() |
| void | setColor(QColor color) |
Сигнал уведомления:
| void | colorChanged() |
См. также brush.
explodeDistanceFactor : qreal
Определяет, насколько далеко от пирога выдвинут сектор.
- 1.0 означает, что расстояние равно радиусу.
- 0.5 означает, что расстояние равно половине радиуса.
По умолчанию расстояние равно 0.15.
Функции доступа:
| qreal | explodeDistanceFactor() const |
| void | setExplodeDistanceFactor(qreal factor) |
См. также exploded.
exploded : bool
Это свойство указывает, отделен ли сектор от пирога.
Функции доступа:
| bool | isExploded() const |
| void | setExploded(bool exploded = true) |
См. также explodeDistanceFactor.
label : QString
Это свойство содержит метку сектора.
Примечание: Строка может иметь форматирование HTML.
Функции доступа:
| QString | label() const |
| void | setLabel(QString label) |
Сигнал уведомления:
| void | labelChanged() |
См. также labelVisible, labelBrush, labelFont и labelArmLengthFactor.
labelArmLengthFactor : qreal
Это свойство содержит длину метки. Коэффициент относится к радиусу пирога. Например:
- 1.0 означает, что длина равна радиусу.
- 0.5 означает, что длина равна половине радиуса.
По умолчанию длина плеча равна 0.15.
Функции доступа:
| qreal | labelArmLengthFactor() const |
| void | setLabelArmLengthFactor(qreal factor) |
См. также label, labelVisible, labelBrush и labelFont.
labelBrush : QBrush
Это свойство содержит кисть, используемую для рисования метки и плеча сектора.
Функции доступа:
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
Сигнал уведомления:
| void | labelBrushChanged() |
См. также label, labelVisible, labelFont и labelArmLengthFactor.
labelColor : QColor
Это свойство содержит цвет, используемый для рисования метки сектора. Это свойство для удобства изменения кисти метки сектора.
Функции доступа:
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
Сигнал уведомления:
| void | labelColorChanged() |
См. также labelBrush.
labelFont : QFont
Это свойство содержит шрифт, используемый для рисования текста метки.
Функции доступа:
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Сигнал уведомления:
| void | labelFontChanged() |
См. также метка, отображение метки и множитель длины отрезка метки.
labelPosition : ПозицияМетки
Это свойство хранит положение метки слайса.
Функции доступа:
| QPieSlice::LabelPosition | labelPosition() |
| void | setLabelPosition(QPieSlice::LabelPosition position) |
См. также метка и отображение метки.
labelVisible : bool
Это свойство хранит видимость метки слайса. По умолчанию метка невидима.
Функции доступа:
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
Сигнал уведомления:
| void | labelVisibleChanged() |
См. также метка, кисть метки, шрифт метки и множитель длины отрезка метки.
pen : QPen
Это свойство хранит перо, используемое для рисования границы слайса.
Функции доступа:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Сигнал уведомления:
| void | penChanged() |
[read-only] percentage : const qreal
Это свойство хранит процент слайса по отношению к сумме всех слайсов в серии. Фактическое значение колеблется от 0,0 до 1,0. Автоматически обновляется после добавления слайса в серию.
Функции доступа:
| qreal | percentage() const |
Сигнал уведомления:
| void | percentageChanged() |
См. также значение и QPieSeries::sum.
[read-only] startAngle : const qreal
Это свойство хранит начальный угол этого слайса в серии, к которой он принадлежит. Полный круг составляет 360 градусов, где 0 градусов находится в 12 часов. Автоматически обновляется после добавления слайса в серию.
Функции доступа:
| qreal | startAngle() const |
Сигнал уведомления:
| void | startAngleChanged() |
value : qreal
Это свойство хранит значение слайса.
Примечание: Отрицательное значение преобразуется в положительное.
Функции доступа:
| qreal | value() const |
| void | setValue(qreal value) |
Сигнал уведомления:
| void | valueChanged() |
См. также percentage() и QPieSeries::sum().
Документация по членам-функциям
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)
Создаёт пустой слайс со значением value, меткой label и родителем parent.
См. также QPieSeries::append() и QPieSeries::insert().
QPieSlice::QPieSlice(QObject *parent = nullptr)
Создаёт пустой слайс с родителем parent.
См. также QPieSeries::append() и QPieSeries::insert().
[signal] void QPieSlice::angleSpanChanged()
Этот сигнал испускается, когда изменяется угол охвата слайса.
Примечание: Сигнал уведомления для свойства angleSpan.
См. также angleSpan.
[signal] void QPieSlice::borderColorChanged()
Этот сигнал испускается, когда изменяется цвет границы слайса.
Примечание: Сигнал уведомления для свойства borderColor.
См. также pen и borderColor.
[signal] void QPieSlice::borderWidthChanged()
Этот сигнал испускается, когда изменяется ширина границы слайса.
Примечание: Сигнал уведомления для свойства borderWidth.
См. также pen и borderWidth.
[signal] void QPieSlice::brushChanged()
Этот сигнал испускается, когда изменяется кисть, используемая для заполнения слайса.
Примечание: Сигнал уведомления для свойства brush.
См. также brush.
[signal] void QPieSlice::clicked()
Этот сигнал испускается, когда слайс нажат.
См. также QPieSeries::clicked().
[signal] void QPieSlice::colorChanged()
Этот сигнал испускается, когда изменяется цвет слайса.
Примечание: Сигнал уведомления для свойства color.
См. также brush.
[signal] void QPieSlice::doubleClicked()
Этот сигнал испускается, когда пользователь дважды щелкает по слайсу.
См. также QPieSeries::doubleClicked().
[signal] void QPieSlice::hovered(bool state)
Этот сигнал испускается, когда курсор мыши наведён на слайс. Когда курсор мыши перемещается на слайс, state становится true, а когда курсор мыши убирается, он становится false.
См. также QPieSeries::hovered().
[signal] void QPieSlice::labelBrushChanged()
Этот сигнал испускается, когда изменяется кисть метки слайса.
Примечание: Сигнал уведомления для свойства labelBrush.
См. также labelBrush.
[signal] void QPieSlice::labelChanged()
Этот сигнал испускается, когда изменяется метка слайса.
Примечание: Сигнал уведомления для свойства label.
См. также label.
[signal] void QPieSlice::labelColorChanged()
Этот сигнал испускается, когда изменяется цвет метки слайса.
Примечание: Сигнал уведомления для свойства labelColor.
См. также labelColor.
[signal] void QPieSlice::labelFontChanged()
Этот сигнал испускается, когда изменяется шрифт метки слайса.
Примечание: Сигнал уведомления для свойства labelFont.
См. также labelFont.
[signal] void QPieSlice::labelVisibleChanged()
Этот сигнал испускается, когда изменяется видимость метки слайса.
Примечание: Сигнал уведомления для свойства labelVisible.
См. также labelVisible.
[signal] void QPieSlice::penChanged()
Этот сигнал испускается, когда изменяется перо, используемое для рисования границы сегмента.
Примечание: Сигнал уведомления для свойства pen.
См. также pen.
[signal] void QPieSlice::percentageChanged()
Этот сигнал испускается, когда изменяется процент сегмента.
Примечание: Сигнал уведомления для свойства percentage.
См. также percentage.
[signal] void QPieSlice::pressed()
Этот сигнал испускается, когда пользователь нажимает на сегмент и удерживает кнопку мыши.
См. также QPieSeries::pressed().
[signal] void QPieSlice::released()
Этот сигнал испускается, когда пользователь отпускает нажатие кнопки мыши на сегменте.
См. также QPieSeries::released().
[signal] void QPieSlice::startAngleChanged()
Этот сигнал испускается, когда изменяется начальный угол сегмента.
Примечание: Сигнал уведомления для свойства startAngle.
См. также startAngle.
[signal] void QPieSlice::valueChanged()
Этот сигнал испускается, когда изменяется значение сегмента.
Примечание: Сигнал уведомления для свойства value.
См. также value.
[virtual] QPieSlice::~QPieSlice()
Удаляет сегмент. Сегмент не следует удалять, если он был добавлен в серию.
QPieSeries *QPieSlice::series() const
Возвращает серию, к которой принадлежит этот сегмент.
См. также QPieSeries::append().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qpieslice.html
