AbstractBarSeries QML Type

Un type parent abstrait pour tous les types de séries de barres. Plus d'informations...

• 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 diagrammes à barres, les barres sont définies comme des ensembles de barres qui contiennent une valeur de données pour chaque catégorie. La position d'une barre est spécifiée par la catégorie et sa hauteur par la valeur des données. Les séries de barres qui contiennent plusieurs ensembles de barres regroupent les barres qui appartiennent à la même catégorie. La façon dont les barres sont affichées est déterminée par le type choisi pour créer le diagramme à barres : BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries, ou HorizontalPercentBarSeries.

Si un type ValueAxis est utilisé au lieu d'un type BarCategoryAxis pour l'axe principal des barres, les barres sont regroupées autour de la valeur de l'indice de la catégorie.

L'extrait de code QML suivant montre comment utiliser les types BarSeries et BarCategoryAxis pour créer un diagramme à 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 sur les propriétés

axisX : AbstractAxis

L'axe des x utilisé pour la série. Si vous laissez axisX et axisXTop indéfinis, un BarCategoryAxis est créé pour la série.

Voir également axisXTop.

axisXTop : AbstractAxis

L'axe des abscisses utilisé pour la série, dessiné au-dessus de la vue du graphique.

Voir également axisX.

axisY : AbstractAxis

L'axe des ordonnées utilisé pour la série. Si vous laissez axisY et axisYRight indéfinis, un ValueAxis est créé pour la série.

Voir également axisYRight.

axisYRight : AbstractAxis

L'axe des ordonnées utilisé pour la série, dessiné à droite de la vue du graphique.

Voir également axisY.

barWidth : real

L'unité de largeur est l'unité de l'axe des x. La largeur minimale des barres est de zéro, et les valeurs négatives sont traitées comme zéro. En fixant la largeur à zéro, la largeur de la barre à l'écran est d'un pixel, quelle que soit l'échelle de l'axe des x. Les barres plus larges que zéro sont mises à l'échelle selon l'échelle de l'axe des x. Les barres plus larges que zéro sont mises à l'échelle en utilisant l'échelle de l'axe des x.

count : int [read-only]

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

labelsAngle : real

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

labelsFormat : string

Format utilisé pour afficher les étiquettes dans une série de barres.

Voir aussi QAbstractBarSeries::labelsFormat, labelsVisible, et labelsPosition.

labelsPosition : enumeration

La position des étiquettes des valeurs de données :

Voir également labelsVisible et labelsFormat.

labelsPrecision : real

Le nombre maximum 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 barres.

Documentation sur les signaux

barsetsAdded()

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

Le gestionnaire de signal correspondant est onBarsetsAdded.

barsetsRemoved()

Ce signal est émis lorsque des jeux de barres sont supprimé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 lorsque la souris passe au-dessus de la barre spécifiée par index dans l'ensemble de barres spécifié par barset. Lorsque la souris passe au-dessus de la barre, status devient true, et lorsque la souris s'éloigne à nouveau, elle devient 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 qu'il 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 la pression 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 de la méthode

BarSet append(string label, VariantList values)

Ajoute un nouvel ensemble de barres avec label et values à l'index. 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 fixée à index. Retourne null si l'index n'est pas valide.

void clear()

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

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

Ajoute un nouvel ensemble de barres avec 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, la nouvelle série de mesures est ajoutée à la série de mesures. Si la valeur de l'index est égale ou supérieure au nombre de séries de barres dans la série de barres, la nouvelle série de barres est ajoutée à la série de barres.

Voir également append().

bool remove(BarSet barset)

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