Sur cette page

GraphsView QML Type

Type de base pour toutes les vues Qt Graphs. Plus d'informations...

Import Statement: import QtGraphs

Propriétés

Méthodes

Description détaillée

Cette classe rassemble les séries et les thèmes et dessine les graphiques. Vous devez importer le module Qt Graphs pour utiliser ce type :

import QtGraphs

Ensuite, vous pouvez utiliser GraphsView dans vos fichiers qml :

import QtQuick
import QtGraphs

GraphsView {
    anchors.fill: parent
    theme: GraphsTheme {
        colorScheme: GraphsTheme.ColorScheme.Dark
        seriesColors: ["#E0D080", "#B0A060"]
        borderColors: ["#807040", "#706030"]
        grid.mainColor: "#ccccff"
        grid.subColor: "#eeeeff"
        axisY.mainColor: "#ccccff"
        axisY.subColor: "#eeeeff"
    }
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis {
        min: 0
        max: 10
        subTickCount: 4
    }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
        BarSet {
            values: [9, 8, 6]
        }
    }
}

Voir aussi BarSeries, LineSeries, BarCategoryAxis, ValueAxis, et GraphsTheme.

Documentation sur les propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série dans cette vue.

Remarque : il n'est pas possible de définir le même axe pour plusieurs GraphsViews.

Voir aussi axisY.

axisXSmoothing : real

Contrôle le degré de lissage (anticrénelage) de l'axe X du graphique. Par défaut, le lissage est de 1.0.

axisY : AbstractAxis

L'axe des ordonnées utilisé pour la série dans cette vue.

Remarque : il n'est pas possible de définir le même axe pour plusieurs GraphsViews.

Voir aussi axisX.

axisYSmoothing : real

Contrôle le niveau de lissage (anti-crénelage) de l'axe des Y du graphique. Par défaut, le lissage est de 1.0.

clipPlotArea : bool [since 6.10]

Contrôle si les éléments du graphique doivent être coupés s'ils sortent de la zone de tracé. La valeur par défaut est true.

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

Voir également plotArea.

gridSmoothing : real

Contrôle le niveau de lissage (anti-crénelage) de la grille du graphique. Par défaut, le lissage est de 1.0.

marginBottom : real

La quantité d'espace vide au bas du graphique. Par défaut, la marge est de 20.

marginLeft : real

La quantité d'espace vide à gauche du graphique. Par défaut, la marge est de 20.

marginRight : real

La quantité d'espace vide à droite du graphique. Par défaut, la marge est de 20.

marginTop : real

La quantité d'espace vide en haut du graphique. Par défaut, la marge est de 20.

orientation : Qt.Orientation

Détermine l'orientation de la page GraphsView. Lorsque l'orientation est Qt.Horizontal, axisX et axisY inverseront les positions de sorte que axisX soit rendu verticalement et axisY horizontalement. Cette propriété est actuellement utilisée par BarSeries. La valeur par défaut est Qt.Vertical.

panStyle : enumeration

Détermine le style de panoramique du GraphsView. Le panoramique fonctionne en manipulant la propriété de panoramique d'un ValueAxis. La valeur par défaut est GraphsView.PanStyle.None.

ConstanteDescription
GraphsView.PanStyle.NoneLe panoramique est désactivé.
GraphsView.PanStyle.DragLe déplacement de la souris et du toucher permet de faire pivoter la vue.

plotArea : rect [read-only, since 6.9]

Le rectangle à l'intérieur duquel le graphique est dessiné. Il s'agit de la zone GraphsView moins les zones d'axe et les marges.

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

Voir aussi marginTop, marginBottom, marginLeft, et marginRight.

seriesList : list [read-only]

Liste des séries qui sont rendues par le site GraphsView. Remplie automatiquement avec les séries de type enfants du site GraphsView.

Il s'agit de la propriété par défaut, de sorte que les éléments enfants sont automatiquement ajoutés à la liste des séries.

Voir aussi BarSeries, LineSeries, et ScatterSeries.

shadowBarWidth : real

Contrôle la largeur de l'ombre de la grille du graphique. Par défaut, la largeur de l'ombre est fixée à 2.0.

shadowColor : color

Contrôle la couleur de l'ombre de la grille du graphique. Par défaut, la couleur de l'ombre est fixée à black.

shadowSmoothing : real

Contrôle le niveau de lissage (anti-crénelage) de l'ombre de la grille du graphique. Par défaut, le lissage des ombres est fixé à 4.0.

shadowVisible : bool

Contrôle si l'ombre de la grille du graphique est visible. Par défaut, la visibilité de l'ombre est fixée à false.

shadowXOffset : real

Contrôle le décalage X de l'ombre de la grille du graphique. Par défaut, le décalage X de l'ombre est fixé à 0.0.

shadowYOffset : real

Contrôle le décalage en Y de l'ombre de la grille du graphique. Par défaut, le décalage Y de l'ombre est fixé à 0.0.

theme : GraphsTheme

Thème utilisé par le graphique. Il détermine la coloration, les lignes d'axe, les polices de caractères, etc. Si le thème n'a pas été défini, le thème par défaut est utilisé.

zoomAreaDelegate : Component

Détermine l'élément QML qui est dessiné lorsque l'utilisateur effectue un mouvement de glissement pour zoomer sur une zone.

zoomAreaEnabled : bool

La zone de zoom change la souris et le glissement tactile pour dessiner une boîte déterminée par zoomAreaDelegate. Au relâchement, les propriétés de zoom et de panoramique du graphique ValueAxis sont modifiées de sorte que la vue ne couvre que la zone intersectée par la boîte dessinée.

Voir aussi zoomAreaDelegate.

zoomSensitivity : real

Détermine la vitesse à laquelle la valeur du zoom change pendant le zoom.

zoomStyle : enumeration

Détermine le style de zoom de la page GraphsView. Le zoom s'effectue en manipulant la propriété ValueAxis zoom. La valeur par défaut est GraphsView.ZoomStyle.None.

ConstanteDescription de la constante
GraphsView.ZoomStyle.NoneLe zoom est désactivé.
GraphsView.ZoomStyle.CenterLe zoom par pincement et la molette de la souris permettent de zoomer vers le centre de la vue du graphique.

Documentation de la méthode

void addSeries(AbstractSeries series)

Ajoute un series à un GraphsView. Si le series est nul, il ne sera pas ajouté. Si le series appartient déjà au graphe, il sera déplacé à la fin.

bool hasSeries(AbstractSeries series)

Renvoie true si le site series se trouve dans le graphique.

void insertSeries(int index, AbstractSeries series)

Insère un series à la position spécifiée par index. Si le series est nul, il ne sera pas inséré. Si le series appartient déjà au graphe, il sera déplacé dans le index.

void removeSeries(AbstractSeries series)

Supprime le site series du graphique.

void removeSeries(int index)

Supprime du graphique la série spécifiée par index.

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