ChartView QML Type

Gère la représentation graphique des séries, des légendes et des axes du graphique. En savoir plus…

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• 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 affiche 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 du graphique.

animationEasingCurve : easing

La courbe d'atténuation de l'animation du graphique.

animationOptions : enumeration

Animations activées dans le graphique :

axes : list<AbstractAxis>

Les axes du graphique.

backgroundColor : color

La couleur d'arrière-plan du graphique. Par défaut, la couleur d'arrière-plan est définie par le thème du graphique.

Voir aussi theme.

backgroundRoundness : real

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

count : int

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

dropShadowEnabled : bool

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

Si la valeur est définie sur « true », l’effet d’ombre portée de l’arrière-plan est activé. Si la valeur est définie sur « false », il est désactivé.

legend : Legend

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

locale : locale [since QtCharts 2.0]

Les paramètres régionaux utilisés pour mettre en forme les différentes étiquettes des graphiques.

Les libellés ne sont localisés que lorsque la propriété « localizeNumbers » est définie sur « true », à l'exception des libellés de l'axe DateTimeAxis, qui utilisent toujours la chaîne « QLocale » définie par cette propriété.

La valeur par défaut correspond aux paramètres régionaux de l'application au moment de la création 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 les libellés d’axe seront localisés à l’aide de l’ QLocale, défini par la propriété locale. Lorsque 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 également locale.

margins : Margins

Marges minimales autorisées entre le bord du rectangle du graphique et la zone de tracé. Ces marges servent à tracer le titre, les axes et la légende.

plotArea : rect

Le rectangle dans lequel le graphique est tracé.

La zone de tracé n'inclut pas la zone définie par les marges. Par défaut, sa taille s'adapte si elle se trouve à l'intérieur d'un élément ` ChartView`. Si un rectangle explicite est défini pour la zone de tracé, celui-ci sera respecté ; pour revenir au comportement par défaut, il suffit de le définir sur ` Qt.rect(0, 0, 0, 0) `.

Voir également margins.

plotAreaColor : color

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é reprend la couleur d'arrière-plan du graphique, qui est définie par le thème du graphique.

Voir également backgroundColor et theme.

theme : enumeration

Le thème utilisé par le graphique.

Un thème est un ensemble intégré de paramètres liés au style de l'interface utilisateur, qui s'appliquent à tous les éléments visuels d'un graphique, tels que les couleurs, les stylos, les pinceaux et les polices des séries, ainsi que les axes, le titre et la légende. L'exemple « Qml Oscilloscope » illustre comment définir un thème.

Les valeurs suivantes sont prises en charge :

title : string

Le titre apparaît sous forme d'en-tête en haut du graphique. Les titres des graphiques prennent en charge la mise en forme HTML.

Voir également titleColor.

titleColor : color

La couleur du texte du titre.

titleFont : font

La police utilisée pour le titre du graphique.

Pour plus d'informations, consultez 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 de série devient invalide une fois que le gestionnaire de signal a terminé son exécution.

Documentation des méthodes

Axis axisX(AbstractSeries series)

L'axe des x de l'series.

Voir également setAxisX().

Axis axisY(AbstractSeries series)

L'axe des y de l'series.

Voir également setAxisY().

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

Ajoute une série de type « type » au graphique sous 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` :

bool isZoomed()

Renvoie « true » si une série quelconque présente 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 efface 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 de série.

void scrollDown(real pixels)

Fait défiler vers le bas du nombre de pixels spécifié par ` pixels`. Il s'agit d'une méthode pratique, adaptée notamment à la navigation à l'aide des touches du clavier.

void scrollLeft(real pixels)

Fait défiler vers la gauche du nombre de pixels spécifié par ` pixels`. Il s'agit d'une méthode pratique, adaptée notamment à la navigation à l'aide des touches du clavier.

void scrollRight(real pixels)

Fait défiler vers la droite du nombre de pixels spécifié par ` pixels`. Il s'agit d'une méthode pratique adaptée, par exemple, à la navigation à l'aide des touches du clavier.

void scrollUp(real pixels)

Fait défiler vers le haut du nombre de pixels spécifié par ` pixels`. Il s'agit d'une méthode pratique, adaptée notamment à la navigation à l'aide des touches du clavier.

AbstractSeries series(int index)

Renvoie la série associée à l'index index du graphique. Associée à la propriété count du graphique, cette méthode permet de parcourir 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'existe aucune série portant ce nom, renvoie null.

void setAxisX(AbstractAxis axis, AbstractSeries series)

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

Voir aussi axisX().

void setAxisY(AbstractAxis axis, AbstractSeries series)

Définit l'axe des y de l'series sur axis.

Voir aussi axisY().

void zoom(real factor)

Effectue un zoom avant sur le graphique selon le facteur personnalisé factor.

Un facteur supérieur à 1,0 effectue un zoom avant sur la vue, tandis qu'un facteur compris entre 0,0 et 1,0 effectue un zoom arrière.

void zoomIn()

Agrandit la vue d'un facteur deux.

void zoomIn(rect rectangle)

Effectue un zoom avant sur la vue jusqu'au niveau maximal auquel le rectangle rectangle reste entièrement visible.

void zoomOut()

Réduit l'échelle de la vue d'un facteur deux.

void zoomReset()

Réinitialise les domaines de la série à leur état initial, avant l'appel de toute méthode de zoom.