Surface3D QML Type

Décrit l'utilisation du graphique de surface 3D. En savoir plus...

Ce type est obsolète. Nous 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

• axisX : ValueAxis3D
• axisY : ValueAxis3D
• axisZ : ValueAxis3D
• flipHorizontalGrid : bool (since QtDataVisualization 1.2)
• selectedSeries : Surface3DSeries
• seriesList : list<Surface3DSeries>

Méthodes

• void addSeries(Surface3DSeries series)
• void removeSeries(Surface3DSeries series)

Description détaillée

Ce type permet aux développeurs de générer des graphiques de surface 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 Surface3D dans vos fichiers QML :

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Surface3D {
        width: parent.width
        height: parent.height
        Surface3DSeries {
            itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
            ItemModelSurfaceDataProxy {
                itemModel: dataModel
                // Mapping model roles to surface series rows, columns, and values.
                rowRole: "longitude"
                columnRole: "latitude"
                yPosRole: "pop_density"
            }
        }
    }
    ListModel {
        id: dataModel
        ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
        ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
        ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
        ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
        ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
        ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
        ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
        ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
        ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
        ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
        ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
        ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
        ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
        ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
        ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
        ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
    }
}

Consultez la galerie de graphiques de surface pour des exemples d'utilisation plus complets.

Voir également Surface3DSeries, ItemModelSurfaceDataProxy, Bars3D, Scatter3D et Qt Data Visualization C++ Classes.

Documentation sur les propriétés

axisX : ValueAxis3D

L'axe x 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.

axisY : ValueAxis3D

L'axe y 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.

axisZ : ValueAxis3D

L'axe Z actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut, sans étiquette 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.

flipHorizontalGrid : bool [since QtDataVisualization 1.2]

Dans certains cas d'utilisation, la grille de l'axe horizontal est en grande partie recouverte par la surface ; il peut donc s'avérer plus pratique d'afficher cette grille au-dessus du graphique plutôt qu'en dessous. Un cas d'utilisation typique est l'affichage de spectrogrammes en 2D utilisant une projection orthographique avec une vue de dessus.

Si ` false`, la grille et les étiquettes de l’axe horizontal sont dessinées sur l’arrière-plan horizontal du graphique. Si ` true`, la grille et les étiquettes de l’axe horizontal sont dessinées du côté opposé au fond horizontal du graphique. La valeur par défaut est ` false`.

Cette propriété a été introduite dans QtDataVisualization 1.2.

selectedSeries : Surface3DSeries

La série sélectionnée ou la valeur null. Si l'objet ` selectionMode ` a le drapeau ` SelectionMultiSeries ` activé, cette propriété contient la série à laquelle appartient le point sélectionné.

seriesList : list<Surface3DSeries> [default]

Cette propriété contient 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.

Documentation des méthodes

void addSeries(Surface3DSeries series)

Ajoute l'series e au graphique.

Voir aussi AbstractGraph3D::hasSeries().

void removeSeries(Surface3DSeries series)

Supprime l'series e du graphe.

Voir aussi AbstractGraph3D::hasSeries().