Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Surface3D QML Type

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

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

Propriétés

Signaux

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 Qt Graphs pour utiliser ce type :

import QtGraphs

Ensuite, vous pouvez utiliser Surface3D dans vos fichiers qml :

import QtQuick
import QtGraphs

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"
            }
        }

        onTapped: {
            // Disable the default input handler
            unsetDefaultTapHandler()
            // Implement own custom event handler
            console.log("Custom tap event handler")
        }
    }
    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 Graphs C++ Classes for 3D.

Documentation sur les propriétés

ambientLightStrength : real

L'intensité de la lumière ambiante pour l'ensemble du graphique. Cette valeur détermine l'uniformité et la luminosité des couleurs sur l'ensemble du graphique, quelle que soit la position de la lumière. La valeur doit être comprise entre 0.0 et 1.0.

aspectRatio : real

Le rapport d'échelle du graphique entre l'axe le plus long sur le plan horizontal et l'axe des ordonnées. La valeur par défaut est 2.0.

Remarque : n'a aucun effet sur Bars3D.

Voir aussi horizontalAspectRatio.

axisX : Value3DAxis

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 : Value3DAxis

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 : Value3DAxis

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.

cameraPreset : Graphs3D.CameraPreset

Le préréglage de la caméra actuellement actif, qui est l'un des suivants : Graphs3D.CameraPreset. Si aucun préréglage n'est actif, la valeur est Graphs3D.CameraPreset.NoPreset.

cameraTargetPosition : vector3d

La cible de la caméra sous forme de vector3d. La valeur par défaut est vector3d(0.0, 0.0, 0.0).

Les valeurs de coordonnées valides sont comprises entre -1.0...1.0, où les valeurs de bord indiquent les bords de la plage d'axes correspondante. Toute valeur en dehors de cette plage est fixée au bord.

cameraXRotation : real

Angle de rotation X de la caméra autour du point cible, en degrés, à partir de la position de base actuelle.

cameraYRotation : real

Angle de rotation Y de la caméra autour du point cible, en degrés, à partir de la position de base actuelle.

cameraZoomLevel : real

Niveau de zoom de la caméra en pourcentage. La valeur par défaut de 100.0 signifie qu'il n'y a pas de zoom avant ou arrière défini dans la caméra. La valeur est limitée par les propriétés minCameraZoomLevel et maxCameraZoomLevel.

Voir également minCameraZoomLevel et maxCameraZoomLevel.

currentFps : int

Lorsque la mesure du FPS est activée, les résultats de la dernière seconde sont stockés dans cette propriété en lecture seule. Il faut au moins une seconde pour que cette valeur soit mise à jour après l'activation de la mesure.

Voir également measureFps.

customItemList : list<Custom3DItem>

La liste des éléments Custom3DItem ajoutés au graphe. Le graphe est propriétaire des éléments ajoutés.

cutoffMargin : real [since 6.11]

Valeur utilisée pour la différence entre les limites de l'axe et la position à laquelle les éléments du graphique sont éliminés.

Note : N 'affecte pas les graphiques à barres.

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

flipHorizontalGrid : bool

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.

gridLineType : Graphs3D.GridLineType

Définit si le type de lignes de la grille est Graphs3D.GridLineType.Shader ou Graphs3D.GridLineType.Geometry.

Cette valeur affecte toutes les lignes de la grille.

Voir également Graphs3D.GridLineType.

horizontalAspectRatio : real

Le rapport d'échelle du graphique entre l'axe des x et l'axe des z. La valeur 0.0 indique une mise à l'échelle automatique en fonction des plages d'axes. La valeur par défaut est 0.0.

Remarque : cette propriété n'a aucun effet sur Bars3D, qui gère la mise à l'échelle sur le plan horizontal via les propriétés barThickness et barSpacing. Les graphiques polaires ignorent également cette propriété.

Voir également aspectRatio, polar, Bars3D::barThickness, et Bars3D::barSpacing.

labelMargin : real

Cette propriété spécifie la marge pour le placement des étiquettes d'axe.

Les valeurs négatives placent les étiquettes à l'intérieur de la zone de tracé, tandis que les valeurs positives les placent à l'extérieur de la zone de tracé. La rotation automatique des étiquettes est désactivée lorsque la valeur est négative. La valeur par défaut est 0.1

Voir également QAbstract3DAxis::labelAutoAngle.

lightColor : color

La couleur de la lumière ambiante et spéculaire définie dans Scene3D.

lightStrength : real

L'intensité de la lumière spéculaire pour l'ensemble du graphique. La valeur doit être comprise entre 0.0 et 10.0.

Cette valeur affecte la lumière spécifiée dans Scene3D.

locale : locale

Définit la locale utilisée pour le formatage de diverses étiquettes numériques. La valeur par défaut est la locale "C".

Voir aussi Value3DAxis::labelFormat.

margin : real

Valeur absolue utilisée pour l'espace laissé entre le bord de la zone graphique traçable et le bord de l'arrière-plan du graphique.

Si la valeur de la marge est négative, les marges sont déterminées automatiquement et peuvent varier en fonction de la taille des éléments de la série et du type de graphique. La valeur est interprétée comme une fraction de la plage de l'axe des y si les rapports d'aspect du graphique n'ont pas été modifiés par rapport aux valeurs par défaut. La valeur par défaut est -1.0.

Remarque : si la marge d'un graphique de dispersion est inférieure à la marge déterminée automatiquement, les éléments de dispersion situés sur les bords du graphique risquent de se superposer à l'arrière-plan du graphique.

Remarque : dans les graphiques de dispersion et de surface, si la marge est petite par rapport à la taille des étiquettes d'axe, les positions des étiquettes de bord des axes sont ajustées pour éviter tout chevauchement avec les étiquettes de bord des axes voisins.

maxCameraXRotation : real [since 6.9]

Angle maximal de rotation X de la caméra autour du point cible, en degrés. La valeur par défaut est 180.0

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

maxCameraYRotation : real [since 6.9]

Angle maximal de rotation Y de la caméra autour du point cible, en degrés. La valeur par défaut est 90.0

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

maxCameraZoomLevel : real

Définit le niveau de zoom maximal autorisé pour la caméra. Si le nouveau niveau maximum est inférieur au niveau minimum existant, le niveau minimum est également ajusté au nouveau maximum. Si l'adresse cameraZoomLevel actuelle est en dehors des nouvelles limites, elle est également ajustée. La valeur par défaut est 500.0f.

Voir également cameraZoomLevel et minCameraZoomLevel.

measureFps : bool

Si true, le rendu est effectué en continu et non à la demande, et la valeur de la propriété currentFps est mise à jour. La valeur par défaut est false.

Voir également currentFps.

minCameraXRotation : real [since 6.9]

Angle minimum de rotation X de la caméra autour du point cible, en degrés. La valeur par défaut est -180.0

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

minCameraYRotation : real [since 6.9]

Angle minimum de rotation Y de la caméra autour du point cible, en degrés. La valeur par défaut est 0.0

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

minCameraZoomLevel : real

Définit le niveau de zoom minimum autorisé pour la caméra. Si le nouveau niveau minimum est supérieur au niveau maximum existant, le niveau maximum est également ajusté au nouveau minimum. Si le site cameraZoomLevel actuel se trouve en dehors des nouvelles limites, il est également ajusté. Le niveau minCameraZoomLevel ne peut pas être inférieur à 1.0. La valeur par défaut est 10.0.

Voir également cameraZoomLevel et maxCameraZoomLevel.

msaaSamples : int

Le nombre d'échantillons utilisés dans l'anticrénelage multi-échantillon lorsque renderingMode est Indirect. Lorsque renderingMode est DirectToBackground, cette valeur de propriété est en lecture seule et renvoie le nombre d'échantillons spécifié par le format de surface de la fenêtre. La valeur par défaut est 4.

Voir également renderingMode.

optimizationHint : Graphs3D.OptimizationHint

Indique si le mode par défaut ou le mode hérité est utilisé pour l'optimisation du rendu.

Le mode par défaut utilise le rendu instancié et fournit l'ensemble des fonctionnalités au meilleur niveau de performance sur la plupart des systèmes. Le mode statique optimise le rendu des graphes et est idéal pour les grands ensembles de données qui ne changent pas. Il est plus lent en cas de modification dynamique des données et de rotation des éléments. La sélection n'étant pas optimisée, il est déconseillé d'utiliser le mode statique avec des ensembles de données volumineux. Le mode hérité rend tous les éléments du graphique individuellement, sans instanciation. Il ne doit être utilisé que si le mode par défaut ne fonctionne pas, c'est-à-dire si le système cible ne prend pas en charge l'instanciation. La valeur par défaut est Default.

Note : Dans certains environnements, les grands graphes utilisant l'optimisation statique peuvent ne pas être rendus, parce que tous les éléments sont rendus en utilisant un seul appel de dessin, et que différents pilotes graphiques supportent différents nombres maximums de vertices par appel. Ce problème se pose principalement sur les plates-formes 32bit et OpenGL ES2. Pour contourner ce problème, choisissez un maillage d'éléments avec un faible nombre de vertex ou utilisez le maillage de points.

Voir aussi Abstract3DSeries::mesh et Graphs3D.OptimizationHint.

orthoProjection : bool

Si true, la projection orthographique sera utilisée pour afficher le graphique. La valeur par défaut est false.

Remarque : Les ombres seront désactivées si le paramètre est fixé à true.

polar : bool

Si true, les axes horizontaux sont transformés en axes polaires. L'axe x devient l'axe angulaire et l'axe z devient l'axe radial. Le mode polaire n'est pas disponible pour les diagrammes à barres.

La valeur par défaut est false.

Voir également orthoProjection et radialLabelOffset.

queriedGraphPosition : vector3d [read-only]

Cette propriété en lecture seule contient les dernières valeurs de position du graphique le long de chaque axe interrogé à l'aide de Scene3D::graphPositionQuery. Les valeurs sont normalisées en fonction de l'intervalle [-1, 1]. Si la position interrogée se situe en dehors des limites du graphique, les valeurs ne reflèteront pas la position réelle, mais correspondront à une position indéfinie située en dehors de l'intervalle [-1, 1]. La valeur sera indéfinie jusqu'à ce qu'une requête soit effectuée.

Il n'existe pas de coordonnées 3D correctes correspondant à une position particulière de l'écran. Par conséquent, pour des raisons de cohérence, les requêtes sont toujours effectuées par rapport aux côtés intérieurs d'une boîte invisible entourant le graphique.

Remarque : les graphiques à barres ne permettent d'interroger la position du graphique qu'au niveau du sol du graphique, de sorte que la valeur y est toujours nulle pour les graphiques à barres et que les requêtes valides ne peuvent être effectuées qu'aux positions d'écran qui contiennent le sol du graphique.

Voir également Scene3D::graphPositionQuery.

radialLabelOffset : real

Cette propriété spécifie le décalage horizontal normalisé des étiquettes de l'axe polaire radial. La valeur 0.0 indique que les étiquettes doivent être dessinées à côté de la ligne de grille de l'axe angulaire 0. La valeur 1.0 indique que les étiquettes sont dessinées à leur place habituelle, au bord du fond du graphique. Cette propriété est ignorée si la valeur de la propriété polar est false. La valeur par défaut est 1.0.

Voir également polar.

renderingMode : Graphs3D.RenderingMode

Comment le graphique sera rendu. La valeur par défaut est Indirect.

Remarque : la définition de la propriété antialiasing du graphique n'a aucun effet. Cependant, elle est définie par le graphique lui-même si le mode de rendu actuel utilise l'anticrénelage.

Voir également msaaSamples et Graphs3D.RenderingMode.

rootNode : Node [read-only, since 6.9]

Renvoie un pointeur sur le nœud racine du graphe 3D. Utilisez cette propriété pour injecter un graphique 3D dans un site View3D distinct à l'aide de importScene:

Bars3D {
  id: bars
}
View3D {
  importScene: bars.rootNode
}

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

Voir aussi View3D.

rotationEnabled : bool

Si ce gestionnaire d'entrée autorise la rotation du graphique.

La valeur par défaut est true.

scene : Scene3D [read-only]

Le pointeur Scene3D qui peut être utilisé pour manipuler la scène et accéder aux éléments de la scène.

Cette propriété est en lecture seule.

selectedElement : Graphs3D.ElementType [read-only]

L'élément sélectionné dans le graphique.

Cette propriété peut être utilisée pour demander le type d'élément sélectionné. Le type est valide jusqu'à ce qu'une nouvelle sélection soit effectuée dans le graphique et que le signal selectedElementChanged soit émis.

Le signal peut être utilisé, par exemple, pour mettre en œuvre une gestion personnalisée des entrées, comme le montre l'exemple de la gestion des axes.

Voir aussi selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition, et Graphs3D.ElementType.

selectedSeries : Surface3DSeries [read-only]

La série sélectionnée ou null. Si l'indicateur MultiSeries est activé sur selectionMode, cette propriété contient la série qui possède le point sélectionné.

selectionEnabled : bool

Si ce gestionnaire d'entrée permet une sélection dans le graphique.

La valeur par défaut est true.

selectionMode : Graphs3D.SelectionMode

Mode de sélection actif dans le graphique. Une des valeurs de l'énumération Graphs3D.SelectionFlag.

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.

shadowQuality : Graphs3D.ShadowQuality

La qualité des ombres. Une des valeurs de l'énumération Graphs3D.ShadowQuality.

shadowStrength : real

L'intensité de l'ombre pour l'ensemble du graphique. Plus le chiffre est élevé, plus les ombres sont foncées. La valeur doit être comprise entre 0.0 et 100.0.

Cette valeur affecte la lumière spécifiée dans Scene3D.

theme : GraphsTheme

Le thème actif du graphique.

Voir aussi GraphsTheme.

transparencyTechnique : Graphs3D.TransparencyTechnique [since 6.9]

Spécifie la technique de transparence à utiliser. La valeur par défaut est Default. Lors du rendu de graphiques à surface transparente, utilisez Approximate ou Accurate. Default doit être utilisé pour les autres types de graphiques.

ConstanteDescription
DefaultIndique que les techniques de transparence indépendantes de l'ordre ne sont pas utilisées. Offre les meilleures performances. À utiliser lorsque les graphiques ne contiennent pas de transparence ou lorsqu'un graphique à barres ou à nuages de points utilise également l'instanciation, c'est-à-dire que optimizationHint est {QtGraphs3D::OptimizationHint::Default}.
ApproximateIndique qu'un graphique tente une approximation de la transparence indépendante de l'ordre. Cette méthode est plus rapide que Accurate et fonctionne sur du matériel plus ancien, mais peut donner des résultats inexacts. À utiliser lorsque la transparence indépendante de l'ordre est nécessaire, mais que le coût des performances doit être inférieur à celui de l'utilisation de la transparence indépendante de l'ordre exacte.
AccurateIndique que la transparence précise indépendante de l'ordre est utilisée. À utiliser lorsqu'un rendu parfait de la transparence est nécessaire.

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

wrapCameraXRotation : bool

Comportement des limites minimales et maximales de la rotation X. Par défaut, la rotation X va de la valeur minimale à la valeur maximale et de la valeur maximale à la valeur minimale.

Si la valeur est true, la rotation X de la caméra s'étend de la valeur minimale à la valeur maximale et de la valeur maximale à la valeur minimale. Si la valeur est false, la rotation X de la caméra est limitée au secteur déterminé par les valeurs minimale et maximale.

wrapCameraYRotation : bool

Le comportement des limites minimales et maximales dans la rotation Y. Par défaut, la rotation Y est limitée entre les valeurs minimale et maximale, sans aucune enveloppe.

Si true, la rotation Y de la caméra est enveloppée du minimum au maximum et du maximum au minimum. Si false, la rotation Y de la caméra est limitée au secteur déterminé par les valeurs minimale et maximale.

zoomAtTargetEnabled : bool

Indique si le zoom doit modifier la cible de la caméra de sorte que le point zoomé du graphique reste au même endroit après le zoom.

La valeur par défaut est true.

zoomEnabled : bool

Si ce gestionnaire d'entrée permet de zoomer sur le graphique.

La valeur par défaut est true.

Documentation sur les signaux

axisXChanged(ValueAxis3D axis)

Ce signal est émis lorsque axisX devient axis.

Note : Le gestionnaire correspondant est onAxisXChanged.

axisYChanged(ValueAxis3D axis)

Ce signal est émis lorsque axisY devient axis.

Note : Le gestionnaire correspondant est onAxisYChanged.

axisZChanged(ValueAxis3D axis)

Ce signal est émis lorsque axisZ devient axis.

Note : Le gestionnaire correspondant est onAxisZChanged.

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

Ce signal est émis lorsque l'élément du graphique est touché deux fois dans un court laps de temps. Le paramètre de signal eventPoint contient des informations sur l'événement de libération concernant le point qui a été touché, et button est le mouse button qui a été cliqué, ou NoButton sur un écran tactile.

Remarque : le gestionnaire correspondant est onDoubleTapped.

Voir également QEventPoint, Qt::MouseButtons, et TapHandler::doubleTapped.

dragged(QVector2D delta)

Ce signal est émis lorsque la translation du groupe de points sur le graphique est modifiée pendant l'exécution du geste de pincement. Le vecteur delta indique le changement de translation.

Remarque : le gestionnaire correspondant est onDragged.

Voir également PinchHandler::translationChanged.

flipHorizontalGridChanged(bool flip)

Ce signal est émis lorsque flipHorizontalGrid devient flip.

Note : Le gestionnaire correspondant est onFlipHorizontalGridChanged.

longPressed()

Ce signal est émis lorsque l'on appuie sur l'élément parent et qu'on le maintient enfoncé pendant une période supérieure à TapHandler::longPressThreshold.

Remarque : le gestionnaire correspondant est onLongPressed.

Voir également TapHandler::longPressed.

mouseMove(QPoint mousePos)

Ce signal est émis lorsque le graphique reçoit un événement mouseMove. La valeur mousePos indique la position de la souris lors de son déplacement.

Remarque : le gestionnaire correspondant est onMouseMove.

Voir également QQuickItem::mouseMoveEvent.

pinch(qreal delta)

Ce signal est émis lorsque le facteur d'échelle du graphique change pendant l'exécution du geste de pincement. La valeur delta indique le changement d'échelle multiplicatif.

Remarque : le gestionnaire correspondant est onPinch.

Voir aussi PinchHandler::scaleChanged.

selectedSeriesChanged(Surface3DSeries series)

Ce signal est émis lorsque selectedSeries devient series.

Note : Le gestionnaire correspondant est onSelectedSeriesChanged.

tapped(QEventPoint eventPoint, Qt::MouseButton button)

Ce signal est émis lorsque l'élément du graphique est touché une fois. Le paramètre de signal eventPoint contient des informations provenant de l'événement de libération sur le point qui a été touché, et button est le mouse button qui a été cliqué, ou NoButton sur un écran tactile.

Remarque : le gestionnaire correspondant est onTapped.

Voir également QEventPoint, Qt::MouseButtons, et TapHandler::singleTapped.

wheel(QQuickWheelEvent *event)

Ce signal est émis chaque fois que le graphe reçoit un event de type QWheelEvent: c'est-à-dire chaque fois que la roue est déplacée ou que le geste de défilement est mis à jour.

Remarque : le gestionnaire correspondant est onWheel.

Voir également WheelEvent et WheelHandler::wheel.

Documentation de la méthode

qsizetype addCustomItem(Custom3DItem item)

Ajoute un Custom3DItem item au graphique. Le graphique devient propriétaire de l'élément ajouté.

Renvoie l'index de l'élément ajouté si l'ajout a réussi, -1 si l'on essaie d'ajouter un élément nul, et l'index de l'élément si l'on essaie d'ajouter un élément déjà ajouté.

Voir aussi removeCustomItems(), removeCustomItem() et removeCustomItemAt().

void addSeries(Surface3DSeries series)

Ajoute le site series au graphique.

Voir aussi GraphsItem3D::hasSeries().

void clearSelection()

Efface la sélection de toutes les séries attachées.

void doPicking(QPoint point)

Effectue le prélèvement en utilisant les coordonnées de la vue à partir de point sur les éléments du graphique, en sélectionnant le premier élément touché. La gestion des entrées par défaut s'effectue lors de la réception de l'événement onTapped.

Voir également selectedElement.

void doRayPicking(QVector3D origin, QVector3D direction)

Effectue un prélèvement à partir de origin et dans direction sur les éléments du graphique, en sélectionnant le premier élément touché.

Voir aussi selectedElement.

bool hasSeries(Abstract3DSeries series)

Indique si le site series a déjà été ajouté au graphique.

void releaseCustomItem(Custom3DItem item)

Récupère la propriété de item et supprime item du graphique.

Remarque : si le même élément est réintroduit dans le graphique, le fichier de texture doit être réinitialisé.

Voir aussi Custom3DItem::textureFile.

void removeCustomItem(Custom3DItem item)

Supprime le site personnalisé item. Supprime les ressources qui lui sont allouées.

void removeCustomItemAt(vector3d position)

Supprime tous les éléments personnalisés à l'adresse position. Supprime les ressources qui leur sont allouées.

void removeCustomItems()

Supprime tous les éléments personnalisés. Supprime les ressources qui leur sont allouées.

void removeSeries(Surface3DSeries series)

Supprime le site series du graphique.

Voir aussi GraphsItem3D::hasSeries().

void removeSeries(Surface3DSeries series)

Supprime le site series du graphique.

Voir aussi GraphsItem3D::hasSeries().

[since 6.10] void renderSliceToImage(int index, int requestedIndex, QtGraphs3D::SliceCaptureType sliceType, QUrl filePath)

Exporte une tranche 2D des séries à l'adresse index et enregistre le résultat dans une image à l'adresse filePath. Pour exporter toutes les séries, fixez index à -1. La tranche exportée comprend les lignes de la rangée ou de la colonne, qui est définie par sliceType à une adresse requestedIndex donnée.

Cette méthode a été introduite dans Qt 6.10.

Abstract3DAxis selectedAxis()

Peut être utilisé pour obtenir l'axe sélectionné après avoir reçu le signal selectedElementChanged avec n'importe quel type d'étiquette. La sélection est valable jusqu'au prochain signal selectedElementChanged.

Renvoie l'axe sélectionné ou null.

Voir aussi selectedElement.

Custom3DItem selectedCustomItem()

Peut être utilisé pour obtenir l'élément personnalisé sélectionné après avoir reçu un signal selectedElementChanged de type ElementType.CustomItem. L'élément reste la propriété du graphique. La sélection est valable jusqu'au prochain signal selectedElementChanged.

Renvoie l'élément personnalisé sélectionné ou null.

Voir aussi selectedElement.

qsizetype selectedCustomItemIndex()

Peut être utilisé pour demander l'index de l'élément personnalisé sélectionné après avoir reçu le signal selectedElementChanged avec le type ElementType.CustomItem. La sélection est valable jusqu'au prochain signal selectedElementChanged.

Renvoie l'index de l'élément personnalisé sélectionné ou -1.

Voir aussi selectedElement.

int selectedLabelIndex()

Peut être utilisé pour demander l'index de l'étiquette sélectionnée après avoir reçu le signal selectedElementChanged avec n'importe quel type d'étiquette. La sélection est valable jusqu'au prochain signal selectedElementChanged.

Renvoie l'index de l'étiquette sélectionnée ou -1.

Voir aussi selectedElement.

void setDefaultInputHandler()

* @brief Restaure le mécanisme de gestion des entrées par défaut. * Cette méthode réactive les gestionnaires d'entrée internes prédéfinis. * Utilisez cette méthode pour revenir au comportement par défaut après avoir appelé * unsetDefaultInputHandler. *

Voir aussi unsetDefaultInputHandler().

void setDragButton(Qt::MouseButtons button)

* @brief Définit le bouton de la souris utilisé pour déclencher les événements de glissement. * Cette méthode permet de modifier le bouton de la souris requis pour déclencher une opération de glissement à button. * La valeur par défaut est Qt::RightButton.

void unsetDefaultDragHandler()

* * @brief Désactive le gestionnaire d'événements de glissement par défaut. * * Ceci désactive spécifiquement la réponse intégrée aux gestes de glissement. * Utilisez ceci si vous avez besoin d'implémenter un gestionnaire personnalisé pour le glissement. *

Voir aussi unsetDefaultInputHandler().

void unsetDefaultInputHandler()

* @brief Désactive le mécanisme de gestion des entrées par défaut. * Cette méthode désactive tous les gestionnaires d'entrée prédéfinis par défaut. * Appelez cette méthode si vous avez l'intention de remplacer les comportements par défaut. *

Voir aussi unsetDefaultTapHandler(), unsetDefaultDragHandler(), unsetDefaultWheelHandler(), et unsetDefaultPinchHandler().

void unsetDefaultPinchHandler()

* @brief Désactive le gestionnaire de gestes de pincement par défaut. * * Ceci désactive spécifiquement la réponse intégrée aux gestes de pincement. * Utilisez ceci pour implémenter un gestionnaire de gestes de pincement personnalisé. *

Voir aussi unsetDefaultInputHandler().

void unsetDefaultTapHandler()

* @brief Désactive le gestionnaire d'événements par défaut. * Cela désactive spécifiquement la réponse intégrée aux événements "tap" ou "click", * permettant une logique personnalisée de gestion des "tap". *

Voir aussi unsetDefaultInputHandler().

void unsetDefaultWheelHandler()

* @brief Désactive le gestionnaire d'événements par défaut de la molette de la souris. * * Ceci désactive spécifiquement la réponse intégrée au défilement de la molette de la souris. * A utiliser lors de l'implémentation d'un comportement personnalisé de la molette. *

Voir aussi unsetDefaultInputHandler().

© 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.