Тип QML AbstractBarSeries

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

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

Свойства

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : перечисление
• 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.

labelsVisible : bool

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

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

barsetsAdded()

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

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

barsetsRemoved()

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

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

clicked(int index, BarSet barset)

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

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

doubleClicked(int index, BarSet barset)

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

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

hovered(bool status, int index, BarSet barset)

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

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

pressed(int index, BarSet barset)

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

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

released(int index, BarSet barset)

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

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