Q3DGraphsWidgetItem Class

Documentation sur les propriétés

activeTheme : QGraphsTheme*

Cette propriété contient le thème actif du graphique.

Définit activeTheme comme thème actif à utiliser pour le graphique. Appelle implicitement la méthode addTheme() pour transférer la propriété du thème à ce graphique.

Si activeTheme est nul, un thème par défaut temporaire est créé. Ce thème temporaire est détruit si un thème est défini explicitement par la suite. Les propriétés du thème peuvent être modifiées même après sa définition, et les modifications prennent effet immédiatement.

Fonctions d’accès :

Signal de notification :

ambientLightStrength : float

Cette propriété définit l'intensité de la lumière ambiante pour l'ensemble du graphique.

Cette valeur détermine l'uniformité et la luminosité de l'affichage des couleurs sur l'ensemble du graphique, quelle que soit la position de la source lumineuse.

La valeur doit être comprise entre 0.0f et 1.0f.

Fonctions d'accès :

Signal de notification :

aspectRatio : qreal

Cette propriété définit le rapport d'échelle du graphique entre l'axe le plus long sur le plan horizontal et l'axe des y.

Valeur par défaut : 2.0.

Fonctions d'accès :

Signal de notification :

Voir également horizontalAspectRatio.

cameraPreset : QtGraphs3D::CameraPreset

Position prédéfinie de la caméra actuellement utilisée. La valeur peut correspondre à l'une des valeurs de l'énumération `CameraPreset`. Cette propriété permet de définir un angle de caméra prédéfini à partir duquel le graphique est visualisé.

Par défaut, le préréglage de caméra est défini sur « CameraPreset::FrontLow ».

Fonctions d’accès :

Signal de notification :

cameraTargetPosition : QVector3D

Cette propriété stocke la position cible de la caméra sous forme de vecteur ou de sommet dans l'espace 3D.

La valeur par défaut est QVector3D(0.0, 0.0, 0.0).

Les valeurs de coordonnées valides se situent entre -1.0...1.0, les valeurs limites indiquant les extrémités de la plage correspondante. Toute valeur hors de cette plage est limitée à la valeur limite correspondante.

Fonctions d'accès :

Signal de notification :

cameraXRotation : float

Cette propriété contient l'angle de rotation X de la caméra autour du point cible, exprimé en degrés.

Fonctions d'accès :

Signal de notification :

cameraYRotation : float

Cette propriété contient l'angle de rotation en Y de la caméra autour du point cible, exprimé en degrés.

Fonctions d'accès :

Signal de notification :

cameraZoomLevel : float

Cette propriété définit le niveau de zoom de la caméra en pourcentage.

La valeur par défaut « 100.0f » signifie qu'aucun zoom avant ou arrière n'est défini pour la caméra. La valeur est limitée par les propriétés « minCameraZoomLevel » et « maxCameraZoomLevel ».

Fonctions d'accès :

Signal de notification :

Voir également minCameraZoomLevel et maxCameraZoomLevel.

[read-only] currentFps : int

Cette propriété contient les résultats de rendu de la dernière seconde.

Les résultats sont stockés dans cette propriété en lecture seule lorsque la mesure du FPS est activée. Il faut au moins une seconde avant que cette valeur ne soit mise à jour après l'activation de la mesure.

Fonctions d'accès :

Signal de notification :

Voir également measureFps.

[since 6.11] cutoffMargin : qreal

Cette propriété contient la valeur utilisée pour définir l'espace entre les limites de l'axe et la position à laquelle les éléments du graphique sont supprimés.

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

Signal de notification :

[since 6.12] dragMode : QtGraphs3D::DragMode

Détermine la manière dont les événements de glissement sur le graphique sont interprétés ; il s'agit de l'une des valeurs de l'énumération « QtGraphs3D::DragMode ».

La valeur par défaut est ` QtGraphs3D::DragMode::Rotate`.

Cette énumération a été introduite dans Qt 6.12.

Fonctions d'accès :

Signal de notification :

Voir également panEnabled.

gridLineType : QtGraphs3D::GridLineType

Cette propriété s'applique quel que soit le type de lignes de la grille : « QtGraphs3D::GridLineType::Shader » ou « QtGraphs3D::GridLineType::Geometry ».

Cette valeur s'applique à toutes les lignes de la grille.

Fonctions d'accès :

Signal de notification :

Voir également QtGraphs3D::GridLineType.

horizontalAspectRatio : qreal

Cette propriété définit 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 des axes. La valeur par défaut est « 0.0 ».

N'a aucun effet sur la propriété « Q3DBarsWidgetItem », 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é.

Fonctions d’accès :

Signal de notification :

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

labelMargin : float

Cette propriété définit la marge pour le positionnement 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 celle-ci. La rotation automatique des étiquettes est désactivée lorsque la valeur est négative. La valeur par défaut est 0.1

Fonctions d'accès :

Signal de notification :

Voir également QAbstract3DAxis::labelAutoAngle.

lightColor : QColor

Cette propriété définit la couleur de la lumière ambiante et spéculaire.

Cette valeur affecte la lumière spécifiée dans « Q3DScene ».

Fonctions d'accès :

Signal de notification :

lightStrength : float

Cette propriété définit l'intensité de la lumière spéculaire pour l'ensemble du graphique.

La valeur doit être comprise entre 0.0f et 10.0f.

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

Fonctions d'accès :

Signal de notification :

locale : QLocale

Cette propriété définit les paramètres régionaux utilisés pour le formatage de diverses étiquettes numériques.

La valeur par défaut est la locale « "C" ».

Fonctions d'accès :

Signal de notification :

Voir aussi QValue3DAxis::labelFormat.

margin : qreal

Cette propriété définit la valeur absolue correspondant à l'espace laissé entre le bord de la zone de tracé du graphique 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 proportions du graphique n'ont pas été modifiées par rapport aux valeurs par défaut. La valeur par défaut est -1.0.

Fonctions d’accès :

Signal de notification :

maxCameraXRotation : float

Cette propriété indique l'angle maximal de rotation X de la caméra autour du point cible, exprimé en degrés. La valeur par défaut est 180.0

Fonctions d'accès :

Signal de notification :

maxCameraYRotation : float

Cette propriété indique l'angle maximal de rotation en Y de la caméra autour du point cible, exprimé en degrés. La valeur par défaut est 90.0

Fonctions d'accès :

Signal de notification :

maxCameraZoomLevel : float

Cette propriété définit le niveau de zoom maximal autorisé pour la caméra.

Si le niveau maximal est défini sur une nouvelle valeur inférieure au niveau minimal existant, le niveau minimal est également ajusté en fonction du nouveau niveau maximal. Si l'cameraZoomLevel e actuelle se trouve en dehors des nouvelles limites, elle est également ajustée. La valeur par défaut est 500.0f.

Fonctions d'accès :

Signal de notification :

Voir également cameraZoomLevel et minCameraZoomLevel.

measureFps : bool

Cette propriété détermine si le rendu s'effectue en continu plutôt qu'à la demande.

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

Fonctions d'accès :

Signal de notification :

Voir également currentFps.

minCameraXRotation : float

Cette propriété contient l'angle minimal de rotation X de la caméra autour du point cible, exprimé en degrés. La valeur par défaut est -180.0

Fonctions d'accès :

Signal de notification :

minCameraYRotation : float

Cette propriété contient l'angle minimal de rotation en Y de la caméra autour du point cible, exprimé en degrés. La valeur par défaut est 0.0

Fonctions d'accès :

Signal de notification :

minCameraZoomLevel : float

Cette propriété définit le niveau de zoom minimum autorisé de la caméra.

Si le niveau minimum est défini sur une nouvelle valeur supérieure au niveau maximum existant, le niveau maximum est également ajusté à la nouvelle valeur minimale. Si le niveau de zoom actuel (zoomLevel) se trouve en dehors des nouvelles limites, il est également ajusté. La propriété minCameraZoomLevel ne peut pas être définie sur une valeur inférieure à 1.0f. La valeur par défaut est 10.0f.

Fonctions d’accès :

Signal de notification :

Voir également cameraZoomLevel et maxCameraZoomLevel.

msaaSamples : int

Cette propriété indique le nombre d'échantillons utilisés en MSAA.

Définit le nombre d'échantillons MSAA utilisés sur samples. Le nombre d'échantillons peut être 0, 2, 4 ou 8.

Fonctions d'accès :

Signal de notification :

optimizationHint : QtGraphs3D::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 offre l’ensemble complet des fonctionnalités avec les meilleures performances sur la plupart des systèmes. Le mode statique optimise le rendu des graphiques et est idéal pour les grands ensembles de données immuables. Il est plus lent en cas de modifications dynamiques des données et de rotations d’éléments. La sélection n’étant pas optimisée, il n’est pas recommandé d’utiliser le mode statique avec des ensembles de données volumineux. L'optimisation statique ne fonctionne que sur les graphiques de dispersion. Le mode hérité affiche 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 « QtGraphs3D::OptimizationHint::Default ».

Fonctions d’accès :

Signal de notification :

Voir également QAbstract3DSeries::mesh.

orthoProjection : bool

Cette propriété indique si la projection orthographique est utilisée pour l'affichage du graphique.

La valeur par défaut est « false ».

Fonctions d'accès :

Signal de notification :

Voir également « QAbstract3DAxis::labelAutoAngle ».

[since 6.12] panEnabled : bool

Cette propriété indique si ce gestionnaire d'entrée autorise le défilement du graphique.

La valeur par défaut est « true ».

Cette énumération a été introduite dans Qt 6.12.

Fonctions d'accès :

Signal de notification :

Voir également ` dragMode ` et ` setPanButton()`.

polar : bool

Cette propriété reste valable même si les axes horizontaux sont remplacés par des axes polaires.

Si true, l'axe x devient l'axe angulaire et l'axe z devient l'axe radial. Le mode polaire n'est pas disponible pour les graphiques à barres.

La valeur par défaut est « false ».

Fonctions d’accès :

Signal de notification :

Voir également orthoProjection et radialLabelOffset.

[read-only] queriedGraphPosition : QVector3D

Cette propriété contient les dernières valeurs de position du graphe interrogées le long de chaque axe.

Cette propriété en lecture seule contient les résultats de la méthode ` Q3DScene::graphPositionQuery`. Les valeurs sont normalisées dans l'intervalle ` [-1, 1]`. Si la position interrogée se trouvait en dehors des limites du graphique, les valeurs ne refléteront pas la position réelle, mais indiqueront plutôt une position indéfinie en dehors de l'intervalle ` [-1, 1]`. La valeur restera indéfinie jusqu'à ce qu'une requête soit effectuée.

Il n'existe pas de coordonnée 3D unique et correcte correspondant à une position particulière à l'écran ; par souci de cohérence, les requêtes sont donc toujours effectuées par rapport aux côtés intérieurs d'un rectangle invisible entourant le graphique.

Fonctions d’accès :

Signal de notification :

Voir également Q3DScene::graphPositionQuery.

radialLabelOffset : float

Cette propriété contient 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 la grille angulaire correspondant à l'angle 0. La valeur 1.0 indique que les étiquettes sont dessinées à leur emplacement habituel, au bord de l'arrière-plan du graphique. La valeur par défaut est 1.0.

Cette propriété est ignorée si la valeur de la propriété ` polar ` est ` false`.

Fonctions d’accès :

Signal de notification :

Voir également polar.

rotationEnabled : bool

Cette propriété indique si ce gestionnaire d'entrée autorise la rotation du graphique.

La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

[read-only] scene : Q3DScene* const

Cette propriété contient le pointeur ` Q3DScene `, qui permet de manipuler la scène et d'accéder à ses éléments.

Cette propriété est en lecture seule.

Fonctions d'accès :

[read-only] selectedElement : QtGraphs3D::ElementType

Cette propriété contient l'élément sélectionné dans le graphe.

Cette propriété permet d'interroger le type de l'élément sélectionné. Ce type reste valide jusqu'à ce qu'une nouvelle sélection soit effectuée dans le graphique et que le signal « selectedElementChanged » soit émis.

Ce signal peut être utilisé, par exemple, pour implémenter des gestionnaires d’entrée personnalisés, comme le montre l’exemple de la Galerie de graphiques sous l’onglet « Scatter Graph ».

Fonctions d'accès :

Signal de notification :

Voir également selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBarsWidgetItem::selectedSeries(), Q3DScatterWidgetItem::selectedSeries(), Q3DSurfaceWidgetItem::selectedSeries() et Q3DScene::setSelectionQueryPosition().

selectionEnabled : bool

Cette propriété indique si ce gestionnaire d'entrée autorise la sélection à partir du graphique.

La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

selectionMode : QtGraphs3D::SelectionFlags

Mode de sélection des éléments.

Une combinaison de SelectionFlags. Par défaut, Item. Les différents types de graphiques prennent en charge différents modes de sélection.

Fonctions d'accès :

Signal de notification :

Voir aussi QtGraphs3D::SelectionFlags.

shadowQuality : QtGraphs3D::ShadowQuality

Cette propriété définit la qualité de l'ombre.

L'une des valeurs de l'énumération ShadowQuality. Par défaut, Medium.

Fonctions d'accès :

Signal de notification :

Voir également QtGraphs3D::ShadowQuality.

shadowStrength : float

Cette propriété définit l'intensité des ombres pour l'ensemble du graphique.

Plus le nombre est élevé, plus les ombres seront foncées. La valeur doit être comprise entre 0.0 et 100.0.

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

Fonctions d'accès :

Signal de notification :

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

Spécifie la technique de transparence à utiliser. La valeur par défaut est « Default ». Pour le rendu de graphes à surfaces transparentes, utilisez « Approximate » ou « Accurate ». Utilisez « Default » pour les autres types de graphes.

Cette énumération a été introduite dans Qt 6.9.

Fonctions d'accès :

Signal de notification :

Voir également QtGraphs3D::TransparencyTechnique.

wrapCameraXRotation : bool

Cette propriété définit le comportement des limites minimale et maximale de la rotation X.

Si elle est définie sur « true », la rotation X de la caméra passe du minimum au maximum, puis du maximum au minimum. Si elle est définie sur « false », la rotation X de la caméra est limitée au secteur déterminé par les valeurs minimale et maximale. La valeur par défaut est « true ».

Fonctions d’accès :

Signal de notification :

wrapCameraYRotation : bool

Cette propriété définit le comportement des limites minimale et maximale de la rotation autour de l'axe Y.

Si l'true, la rotation Y de la caméra passe du minimum au maximum, puis du maximum au minimum. Si l'false, la rotation Y de la caméra est limitée au secteur défini par les valeurs minimale et maximale. La valeur par défaut est « true ».

Fonctions d’accès :

Signal de notification :

zoomAtTargetEnabled : bool

Cette propriété détermine si le zoom doit modifier la cible de la caméra afin que le point zoomé du graphique reste au même endroit après le zoom.

Valeur par défaut : true.

Fonctions d'accès :

Signal de notification :

zoomEnabled : bool

Cette propriété indique si ce gestionnaire d'entrée autorise le zoom sur le graphique.

La valeur par défaut est « true ».

Fonctions d'accès :

Signal de notification :

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);