Тип Bars3D QML

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

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

Свойства

• barSpacing : size
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : list<Bar3DSeries>
• valueAxis : ValueAxis3D

Методы

• void addSeries(series)
• void insertSeries(index, Bar3DSeries series)
• void removeSeries(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 : size

Отступ между столбцами по осям 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 установлен флаг SelectionMultiSeries, это свойство содержит ряд, к которому принадлежит выбранный столбец.

[default] seriesList : list<Bar3DSeries>

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

valueAxis : ValueAxis3D

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

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

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

void addSeries(series)

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

void insertSeries(index, Bar3DSeries series)

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

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

void removeSeries(series)

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