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

Bars3D QML Type

Diagramme à barres en 3D. En savoir plus...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

Propriétés

Signaux

Méthodes

Description détaillée

Ce type permet aux développeurs d'afficher des graphiques à barres en 3D grâce à Qt Quick.

Pour utiliser ce type, vous devrez importer le module Qt Graphs:

import QtGraphs

Vous pourrez ensuite utiliser Bars3D dans vos fichiers QML :

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2022"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2022"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2022"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2022"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2023"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2023"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2023"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2023"; city: "Tampere";  expenses: "4650"; }
    }
}

Consultez la section « Graphique à barres simple » pour un exemple d'utilisation plus complet.

Voir également les classes C++ pour la 3D:Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D et Qt Graphs .

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é d'affichage des couleurs sur l'ensemble du graphique, quelle que soit la position de la source lumineuse. La valeur doit être comprise entre 0.0 et 1.0.

aspectRatio : real

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

Remarque : n’a aucun effet sur ` Bars3D`.

Voir également horizontalAspectRatio.

barSeriesMargin : size

Marge entre les colonnes d’une série dans les dimensions X et Z. Valeur par défaut : (0.0, 0.0). Les valeurs recommandées se situent dans l’intervalle [0, 1).

barSpacing : size

Espacement des barres selon les axes X et Z.

Réglé par défaut sur « (1.0, 1.0) ». L'espacement est influencé par la propriété « barSpacingRelative ».

barSpacingRelative : bool

Si l'espacement est absolu ou relatif à l'épaisseur des barres.

Si l'true, la valeur « 0.0 » signifie que les barres sont placées côte à côte, « 1.0 » signifie qu'un espace égal à l'épaisseur d'une barre est laissé entre les barres, et ainsi de suite. La valeur par défaut est « true ».

barThickness : real

Rapport d'épaisseur des barres entre les dimensions X et Z. La valeur « 1.0 » signifie que les barres ont une largeur égale à leur profondeur, tandis que « 0.5 » indique qu'elles sont deux fois plus profondes que larges.

cameraPreset : Graphs3D.CameraPreset

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

cameraTargetPosition : vector3d

La cible de la caméra est définie sous la forme d'un vecteur 3D. 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, les valeurs extrêmes indiquant les limites de la plage de l'axe correspondant. Toute valeur située en dehors de cette plage est limitée à la valeur extrême.

cameraXRotation : real

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

cameraYRotation : real

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

cameraZoomLevel : real

Niveau de zoom de la caméra, exprimé en pourcentage. La valeur par défaut « 100.0 » signifie qu’aucun zoom avant ou arrière n’est défini pour la caméra. Cette valeur est limitée par les propriétés « minCameraZoomLevel » et « maxCameraZoomLevel ».

Voir également minCameraZoomLevel et maxCameraZoomLevel.

columnAxis : Category3DAxis

L'axe de colonne actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est supprimé si un autre axe est explicitement défini avec la même orientation.

currentFps : int

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

Voir également measureFps.

customItemList : list<Custom3DItem>

La liste des éléments de type « Custom3DItem » ajoutés au graphe. Le graphe prend possession des éléments ajoutés.

cutoffMargin : real [since 6.11]

Valeur utilisée pour la différence entre les limites des axes et la position à laquelle les éléments du graphique sont supprimés.

Remarque : n'affecte pas les graphiques à barres.

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

dragMode : Graphs3D.DragMode [since 6.12]

Détermine la manière dont les événements de glissement sur le graphique sont interprétés ; correspond à l'une des valeurs de l'énumération Graphs3D.DragMode.

La valeur par défaut est « Graphs3D.DragMode.Rotate ».

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

Voir également panEnabled.

floorLevel : real

Niveau de base du graphique à barres dans les coordonnées de l'axe Y.

Le niveau de base réel sera limité par les valeurs minimale et maximale de l'axe Y. La valeur par défaut est zéro.

gridLineType : Graphs3D.GridLineType

Détermine si le type des lignes de la grille est « Graphs3D.GridLineType.Shader » ou « Graphs3D.GridLineType.Geometry ».

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

Voir également Graphs3D.GridLineType.

horizontalAspectRatio : real

Rapport d'échelle entre l'axe des x et l'axe des z dans le graphique. La valeur « 0.0 » indique une mise à l'échelle automatique en fonction des plages des axes. La valeur par défaut est « 0.0 ».

Remarque : 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é définit 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 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

Voir également QAbstract3DAxis::labelAutoAngle.

lightColor : color

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

lightStrength : real

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 les paramètres régionaux utilisés pour le formatage de diverses étiquettes numériques. La valeur par défaut est la locale "C".

Voir également Value3DAxis::labelFormat.

margin : real

Valeur absolue définissant 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.

Remarque : définir une marge inférieure à celle déterminée automatiquement pour un graphique de nuage de points peut entraîner un chevauchement des éléments situés aux bords du graphique avec l’arrière-plan de celui-ci.

Remarque : sur les graphiques de nuages de points et de surface, si la marge est petite par rapport à la taille des étiquettes d'axe, la position des étiquettes situées aux bords des axes est ajustée afin d’éviter tout chevauchement avec les étiquettes des axes voisins.

maxCameraXRotation : real [since 6.9]

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

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

maxCameraYRotation : real [since 6.9]

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

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 maximal est inférieur au niveau minimal actuel, ce dernier est également ajusté pour correspondre au nouveau niveau maximal. Si l'cameraZoomLevel e actuelle se situe 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 s'effectue en continu plutôt qu'à 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 minimal de rotation X de la caméra autour du point cible, exprimé 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 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

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 actuel, ce dernier est également ajusté à la valeur du nouveau minimum. Si l'cameraZoomLevel e actuel se situe en dehors des nouvelles limites, il est également ajusté. La valeur de minCameraZoomLevel ne peut pas être inférieure à 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-échantillons lorsque renderingMode a la valeur Indirect. Lorsque renderingMode a la valeur DirectToBackground, cette 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.

multiSeriesUniform : bool

Détermine si les barres doivent être mises à l'échelle selon les proportions d'une seule série, même si plusieurs séries sont affichées. Si l'option « true » est sélectionnée, l'option « bar spacing » ne s'appliquera correctement qu'à l'axe X. La valeur par défaut est « false ».

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 offre l’ensemble complet des fonctionnalités avec un niveau de performances optimal sur la plupart des systèmes. Le mode statique optimise le rendu du graphique 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 des é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. Le mode hérité effectue le rendu de tous les éléments du graphe 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.

Remarque : dans certains environnements, les graphes volumineux utilisant l’optimisation statique peuvent ne pas s’afficher, car tous les éléments sont rendus à l’aide d’un seul appel de dessin, et les différents pilotes graphiques prennent en charge des nombres maximaux de sommets par appel variables. Ce problème se pose principalement sur les plateformes 32 bits et OpenGL ES2. Pour contourner ce problème, choisissez un maillage d’élément comportant un faible nombre de sommets ou utilisez le maillage de points.

Voir également Abstract3DSeries::mesh et Graphs3D.OptimizationHint.

orthoProjection : bool

Si la valeur est « true », la projection orthographique sera utilisée pour l'affichage du graphique. La valeur par défaut est « false ».

Remarque : les ombres seront désactivées lorsque l'option est définie sur true.

panEnabled : bool [since 6.12]

Indique si ce gestionnaire d'entrée autorise le panoramique du graphique.

La valeur par défaut est « true ».

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

polar : bool

Si true, les axes horizontaux sont remplacés par des 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 graphiques à barres.

La valeur par défaut est « false ».

Voir également orthoProjection et radialLabelOffset.

primarySeries : Bar3DSeries

La série principale du graphique. Elle sert à déterminer les libellés des axes des lignes et des colonnes lorsque ceux-ci ne sont pas explicitement définis sur les axes.

Si la série spécifiée n'est pas encore ajoutée au graphique, le fait de la définir comme série principale entraîne également son ajout implicite au graphique.

Si la série principale elle-même est supprimée du graphique, cette propriété reprend sa valeur par défaut.

Si la série est nulle, cette propriété revient à sa valeur par défaut. La valeur par défaut est la première série ajoutée ou zéro si aucune série n'est ajoutée au graphique.

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ées à l'aide de la méthode ` Scene3D::graphPositionQuery`. Les valeurs sont normalisées pour s'inscrire 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 correspondront 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 cadre invisible entourant le graphique.

Remarque : les graphiquesà barres ne permettent d’interroger la position du graphique qu’au niveau de la base du graphique ; par conséquent, la valeur y est toujours égale à zéro pour les graphiques à barres et les requêtes valides ne peuvent être effectuées qu’aux positions à l’écran qui contiennent la base 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 tracées à côté de la ligne de grille angulaire correspondant à l’angle 0. La valeur 1.0 indique que les étiquettes sont tracées à leur emplacement habituel, au bord de l’arrière-plan 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

Mode de rendu du graphique. La valeur par défaut est « Indirect ».

Remarque : la définition de la propriété ` antialiasing ` du graphique n'a aucun effet. Cependant, celle-ci est définie automatiquement par le graphique 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 vers le nœud racine du graphe 3D. Utilisez cette propriété pour intégrer un graphe 3D dans un « View3D » distinct à l’aide de l’ importScene:

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

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

Voir également View3D.

rotationEnabled : bool

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

La valeur par défaut est « true ».

rowAxis : Category3DAxis

L'axe des lignes actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut sans étiquettes est créé. Cet axe temporaire est supprimé si un autre axe est explicitement défini avec la même orientation.

scene : Scene3D [read-only]

Le pointeur ` Scene3D ` qui permet de manipuler la scène et d'accéder à ses éléments.

Cette propriété est en lecture seule.

selectedElement : Graphs3D.ElementType [read-only]

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 une gestion personnalisée des entrées, comme le montre l’exemple « Axis Handling ».

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

selectedSeries : Bar3DSeries [read-only]

La série sélectionnée ou null. Si selectionMode comporte le drapeau SelectionMultiSeries, cette propriété contient la série à laquelle appartient la barre sélectionnée.

selectionEnabled : bool

Indique si ce gestionnaire d'entrée autorise la sélection à partir du graphique.

La valeur par défaut est « true ».

selectionMode : Graphs3D.SelectionMode

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

seriesList : list<Bar3DSeries> [default]

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'éléments enfants du graphique.

shadowQuality : Graphs3D.ShadowQuality

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

shadowStrength : real

Intensité des ombres pour l'ensemble du graphique. Plus la valeur est élevée, plus les ombres seront foncées. La valeur doit être comprise entre 0.0 et 100.0.

Cette valeur influe sur la luminosité définie dans Scene3D.

theme : GraphsTheme

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 graphes à surface transparente, utilisez « Approximate » ou « Accurate ». Utilisez « Default » pour les autres types de graphes.

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 un nuage de points utilise également l'instanciation, c'est-à-dire que ` optimizationHint ` est égal à `{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 imprécis. À utiliser lorsque la transparence indépendante de l’ordre est nécessaire, mais que le coût en termes de performances doit être inférieur à celui de l’utilisation d’une transparence indépendante de l’ordre précise.
AccurateIndique qu’une transparence indépendante de l’ordre précise est utilisée. À utiliser lorsqu’un rendu de transparence parfait est nécessaire.

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

valueAxis : ValueAxis3D

L'axe des valeurs actif.

Si aucun axe n'est spécifié, un axe temporaire par défaut, sans étiquettes et dont la plage s'ajuste automatiquement, est créé. Cet axe temporaire est supprimé si un autre axe est explicitement défini avec la même orientation.

wrapCameraXRotation : bool

Comportement des limites minimale et maximale de la rotation X. Par défaut, la rotation X passe de la valeur minimale à la valeur maximale, puis de la valeur maximale à la valeur minimale.

Si l'option « true » est sélectionnée, la rotation X de la caméra passe de la valeur minimale à la valeur maximale, puis de la valeur maximale à la valeur minimale. Si l'option « false » est sélectionnée, la rotation X de la caméra est limitée au secteur défini par les valeurs minimale et maximale.

wrapCameraYRotation : bool

Comportement des limites minimale et maximale de la rotation Y. Par défaut, la rotation Y est limitée entre les valeurs minimale et maximale, sans bouclage.

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

zoomAtTargetEnabled : bool

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.

La valeur par défaut est « true ».

zoomEnabled : bool

Indique si ce gestionnaire d'entrée autorise le zoom sur le graphique.

Valeur par défaut : true.

Documentation sur les signaux

barSeriesMarginChanged(size margin)

Ce signal est émis lorsque barSeriesMargin devient margin.

Remarque : le gestionnaire correspondant est onBarSeriesMarginChanged.

barSpacingChanged(size spacing)

Ce signal est émis lorsque l'adresse barSpacing devient spacing.

Remarque : le gestionnaire correspondant est onBarSpacingChanged.

barSpacingRelativeChanged(bool relative)

Ce signal est émis lorsque barSpacingRelative devient relative.

Remarque : le gestionnaire correspondant est onBarSpacingRelativeChanged.

barThicknessChanged(real thicknessRatio)

Ce signal est émis lorsque barThickness devient thicknessRatio.

Remarque : le gestionnaire correspondant est onBarThicknessChanged.

columnAxisChanged(Category3DAxis axis)

Ce signal est émis lorsque columnAxis devient axis.

Remarque : le gestionnaire correspondant est onColumnAxisChanged.

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

Ce signal est émis lorsque l'élément du graphique est touché deux fois en très peu de temps. Le paramètre de signal « eventPoint » contient des informations issues de l'événement de relâchement concernant le point qui a été touché, et « button » correspond à l'mouse button e sur laquelle on a 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 de l'ensemble de points sur le graphique est modifiée pendant l'exécution du geste de pincement. Le vecteur delta indique la variation de la translation.

Remarque : le gestionnaire correspondant est onDragged.

Voir également PinchHandler::translationChanged.

floorLevelChanged(real level)

Ce signal est émis lorsque floorLevel devient level.

Remarque : le gestionnaire correspondant est onFloorLevelChanged.

longPressed()

Ce signal est émis lorsque l’élément « parent » est maintenu enfoncé pendant une durée 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 pendant son déplacement.

Remarque : le gestionnaire correspondant est onMouseMove.

Voir également QQuickItem::mouseMoveEvent.

multiSeriesUniformChanged(bool uniform)

Ce signal est émis lorsque multiSeriesUniform devient uniform.

Remarque : le gestionnaire correspondant est onMultiSeriesUniformChanged.

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 facteur multiplicatif de modification de l'échelle.

Remarque : le gestionnaire correspondant est onPinch.

Voir également PinchHandler::scaleChanged.

primarySeriesChanged(Bar3DSeries series)

Ce signal est émis lorsque primarySeries devient series.

Remarque : le gestionnaire correspondant est onPrimarySeriesChanged.

rowAxisChanged(Category3DAxis axis)

Ce signal est émis lorsque rowAxis devient axis.

Remarque : le gestionnaire correspondant est onRowAxisChanged.

selectedSeriesChanged(Bar3DSeries series)

Ce signal est émis lorsque selectedSeries devient series.

Remarque : le gestionnaire correspondant est onSelectedSeriesChanged.

tapped(QEventPoint eventPoint, Qt::MouseButton button)

Ce signal est émis lorsqu'on appuie une fois sur un élément du graphique. Le paramètre de signal « eventPoint » contient des informations issues de l'événement de relâchement concernant le point sur lequel on a appuyé, et « button » correspond à l'mouse button sur laquelle on a cliqué, ou à « NoButton » sur un écran tactile.

Remarque : le gestionnaire correspondant est ` onTapped`.

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

valueAxisChanged(ValueAxis3D axis)

Ce signal est émis lorsque valueAxis devient axis.

Remarque : le gestionnaire correspondant est onValueAxisChanged.

wheel(QQuickWheelEvent *event)

Ce signal est émis chaque fois que le graphique reçoit une event de type QWheelEvent: c'est-à-dire chaque fois que la molette 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 des méthodes

qsizetype addCustomItem(Custom3DItem item)

Ajoute un objet de type « Custom3DItem » item au graphe. Le graphe prend en charge l'élément ajouté.

Renvoie l’index de l’élément ajouté si l’ajout a réussi, -1 si l’on tente d’ajouter un élément nul, et l’index de l’élément si l’on tente d’ajouter un élément déjà présent.

Voir également removeCustomItems(), removeCustomItem() et removeCustomItemAt().

void addSeries(Bar3DSeries series)

Ajoute l'series e au graphique. Un graphique peut contenir plusieurs séries, mais un seul jeu d'axes ; les lignes et les colonnes de toutes les séries doivent donc correspondre pour que les données visualisées aient un sens. Si le graphique comporte plusieurs séries visibles, seule la première série ajoutée générera les étiquettes de ligne ou de colonne sur les axes lorsque celles-ci ne sont pas explicitement définies. Si la série nouvellement ajoutée a spécifié une barre sélectionnée, celle-ci sera mise en surbrillance et toute sélection existante sera effacée. Une seule série ajoutée peut avoir une sélection active.

Voir également GraphsItem3D::hasSeries().

void clearSelection()

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

void doPicking(QPoint point)

Effectue une sélection à l'aide des coordonnées de la vue issues de point sur les éléments du graphique, en choisissant le premier élément touché. Le traitement par défaut des entrées effectue cette opération à la réception de l'événement onTapped.

Voir également selectedElement.

void doRayPicking(QVector3D origin, QVector3D direction)

Effectue une sélection en commençant par origin et en suivant la méthode direction sur les éléments du graphe, en choisissant le premier élément trouvé.

Voir également selectedElement.

bool hasSeries(Abstract3DSeries series)

Indique si l'series e a déjà été ajouté au graphe.

void insertSeries(int index, Bar3DSeries series)

Insère l'series à la position index dans la liste des séries. Si l'series a déjà été ajoutée à la liste, elle est déplacée vers la nouvelle index.

Remarque : lorsque l'on déplace une série vers une nouvelle index située après son ancien index, la nouvelle position dans la liste est calculée comme si la série se trouvait toujours à son ancien index ; l'index final correspond donc en réalité à index diminué d'un.

Voir également GraphsItem3D::hasSeries().

void releaseCustomItem(Custom3DItem item)

Récupère la propriété de item et supprime l'item du graphe.

Remarque : si le même élément est rajouté au graphe, le fichier de texture doit être redéfini.

Voir également Custom3DItem::textureFile.

void removeCustomItem(Custom3DItem item)

Supprime l'item e personnalisée. Supprime les ressources qui lui sont allouées.

void removeCustomItemAt(vector3d position)

Supprime tous les éléments personnalisés disponibles à 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(Bar3DSeries series)

Supprimez l'series e du graphique.

Voir aussi GraphsItem3D::hasSeries().

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

Exporte une coupe 2D à partir de la série disponible à l'adresse requestedIndex et enregistre le résultat dans une image à l'filePath spécifiée. La coupe exportée comprend des barres de ligne ou de colonne, définies par sliceType.

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

Abstract3DAxis selectedAxis()

Permet d'obtenir l'axe sélectionné après réception d'un signal « selectedElementChanged » avec n'importe quel type d'étiquette. La sélection reste valide jusqu'au prochain signal « selectedElementChanged ».

Renvoie l'axe sélectionné, ou null.

Voir également selectedElement.

Custom3DItem selectedCustomItem()

Permet d'obtenir l'élément personnalisé sélectionné après réception d'un signal « selectedElementChanged » de type « ElementType.CustomItem ». La propriété de l'élément reste celle du graphe. La sélection reste valable jusqu'au prochain signal « selectedElementChanged ».

Renvoie l’élément personnalisé sélectionné, ou null.

Voir également selectedElement.

qsizetype selectedCustomItemIndex()

Permet d'interroger l'index de l'élément personnalisé sélectionné après réception d'un signal « selectedElementChanged » de type « ElementType.CustomItem ». La sélection reste valide jusqu'au prochain signal « selectedElementChanged ».

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

Voir également selectedElement.

int selectedLabelIndex()

Permet d'interroger l'index de l'étiquette sélectionnée après réception d'un signal « selectedElementChanged » (sélection d'étiquette), quel que soit le type d'étiquette. La sélection reste valide jusqu'au prochain signal « selectedElementChanged » (réinitialisation de l'étiquette).

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

Voir également selectedElement.

void setDefaultInputHandler()

* * @brief Rétablit 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-la 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 souris utilisé pour déclencher les événements de glisser-déposer. * * Cette méthode permet de remplacer le bouton de souris requis pour lancer * une opération de glisser-déposer par button. * La valeur par défaut est Qt::RightButton.

[since 6.12] void setPanButton(Qt::MouseButtons button)

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

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

void unsetDefaultDragHandler()

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

Voir également 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ées par défaut prédéfinis. * Appelez cette méthode lorsque vous souhaitez remplacer les comportements par défaut. *

Voir également unsetDefaultTapHandler(), unsetDefaultDragHandler(), unsetDefaultWheelHandler() et unsetDefaultPinchHandler().

void unsetDefaultPinchHandler()

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

Voir également unsetDefaultInputHandler().

void unsetDefaultTapHandler()

* * @brief Désactive le gestionnaire d'événements de tap par défaut. * * Cela désactive spécifiquement la réponse intégrée aux événements de tap ou de clic, * ce qui permet de mettre en place une logique personnalisée de gestion des taps. *

Voir également unsetDefaultInputHandler().

void unsetDefaultWheelHandler()

* * @brief Désactive le gestionnaire d'événements par défaut de la molette de souris. * * Cela désactive spécifiquement la réponse intégrée au défilement par la molette de souris. * À utiliser lorsque vous implémentez un comportement personnalisé de la molette. *

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