Тип 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 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, новое положение в списке рассчитывается так, как если бы ряд все еще находился в своей старой index, поэтому окончательная index фактически index уменьшенная на единицу.

void removeSeries(Bar3DSeries series)

Удаляет series из диаграммы.