Sur cette page

Scatter3D QML Type

Graphique de dispersion en 3D. En savoir plus...

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

AbstractGraph3D

Status: Deprecated

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

Propriétés

Méthodes

Description détaillée

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

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Scatter3D {
        width: parent.width
        height: parent.height
        Scatter3DSeries {
            ItemModelScatterDataProxy {
                itemModel: dataModel
                // Mapping model roles to scatter series item coordinates.
                xPosRole: "xPos"
                yPosRole: "yPos"
                zPosRole: "zPos"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ xPos: "2.754"; yPos: "1.455"; zPos: "3.362"; }
        ListElement{ xPos: "3.164"; yPos: "2.022"; zPos: "4.348"; }
        ListElement{ xPos: "4.564"; yPos: "1.865"; zPos: "1.346"; }
        ListElement{ xPos: "1.068"; yPos: "1.224"; zPos: "2.983"; }
        ListElement{ xPos: "2.323"; yPos: "2.502"; zPos: "3.133"; }
    }
}

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

Voir également Scatter3DSeries, ScatterDataProxy, Bars3D, Surface3D 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.

selectedSeries : Scatter3DSeries

La série sélectionnée ou la valeur nulle.

seriesList : list<Scatter3DSeries> [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 méthode addSeries() ou définissez-les en tant qu’enfants du graphique.

Documentation de la méthode

void addSeries(Scatter3DSeries series)

Ajoute la série « series » au graphique. Un graphique peut contenir plusieurs séries, mais ne dispose que d’un seul jeu d’axes. Si la série nouvellement ajoutée comporte un élément sélectionné, celui-ci sera mis en surbrillance et toute sélection existante sera désélectionnée. Une seule série ajoutée peut faire l’objet d’une sélection active.

Voir également AbstractGraph3D::hasSeries().

void removeSeries(Scatter3DSeries series)

Supprimez l'series e 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.