QAbstract3DGraph Class

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

Documentation sur les propriétés

activeInputHandler : QAbstract3DInputHandler*

Cette propriété contient le gestionnaire d'entrée actif utilisé dans le graphique.

Fonctions d'accès :

Signal du notificateur :

activeTheme : Q3DTheme*

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

Fonctions d'accès :

Signal de notification :

[since QtDataVisualization 1.1] 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.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Notifier signal :

Voir aussi horizontalAspectRatio.

[read-only, since QtDataVisualization 1.1] currentFps : qreal

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.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal Notifier :

Voir aussi measureFps.

[since QtDataVisualization 1.2] 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 Q3DBars, 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é.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir aussi aspectRatio, polar, Q3DBars::barThickness, et Q3DBars::barSpacing.

[since QtDataVisualization 1.2] 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".

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir aussi QValue3DAxis::labelFormat.

[since QtDataVisualization 1.2] 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.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

[since QtDataVisualization 1.1] 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.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal Notifier :

Voir aussi currentFps.

optimizationHints : OptimizationHints

Cette propriété indique si le mode par défaut ou le mode statique est utilisé pour l'optimisation du rendu.

Le mode par défaut fournit l'ensemble des fonctionnalités à un niveau de performance raisonnable. Le mode statique optimise le rendu du graphique et est idéal pour les grands ensembles de données qui ne changent pas. Il est plus lent en cas de modifications dynamiques des données et de rotations des éléments. La sélection n'étant pas optimisée, il n'est pas conseillé d'utiliser le mode statique avec des ensembles de données volumineux. L'optimisation statique ne fonctionne que pour les diagrammes de dispersion. La valeur par défaut est OptimizationDefault.

Fonctions d'accès :

Signal de notification :

Voir aussi QAbstract3DSeries::mesh.

[since QtDataVisualization 1.1] orthoProjection : bool

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

La valeur par défaut est false.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal Notifier :

Voir également QAbstract3DAxis::labelAutoRotation et Q3DCamera::cameraPreset.

[since QtDataVisualization 1.2] 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.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir également orthoProjection et radialLabelOffset.

[read-only, since QtDataVisualization 1.2] 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.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir aussi Q3DScene::graphPositionQuery.

[since QtDataVisualization 1.2] 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.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir aussi polar.

[since QtDataVisualization 1.2] reflection : bool

Cette propriété indique si les réflexions sur le sol sont activées ou désactivées.

La valeur par défaut est false.

Affecte uniquement Q3DBars. Toutefois, dans les graphiques Q3DBars contenant des valeurs positives et négatives, les réflexions ne sont pas prises en charge pour les éléments personnalisés qui coupent le plan du sol. Dans ce cas, les réflexions doivent être désactivées pour éviter un rendu incorrect.

Si vous utilisez un format de surface personnalisé, le tampon du pochoir doit être défini (QSurfaceFormat::setStencilBufferSize()) pour que les réflexions fonctionnent.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal Notifier :

Voir aussi reflectivity.

[since QtDataVisualization 1.2] reflectivity : qreal

Réflectivité du sol.

Plus les chiffres sont élevés, plus le sol est réfléchissant. La plage valide est [0...1]. La valeur par défaut est 0.5.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Notifier signal :

Voir aussi reflection.

[read-only] scene : Q3DScene*

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, tels que la caméra active.

Cette propriété est en lecture seule.

Fonctions d'accès :

[read-only, since QtDataVisualization 1.1] selectedElement : 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.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal Notifier :

Voir aussi selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBars::selectedSeries(), Q3DScatter::selectedSeries(), Q3DSurface::selectedSeries() et Q3DScene::setSelectionQueryPosition().

selectionMode : SelectionFlags

Mode de sélection des éléments.

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

Fonctions d'accès :

Signal de notification :

Voir également SelectionFlags.

shadowQuality : ShadowQuality

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

Une des valeurs de l'énumération ShadowQuality. Par défaut, ShadowQualityMedium.

Fonctions d'accès :

Signal Notifier :

Voir aussi ShadowQuality.

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));