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

clicked(PieSlice slice)

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

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

doubleClicked(PieSlice slice)

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

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

hovered(PieSlice slice, bool state)

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

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

pressed(PieSlice slice)

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

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

released(PieSlice slice)

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

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

removed(list<PieSlice> slices)

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

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

sliceAdded(PieSlice slice)

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

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

sliceRemoved(PieSlice slice)

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

Соответствующий обработчик сигнала 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, в противном случае.