DoubleSpinBox QML Type

Permet à l'utilisateur de choisir parmi un ensemble de valeurs à virgule flottante prédéfinies. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• decimals : int
• displayText : string
• down
  • down.hovered : bool
  • down.implicitIndicatorHeight : real
  • down.implicitIndicatorWidth : real
  • down.indicator : Item
  • down.pressed : bool
• editable : bool
• from : double
• inputMethodComposing : bool
• inputMethodHints : flags (since QtQuick.Controls 2.2 (Qt 5.9))
• stepSize : double
• textFromValue : function
• to : double
• up
  • up.hovered : bool
  • up.implicitIndicatorHeight : real
  • up.implicitIndicatorWidth : real
  • up.indicator : Item
  • up.pressed : bool
• validator : Validator
• value : double
• valueFromText : function
• wrap : bool (since QtQuick.Controls 2.3 (Qt 5.10))

Signaux

• valueModified()

Méthodes

• void decrease()
• void increase()

Description détaillée

DoubleSpinBox est similaire à SpinBox, à la différence près qu'il prend en charge les valeurs doubles plutôt que les entiers. L'utilisateur peut choisir une valeur en cliquant sur les boutons indicateurs haut ou bas, ou en appuyant sur les touches haut ou bas du clavier. En option, DoubleSpinBox peut également être configuré en mode « editable », ce qui permet à l'utilisateur de saisir une valeur textuelle dans le champ de saisie.

Par défaut, DoubleSpinBox propose des valeurs discrètes comprises dans l’intervalle défini par [0.00-99.99], avec une valeur de texte ( stepSize ) définie par 1.0.

DoubleSpinBox {
    id: doubleSpinBox
    from: 0
    value: 1.1
    to: 100
    stepSize: Math.pow(10, -decimals)
    decimals: 2
    editable: true
    anchors.centerIn: parent
}

Voir également SpinBox, Tumbler, Personnalisation de DoubleSpinBox et Gestion du focus dans Qt Quick Controls.

Documentation sur les propriétés

decimals : int

Cette propriété définit le nombre de décimales que la zone de saisie utilisera pour afficher et interpréter les valeurs de type double.

La valeur par défaut est 2.

La modification de la valeur de cette propriété peut avoir une incidence sur from, to et value.

displayText : string [read-only]

Cette propriété contient la valeur textuelle de la zone de saisie à sélection.

La valeur de cette propriété s'appuie sur textFromValue et locale, et est égale à :

let text = spinBox.textFromValue(spinBox.value, spinBox.decimals, spinBox.locale)

Voir également textFromValue.

down group

Cette propriété groupée contient l'élément indicateur « vers le bas » et ses propriétés associées.

Voir également decrease().

editable : bool

Cette propriété indique si la zone de saisie « spinbox » est modifiable. La valeur par défaut est « false ».

Voir également validator.

from : double

Cette propriété contient la valeur initiale de la plage. La valeur par défaut est 0.0.

Voir également to et value.

inputMethodComposing : bool [read-only]

Cette propriété indique si une zone de saisie modifiable contient une saisie partielle provenant d'une méthode de saisie.

Lors de la saisie, une méthode de saisie peut s'appuyer sur des événements de souris ou de clavier provenant de la zone de saisie pour modifier ou valider le texte partiel. Cette propriété permet de déterminer à quel moment désactiver les gestionnaires d'événements susceptibles d'interférer avec le bon fonctionnement d'une méthode de saisie.

inputMethodHints : flags [since QtQuick.Controls 2.2 (Qt 5.9)]

Cette propriété fournit des indications à la méthode de saisie concernant le contenu attendu de la zone de saisie à rouleau et son mode de fonctionnement.

La valeur par défaut est « Qt.ImhDigitsOnly ».

La valeur est une combinaison binaire d’indicateurs ou « Qt.ImhNone » si aucun indice n’est défini.

Les indicateurs qui modifient le comportement sont les suivants :

• Qt.ImhHiddenText : les caractères doivent être masqués, comme c'est généralement le cas lors de la saisie de mots de passe.
• Qt.ImhSensitiveData - Le texte saisi ne doit pas être stocké par la méthode de saisie active dans un espace de stockage persistant, tel qu’un dictionnaire prédictif de l’utilisateur.
• Qt.ImhNoAutoUppercase - La méthode de saisie ne doit pas tenter de passer automatiquement en majuscules à la fin d'une phrase.
• Qt.ImhPreferNumbers : les chiffres sont préférés (mais pas obligatoires).
• Qt.ImhPreferUppercase - Les majuscules sont préférées (mais pas obligatoires).
• Qt.ImhPreferLowercase - Les lettres minuscules sont préférées (mais pas obligatoires).
• Qt.ImhNoPredictiveText - Ne pas utiliser la saisie prédictive (c'est-à-dire la recherche dans le dictionnaire) pendant la saisie.
• Qt.ImhDate - L'éditeur de texte fonctionne comme un champ de date.
• Qt.ImhTime - L'éditeur de texte fonctionne comme un champ d'heure.

Les indicateurs qui restreignent la saisie (indicateurs exclusifs) sont les suivants :

• Qt.ImhDigitsOnly - Seuls les chiffres sont autorisés.
• Qt.ImhFormattedNumbersOnly - Seule la saisie de nombres est autorisée. Cela inclut la virgule décimale et le signe moins.
• Qt.ImhUppercaseOnly - Seules les lettres majuscules sont autorisées.
• Qt.ImhLowercaseOnly - Seule la saisie de lettres minuscules est autorisée.
• Qt.ImhDialableCharactersOnly : seuls les caractères pouvant être utilisés pour composer un numéro de téléphone sont autorisés.
• Qt.ImhEmailCharactersOnly - Seuls les caractères autorisés dans les adresses e-mail sont autorisés.
• Qt.ImhUrlCharactersOnly - Seuls les caractères adaptés aux URL sont autorisés.

Masques :

• Qt.ImhExclusiveInputMask - Ce masque renvoie une valeur non nulle si l'un des indicateurs d'exclusion est utilisé.

Cette propriété a été introduite dans QtQuick.Controls 2.2 (Qt 5.9).

stepSize : double

Cette propriété définit la taille du pas. La valeur par défaut est 1.0.

Voir également increase() et decrease().

textFromValue : function

Cette propriété contient une fonction de rappel qui est appelée chaque fois qu'une valeur de type double doit être convertie en texte d'affichage.

La fonction par défaut peut être redéfinie pour afficher un texte personnalisé pour une valeur donnée. Cela s'applique aussi bien aux spinboxes modifiables qu'aux spinboxes non modifiables ; par exemple, lorsque vous utilisez les boutons haut et bas ou la molette de la souris pour augmenter ou diminuer la valeur, la nouvelle valeur est convertie en texte à afficher à l'aide de cette fonction.

La signature de la fonction de rappel est string function(value, decimals, locale). La fonction peut avoir deux ou trois arguments : le premier argument est la valeur à convertir, le deuxième argument est le nombre de décimales, et le troisième argument, facultatif, est la locale à utiliser pour la conversion, le cas échéant.

L’implémentation par défaut effectue la conversion à l’aide de Number.toLocaleString() :

textFromValue: function(value, decimals, locale) {
    return Number(value).toLocaleString(locale, 'f', decimals);
}

Voir également valueFromText, validator et locale.

to : double

Cette propriété contient la valeur finale de la plage. La valeur par défaut est 99.99.

Voir également from et value.

up group

Cette propriété groupée contient l'élément indicateur « haut » et ses propriétés associées.

Voir également increase().

validator : Validator

Cette propriété contient le validateur de texte pour les zones de saisie modifiables de type « spinbox ». Par défaut, DoubleSpinBox utilise DoubleValidator pour accepter la saisie de nombres de type double.

DoubleSpinBox {
    id: control
    validator: DoubleValidator {
        locale: control.locale.name
        bottom: Math.min(control.from, control.to)
        top: Math.max(control.from, control.to)
    }
}

Voir également editable, textFromValue, valueFromText, locale et Validation du texte saisi.

value : double

Cette propriété prend une valeur comprise entre from et to. La valeur par défaut est 0.0.

valueFromText : function

Cette propriété contient une fonction de rappel qui est appelée chaque fois que le texte saisi doit être converti en une valeur de type double.

Cette fonction ne doit être redéfinie que lorsque la méthode ` textFromValue ` est redéfinie pour une zone de saisie modifiable de type « spinbox ».

La signature de la fonction de rappel est int function(text, locale). La fonction peut prendre un ou deux arguments : le premier est le texte à convertir, et le second, facultatif, correspond aux paramètres régionaux à utiliser pour la conversion, le cas échéant.

L’implémentation par défaut effectue la conversion à l’aide de ` Number.fromLocaleString()` :

valueFromText: function(text, locale) { return Number.fromLocaleString(locale, text); }

Voir également textFromValue, validator et locale.

wrap : bool [since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété détermine si la zone de saisie « spinbox » effectue un retour à la ligne. La valeur par défaut est « false ».

Si wrap est défini sur « true », le fait de dépasser « to » fait passer la valeur à « from » et inversement.

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Documentation sur les signaux

valueModified()

Ce signal est émis lorsque la valeur de la zone de sélection a été modifiée de manière interactive par l'utilisateur, que ce soit par effleurement, à l'aide de la souris, de la molette ou du clavier. En cas d'interaction via le clavier, le signal n'est émis que lorsque le texte a été validé, c'est-à-dire lorsque les touches Entrée ou Retour ont été enfoncées, ou lorsque le champ de saisie perd le focus.

Documentation de la méthode

void decrease()

Réduit la valeur de stepSize, ou de 1 si stepSize n'est pas défini.

Voir également stepSize.

void increase()

Augmente la valeur de stepSize, ou de 1 si stepSize n'est pas défini.

Voir également stepSize.