Тип Bars3D QML

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(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 : размер

Отступ между столбцами по осям 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, расстояние между столбцами будет правильно применено только к оси X. По умолчанию установлено значение false.

primarySeries : Bar3DSeries

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

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

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

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

rowAxis : CategoryAxis3D

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

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

selectedSeries : Bar3DSeries

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

[по умолчанию] seriesList : список<Bar3DSeries>

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

valueAxis : ValueAxis3D

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

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

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

void addSeries(series)

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

void insertSeries(index, Bar3DSeries series)

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

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

void removeSeries(series)

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