Spec-Zone.ru › Qt

Тип QML PieSlice

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

Заявление об импорте: import QtCharts
Создаёт: 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 : строка

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

Примечание: Строка может быть отформатирована в HTML.

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.2/qml-qtcharts-pieslice.html

Spec-Zone.ru

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