Sur cette page

Surface3D QML Type

Décrit l'utilisation du graphe de surface 3D. Plus d'informations...

Import Statement: import QtDataVisualization 1.11
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Propriétés

Méthodes

Description détaillée

Ce type permet aux développeurs de rendre des graphiques de surface 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 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"; }
    }
}

Voir la galerie de graphiques de surface pour un exemple d'utilisation plus complet.

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

Documentation sur les propriétés

axisX : ValueAxis3D

L'axe des x actif.

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

axisY : ValueAxis3D

L'axe des ordonnées actif.

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

axisZ : ValueAxis3D

L'axe z actif.

Si aucun axe n'est fourni, un axe temporaire par défaut, sans étiquette et avec une plage qui s'ajuste automatiquement, est créé. Cet axe temporaire est détruit 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 principalement couverte par la surface, il peut donc être plus utile d'afficher la grille de l'axe horizontal en haut du graphique plutôt qu'en bas. Un cas d'utilisation typique est l'affichage de spectrogrammes en 2D à l'aide de la projection orthographique avec un point de vue du haut vers le bas.

Si false, la grille de l'axe horizontal et les étiquettes sont dessinées sur le fond horizontal du graphique. Si true, la grille et les étiquettes de l'axe horizontal sont dessinées sur le côté opposé du graphique par rapport à l'arrière-plan horizontal. 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 null. Si l'indicateur SelectionMultiSeries est activé sur selectionMode, cette propriété contient la série qui possède 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'enfants du graphique.

Documentation de la méthode

void addSeries(Surface3DSeries series)

Ajoute le site series au graphique.

Voir aussi AbstractGraph3D::hasSeries().

void removeSeries(Surface3DSeries series)

Supprime le site series du graphique.

Voir aussi AbstractGraph3D::hasSeries().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.