ValueAxis QML Type

Ajoute des valeurs aux axes d'un graphique. En savoir plus...

• Liste de tous les membres, y compris les membres hérités
• ValueAxis fait partie des types QML 2D d'Qt Graphs .

Propriétés

• labelDecimals : int
• labelFormat : string
• labelPostFormat : string (since 6.12)
• max : real
• min : real
• pan : real (since 6.9)
• subTickCount : int
• tickAnchor : real
• tickInterval : real
• visualMax : real (since 6.11)
• visualMin : real (since 6.11)
• zoom : real (since 6.9)

Signaux

• labelDecimalsChanged(int decimals)
• labelFormatChanged(string format)
• labelPostFormatChanged(string format) (since 6.12)
• maxChanged(real max)
• minChanged(real min)
• rangeChanged(real min, real max)
• subTickCountChanged(int subTickCount)
• tickAnchorChanged(real tickAnchor)
• tickIntervalChanged(real tickInterval)

Description détaillée

Le type ValueAxis peut être configuré pour afficher une ligne d'axe avec des graduations, des lignes de quadrillage et des ombres. Les valeurs sur l'axe sont tracées aux emplacements des graduations.

L'exemple de code suivant illustre l'utilisation du type ValueAxis :

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

Documentation sur les propriétés

labelDecimals : int

Nombre de décimales utilisées pour afficher les étiquettes. Lorsque cette valeur est définie sur -1, le nombre de décimales est ajusté automatiquement en fonction de la plage de valeurs. La valeur par défaut est -1.

labelFormat : string

La chaîne de format prend en charge les spécificateurs de conversion, les modificateurs de longueur et les indicateurs suivants, fournis par la fonction ` printf() ` de la bibliothèque C++ standard : d, i, o, x, X, f, F, e, E, g, G, c. La chaîne formatée est ensuite traitée par la fonction ` ValueAxis::labelPostFormat`.

La valeur par défaut est vide ; dans ce cas, le format « f » est utilisé.

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Voir également QString::asprintf().

labelPostFormat : string [since 6.12]

L'étiquette passe d'abord par ` ValueAxis::labelFormat ` pour mettre la valeur en forme, puis par ceci.

La valeur par défaut est « %1 ».

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Cette propriété a été introduite dans Qt 6.12.

Voir également QString::arg().

max : real

La valeur maximale sur l'axe.

Lors de la définition de cette propriété, la valeur minimale est ajustée si nécessaire, afin de garantir que la plage reste valide. La valeur par défaut est 10,0.

min : real

La valeur minimale sur l'axe.

Lors de la définition de cette propriété, la valeur maximale est ajustée si nécessaire, afin de garantir que la plage reste valide. La valeur par défaut est 0,0.

pan : real [since 6.9]

Valeur de panoramique de l'axe.

La valeur de panoramique déplace le centre de l'axe sans affecter les intervalles de la grille ni les étiquettes. La valeur par défaut est 0.

Cette propriété a été introduite dans Qt 6.9.

subTickCount : int

Nombre de graduations secondaires sur l'axe. Ce paramètre indique le nombre de graduations secondaires affichées entre les lignes principales du graphique. Les graduations secondaires ne sont pas accompagnées de libellés. La valeur par défaut est 0.

tickAnchor : real

Valeur de référence à partir de laquelle sont placés les repères et les libellés générés dynamiquement. La valeur par défaut est 0.

tickInterval : real

Intervalle entre les repères et les étiquettes placés dynamiquement. La valeur par défaut est 0, ce qui signifie que les intervalles sont calculés automatiquement en fonction des valeurs minimale et maximale de l'intervalle.

visualMax : real [read-only, since 6.11]

Valeur maximale d'affichage de l'axe.

Cette propriété contient la valeur maximale visuelle de l’axe lorsque celui-ci a fait l’objet d’un déplacement ou d’un zoom. La valeur par défaut est max

Cette propriété a été introduite dans Qt 6.11.

visualMin : real [read-only, since 6.11]

Valeur minimale d'affichage de l'axe.

Cette propriété contient la valeur minimale visuelle de l'axe lorsque celui-ci a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est min

Cette propriété a été introduite dans Qt 6.11.

zoom : real [since 6.9]

La valeur de zoom de l'axe.

La valeur de zoom agrandit ou réduit l'axe, et donc le graphique, sans affecter les intervalles de la grille ni les étiquettes. La valeur par défaut est 1.

Cette propriété a été introduite dans Qt 6.9.

Documentation sur les signaux

labelDecimalsChanged(int decimals)

Ce signal est émis lorsque le nombre de décimales de l'étiquette d'axe passe à decimals.

labelFormatChanged(string format)

Ce signal est émis lorsque le format des étiquettes d'axe passe à « format ».

[since 6.12] labelPostFormatChanged(string format)

Ce signal est émis lorsque le format des étiquettes d'axe passe à « format ».

Ce signal a été introduit dans Qt 6.12.

maxChanged(real max)

Ce signal est émis lorsque la valeur maximale de l'axe passe à max.

minChanged(real min)

Ce signal est émis lorsque la valeur minimale de l'axe passe à min.

rangeChanged(real min, real max)

Ce signal est émis lorsque la valeur minimale ou maximale de l'axe passe respectivement à min et max.

subTickCountChanged(int subTickCount)

Ce signal est émis lorsque le nombre de sous-crans sur l'axe, spécifié par subTickCount, change.

tickAnchorChanged(real tickAnchor)

Ce signal est émis lorsque la valeur d'ancrage du tick passe à tickAnchor.

tickIntervalChanged(real tickInterval)

Ce signal est émis lorsque la valeur de l'intervalle de tick passe à « tickInterval ».