DateTimeAxis QML Type

Ajoute des éléments de type DateTime à l'axe d'un graphique. En savoir plus…

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

Propriétés

• labelFormat : string
• max : real
• min : real
• pan : real (since 6.11)
• subTickCount : int
• tickCount : real (since 6.12)
• tickInterval : real (until 6.15)
• timeZone : QTimeZone (since 6.11)
• visualMax : real (since 6.11)
• visualMin : real (since 6.11)
• zoom : real (since 6.11)

Signaux

• labelFormatChanged(string format)
• maxChanged(DateTime max)
• minChanged(DateTime min)
• rangeChanged(real min, real max)
• subTickCountChanged(int subTickCount)
• tickCountChanged(real count) (since 6.12)
• tickIntervalChanged(real tickInterval) (until 6.15)
• timeZoneChanged() (since 6.11)
• zoomChanged() (since 6.11)

Méthodes

• string timeZoneAsString() (since 6.11)
• QTimeZone timeZoneFromString(string zoneId) (since 6.11)

Description détaillée

Un axe DateTime permet d'afficher des représentations DateTime à l'aide de repères et de lignes de quadrillage. Les éléments DateTime de l'axe sont affichés à la position des repères.

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

GraphsView {
    axisX: DateTimeAxis {
        min: new Date(2000,1,1)
        max: new Date(1970,1,1)
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

Documentation des propriétés

labelFormat : string

Le format des étiquettes DateTime sur l'axe. La propriété « format » permet de définir la représentation visuelle de l'objet DateTime, en jours, mois et années. La valeur par défaut est « dd-MMMM-yy ».

max : real

La valeur maximale sur l'axe.

Cette valeur peut être inférieure ou supérieure à la valeur minimale. La date-heure est stockée en interne au format UTC. La valeur par défaut est `new Date(1980, 1, 1)`.

min : real

La valeur minimale sur l'axe.

Cette valeur peut être inférieure ou supérieure à la valeur maximale. La date-heure est stockée en interne au format UTC. La valeur par défaut est new Date(1970,1,1).

pan : real [since 6.11]

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

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.

tickCount : real [since 6.12]

Nombre de graduations principales placées sur un axe. Si la valeur est égale à 0 ou inférieure, l'axe calcule automatiquement le nombre approprié de graduations. La valeur par défaut est 0.

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

tickInterval : real [until 6.15]

Cette propriété sera obsolète à partir de la version 6.15.

Nombre de graduations principales placées sur un axe. Si la valeur est égale à 0 ou inférieure, l'axe calculera automatiquement le nombre approprié de graduations. La valeur par défaut est 0. Utilisez plutôt « tickCount ».

timeZone : QTimeZone [since 6.11]

Le fuseau horaire qui sera utilisé pour afficher les libellés des axes. Les valeurs acceptées correspondent aux identifiants de fuseaux horaires de l’IANA. Le fuseau horaire par défaut est UTC.

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

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 panoramique 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 déplacement 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.11]

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

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

Documentation sur les signaux

labelFormatChanged(string format)

Ce signal est émis lorsque l'format e des étiquettes d'axe change.

maxChanged(DateTime max)

Ce signal est émis lorsque la valeur maximale de l'axe, spécifiée par max, change.

minChanged(DateTime min)

Ce signal est émis lorsque la valeur minimale de l'axe, spécifiée par min, change.

rangeChanged(real min, real max)

Ce signal est émis lorsque la valeur minimale ou maximale de l'axe, spécifiée par min et max, change.

subTickCountChanged(int subTickCount)

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

[since 6.12] tickCountChanged(real count)

Ce signal est émis lorsque la valeur « tickCount » de l'axe, spécifiée par « count », change.

Ce signal a été introduit dans Qt 6.12.

[until 6.15] tickIntervalChanged(real tickInterval)

Ce signal sera obsolète à partir de la version 6.15.

Ce signal est émis lorsque la valeur de l'intervalle de tick, spécifiée par ` tickInterval`, change. Utilisez plutôt ` tickCountChanged `.

[since 6.11] timeZoneChanged()

Ce signal est émis lorsque le fuseau horaire est modifié. Il représente une chaîne de caractères correspondant à l'identifiant IANA du fuseau horaire qui a été défini.

Ce signal a été introduit dans Qt 6.11.

[since 6.11] zoomChanged()

Ce signal est émis lorsque la valeur du zoom change.

Ce signal a été introduit dans Qt 6.11.

Documentation des méthodes

[since 6.11] string timeZoneAsString()

Renvoie l'identifiant de zone IANA de QDateTimeAxis::timeZone sous forme de chaîne de caractères.

Cette méthode a été introduite dans Qt 6.11.

Voir également timeZone.

[since 6.11] QTimeZone timeZoneFromString(string zoneId)

Renvoie l'QTimeZone correspondant à l'zoneId de l'IANA.

Cette méthode a été introduite dans Qt 6.11.

Voir également ` QDateTimeAxis::timeZone ` et ` timeZoneAsString`.