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 de notification :

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

Cette énumération a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal de notification :

Voir également horizontalAspectRatio.

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

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.

Cette énumération a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal de notification :

Voir également measureFps.

[since QtDataVisualization 1.2] 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 un redimensionnement automatique en fonction des plages des 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 énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d’accès :

Signal de notification :

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

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

Voir également QValue3DAxis::labelFormat.

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

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

Cette énumération a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal de notification :

Voir également currentFps.

optimizationHints : OptimizationHints

Cette propriété s'applique quel que soit le mode utilisé pour l'optimisation du rendu (mode par défaut ou mode statique).

Le mode par défaut offre l’ensemble complet des fonctionnalités avec un niveau de performances raisonnable. Le mode statique optimise le rendu des graphiques 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 d’éléments. La sélection n’est pas optimisée ; il n’est donc 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. 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 l'affichage du graphique.

La valeur par défaut est « false ».

Cette énumération a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal de notification :

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

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d’accès :

Signal de notification :

Voir également orthoProjection et radialLabelOffset.

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d’accès :

Signal de notification :

Voir également Q3DScene::graphPositionQuery.

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

Voir également polar.

[since QtDataVisualization 1.2] reflection : bool

Cette propriété détermine si les reflets au sol sont activés ou désactivés.

La valeur par défaut est « false ».

N'affecte que les Q3DBars. Cependant, dans les graphiques Q3DBars contenant à la fois des valeurs positives et négatives, les reflets ne sont pas pris en charge pour les éléments personnalisés qui coupent le plan du sol. Dans ce cas, il convient de désactiver les reflets afin d'éviter un rendu incorrect.

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

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

Voir également reflectivity.

[since QtDataVisualization 1.2] reflectivity : qreal

Réflectivité du sol.

Plus la valeur est élevée, plus le sol est réfléchissant. La plage valide est comprise entre [0...1]. La valeur par défaut est 0.5.

Cette énumération a été introduite dans QtDataVisualization 1.2.

Fonctions d'accès :

Signal de notification :

Voir également reflection.

[read-only] scene : Q3DScene*

Cette propriété contient le pointeur Q3DScene qui permet de manipuler la scène et d'accéder à ses éléments, 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 graphe.

Cette propriété permet de récupérer 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 des graphiques sous l'onglet « Scatter Graph ».

Cette énumération a été introduite dans QtDataVisualization 1.1.

Fonctions d'accès :

Signal Notifier :

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

selectionMode : SelectionFlags

Mode de sélection des éléments.

Combinaison d'SelectionFlags. Par défaut, SelectionItem. Les 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.

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

Fonctions d’accès :

Signal de notification :

Voir également ShadowQuality.

#include <QtDataVisualization/qutils.h>

// ...

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

#include <QtDataVisualization/qutils.h>

// ...

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