Bars3D QML Type

Diagramme à barres en 3D. En savoir plus...

Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

• 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 d'afficher des graphiques à barres en 3D à l'aide de Qt Quick.

Pour utiliser ce type, vous devrez importer le module de visualisation des données :

import QtDataVisualization 1.2

Vous pourrez ensuite 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"; }
    }
}

Consultez la section « Graphique à barres simple » pour un exemple d'utilisation plus complet.

Voir également 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 d'une série dans les dimensions X et Z. Valeur par défaut : (0.0, 0.0). Les valeurs recommandées se situent dans l'intervalle [0, 1).

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

barSpacing : size

Espacement des barres dans les axes X et Z.

Réglé par défaut sur (1.0, 1.0). L'espacement est influencé par la propriété « barSpacingRelative ».

barSpacingRelative : bool

Si l'espacement est absolu ou relatif à l'épaisseur des barres.

Si l'true, la valeur « 0.0 » signifie que les barres sont placées côte à côte, « 1.0 » signifie qu'un espace égal à l'épaisseur d'une barre est laissé entre les barres, et ainsi de suite. La valeur par défaut est « true ».

barThickness : real

Rapport d'épaisseur des barres entre les dimensions X et Z. La valeur « 1.0 » signifie que les barres ont une largeur égale à leur profondeur, tandis que « 0.5 » indique qu'elles sont deux fois plus profondes que larges.

columnAxis : CategoryAxis3D

L'axe de colonne actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est supprimé si un autre axe est explicitement défini avec la même orientation.

floorLevel : real

Niveau de base du graphique à barres dans les coordonnées de l'axe Y.

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

multiSeriesUniform : bool

Détermine si les barres doivent être mises à l'échelle en respectant les proportions d'une seule série, même si plusieurs séries sont affichées. Si l'option « true » est sélectionnée, la fonction « bar spacing » ne s'appliquera correctement qu'à l'axe X. La valeur par défaut est « false ».

primarySeries : Bar3DSeries

La série principale du graphique. Elle sert à déterminer les libellés des axes des lignes et des colonnes lorsque ceux-ci ne sont pas explicitement définis sur 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 principale l'ajoutera implicitement au graphique.

Si la série principale 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é reprend sa valeur par défaut. La valeur par défaut est la première série ajoutée ou zéro si aucune série n’a été ajoutée au graphique.

rowAxis : CategoryAxis3D

L'axe des lignes actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est supprimé 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 comporte le drapeau SelectionMultiSeries, cette propriété contient la série à laquelle appartient 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, utilisez la fonction ` addSeries()` ou définissez-les en tant qu'éléments enfants du graphique.

valueAxis : ValueAxis3D

L'axe des valeurs actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut, sans étiquettes et dont la plage s'ajuste automatiquement, est créé. Cet axe temporaire est supprimé si un autre axe est explicitement défini avec la même orientation.

Documentation de la méthode

void addSeries(Bar3DSeries series)

Ajoute l'series e au graphique. Un graphique peut contenir plusieurs séries, mais un seul jeu d'axes ; les lignes et les colonnes de toutes les séries doivent donc correspondre pour que les données visualisées aient un sens. Si le graphique comporte plusieurs séries visibles, seule la première série ajoutée générera les étiquettes de ligne ou de colonne sur les axes lorsque celles-ci 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 surbrillance 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 l'series à la position index dans la liste des séries. Si l'series a déjà été ajoutée à la liste, elle est déplacée vers la nouvelle index.

Voir également AbstractGraph3D::hasSeries().

void removeSeries(Bar3DSeries series)

Supprimez l'series e du graphique.

Voir aussi AbstractGraph3D::hasSeries().