Тип 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)

Добавляет новый сектор с меткой метка и значением значение в пирог.

PieSlice at(int индекс)

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

clear()

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

PieSlice find(string метка)

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

bool remove(PieSlice сектор)

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