ChartView QML Type

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

• Liste de tous les membres, y compris les membres hérités

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)
• bool isZoomed()
• point mapToPosition(point value, AbstractSeries series)
• point mapToValue(point position, AbstractSeries series)
• void removeAllSeries()
• void removeSeries(AbstractSeries series)
• void scrollDown(real pixels)
• void scrollLeft(real pixels)
• void scrollRight(real pixels)
• void scrollUp(real pixels)
• AbstractSeries series(int index)
• AbstractSeries series(string name)
• void setAxisX(AbstractAxis axis, AbstractSeries series)
• void setAxisY(AbstractAxis axis, AbstractSeries series)
• void zoom(real factor)
• void zoomIn()
• void zoomIn(rect rectangle)
• void zoomOut()
• void 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 sur les 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 :

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 aussi 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

Indique si l'effet d'ombre portée de l'arrière-plan est activé.

Si la valeur est 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 parts de tarte 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 des graphiques.

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.

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

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

Voir aussi locale.

margins : Margins

Marges minimales autorisées entre le bord du rectangle du graphique et la zone de tracé. Les 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é n'inclut 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 lui attribuer la valeur 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.

Les valeurs suivantes sont prises en charge :

title : string

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

Voir aussi titleColor.

titleColor : color

La couleur du texte du titre.

titleFont : font

La police du titre du graphique.

Pour plus d'informations, voir font.

Documentation sur les signaux

seriesAdded(AbstractSeries series)

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

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.

Documentation de la méthode

Axis axisX(AbstractSeries series)

L'axe des x du site series.

Voir aussi setAxisX().

Axis axisY(AbstractSeries series)

L'axe des ordonnées du site 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, les valeurs d'énumération suivantes peuvent être utilisées comme valeurs de

// 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:

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

void removeAllSeries()

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

void removeSeries(AbstractSeries series)

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

void scrollDown(real pixels)

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

void scrollLeft(real pixels)

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

void scrollRight(real pixels)

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

void scrollUp(real pixels)

Fait défiler vers le haut le nombre de pixels spécifié par pixels. Il s'agit d'une méthode pratique qui convient à la navigation par touches, par exemple.

AbstractSeries series(int index)

Renvoie la série avec l'index index sur le graphique. Avec la propriété count du graphique, cela permet de parcourir en boucle les séries d'un graphique.

Voir aussi 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.

void setAxisX(AbstractAxis axis, AbstractSeries series)

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

Voir aussi axisX().

void setAxisY(AbstractAxis axis, AbstractSeries series)

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

Voir aussi axisY().

void zoom(real factor)

Effectue un zoom sur le graphique en fonction du 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 d'en sortir.

void zoomIn()

Agrandit la vue d'un facteur de deux.

void zoomIn(rect rectangle)

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

void zoomOut()

Agrandit la vue d'un facteur de deux.

void zoomReset()

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