Тип Bars3D QML

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

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

Свойства

• barSpacing : размер
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• 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 : real

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

columnAxis : CategoryAxis3D

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

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

floorLevel : real

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

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

multiSeriesUniform : bool

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

primarySeries : Bar3DSeries

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

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

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

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

rowAxis : CategoryAxis3D

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

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

selectedSeries : Bar3DSeries

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

seriesList : список<Bar3DSeries>

\qmldefaultРяды графика. По умолчанию это свойство содержит пустой список. Чтобы установить ряды, используйте функцию 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 из графика.