Bars3D QML Type

Graphique à barres en 3D. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Méthodes

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

Description détaillée

Ce type permet aux développeurs de rendre les graphiques à barres en 3D à l'aide de Qt Quick.

Vous devez importer le module de visualisation des données pour utiliser ce type :

import QtDataVisualization 1.2

Ensuite, vous pouvez utiliser Bars3D dans vos fichiers 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"; }
    }
}

Voir Simple Bar Graph pour un exemple d'utilisation plus complet.

Voir aussi Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, et Qt Data Visualization C++ Classes.

Documentation sur les propriétés

barSeriesMargin : size [since 6.3]

Marge entre les colonnes de la série dans les dimensions X et Z. La valeur par défaut est (0.0, 0.0). Les valeurs raisonnables se situent dans l'intervalle [0,1].

Cette propriété a été introduite dans Qt 6.3.

barSpacing : size

Espacement des barres dans les dimensions X et Z.

La valeur par défaut est (1.0, 1.0). L'espacement est affecté par la propriété barSpacingRelative.

barSpacingRelative : bool

Si l'espacement est absolu ou relatif à l'épaisseur de la barre.

Si true, la valeur de 0.0 signifie que les barres sont placées côte à côte, 1.0 signifie qu'un espace aussi large que l'épaisseur d'une barre est laissé entre les barres, et ainsi de suite. Préréglé sur true.

barThickness : real

Le rapport d'épaisseur de la barre entre les dimensions X et Z. La valeur 1.0 signifie que les barres sont aussi larges que profondes, tandis que 0.5 les rend deux fois plus profondes que larges.

columnAxis : CategoryAxis3D

L'axe de la colonne active.

Si aucun axe n'est fourni, un axe temporaire par défaut sans étiquette est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

floorLevel : real

Le niveau de l'étage pour le graphique à barres dans les coordonnées des données de l'axe des Y.

Le niveau réel sera limité par les valeurs minimales et maximales de l'axe des Y. La valeur par défaut est zéro.

multiSeriesUniform : bool

Définit si les barres doivent être mises à l'échelle avec des proportions définies pour une barre de série unique, même si plusieurs séries sont affichées. Si la valeur est true, bar spacing ne sera correctement appliqué qu'à l'axe des X. La valeur par défaut est false.

primarySeries : Bar3DSeries

La série primaire du graphique. Elle est utilisée pour déterminer les étiquettes des axes des lignes et des colonnes lorsque les étiquettes ne sont pas explicitement définies pour les axes.

Si la série spécifiée n'est pas encore ajoutée au graphique, le fait de la définir comme série primaire l'ajoutera implicitement au graphique.

Si la série primaire elle-même est supprimée du graphique, cette propriété reprend sa valeur par défaut.

Si la série est nulle, cette propriété est réinitialisée par défaut. La valeur par défaut est la première série ajoutée ou zéro si aucune série n'est ajoutée au graphique.

rowAxis : CategoryAxis3D

L'axe de la ligne active.

Si aucun axe n'est fourni, un axe temporaire par défaut sans étiquette est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

selectedSeries : Bar3DSeries

La série sélectionnée ou null. Si selectionMode a l'indicateur SelectionMultiSeries activé, cette propriété contient la série qui possède la barre sélectionnée.

seriesList : list<Bar3DSeries> [default]

Les séries du graphique. Par défaut, cette propriété contient une liste vide. Pour définir les séries, il faut soit utiliser la fonction addSeries(), soit les définir en tant qu'enfants du graphique.

valueAxis : ValueAxis3D

L'axe de valeur actif.

Si aucun axe n'est fourni, un axe temporaire par défaut, sans étiquette et avec une plage d'ajustement automatique, est créé. Cet axe temporaire est détruit si un autre axe est explicitement défini avec la même orientation.

Documentation de la méthode

void addSeries(Bar3DSeries series)

Ajoute le site series au graphique. Un graphique peut contenir plusieurs séries, mais un seul ensemble d'axes, de sorte que les lignes et les colonnes de toutes les séries doivent correspondre pour que les données visualisées soient significatives. Si le graphique contient plusieurs séries visibles, seule la première série ajoutée génère les étiquettes de ligne ou de colonne sur les axes dans les cas où les étiquettes ne sont pas explicitement définies sur les axes. Si la série nouvellement ajoutée a spécifié une barre sélectionnée, celle-ci sera mise en évidence et toute sélection existante sera effacée. Une seule série ajoutée peut avoir une sélection active.

Voir également AbstractGraph3D::hasSeries().

void insertSeries(int index, Bar3DSeries series)

Insère le series à la position index dans la liste des séries. Si la série series a déjà été ajoutée à la liste, elle est déplacée vers la nouvelle index.

Voir aussi AbstractGraph3D::hasSeries().

void removeSeries(Bar3DSeries series)

Supprimez le site series du graphique.

Voir aussi AbstractGraph3D::hasSeries().