AbstractBarSeries QML Type

Un type parent abstrait pour tous les types de séries de barres. 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

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool

Signaux

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

Méthodes

• BarSet append(string label, VariantList values)
• BarSet at(int index)
• void clear()
• BarSet insert(int index, string label, VariantList values)
• bool remove(BarSet barset)

Description détaillée

Dans les graphiques à barres, les barres sont définies comme des ensembles de barres contenant une valeur de données pour chaque catégorie. La position d'une barre est déterminée par la catégorie et sa hauteur par la valeur de données. Les séries de barres contenant plusieurs ensembles de barres regroupent les barres appartenant à la même catégorie. L'affichage des barres est déterminé par le type choisi pour créer le graphique à barres : « BarSeries », « StackedBarSeries », « PercentBarSeries », « HorizontalBarSeries », « HorizontalStackedBarSeries » ou « HorizontalPercentBarSeries ».

Si le type « ValueAxis » est utilisé à la place du type « BarCategoryAxis » pour l’axe principal du graphique à barres, les barres sont regroupées autour de la valeur d’index de la catégorie.

L'extrait de code QML suivant montre comment utiliser les types BarSeries et BarCategoryAxis pour créer un graphique à barres simple :

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}

Documentation des propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous ne définissez ni axisX ni axisXTop, un BarCategoryAxis est créé pour la série.

Voir également axisXTop.

axisXTop : AbstractAxis

L'axe des x utilisé pour la série, tracé par-dessus la vue graphique.

Voir également axisX.

axisY : AbstractAxis

L'axe des y utilisé pour la série. Si vous ne définissez ni axisY ni axisYRight, un ValueAxis est créé pour la série.

Voir également axisYRight.

axisYRight : AbstractAxis

L'axe des y utilisé pour la série, tracé à droite de la vue graphique.

Voir également axisY.

barWidth : real

L'unité de largeur correspond à l'unité de l'axe x. La largeur minimale des barres est zéro, et les valeurs négatives sont considérées comme égales à zéro. Définir la largeur sur zéro signifie que la largeur de la barre à l'écran est d'un pixel, quelle que soit l'échelle de l'axe x. Les barres dont la largeur est supérieure à zéro sont mises à l'échelle en fonction de l'échelle de l'axe x.

count : int [read-only]

Le nombre de barres dans une série de barres.

labelsAngle : real

L'angle des étiquettes de valeur, exprimé en degrés.

labelsFormat : string

Format utilisé pour l'affichage des étiquettes dans une série de graphiques à barres.

Voir également QAbstractBarSeries::labelsFormat, labelsVisible et labelsPosition.

labelsPosition : enumeration

La position des étiquettes de valeurs :

Voir également labelsVisible et labelsFormat.

labelsPrecision : real

Nombre maximal de chiffres significatifs affichés dans les étiquettes de valeur.

La valeur par défaut est 6.

labelsVisible : bool

La visibilité des étiquettes dans une série de graphiques à barres.

Documentation Signal

barsetsAdded()

Ce signal est émis lorsque des ensembles de barres sont ajoutés à la série.

Le gestionnaire de signal correspondant est onBarsetsAdded.

barsetsRemoved()

Ce signal est émis lorsque des ensembles de barres sont retirés de la série.

Le gestionnaire de signal correspondant est onBarsetsRemoved.

clicked(int index, BarSet barset)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

Le gestionnaire de signal correspondant est onClicked.

doubleClicked(int index, BarSet barset)

Ce signal est émis lorsque l'utilisateur double-clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

Le gestionnaire de signal correspondant est onDoubleClicked.

hovered(bool status, int index, BarSet barset)

Ce signal est émis lorsqu'un curseur de souris survole la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Lorsque la souris survole la barre, status devient true, et lorsque la souris s'en éloigne, il redevient false.

Le gestionnaire de signal correspondant est onHovered.

pressed(int index, BarSet barset)

Ce signal est émis lorsque l'utilisateur clique sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset et maintient le bouton de la souris enfoncé.

Le gestionnaire de signal correspondant est onPressed.

released(int index, BarSet barset)

Ce signal est émis lorsque l'utilisateur relâche le bouton de la souris sur la barre spécifiée par index dans l'ensemble de barres spécifié par barset.

Le gestionnaire de signal correspondant est onReleased.

Documentation des méthodes

BarSet append(string label, VariantList values)

Ajoute à l'index un nouvel ensemble de barres comprenant label et values. values est une liste de valeurs réelles.

Par exemple :

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

Renvoie la barre définie à l'adresse index. Renvoie null si l'index n'est pas valide.

void clear()

Supprime tous les ensembles de barres de la série.

BarSet insert(int index, string label, VariantList values)

Ajoute un nouvel ensemble de barres avec les paramètres « label » et « values » à « index ». « values » peut être une liste de valeurs réelles ou une liste de types « XYPoint ».

Si la valeur de l'index est inférieure ou égale à zéro, le nouvel ensemble de barres est ajouté au début de la série de barres. Si la valeur de l'index est supérieure ou égale au nombre d'ensembles de barres de la série, le nouvel ensemble de barres est ajouté à la fin de la série.

Voir également append().

bool remove(BarSet barset)

Supprime de la série l'ensemble de barres spécifié par ` barset `. Renvoie ` true ` en cas de succès, ` false ` dans le cas contraire.