Тип 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, отступ между столбцами будет корректно применен только к оси X. По умолчанию установлено значение false.

primarySeries : Bar3DSeries

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

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

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

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

rowAxis : CategoryAxis3D

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

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

selectedSeries : Bar3DSeries

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

[по умолчанию] seriesList : список<Bar3DSeries>

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

valueAxis : ValueAxis3D

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

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

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

void addSeries(Bar3DSeries series)

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

void insertSeries(int index, Bar3DSeries series)

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

void removeSeries(Bar3DSeries series)

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