DoubleSpinBox QML Type

Permet à l'utilisateur de choisir parmi un ensemble de valeurs prédéfinies en virgule flottante. Plus d'informations...

• 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 : int
• 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, sauf qu'il prend en charge des valeurs doubles plutôt qu'entières. L'utilisateur peut choisir une valeur en cliquant sur les boutons indicateurs vers le haut ou vers le bas, ou en appuyant sur les touches haut ou bas du clavier. En option, DoubleSpinBox peut également être rendu editable, afin que l'utilisateur puisse saisir une valeur textuelle dans le champ de saisie.

Par défaut, DoubleSpinBox fournit des valeurs discrètes dans l'intervalle [0.00-99.99] avec un stepSize de 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, Personnaliser DoubleSpinBox, et Gestion du focus dans les contrôles Qt Quick .

Documentation sur les propriétés

decimals : int

Cette propriété indique le nombre de décimales que la spinbox utilisera pour l'affichage et l'interprétation des doubles.

La valeur par défaut est 2.

La modification de la valeur de cette propriété peut affecter from, to et value.

displayText : string [read-only]

Cette propriété contient la valeur textuelle de la boîte à outils.

La valeur de la propriété est basée sur textFromValue et locale, et égale à :

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

Voir aussi textFromValue.

down group

Cette propriété groupée contient l'élément de l'indicateur de bas et ses propriétés associées.

Voir également decrease().

editable : bool

Cette propriété indique si la boîte à outils est modifiable. La valeur par défaut est false.

Voir également validator.

from : double

Cette propriété contient la valeur de départ de l'intervalle. La valeur par défaut est 0.0.

Voir également to et value.

inputMethodComposing : bool [read-only]

Cette propriété indique si un texte partiel a été saisi par une méthode de saisie dans une zone de rotation modifiable.

Pendant qu'elle compose, une méthode de saisie peut s'appuyer sur des événements souris ou touche de la boîte tournante pour éditer ou valider le texte partiel. Cette propriété peut être utilisée pour déterminer quand 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 à la méthode de saisie des indications sur le contenu attendu de la boîte de dialogue et sur la manière dont elle doit fonctionner.

La valeur par défaut est Qt.ImhDigitsOnly.

La valeur est une combinaison bit à bit de drapeaux ou Qt.ImhNone si aucun indice n'est défini.

Les drapeaux qui modifient le comportement sont :

• Qt.ImhHiddenText - Les caractères doivent être caché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 une mémoire persistante telle que le dictionnaire prédictif de l'utilisateur.
• Qt.ImhNoAutoUppercase - La méthode de saisie ne doit pas essayer 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 lettres majuscules sont préférées (mais pas obligatoires).
• Qt.ImhPreferLowercase - Les lettres minuscules sont préférées (mais pas obligatoires).
• Qt.ImhNoPredictiveText - N'utilise pas le texte prédictif (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 de temps.

Les drapeaux qui limitent la saisie (drapeaux exclusifs) sont :

• Qt.ImhDigitsOnly - Seuls les chiffres sont autorisés.
• Qt.ImhFormattedNumbersOnly - Seule la saisie de nombres est autorisée. Cela inclut le point décimal et le signe moins.
• Qt.ImhUppercaseOnly - Seule la saisie des lettres majuscules est autorisée.
• Qt.ImhLowercaseOnly - Seule la saisie des lettres minuscules est autorisée.
• Qt.ImhDialableCharactersOnly - Seuls les caractères permettant de composer un numéro de téléphone sont autorisés.
• Qt.ImhEmailCharactersOnly - Seuls les caractères adaptés aux adresses électroniques sont autorisés.
• Qt.ImhUrlCharactersOnly - Seuls les caractères convenant aux URL sont autorisés.

Masques :

• Qt.ImhExclusiveInputMask - Ce masque produit un résultat non nul si l'un des drapeaux exclusifs 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 double doit être convertie en texte d'affichage.

La fonction par défaut peut être remplacée pour afficher un texte personnalisé pour une valeur donnée. Cela s'applique aux spinboxes modifiables et non modifiables ; par exemple, lorsque l'on utilise les boutons haut et bas ou la molette de la souris pour incrémenter et décrémenter la valeur, la nouvelle valeur est convertie en texte d'affichage à 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 étant la valeur à convertir, le deuxième le nombre de décimales et le troisième, facultatif, 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 aussi valueFromText, validator, et locale.

to : int

Cette propriété contient la valeur finale de l'intervalle. La valeur par défaut est 2.

Voir également from et value.

up group

Cette propriété groupée contient l'élément de l'indicateur de progression et ses propriétés associées.

Voir également increase().

validator : Validator

Cette propriété contient le validateur de texte d'entrée pour les spinboxes éditables. Par défaut, DoubleSpinBox utilise DoubleValidator pour accepter la saisie de nombres doubles.

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

Voir aussi editable, textFromValue, valueFromText, locale, et Validation du texte d'entrée.

value : double

Cette propriété contient la valeur dans l'intervalle from - 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 qu'un texte saisi doit être converti en une valeur double.

Cette fonction ne doit être remplacée que lorsque textFromValue est remplacé par une spinbox modifiable.

La signature de la fonction de rappel est int function(text, locale). La fonction peut avoir un ou deux arguments, le premier étant le texte à convertir et le second, facultatif, la locale à 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 aussi textFromValue, validator, et locale.

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

Cette propriété indique si le spinbox est enveloppé. La valeur par défaut est false.

Si la valeur de wrap est true, le fait de passer devant to change la valeur en from et vice versa.

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 du champ de saisie a été modifiée de manière interactive par l'utilisateur, que ce soit par le toucher, la souris, la roue ou les touches. Dans le cas d'une interaction via le clavier, le signal n'est émis que lorsque le texte a été accepté, c'est-à-dire lorsque les touches Entrée ou Retour sont enfoncées ou que le champ de saisie perd le focus.

Documentation de la méthode

void decrease()

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