Q3DGraphsWidgetItem Class

Documentation sur les propriétés

activeTheme : QGraphsTheme*

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

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

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

Fonctions d'accès :

Signal Notifier :

ambientLightStrength : float

Cette propriété contient 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.0f et 1.0f.

Fonctions d'accès :

Signal de notification :

aspectRatio : qreal

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

Fonctions d'accès :

Signal de notification :

Voir aussi horizontalAspectRatio.

cameraPreset : QtGraphs3D::CameraPreset

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

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

Fonctions d'accès :

Signal de notification :

cameraTargetPosition : QVector3D

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

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

Les valeurs de coordonnées valides sont comprises entre -1.0...1.0, les valeurs de bord indiquant les bords de la plage d'axes correspondante. Toutes les valeurs situées en dehors de cette plage sont fixées au bord.

Fonctions d'accès :

Signal de notification :

cameraXRotation : float

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

Fonctions d'accès :

Signal du notificateur :

cameraYRotation : float

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

Fonctions d'accès :

Signal du notificateur :

cameraZoomLevel : float

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

La valeur par défaut de 100.0f 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.

Fonctions d'accès :

Signal de notification :

Voir également minCameraZoomLevel et maxCameraZoomLevel.

[read-only] currentFps : int

Cette propriété contient les résultats du rendu pour 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 pour que cette valeur soit mise à jour après l'activation de la mesure.

Fonctions d'accès :

Signal de notification :

Voir aussi measureFps.

[since 6.11] cutoffMargin : qreal

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

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

Fonctions d'accès :

Notifier signal :

gridLineType : QtGraphs3D::GridLineType

Cette propriété indique si le type de lignes de la grille est QtGraphs3D::GridLineType::Shader ou QtGraphs3D::GridLineType::Geometry.

Cette valeur affecte toutes les lignes de la grille.

Fonctions d'accès :

Signal de notification :

Voir aussi QtGraphs3D::GridLineType.

horizontalAspectRatio : qreal

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

N'a aucun effet sur 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é 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. Valeur par défaut 0.1

Fonctions d'accès :

Notifier signal :

Voir aussi 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é contient 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é indique la locale utilisée pour formater les différentes é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é contient la 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.

Fonctions d'accès :

Signal de notification :

maxCameraXRotation : float

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

Fonctions d'accès :

Notificateur signal :

maxCameraYRotation : float

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

Fonctions d'accès :

Notificateur signal :

maxCameraZoomLevel : float

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

Si le niveau maximum est fixé à une nouvelle valeur inférieure 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.

Fonctions d'accès :

Signal de notification :

Voir également cameraZoomLevel et minCameraZoomLevel.

measureFps : bool

Cette propriété indique si le rendu est effectué en continu plutôt qu'à la demande.

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

Notifier signal :

Voir également currentFps.

minCameraXRotation : float

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

Fonctions d'accès :

Notificateur signal :

minCameraYRotation : float

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

Fonctions d'accès :

Notificateur signal :

minCameraZoomLevel : float

Cette propriété indique le niveau de zoom minimum autorisé pour la caméra.

Si le niveau minimum est défini à une nouvelle valeur supérieure au niveau maximum existant, le niveau maximum est également ajusté au nouveau minimum. Si le niveau de zoom actuel est en dehors des nouvelles limites, il est également ajusté. Le niveau de zoom minCameraZoomLevel ne peut être inférieur à 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 à 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 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. L'optimisation statique ne fonctionne que pour les diagrammes de dispersion. 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 QtGraphs3D::OptimizationHint::Default.

Fonctions d'accès :

Signal de notification :

Voir aussi QAbstract3DSeries::mesh.

orthoProjection : bool

Cette propriété indique si la projection orthographique est utilisée pour afficher le graphique.

La valeur par défaut est false.

Fonctions d'accès :

Signal de notification :

Voir aussi QAbstract3DAxis::labelAutoAngle.

polar : bool

Cette propriété indique si les axes horizontaux sont transformés en 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 graphique interrogées sur chaque axe.

Cette propriété en lecture seule contient les résultats de Q3DScene::graphPositionQuery. Les valeurs sont normalisées à l'intervalle [-1, 1]. Si la position interrogée est en dehors des limites du graphique, les valeurs ne reflètent pas la position réelle, mais indiquent 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ées 3D correctes uniques correspondant à une position d'écran particulière. 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.

Fonctions d'accès :

Signal de notification :

Voir aussi Q3DScene::graphPositionQuery.

radialLabelOffset : float

Cette propriété définit 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 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 Notifier :

Voir aussi polar.

rotationEnabled : bool

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

La valeur par défaut est true.

Fonctions d'accès :

Signal du notificateur :

[read-only] scene : Q3DScene* const

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

Fonctions d'accès :

[read-only] selectedElement : QtGraphs3D::ElementType

Cette propriété contient 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 des gestionnaires d'entrée personnalisés, comme le montre l'exemple de la galerie graphique sous l'onglet Scatter Graph.

Fonctions d'accès :

Signal Notifier :

Voir aussi 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 permet une sélection dans le graphique.

La valeur par défaut est true.

Fonctions d'accès :

Signal du notificateur :

selectionMode : QtGraphs3D::SelectionFlags

Mode de sélection des éléments.

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

Fonctions d'accès :

Signal de notification :

Voir également QtGraphs3D::SelectionFlags.

shadowQuality : QtGraphs3D::ShadowQuality

Cette propriété indique la qualité de l'ombre.

Une des valeurs de l'enum ShadowQuality. Par défaut, Medium.

Fonctions d'accès :

Signal Notifier :

Voir aussi QtGraphs3D::ShadowQuality.

shadowStrength : float

Cette propriété définit la force de l'ombre pour l'ensemble du graphique.

Plus la valeur est élevée, 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 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. Lors du rendu de graphiques à surface transparente, utilisez Approximate ou Accurate. Default doit être utilisé pour les autres types de graphiques.

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

Fonctions d'accès :

Notifier signal :

Voir aussi QtGraphs3D::TransparencyTechnique.

wrapCameraXRotation : bool

Cette propriété définit le comportement des limites minimales et maximales de la rotation X. Si elle est définie sur , la caméra est enveloppée du minimum au maximum et du maximum au minimum.

Si elle est définie sur true, la rotation X de la caméra est enveloppée du minimum au maximum et du maximum au minimum. 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. 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 minimales et maximales de la rotation en Y. Si , la rotation en Y de la caméra est enveloppée du minimum au maximum et du maximum au minimum.

Si true, la rotation Y de la caméra s'étend 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. La valeur par défaut est true.

Fonctions d'accès :

Signal de notification :

zoomAtTargetEnabled : bool

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

Fonctions d'accès :

Signal de notification :

zoomEnabled : bool

Cette propriété indique si ce gestionnaire d'entrée permet de zoomer sur le graphique.

La valeur par défaut est true.

Fonctions d'accès :

Signal du notificateur :

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