QDoubleSpinBox Class

Documentation sur les fonctions membres

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

Construit une boîte de rotation avec 0,0 comme valeur minimale et 99,99 comme valeur maximale, une valeur de pas de 1,0 et une précision de 2 décimales. La valeur est initialement fixée à 0,00. La boîte à outils a le nom suivant : parent.

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 minimum et maximum en un seul appel de fonction.

Remarque : les valeurs maximales et minimales seront arrondies pour correspondre à la propriété des décimales.

setRange(minimum, maximum);

est équivalent à :

setMinimum(minimum);
setMaximum(maximum);

Voir également minimum et maximum.

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

Définit le type de pas pour la boîte à outils à stepType, qui est un pas unique ou un pas décimal adaptatif.

Le pas décimal adaptatif signifie que la taille du pas sera continuellement ajustée à une puissance de dix en dessous de la valeur actuelle value. Ainsi, lorsque la valeur est de 1100, le pas est fixé à 100, de sorte qu'en augmentant une fois la valeur, on passe à 1200. Pour une valeur de 1200, le pas augmente jusqu'à 1300. Pour les valeurs négatives, un pas vers le bas à partir de -1100 permet d'atteindre -1200.

Cela fonctionne également pour toutes les valeurs décimales, 0,041 est augmenté à 0,042 en faisant un pas.

La direction du pas est prise en compte pour traiter les cas de contournement, de sorte qu'un pas vers le bas à partir de 100 amène la valeur à 99 au lieu de 90. Ainsi, un pas vers le haut suivi d'un pas vers le bas - ou vice versa - aboutit toujours à la valeur de départ ; 99 -> 100 -> 99.

Si cette propriété est activée, la boîte à outils ne tiendra pas compte de la valeur de singleStep, bien qu'elle soit préservée de sorte que singleStep prenne effet si l'échelon décimal adaptatif est désactivé ultérieurement.

Voir également stepType().

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

Ce signal est émis lorsque le texte de la boîte de dialogue est modifié. Le nouveau texte est transmis à text avec prefix() et suffix().

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

Cette fonction virtuelle est utilisée par la spin box chaque fois qu'elle doit afficher le message value. L'implémentation par défaut renvoie une chaîne contenant value imprimée à l'aide de QWidget::locale().toString(value, u'f', decimals()) et supprimera le séparateur de milliers à moins que setGroupSeparatorShown() ne soit défini. Les réimplémentations peuvent renvoyer n'importe quoi.

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 aussi réimplémenter valueFromText().

Voir aussi 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 lorsque la valeur de la boîte de rotation est modifiée. La nouvelle valeur est transmise à d.

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

Cette fonction virtuelle est utilisée par la boîte à boutons chaque fois qu'elle doit interpréter text saisi par l'utilisateur comme une valeur.

Les sous-classes qui doivent afficher les valeurs de la boîte à outils d'une manière non numérique doivent réimplémenter cette fonction.

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

Voir également textFromValue() et validate().