Тип Bars3D QML

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 для более подробного примера использования.

См. также 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 с графика.