Тип QML Bars3D

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

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

Свойства

• barSpacing : size
• 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 : 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, это свойство содержит серию, которой принадлежит выделенный столбец.

[по умолчанию] 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 с графика.