QSpinBox Class

Documentation des fonctions membres

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

Construit une boîte à spin avec 0 comme valeur minimale et 99 comme valeur maximale, une valeur de pas de 1. La valeur est initialement fixée à 0. Elle est apparentée à parent.

Voir aussi setMinimum(), setMaximum() et setSingleStep().

[virtual noexcept] QSpinBox::~QSpinBox()

Destructeur.

[override virtual protected] bool QSpinBox::event(QEvent *event)

Réimplémente : QAbstractSpinBox::event(QEvent *event).

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

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

void QSpinBox::setRange(int minimum, int maximum)

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

setRange(minimum, maximum);

est équivalent à :

setMinimum(minimum);
setMaximum(maximum);

Voir aussi minimum et maximum.

void QSpinBox::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, le pas vers le bas à partir de -1100 va jusqu'à -1200.

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 porte 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 QSpinBox::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 protected] QString QSpinBox::textFromValue(int value) const

Cette fonction virtuelle est utilisée par la spin box chaque fois qu'elle doit afficher la valeur donnée value. L'implémentation par défaut renvoie une chaîne contenant value imprimée de manière standard à l'aide de QWidget::locale().toString(), mais avec le séparateur de milliers supprimé à moins que setGroupSeparatorShown() ne soit défini. Les réimplémentations peuvent renvoyer n'importe quoi. (Voir l'exemple dans la description détaillée).

Remarque : QSpinBox 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() et validate().

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

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

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

[signal] void QSpinBox::valueChanged(int i)

Ce signal est émis lorsque la valeur de la boîte de rotation est modifiée. La valeur entière de la nouvelle valeur est transmise à i.

[virtual protected] int QSpinBox::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 : QSpinBox gère specialValueText() séparément ; cette fonction ne s'occupe que des autres valeurs.

Voir également textFromValue() et validate().