GraphsView QML Type

Type de base pour toutes les vues « Qt Graphs ». En savoir plus…

• Liste de tous les membres, y compris les membres hérités
• GraphsView fait partie des types QML d'Qt Graphs pour la 2D.

Propriétés

• axisX : AbstractAxis
• axisXSmoothing : real
• axisY : AbstractAxis
• axisYSmoothing : real
• clipPlotArea : bool (since 6.10)
• dynamicLabelMargins : bool
• gridSmoothing : real
• marginBottom : real
• marginLeft : real
• marginRight : real
• marginTop : real
• orientation : Qt.Orientation
• panStyle : enumeration (since 6.9)
• plotArea : rect (since 6.9)
• seriesList : list
• shadowBarWidth : real
• shadowColor : color
• shadowSmoothing : real
• shadowVisible : bool
• shadowXOffset : real
• shadowYOffset : real
• theme : GraphsTheme
• zoomAreaDelegate : Component (since 6.9)
• zoomAreaEnabled : bool (since 6.9)
• zoomSensitivity : real (since 6.9)
• zoomStyle : enumeration (since 6.9)

Méthodes

• void addSeries(AbstractSeries series)
• bool hasSeries(AbstractSeries series)
• void insertSeries(int index, AbstractSeries series)
• void removeSeries(AbstractSeries series)
• void removeSeries(int index)

Description détaillée

Cette classe regroupe les séries et les thèmes, puis trace les graphiques. Vous devrez importer le module Qt Graphs pour utiliser ce type :

import QtGraphs

Vous pourrez ensuite 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 également BarSeries, LineSeries, BarCategoryAxis, ValueAxis et GraphsTheme.

Documentation sur les propriétés

axisX : AbstractAxis

L'axe des x utilisé pour les séries de cette vue.

Voir également axisY.

axisXSmoothing : real

Permet de régler le niveau de lissage (anti-aliasing) de l'axe X du graphique. Par défaut, le lissage est défini sur « 1.0 ».

axisY : AbstractAxis

L'axe des y utilisé pour les séries de cette vue.

Voir également axisX.

axisYSmoothing : real

Permet de régler le niveau de lissage (anti-aliasing) de l'axe des Y du graphique. Par défaut, le lissage est défini sur « 1.0 ».

clipPlotArea : bool [since 6.10]

Détermine si les éléments du graphique doivent être rognés lorsqu'ils dépassent les limites 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.

dynamicLabelMargins : bool

Cette propriété détermine si les marges des étiquettes s'ajustent de manière dynamique.

Par défaut, les étiquettes dont la largeur dépasse la marge allouée chevauchent d'autres éléments du graphique. Lorsque cette option est activée, le moteur de rendu réserve un espace supplémentaire pour ces étiquettes et repositionne les axes afin d'éviter tout chevauchement.

gridSmoothing : real

Permet de régler le niveau de lissage (anti-aliasing) de la grille du graphique. Par défaut, le lissage est défini sur « 1.0 ».

marginBottom : real

L'espace libre au bas du graphique. Par défaut, la marge est de 20.

marginLeft : real

L'espace libre situé à gauche du graphique. Par défaut, la marge est de 20.

marginRight : real

L'espace libre à droite du graphique. Par défaut, la marge est de 20.

marginTop : real

L'espace libre en haut du graphique. Par défaut, la marge est de 20.

orientation : Qt.Orientation

Détermine l'orientation de l'GraphsView. Lorsque l'orientation est définie sur « Qt.Horizontal », les éléments axisX et axisY échangent leurs positions afin que axisX s'affiche verticalement et axisY horizontalement. Cette propriété est actuellement utilisée par l'BarSeries. La valeur par défaut est « Qt.Vertical ».

panStyle : enumeration [since 6.9]

Détermine le style de panoramique de l'GraphsView. Le panoramique s'effectue en modifiant la propriété « pan » d'un ValueAxis. La valeur par défaut est « GraphsView.PanStyle.None ».

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

plotArea : rect [read-only, since 6.9]

Le rectangle dans lequel le graphique est tracé. Il s'agit de la zone d'GraphsView, déduction faite des zones des axes et des marges.

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

Voir également marginTop, marginBottom, marginLeft et marginRight.

seriesList : list [read-only]

Liste des séries générées par l'GraphsView. Elle est remplie automatiquement avec les éléments enfants de type « série » de l'GraphsView.

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

Voir également BarSeries, LineSeries et ScatterSeries.

shadowBarWidth : real

Permet de contrôler la largeur de l'ombre de la grille du graphique. Par défaut, la largeur de l'ombre est définie sur 2.0.

shadowColor : color

Permet de définir la couleur de l'ombre de la grille du graphique. Par défaut, la couleur de l'ombre est définie sur « black ».

shadowSmoothing : real

Permet de régler le niveau de lissage des ombres (anti-aliasing) de la grille du graphique. Par défaut, le lissage des ombres est défini sur « 4.0 ».

shadowVisible : bool

Détermine si l'ombre de la grille du graphique est visible. Par défaut, la visibilité de l'ombre est définie sur « false ».

shadowXOffset : real

Permet de contrôler le décalage horizontal de l'ombre de la grille du graphique. Par défaut, le décalage horizontal de l'ombre est défini sur 0.0.

shadowYOffset : real

Permet de contrôler le décalage vertical de l'ombre de la grille du graphique. Par défaut, le décalage vertical de l'ombre est défini sur 0.0.

theme : GraphsTheme

Thème utilisé par le graphique. Il détermine les couleurs, les lignes des axes, les polices, etc. Si aucun thème n'a été défini, c'est le thème par défaut qui est utilisé.

zoomAreaDelegate : Component [since 6.9]

Détermine l'élément QML qui s'affiche lorsque l'utilisateur effectue un glissement pour zoomer sur une zone.

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

zoomAreaEnabled : bool [since 6.9]

La fonction « Zoom area » transforme le glissement de la souris ou du doigt en un tracé de rectangle défini par zoomAreaDelegate. Lorsque l'on relâche le bouton, les propriétés de zoom et de panoramique de l'ValueAxis du graphique sont modifiées de manière à ce que la vue ne couvre plus que la zone recoupée par le rectangle tracé.

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

Voir également zoomAreaDelegate.

zoomSensitivity : real [since 6.9]

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

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

zoomStyle : enumeration [since 6.9]

Définit le style de zoom de l'GraphsView. Le zoom s'effectue en modifiant la propriété « zoom » de l'ValueAxis. La valeur par défaut est « GraphsView.ZoomStyle.None ».

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

Documentation de la méthode

void addSeries(AbstractSeries series)

Ajoute un « series » au grap GraphsView. Si l'series est nul, il ne sera pas ajouté. Si l'series fait déjà partie du graphe, il sera déplacé à la fin.

bool hasSeries(AbstractSeries series)

Renvoie « true » si l'series e figure dans le graphe.

void insertSeries(int index, AbstractSeries series)

Insère un « series » à la position indiquée par index. Si l'series est nulle, il ne sera pas inséré. Si le series fait déjà partie du graphe, il sera déplacé vers index.

void removeSeries(AbstractSeries series)

Supprime l'series e du graphique.

void removeSeries(int index)

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