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

axisY : AbstractAxis

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

См. также axisYRight.

axisYRight : AbstractAxis

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

См. также axisY.

barWidth : real

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

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, в противном случае.