Тип QML Bars3D

3D столбчатая диаграмма. Подробнее...

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

Свойства

• barSpacing : размер
• barSpacingRelative : bool
• barThickness : вещественное
• columnAxis : CategoryAxis3D
• floorLevel : вещественное
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : список<Bar3DSeries>
• valueAxis : ValueAxis3D

Методы

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

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

Этот тип позволяет разработчикам отображать столбчатые диаграммы в 3D с помощью Qt Quick 2.

Для использования этого типа необходимо импортировать модуль визуализации данных:

import QtDataVisualization 1.2

После этого вы можете использовать Bars3D в своих файлах qml:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

См. Пример диаграммы Qt Quick 2 Bars для более подробного примера использования.

См. также Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D и Классы Qt Data Visualization на C++.

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

barSpacing : размер

Отступ между столбцами по осям X и Z.

По умолчанию установлено значение (1.0, 1.0). Отступ зависит от свойства barSpacingRelative.

barSpacingRelative : bool

Указывает, является ли отступ абсолютным или относительным к толщине столбцов.

Если true, то значение 0.0 означает, что столбцы расположены вплотную, 1.0 означает, что между столбцами оставлен промежуток, равный толщине одного столбца, и так далее. По умолчанию установлено значение true.

barThickness : вещественное

Отношение толщины столбца по осям X и Z. Значение 1.0 означает, что столбцы имеют одинаковую ширину и глубину, а значение 0.5 делает их в два раза глубже, чем шире.

columnAxis : CategoryAxis3D

Активная ось столбцов.

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

floorLevel : вещественное

Уровень пола для столбчатой диаграммы в координатах данных оси Y.

Фактический уровень пола будет ограничен минимальными и максимальными значениями оси Y. По умолчанию ноль.

multiSeriesUniform : bool

Определяет, должны ли столбцы масштабироваться с пропорциями, установленными для столбца одного ряда, даже если отображается несколько рядов. Если установлено true, отступ столбцов bar spacing будет правильно применяться только к оси X. По умолчанию установлено false.

primarySeries : Bar3DSeries

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

Если указанный ряд еще не добавлен на график, его назначение в качестве основного ряда также подразумевает его добавление на график.

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

Если ряд равен null, это свойство сбрасывается до значения по умолчанию. По умолчанию равен первому добавленному ряду или нулю, если на график не добавлены ряды.

rowAxis : CategoryAxis3D

Активная ось строк.

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

selectedSeries : Bar3DSeries

Выбранный ряд или null. Если selectionMode содержит установленный флаг SelectionMultiSeries, это свойство содержит ряд, который владеет выбранным столбцом.

[default] seriesList : список<Bar3DSeries>

Ряды графика. По умолчанию это свойство содержит пустой список. Для задания рядов используйте функцию addSeries() или определите их как дочерние элементы графика.

valueAxis : ValueAxis3D

Активная ось значений.

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

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

void addSeries(Bar3DSeries series)

Добавляет series на график. График может содержать несколько рядов, но только один набор осей, поэтому строки и столбцы всех рядов должны совпадать для того, чтобы визуализированные данные имели смысл. Если на графике несколько видимых рядов, только первый добавленный ряд создаст метки строк или столбцов на осях в тех случаях, когда метки не заданы явно для осей. Если новый добавленный ряд имеет указанный выбранный столбец, он будет выделен, и любое существующее выделение будет очищено. Только один добавленный ряд может иметь активное выделение.

void insertSeries(int index, Bar3DSeries series)

Вставляет series в позицию index в списке рядов. Если series уже добавлен в список, он перемещается в новую index.

Примечание: При перемещении ряда в новую index, которая находится после его старой индексации, новая позиция в списке вычисляется так, как если бы ряд всё ещё находился на его старой индексе, поэтому окончательный индекс фактически является index, уменьшенным на единицу.

void removeSeries(Bar3DSeries series)

Удаляет series с графика.