Класс QPieSlice
Класс QPieSlice представляет собой один сектор в диаграмме круговой диаграммы. Подробнее...
| Заголовок: | #include <QPieSlice> |
| Создается из: | PieSlice |
| Наследуется от: | QObject |
Публичные типы
| Перечисление | ПоложениеМетки { МеткаСнаружи, МеткаВнутриГоризонтально, МеткаВнутриКасательно, МеткаВнутриНормально } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Общедоступные функции
| QPieSlice(QObject *parent = Q_NULLPTR) | |
| QPieSlice(QString label, qreal value, QObject *parent = Q_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 |
| LabelPosition | позицияМетки() |
| QPen | штрих() const |
| qreal | процент() const |
| QPieSeries * | series() const |
| void | установитьЦветОбводки(QColor color) |
| void | установитьТолщинуОбводки(int width) |
| void | установитьЗаливку(const QBrush &brush) |
| void | установитьЦвет(QColor color) |
| void | установитьКоэффициентОтступыВзорванности(qreal factor) |
| void | установитьВзорванным(bool exploded = true) |
| void | установитьМетку(QString label) |
| void | установитьКоэффициентДлиныСтрелкиМетки(qreal factor) |
| void | установитьЗаливкуМетки(const QBrush &brush) |
| void | установитьЦветМетки(QColor color) |
| void | установитьШрифтМетки(const QFont &font) |
| void | установитьПозициюМетки(LabelPosition position) |
| void | установитьМеткуВидимой(bool visible = true) |
| void | установитьШтрих(const QPen &pen) |
| void | установитьЗначение(qreal value) |
| qreal | начальныйУгол() const |
| qreal | значение() const |
- 32 общедоступных функции унаследованы от QObject
Сигналы
| 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() |
- 2 сигнала унаследованы от QObject
Дополнительные унаследованные члены
- 1 открытый слот унаследован от QObject
- 11 статических открытых членов унаследованных от QObject
- 9 защищенных функций унаследованных от QObject
Подробное описание
Класс QPieSlice представляет собой одиночный сектор в серии круговой диаграммы.
Сектор круговой диаграммы имеет значение и метку. При добавлении сектора в серию круговой диаграммы объект QPieSeries вычисляет процент сектора по отношению к сумме всех секторов в серии, чтобы определить фактический размер сектора в диаграмме.
По умолчанию метка скрыта. Если она видна, то она может быть расположена вне сектора и соединена с ним отрезком или расположена внутри сектора, либо горизонтально, либо параллельно касательной или нормали дуги сектора.
По умолчанию визуальный вид сектора устанавливается темой, но тема может быть переопределена с помощью свойств сектора. Однако, если тема меняется после того, как сектора настроены, все настройки будут утеряны.
Для включения взаимодействия пользователя с круговой диаграммой при наведении курсора мыши на сектор или щелчке по нему генерируются некоторые базовые сигналы.
См. также QPieSeries.
Документация по типам членов
enum QPieSlice::LabelPosition
Этот перечисление описывает положение метки сектора.
| Константа | Значение | Описание |
|---|---|---|
QPieSlice::LabelOutside |
0 |
Метка расположена вне сектора, соединённая с ним отрезком. Это значение по умолчанию. |
QPieSlice::LabelInsideHorizontal |
1 |
Метка расположена внутри сектора и ориентирована горизонтально. |
QPieSlice::LabelInsideTangential |
2 |
Метка расположена внутри сектора и повернута параллельно касательной к дуге сектора. |
QPieSlice::LabelInsideNormal |
3 |
Метка расположена внутри сектора и повернута параллельно нормали к дуге сектора. |
Документация свойств
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() |
См. также label, labelVisible и labelArmLengthFactor.
labelPosition : LabelPosition
Это свойство определяет положение метки среза.
Функции доступа:
| LabelPosition | labelPosition() |
| void | setLabelPosition(LabelPosition position) |
См. также label и labelVisible.
labelVisible : bool
Это свойство определяет видимость метки среза. По умолчанию метка невидима.
Функции доступа:
| bool | isLabelVisible() const |
| void | setLabelVisible(bool visible = true) |
Сигнал уведомления:
| void | labelVisibleChanged() |
См. также label, labelBrush, labelFont и labelArmLengthFactor.
pen : QPen
Это свойство содержит перо, используемое для рисования границы среза.
Функции доступа:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
Сигнал уведомления:
| void | penChanged() |
percentage : const qreal
Это свойство содержит процентное отношение среза к сумме всех срезов в серии. Фактическое значение находится в диапазоне от 0,0 до 1,0. Обновляется автоматически после добавления среза в серию.
Функции доступа:
| qreal | percentage() const |
Сигнал уведомления:
| void | percentageChanged() |
См. также value и QPieSeries::sum.
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(QObject *parent = Q_NULLPTR)
Создаёт пустой срез с родителем parent.
См. также QPieSeries::append() и QPieSeries::insert().
QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = Q_NULLPTR)
Создаёт пустой срез со значением value, меткой label и родителем parent.
См. также QPieSeries::append() и QPieSeries::insert().
[virtual] QPieSlice::~QPieSlice()
Удаляет срез. Срез не должен удаляться, если он добавлен в серию.
[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().
QPieSeries *QPieSlice::series() const
Возвращает серию, к которой принадлежит этот сегмент.
См. также QPieSeries::append().
[signal] void QPieSlice::startAngleChanged()
Этот сигнал испускается, когда изменяется начальный угол сегмента.
Примечание: Сигнал-уведомитель для свойства startAngle.
См. также startAngle.
[signal] void QPieSlice::valueChanged()
Этот сигнал испускается, когда изменяется значение сегмента.
Примечание: Сигнал-уведомитель для свойства value.
См. также value.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qpieslice.html
