Spec-Zone.ru › Qt 6.1

Тип QML PieSlice

Представляет один сектор в круговой диаграмме. Подробнее...

Оператор импорта: import QtCharts 2.1
Создает: QPieSlice
  • Список всех членов, включая наследуемые

Свойства

  • angleSpan : real
  • borderColor : цвет
  • borderWidth : int
  • brushFilename : строка
  • color : цвет
  • explodeDistanceFactor : real
  • exploded : bool
  • label : строка
  • labelArmLengthFactor : real
  • labelColor : цвет
  • labelFont : шрифт
  • labelPosition : перечисление
  • labelVisible : bool
  • percentage : real
  • startAngle : real
  • value : real

Сигналы

  • clicked()
  • doubleClicked()
  • hovered(bool 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 : real

Длина сектора в градусах. Полная круговая диаграмма составляет 360 градусов, где 0 градусов находится в 12 часов. Обновляется автоматически после добавления сектора в диаграмму.

borderColor : цвет

Цвет, используемый для рисования границы сектора (цвет пера).

См. также borderWidth.

borderWidth : int

Ширина границы сектора. Это свойство для удобства изменения пера сектора.

См. также borderColor.

brushFilename : строка

Имя файла, используемого в качестве кисти для сектора.

color : цвет

Цвет заливки (кисти) сектора.

explodeDistanceFactor : real

Определяет, насколько далеко от круговой диаграммы отделен сектор.

  • 1.0 означает, что расстояние равно радиусу.
  • 0.5 означает, что расстояние равно половине радиуса.

По умолчанию расстояние составляет 0.15

См. также exploded.

exploded : bool

Отделен ли сектор от круговой диаграммы.

См. также explodeDistanceFactor.

label : строка

Метка сектора.

labelArmLengthFactor : real

Длина отрезка метки. Коэффициент относится к радиусу круговой диаграммы. Например:

  • 1.0 означает, что длина равна радиусу.
  • 0.5 означает, что длина равна половине радиуса.

По умолчанию длина отрезка составляет 0.15

См. также labelVisible.

labelColor : цвет

Цвет, используемый для рисования метки сектора.

labelFont : шрифт

Шрифт, используемый для метки сектора.

Дополнительную информацию см. в шрифте.

См. также labelVisible и labelPosition.

labelPosition : перечисление

Определяет положение метки сектора.

Константа Описание
PieSlice.LabelOutside Метка расположена вне сектора, соединенная с ним отрезком. Это значение по умолчанию.
PieSlice.LabelInsideHorizontal Метка центрирована внутри сектора и выровнена горизонтально.
PieSlice.LabelInsideTangential Метка центрирована внутри сектора и повернута параллельно касательной к дуге сектора.
PieSlice.LabelInsideNormal Метка центрирована внутри сектора и повернута параллельно нормали к дуге сектора.

См. также labelVisible.

labelVisible : bool

Видимость метки сектора. По умолчанию метка не видна.

percentage : real

Процент сектора по отношению к сумме всех секторов в диаграмме. Фактическое значение находится в диапазоне от 0,0 до 1,0. Обновляется автоматически после добавления сектора в диаграмму.

startAngle : real

Угол начала этого сектора в принадлежащей ему диаграмме. Полная круговая диаграмма составляет 360 градусов, где 0 градусов находится в 12 часов. Обновляется автоматически после добавления сектора в диаграмму.

value : real

Значение сектора.

Примечание: Отрицательное значение преобразуется в положительное.

Документация по сигналам

clicked()

Этот сигнал излучается при щелчке по сектору.

Соответствующий обработчик сигналов onClicked().

Примечание: Соответствующий обработчик onClicked.

doubleClicked()

Этот сигнал излучается при двойном щелчке по сектору.

Соответствующий обработчик сигналов onDoubleClicked().

Примечание: Соответствующий обработчик onDoubleClicked.

hovered(bool state)

Этот сигнал излучается при наведении курсора мыши на сектор. Когда курсор перемещается на сектор, state становится true, а когда курсор снова уходит, он становится false.

Соответствующий обработчик сигналов onHovered().

Примечание: Соответствующий обработчик onHovered.

pressed()

Этот сигнал излучается, когда пользователь нажимает на сектор и удерживает кнопку мыши.

Соответствующий обработчик сигналов onPressed().

Примечание: Соответствующий обработчик onPressed.

released()

Этот сигнал излучается, когда пользователь отпускает нажатие кнопки мыши на секторе.

Соответствующий обработчик сигналов onReleased().

Примечание: Соответствующий обработчик onReleased.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qml-qtcharts-pieslice.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API