Тип QML PieSeries

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

• Список всех членов, включая унаследованные

Свойства

• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• size : real
• startAngle : real
• sum : real
• verticalPosition : real

Сигналы

• added(list<PieSlice> slices)
• clicked(PieSlice slice)
• doubleClicked(PieSlice slice)
• hovered(PieSlice slice, bool state)
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceAdded(PieSlice slice)
• sliceRemoved(PieSlice slice)

Методы

• PieSlice append(string label, real value)
• PieSlice at(int index)
• clear()
• PieSlice find(string label)
• bool remove(PieSlice slice)

Подробное описание

Серия круговых диаграмм состоит из секторов, определённых с помощью типа PieSlice. У секторов могут быть любые значения, так как тип PieSeries рассчитывает процент сектора по сравнению со суммой всех секторов в серии, чтобы определить фактический размер сектора на диаграмме.

Размер и положение сектора на диаграмме контролируются с помощью относительных значений от 0,0 до 1,0. Они относятся к фактической области диаграммы.

По умолчанию круговая диаграмма определяется как полная. Неполную круговую диаграмму можно создать, установив начальный угол и размах угла для серии. Полная круговая диаграмма — это 360 градусов, где 0 градусов находится в 12 часов.

Следующий пример QML демонстрирует, как создать простую круговую диаграмму.

ChartView {
    id: chart
    title: "Top-5 car brand shares in Finland"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    PieSeries {
        id: pieSeries
        PieSlice { label: "Volkswagen"; value: 13.5 }
        PieSlice { label: "Toyota"; value: 10.9 }
        PieSlice { label: "Ford"; value: 8.6 }
        PieSlice { label: "Skoda"; value: 8.2 }
        PieSlice { label: "Volvo"; value: 6.8 }
    }
}

Component.onCompleted: {
    // You can also manipulate slices dynamically, like append a slice or set a slice exploded
    othersSlice = pieSeries.append("Others", 52.0);
    pieSeries.find("Volkswagen").exploded = true;
}

См. также PieSlice и ChartView.

Документация свойств

count : int

Количество секторов в серии.

endAngle : real

Конечный угол круговой диаграммы.

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

Значение по умолчанию — 360.

holeSize : real

Размер отверстия в диаграмме-кольце.

Значение относится к области диаграммы, таким образом:

• 0,0 — минимальный размер (полная круговая диаграмма без отверстия).
• 1,0 — максимальный размер, который может поместиться в области диаграммы (кольцо без ширины).

При установке этого свойства свойство size корректируется при необходимости, чтобы обеспечить, что размер отверстия не превышает размер круговой диаграммы.

Значение по умолчанию — 0,0.

horizontalPosition : real

Горизонтальное положение круговой диаграммы.

Значение относится к области диаграммы, таким образом:

• 0,0 — абсолютный левый край.
• 1,0 — абсолютный правый край.

Значение по умолчанию — 0,5 (центр).

См. также verticalPosition.

size : real

Размер круговой диаграммы.

Значение относится к области диаграммы, таким образом:

• 0,0 — минимальный размер (круговая диаграмма не отображается).
• 1,0 — максимальный размер, который может поместиться в области диаграммы.

При установке этого свойства свойство holeSize корректируется при необходимости, чтобы обеспечить, что размер отверстия не превышает размер круговой диаграммы.

Значение по умолчанию — 0,7.

startAngle : real

Начальный угол круговой диаграммы.

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

Значение по умолчанию — 0.

sum : real

Сумма всех секторов.

Серия отслеживает сумму всех секторов, которые она содержит.

verticalPosition : real

Вертикальное положение круговой диаграммы.

Значение относится к области диаграммы, таким образом:

• 0,0 — абсолютное верхнее положение.
• 1,0 — абсолютное нижнее положение.

Значение по умолчанию — 0,5 (центр).

См. также horizontalPosition.

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

added(list<PieSlice> slices)

Этот сигнал испускается, когда сектора, указанные в slices, добавляются к серии.

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

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

clicked(PieSlice slice)

Этот сигнал испускается, когда сектор, указанный в slice, нажат.

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

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

doubleClicked(PieSlice slice)

Этот сигнал испускается, когда сектор, указанный в slice, дважды нажат.

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

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

hovered(PieSlice slice, bool state)

Этот сигнал испускается, когда курсор мыши наведён на сектор, указанный в slice. Когда курсор наводится на сектор, state становится true, а когда курсор убирается, он становится false.

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

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

pressed(PieSlice slice)

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

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

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

released(PieSlice slice)

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

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

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

removed(list<PieSlice> slices)

Этот сигнал испускается, когда сектора, указанные в slices, удаляются из серии.

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

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

sliceAdded(PieSlice slice)

Этот сигнал испускается, когда сектор, указанный в slice, добавляется в серию.

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

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

sliceRemoved(PieSlice slice)

Этот сигнал испускается, когда сектор, указанный в slice, удаляется из серии.

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

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

Документация методов

PieSlice append(string label, real value)

Добавляет новый сектор с меткой label и значением value в круговую диаграмму.

PieSlice at(int index)

Возвращает сектор по указанному индексу index. Возвращает null, если индекс недействителен.

clear()

Удаляет все сектора из пирога.

PieSlice find(string label)

Возвращает первый сектор с меткой label. Возвращает null, если метка не найдена.

bool remove(PieSlice slice)

Удаляет сектор slice из пирога. Возвращает true если удаление прошло успешно, false в противном случае.