Тип QML PieSlice
Представляет один сектор в серии круговой диаграммы. Подробнее...
| Заявление об импорте: | import QtCharts 2.2 |
| Инициализирует: | QPieSlice |
Свойства
- angleSpan : вещественное число
- borderColor : цвет
- borderWidth : целое число
- brushFilename : строка
- color : цвет
- explodeDistanceFactor : вещественное число
- exploded : логическое значение
- label : строка
- labelArmLengthFactor : вещественное число
- labelColor : цвет
- labelFont : шрифт
- labelPosition : перечисление
- labelVisible : логическое значение
- percentage : вещественное число
- startAngle : вещественное число
- value : вещественное число
Сигналы
- clicked()
- doubleClicked()
- hovered(логическое значение state)
- pressed()
- released()
Подробное описание
Сектор круговой диаграммы имеет значение и метку. При добавлении сектора в серию круговой диаграммы, тип PieSeries вычисляет процент сектора по сравнению с суммой всех секторов в серии, чтобы определить фактический размер сектора в диаграмме.
По умолчанию метка скрыта. Если она видимая, она может быть расположена за пределами сектора и соединена с ним с помощью линии или расположена в центре сектора, либо горизонтально, либо параллельно касательной или нормали дуги сектора.
По умолчанию визуальный вид сектора устанавливается темой, но тема может быть переопределена путем задания свойств сектора. Однако, если тема изменяется после настройки секторов, вся настройка будет потеряна.
Тип PieSlice должен использоваться в качестве дочернего элемента типа PieSeries. Например:
PieSeries {
id: pieSeries
PieSlice { label: "eaten"; value: 94.9 }
PieSlice { label: "not yet eaten"; value: 5.1 }
} В качестве альтернативы, сектора можно добавить к серии круговой диаграммы, используя метод PieSeries.append().
pieSeries.append("don't care", 1.1); В этом случае, PieSeries.at() или PieSeries.find можно использовать для доступа к свойствам отдельной инстанции PieSlice.
pieSeries.at(0).exploded = true;
См. также PieSeries.
Документация по свойствам
angleSpan : вещественное число
Угол сектора в градусах. Полная круговая диаграмма составляет 360 градусов, где 0 градусов находится в 12 часов. Автоматически обновляется после добавления сектора в серию.
borderColor : цвет
Цвет, используемый для рисования границы сектора (цвет пера).
См. также borderWidth.
borderWidth : целое число
Ширина границы сектора. Это удобное свойство для изменения пера сектора.
См. также borderColor.
brushFilename : строка
Имя файла, используемого в качестве кисти для сектора.
color : цвет
Цвет заливки (кисти) сектора.
explodeDistanceFactor : вещественное число
Определяет, насколько далеко от круговой диаграммы отделяется сектор.
- 1.0 означает, что расстояние равно радиусу.
- 0.5 означает, что расстояние равно половине радиуса.
По умолчанию расстояние равно 0,15
См. также exploded.
exploded : логическое значение
Указывает, отделен ли сектор от круговой диаграммы.
См. также explodeDistanceFactor.
label : строка
Метка сектора.
labelArmLengthFactor : вещественное число
Длина линии метки. Коэффициент относится к радиусу круговой диаграммы. Например:
- 1.0 означает, что длина равна радиусу.
- 0.5 означает, что длина равна половине радиуса.
По умолчанию длина линии равна 0,15
См. также labelVisible.
labelColor : цвет
Цвет, используемый для рисования метки сектора.
labelFont : шрифт
Шрифт, используемый для метки сектора.
Для получения дополнительной информации см. font.
См. также labelVisible и labelPosition.
labelPosition : перечисление
Описание положения метки сектора.
| Константа | Описание |
|---|---|
PieSlice.LabelOutside |
Метка расположена за пределами сектора, соединенная с ним линией. Это значение по умолчанию. |
PieSlice.LabelInsideHorizontal |
Метка расположена в центре сектора и выровнена по горизонтали. |
PieSlice.LabelInsideTangential |
Метка расположена в центре сектора и повернута, чтобы быть параллельной касательной дуги сектора. |
PieSlice.LabelInsideNormal |
Метка расположена в центре сектора и повернута, чтобы быть параллельной нормали дуги сектора. |
См. также labelVisible.
labelVisible : логическое значение
Видимость метки сектора. По умолчанию метка не отображается.
percentage : вещественное число
Процент сектора по отношению к сумме всех секторов в серии. Фактическое значение находится в диапазоне от 0,0 до 1,0. Автоматически обновляется после добавления сектора в серию.
startAngle : вещественное число
Угол начала этого сектора в серии, к которой он принадлежит. Полная круговая диаграмма составляет 360 градусов, где 0 градусов находится в 12 часов. Автоматически обновляется после добавления сектора в серию.
value : вещественное число
Значение сектора.
Примечание: Отрицательное значение преобразуется в положительное.
Документация по сигналам
clicked()
Этот сигнал генерируется, когда сектор нажат.
Соответствующая обработчик сигналов onClicked().
doubleClicked()
Этот сигнал генерируется, когда пользователь дважды щелкает сектор.
Соответствующая обработчик сигналов onDoubleClicked().
hovered(логическое значение state)
Этот сигнал генерируется, когда курсор мыши находится над сектором. При перемещении курсора мыши на сектор, state принимает значение true, а при повторном перемещении курсора мыши с сектора, принимает значение false.
Соответствующая обработчик сигналов onHovered().
pressed()
Этот сигнал генерируется, когда пользователь нажимает на сектор и удерживает нажатой кнопку мыши.
Соответствующая обработчик сигналов onPressed().
released()
Этот сигнал генерируется, когда пользователь отпускает кнопку мыши, нажатой на сектор.
Соответствующая обработчик сигналов onReleased().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtcharts-pieslice.html