Тип QML AbstractBarSeries

Абстрактный родительский тип для всех типов рядов столбцов. Подробнее...

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

Свойства

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : перечисление
• labelsPrecision : real
• labelsVisible : bool

Сигналы

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

Методы

• BarSet append(string label, VariantList values)
• BarSet at(int index)
• clear()
• BarSet insert(int index, string label, VariantList values)
• bool remove(BarSet barset)

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

В столбиковых диаграммах столбцы определяются как наборы столбцов, которые содержат одно значение данных для каждой категории. Положение столбца определяется категорией, а его высота — значением данных. Ряды столбцов, содержащие несколько наборов столбцов, группируют вместе столбцы, принадлежащие одной и той же категории. Способ отображения столбцов определяется типом, выбранным для создания столбиковой диаграммы: BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries или HorizontalPercentBarSeries.

Если вместо типа BarCategoryAxis используется тип ValueAxis для основной оси столбцов, столбцы группируются вокруг значения индекса категории.

Следующий фрагмент QML показывает, как использовать тип BarSeries и BarCategoryAxis для создания простой столбиковой диаграммы:

ChartView {
    title: "Bar series"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}

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

axisX : AbstractAxis

Ось X, используемая для ряда. Если оба axisX и axisXTop не определены, для ряда создаётся BarCategoryAxis.

См. также axisXTop.

axisXTop : AbstractAxis

Ось X, используемая для ряда, нарисованная сверху области просмотра диаграммы.

Примечание: Вы можете указать только axisX или axisXTop, но не оба.

См. также axisX.

axisY : AbstractAxis

Ось Y, используемая для ряда. Если оба axisY и axisYRight не определены, для ряда создаётся ValueAxis.

См. также axisYRight.

axisYRight : AbstractAxis

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

Примечание: Вы можете указать только axisY или axisYRight, но не оба.

См. также axisY.

barWidth : real

Единицей измерения ширины является единица измерения оси X. Минимальная ширина столбцов равна нулю, а отрицательные значения обрабатываются как ноль. Установка ширины в ноль означает, что ширина столбца на экране составляет один пиксель независимо от масштаба оси X. Столбцы шириной больше нуля масштабируются с использованием масштаба оси X.

Примечание: При использовании с типом BarSeries это значение определяет ширину группы столбцов, а не одного столбца.

count : int

Количество наборов столбцов в ряде столбцов.

labelsAngle : real

Угол меток значений в градусах.

labelsFormat : string

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

См. также QAbstractBarSeries::labelsFormat, labelsVisible и labelsPosition.

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

Положение меток значений данных:

См. также labelsVisible и labelsFormat.

labelsPrecision : real

Максимальное количество значащих цифр, отображаемых в метках значений.

Значение по умолчанию равно 6.

labelsVisible : bool

Видимость меток в ряде столбцов.

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

barsetsAdded()

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

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

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

barsetsRemoved()

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

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

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

clicked(int index, BarSet barset)

Этот сигнал испускается при нажатии пользователем столбца, указанного параметром index, в наборе столбцов, указанном параметром barset.

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

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

doubleClicked(int index, BarSet barset)

Этот сигнал испускается, когда пользователь дважды щелкает по столбцу, указанному index, в наборе столбцов, указанном barset.

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

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

hovered(bool status, int index, BarSet barset)

Этот сигнал испускается, когда курсор мыши наведён на столбец, указанный index, в наборе столбцов, указанном barset. При перемещении мыши над столбцом, status становится true, а при перемещении мыши с столбца — false.

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

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

pressed(int index, BarSet barset)

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

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

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

released(int index, BarSet barset)

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

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

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

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

BarSet append(string label, VariantList values)

Добавляет новый набор столбцов с label и values в индекс. values — список вещественных значений.

Например:

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

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

clear()

Удаляет все наборы столбцов из ряда.

BarSet insert(int index, string label, VariantList values)

Добавляет новый набор столбцов с label и values в index. values может быть списком вещественных значений или списком типов XYPoint.

Если значение индекса равно или меньше нуля, новый набор столбцов добавляется в начало ряда. Если значение индекса равно или больше числа наборов столбцов в ряду столбцов, новый набор столбцов добавляется в конец ряда.

См. также append().

bool remove(BarSet barset)

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