ChartView QML Type

Gère la représentation graphique des séries, des légendes et des axes du graphique. Plus d'informations...

Import Statement: import QtCharts 2.10
Inherited By:

PolarChartView

Propriétés

Signaux

Méthodes

Description détaillée

Le type ChartView permet d'afficher différents types de séries sous forme de graphiques.

Cet exemple montre comment créer un simple graphique linéaire :

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

Documentation des propriétés

animationDuration : int

La durée de l'animation pour le graphique.


animationEasingCurve : easing

La courbe d'assouplissement de l'animation pour le graphique.


animationOptions : enumeration

Les animations activées dans le graphique :

ConstanteDescription
ChartView.NoAnimationL'animation est désactivée dans le graphique. Il s'agit de la valeur par défaut.
ChartView.GridAxisAnimationsL'animation de l'axe de la grille est activée dans le graphique.
ChartView.SeriesAnimationsL'animation des séries est activée dans le graphique.
ChartView.AllAnimationsTous les types d'animation sont activés dans le graphique.

axes : list<AbstractAxis>

Les axes du graphique.


backgroundColor : color

La couleur de l'arrière-plan du graphique. Par défaut, la couleur d'arrière-plan est spécifiée par le thème du graphique.

Voir également theme.


backgroundRoundness : real

Le diamètre du cercle d'arrondi aux coins de l'arrière-plan du graphique.


count : int

Le nombre de séries ajoutées au graphique.


dropShadowEnabled : bool

L'activation ou non de l'effet d'ombre portée sur l'arrière-plan.

S'il est défini sur true, l'effet d'ombre portée de l'arrière-plan est activé. S'il est défini sur false, il est désactivé.


legend : Legend

La légende du graphique. La légende répertorie toutes les séries, les camemberts et les ensembles de barres ajoutés au graphique.


locale : locale [since QtCharts 2.0]

La locale utilisée pour formater les différentes étiquettes du graphique.

Les étiquettes ne sont localisées que si localizeNumbers est true, à l'exception des étiquettes DateTimeAxis, qui utilisent toujours la locale QLocale définie avec cette propriété.

La valeur par défaut est la locale par défaut de l'application au moment de la construction du graphique.

Cette propriété a été introduite dans QtCharts 2.0.

Voir également localizeNumbers.


localizeNumbers : bool [since QtCharts 2.0]

Si les nombres sont localisés.

Lorsque true, tous les nombres générés apparaissant dans les différentes séries et étiquettes d'axes seront localisés en utilisant la locale QLocale définie avec la propriété locale. Avec false, la locale C est toujours utilisée. La valeur par défaut est false.

Remarque : cette propriété n'affecte pas les étiquettes DateTimeAxis, qui utilisent toujours la locale QLocale définie avec la propriété locale.

Cette propriété a été introduite dans QtCharts 2.0.

Voir également locale.


margins : Margins

Les marges minimales autorisées entre le bord du rectangle du graphique et la zone de tracé. Ces marges sont utilisées pour dessiner le titre, les axes et la légende.


plotArea : rect

Le rectangle à l'intérieur duquel le graphique est dessiné.

La zone de tracé ne comprend pas la zone définie par les marges. Par défaut, ce rectangle sera redimensionné s'il se trouve à l'intérieur d'un ChartView. Si un rectangle explicite est défini pour la zone de tracé, il sera respecté. Pour revenir au comportement par défaut, il suffit de le définir à Qt.rect(0, 0, 0, 0).

Voir également margins.


plotAreaColor : color

La couleur de l'arrière-plan de la zone de tracé du graphique. Par défaut, l'arrière-plan de la zone de tracé utilise la couleur d'arrière-plan du graphique, qui est spécifiée par le thème du graphique.

Voir également backgroundColor et theme.


theme : enumeration

Le thème utilisé par le graphique.

Un thème est une collection intégrée de paramètres liés au style de l'interface utilisateur et appliqués à tous les éléments visuels d'un graphique, tels que les couleurs, les stylos, les brosses et les polices de caractères des séries, ainsi que les axes, le titre et la légende. L'exemple de l'oscilloscope Qml illustre comment définir un thème.

Remarque : la modification du thème écrasera toutes les personnalisations précédemment appliquées à la série.

Les valeurs suivantes sont prises en charge :

ConstanteDescription
ChartView.ChartThemeLightLe thème clair, qui est le thème par défaut.
ChartView.ChartThemeBlueCeruleanLe thème bleu céruléen.
ChartView.ChartThemeDarkThème sombre.
ChartView.ChartThemeBrownSandLe thème brun sable.
ChartView.ChartThemeBlueNcsLe thème bleu du système de couleurs naturelles (NCS).
ChartView.ChartThemeHighContrastLe thème à fort contraste.
ChartView.ChartThemeBlueIcyLe thème bleu glacé.
ChartView.ChartThemeQtLe thème Qt.

title : string

Le titre est affiché en haut du graphique. Les titres des graphiques prennent en charge le formatage HTML.

Voir également titleColor.


titleColor : color

La couleur du texte du titre.


titleFont : font

La police du titre du graphique.

Pour plus d'informations, voir font.


Signal Documentation

seriesAdded(AbstractSeries series)

Ce signal est émis lorsque la série series est ajoutée au graphique.

Remarque : le gestionnaire correspondant est onSeriesAdded.


seriesRemoved(AbstractSeries series)

Ce signal est émis lorsque la série series est supprimée du graphique. L'objet série devient invalide lorsque le gestionnaire du signal s'achève.

Remarque : le gestionnaire correspondant est onSeriesRemoved.


Documentation de la méthode

Axis axisX(AbstractSeries series)

L'axe des abscisses de la série series.

Voir également setAxisX().


Axis axisY(AbstractSeries series)

L'axe des ordonnées de la série series.

Voir aussi setAxisY().


AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

Ajoute une série du type type au graphique avec le nom name et, éventuellement, les axes axisX et axisY. Par exemple :

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

Les valeurs d'énumération suivantes peuvent être utilisées comme valeurs de type:

ConstanteDescription
ChartView.SeriesTypeLineUne série de lignes.
ChartView.SeriesTypeAreaUne série de surfaces.
ChartView.SeriesTypeBarUne série de barres.
ChartView.SeriesTypeStackedBarUne série de barres empilées.
ChartView.SeriesTypePercentBarUne série de barres en pourcentage.
ChartView.SeriesTypeBoxPlotUne série de diagrammes en boîte.
ChartView.SeriesTypeCandlestickUne série de chandeliers.
ChartView.SeriesTypePieUne série de camemberts.
ChartView.SeriesTypeScatterUne série de nuages de points.
ChartView.SeriesTypeSplineUne série de splines.
ChartView.SeriesTypeHorizontalBarUne série de barres horizontales.
ChartView.SeriesTypeHorizontalStackedBarUne série de barres horizontales empilées.
ChartView.SeriesTypeHorizontalPercentBarUne série de barres horizontales en pourcentage.

isZoomed()

Renvoie true si une série a un domaine zoomé.


point mapToPosition(point value, AbstractSeries series)

Renvoie la position dans le graphique de la valeur value dans la série series.


point mapToValue(point position, AbstractSeries series)

Renvoie la valeur de la série series située à la position position dans le graphique.


removeAllSeries()

Supprime toutes les séries du graphique et supprime définitivement tous les objets séries.


removeSeries(AbstractSeries series)

Supprime la série series du graphique et supprime définitivement l'objet série.


scrollDown(real pixels)

Défilement vers le bas du nombre de pixels spécifié par pixels. Il s'agit d'une méthode pratique qui convient à la navigation par touches, par exemple.


scrollLeft(real pixels)

Défilement vers la gauche du nombre de pixels spécifié par pixels. Il s'agit d'une méthode de commodité adaptée à la navigation par touches, par exemple.


scrollRight(real pixels)

Défilement vers la droite du nombre de pixels spécifié par pixels. Il s'agit d'une méthode pratique adaptée à la navigation par touches, par exemple.


scrollUp(real pixels)

Défilement vers le haut du nombre de pixels spécifié par pixels. Il s'agit d'une méthode de commodité adaptée à la navigation par touches, par exemple.


AbstractSeries series(int index)

Renvoie la série avec l'index index sur le graphique. Associée à la propriété count du graphique, cette méthode permet de parcourir en boucle les séries d'un graphique.

Voir également count.


AbstractSeries series(string name)

Renvoie la première série du graphique portant le nom name. S'il n'y a pas de série portant ce nom, il renvoie null.


setAxisX(AbstractAxis axis, AbstractSeries series)

Définit l'axe des x de series à axis.

Voir également axisX().


setAxisY(AbstractAxis axis, AbstractSeries series)

Définit l'axe des ordonnées de series à axis.

Voir également axisY().


zoom(real facteur)

Zoome dans le graphique selon le facteur personnalisé factor.

Un facteur supérieur à 1,0 permet de zoomer dans la vue et un facteur compris entre 0,0 et 1,0 permet de zoomer hors de la vue.


zoomIn()

Zoom sur la vue par un facteur de deux.


zoomIn(rect rectangle)

Zoome dans la vue jusqu'à un niveau maximum auquel le rectangle rectangle est encore entièrement visible.

Remarque : cette fonction n'est pas prise en charge pour les cartes polaires.


zoomOut()

Effectue un zoom arrière d'un facteur de deux.

Note : Ceci n'aura aucun effet si le résultat contient une plage d'axe logarithmique invalide.


zoomReset()

Réinitialise les domaines de la série à ce qu'ils étaient avant l'appel d'une méthode de zoom.

Remarque : cette méthode réinitialise également les paramètres de défilement et de plage d'axes explicite spécifiés entre la première opération de zoom et l'appel à cette méthode. Si aucune opération de zoom n'a été effectuée, cette méthode ne fait rien.


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