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: |
Propriétés
- animationDuration : int
- animationEasingCurve : easing
- animationOptions : enumeration
- axes : list<AbstractAxis>
- backgroundColor : color
- backgroundRoundness : real
- count : int
- dropShadowEnabled : bool
- legend : Legend
- locale : locale
(since QtCharts 2.0) - localizeNumbers : bool
(since QtCharts 2.0) - margins : Margins
- plotArea : rect
- plotAreaColor : color
- theme : enumeration
- title : string
- titleColor : color
- titleFont : font
Signaux
- seriesAdded(AbstractSeries series)
- seriesRemoved(AbstractSeries series)
Méthodes
- Axis axisX(AbstractSeries series)
- Axis axisY(AbstractSeries series)
- AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
- isZoomed()
- point mapToPosition(point value, AbstractSeries series)
- point mapToValue(point position, AbstractSeries series)
- removeAllSeries()
- removeSeries(AbstractSeries series)
- scrollDown(real pixels)
- scrollLeft(real pixels)
- scrollRight(real pixels)
- scrollUp(real pixels)
- AbstractSeries series(int index)
- AbstractSeries series(string name)
- setAxisX(AbstractAxis axis, AbstractSeries series)
- setAxisY(AbstractAxis axis, AbstractSeries series)
- zoom(real factor)
- zoomIn()
- zoomIn(rect rectangle)
- zoomOut()
- zoomReset()
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 :
| Constante | Description |
|---|---|
ChartView.NoAnimation | L'animation est désactivée dans le graphique. Il s'agit de la valeur par défaut. |
ChartView.GridAxisAnimations | L'animation de l'axe de la grille est activée dans le graphique. |
ChartView.SeriesAnimations | L'animation des séries est activée dans le graphique. |
ChartView.AllAnimations | Tous 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 |
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 |
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 :
| Constante | Description |
|---|---|
ChartView.ChartThemeLight | Le thème clair, qui est le thème par défaut. |
ChartView.ChartThemeBlueCerulean | Le thème bleu céruléen. |
ChartView.ChartThemeDark | Thème sombre. |
ChartView.ChartThemeBrownSand | Le thème brun sable. |
ChartView.ChartThemeBlueNcs | Le thème bleu du système de couleurs naturelles (NCS). |
ChartView.ChartThemeHighContrast | Le thème à fort contraste. |
ChartView.ChartThemeBlueIcy | Le thème bleu glacé. |
ChartView.ChartThemeQt | Le 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.
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:
| Constante | Description |
|---|---|
ChartView.SeriesTypeLine | Une série de lignes. |
ChartView.SeriesTypeArea | Une série de surfaces. |
ChartView.SeriesTypeBar | Une série de barres. |
ChartView.SeriesTypeStackedBar | Une série de barres empilées. |
ChartView.SeriesTypePercentBar | Une série de barres en pourcentage. |
ChartView.SeriesTypeBoxPlot | Une série de diagrammes en boîte. |
ChartView.SeriesTypeCandlestick | Une série de chandeliers. |
ChartView.SeriesTypePie | Une série de camemberts. |
ChartView.SeriesTypeScatter | Une série de nuages de points. |
ChartView.SeriesTypeSpline | Une série de splines. |
ChartView.SeriesTypeHorizontalBar | Une série de barres horizontales. |
ChartView.SeriesTypeHorizontalStackedBar | Une série de barres horizontales empilées. |
ChartView.SeriesTypeHorizontalPercentBar | Une 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) |
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.