QDoubleSpinBox Class

Documentation des fonctions membres

[explicit] QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = nullptr)

Crée une zone de sélection à molette dont la valeur minimale est 0,0, la valeur maximale 99,99, le pas 1,0 et la précision de 2 décimales. La valeur est initialement définie sur 0,00. La zone de sélection à molette présente l'parent indiquée.

Voir également setMinimum(), setMaximum() et setSingleStep().

[virtual noexcept] QDoubleSpinBox::~QDoubleSpinBox()

Destructeur.

[override virtual] void QDoubleSpinBox::fixup(QString &input) const

Réimplémente : QAbstractSpinBox::fixup(QString &input) const.

void QDoubleSpinBox::setRange(double minimum, double maximum)

Fonction pratique permettant de définir les valeurs de ` minimum ` et ` maximum ` en un seul appel de fonction.

Remarque : les valeurs maximales et minimales seront arrondies pour correspondre à la propriété « decimals ».

setRange(minimum, maximum);

équivaut à :

setMinimum(minimum);
setMaximum(maximum);

Voir également minimum et maximum.

void QDoubleSpinBox::setStepType(QAbstractSpinBox::StepType stepType)

Définit le type de pas de la zone de sélection rotative sur « stepType », ce qui correspond à un pas unique ou à un pas décimal adaptatif.

Un pas décimal adaptatif signifie que la taille du pas sera continuellement ajustée à une puissance de dix inférieure à la valeur actuelle de « value ». Ainsi, lorsque la valeur est 1 100, le pas est défini sur 100 ; une augmentation d’un pas fait donc passer la valeur à 1 200. Pour 1 200, une augmentation d’un pas fait passer la valeur à 1 300. Pour les valeurs négatives, une diminution à partir de -1 100 conduit à -1 200.

Cela fonctionne également pour toutes les valeurs décimales : 0,041 passe à 0,042 après un pas.

Le sens de l'incrément est pris en compte pour gérer les cas limites, de sorte qu'une diminution à partir de 100 ramène la valeur à 99 au lieu de 90. Ainsi, un incrément suivi d'une diminution – ou inversement – ramène toujours à la valeur de départ : 99 -> 100 -> 99.

La définition de ce paramètre fera en sorte que la zone de saisie ignore la valeur de ` singleStep`, bien que celle-ci soit conservée afin que ` singleStep ` prenne effet si le pas décimal adaptatif est désactivé ultérieurement.

Voir également stepType().

[signal] void QDoubleSpinBox::textChanged(const QString &text)

Ce signal est émis chaque fois que le texte de la zone de saisie est modifié. Le nouveau texte est transmis via les méthodes ` text `, ` prefix()` et ` suffix()`.

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

Cette fonction virtuelle est utilisée par la zone de saisie « spin box » chaque fois qu’elle doit afficher la valeur fournie par ` value`. L’implémentation par défaut renvoie une chaîne contenant ` value `, affichée à l’aide de ` QWidget::locale()`. `toString` (value, u'f', decimals()) et supprime le séparateur des milliers, sauf si ` setGroupSeparatorShown()` est défini. Les réimplémentations peuvent renvoyer n’importe quelle valeur.

Remarque : QDoubleSpinBox n’appelle pas cette fonction pour specialValueText() et ni prefix() ni suffix() ne doivent être inclus dans la valeur de retour.

Si vous réimplémentez cette fonction, vous devrez peut-être également réimplémenter valueFromText().

Voir également valueFromText() et QLocale::groupSeparator().

[override virtual] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

Réimplémente : QAbstractSpinBox::validate(QString &input, int &pos) const.

[signal] void QDoubleSpinBox::valueChanged(double d)

Ce signal est émis chaque fois que la valeur de la zone de sélection est modifiée. La nouvelle valeur est transmise via l'd.

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

Cette fonction virtuelle est utilisée par la zone de sélection à roue chaque fois qu’elle doit interpréter une « text » saisie par l’utilisateur comme une valeur.

Les sous-classes qui doivent afficher les valeurs de la zone de sélection sous une forme non numérique doivent réimplémenter cette fonction.

Remarque : QDoubleSpinBox gère specialValueText() séparément ; cette fonction ne concerne que les autres valeurs.

Voir également textFromValue() et validate().