Класс QPieSlice
Класс QPieSlice представляет собой один сектор в круговой диаграмме. Подробнее...
| Заголовок: | #include <QPieSlice> |
| Создаётся из: | PieSlice |
| Наследует: | QObject |
Открытые типы
| Перечисление | ПоложениеМетки { МеткаСнаружи, МеткаВнутриГоризонтально, МеткаВнутриКасательно, МеткаВнутриНормально } |
Свойства
|
|
Открытые функции
| QPieSlice(QString метка, qreal значение, QObject *родитель = nullptr) | |
| QPieSlice(QObject *родитель = nullptr) | |
| virtual | ~QPieSlice() |
| qreal | angleSpan() const |
| QColor | цветГраницы() |
| int | ширинаГраницы() |
| QBrush | мастиха() const |
| QColor | цвет() |
| qreal | коэффициентОтступаПриВзрыве() const |
| bool | являетсяВзрывным() const |
| bool | являетсяМеткаВидимой() const |
| QString | метка() const |
| qreal | коэффициентДлинаРукиМетки() const |
| QBrush | мастихаМетки() const |
| QColor | цветМетки() |
| QFont | шрифтМетки() const |
| QPieSlice::LabelPosition | положениеМетки() |
| QPen | ручка() const |
| qreal | процент() const |
| QPieSeries * | серия() const |
| void | установитьЦветГраницы(QColor цвет) |
| void | установитьШиринаГраницы(int ширина) |
| void | установитьМастиху(const QBrush &мастиха) |
| void | установитьЦвет(QColor цвет) |
| void | установитьКоэффициентОтступаПриВзрыве(qreal фактор) |
| void | установитьВзрывной(bool взрывной = true) |
| void | установитьМетку(QString метка) |
| void | установитьКоэффициентДлинаРукиМетки(qreal фактор) |
| void | установитьМастихуМетки(const QBrush &мастиха) |
| void | установитьЦветМетки(QColor цвет) |
| void | установитьШрифтМетки(const QFont &шрифт) |
| void | установитьПоложениеМетки(QPieSlice::LabelPosition позиция) |
| void | установитьВидимостьМетки(bool видимость = true) |
| void | установитьРучку(const QPen &ручка) |
| void | установитьЗначение(qreal значение) |
| qreal | начальныйУгол() const |
| qreal | значение() const |
Сигналы
| void | изменениеДиапазонаУглов() |
| void | изменениеЦветаГраницы() |
| void | изменениеТолщиныГраницы() |
| void | изменениеКисти() |
| void | нажатие() |
| void | изменениеЦвета() |
| void | двойноеНажатие() |
| void | наведениеНаКурсор(bool state) |
| void | изменениеКистиМетки() |
| void | изменениеМетки() |
| void | изменениеЦветаМетки() |
| void | изменениеШрифтаМетки() |
| void | изменениеВидимостиМетки() |
| void | изменениеПера() |
| void | изменениеПроцента() |
| void | нажатиеНажатия() |
| void | отжатие() |
| void | изменениеНачальногоУгла() |
| void | изменениеЗначения() |
Подробное описание
У куска пирога есть значение и метка. Когда кусок добавляется к ряду круговых диаграмм, объект 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
Это свойство содержит метку сектора.
Функции доступа:
| 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 : 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.1/qpieslice.html
