QInputDialog

La classe QInputDialog fournit une boîte de dialogue simple et commode pour la saisie d'une valeur unique par l'utilisateur. Plus <code cpp-qt> #include <QInputDialog></code> ==== Héritage ==== Hérite de [[QDialog.

Description détaillée

La classe QInputDialog fournit une boîte de dialogue simple et commode pour la saisie d'une valeur unique par l'utilisateur.

La valeur saisie peut être une chaîne de caractères, un nombre ou un élément d'une liste. Un libellé doit être spécifié pour indiquer à l'utilisateur ce qu'il doit saisir.

Quatre fonctions statiques sont fournies : getText(), getInt(), getDouble() et getItem(). Toutes les fonctions peuvent être utilisées de la même manière, par exemple :

     bool ok;
     QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                          tr("User name:"), QLineEdit::Normal,
                                          QDir::home().dirName(), &ok);
     if (ok && !text.isEmpty())
         textLabel->setText(text);

La variable ok est mise à true si l'utilisateur a cliqué sur OK ; sinon à false.

L'exemple Standard Dialogs montre comment utiliser QInputDialog de la même manière que toute autre boîte de dialogue de Qt.

Voir aussi QMessageBox et Standard Dialogs Example.

Type

enum QInputDialog::InputDialogOptionflags QInputDialog::InputDialogOptions

Cette énumération spécifie les différentes options qui affectent l'apparence de la boîte de dialogue.

Cette énumération a été introduite ou modifiée dans Qt 4.5.

Le type InputDialogOptions est un typedef pour QFlags<InputDialogOption>. Il stocke une combinaison OU de valeurs de InputDialogOption.

Voir aussi options, setOption() et testOption().

enum QInputDialog::InputMode

Cette énumération décrit les différents modes de saisie qui peuvent être sélectionnés pour la boîte de dialogue

Cette énumération fut introduite ou modifiée dans Qt 4.5.

Voir aussi inputMode.

Propriétés

cancelButtonText : QString

Cette propriété contient le texte du bouton utilisé pour annuler la boîte de dialogue.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QString cancelButtonText () const

void setCancelButtonText ( const QString & text )

comboBoxEditable : bool

Cette propriété indique si la liste déroulante utilisée dans la boîte de dialogue de saisie est modifiable ou non.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

bool isComboBoxEditable () const

void setComboBoxEditable ( bool editable )

comboBoxItems : QStringList

Cette propriété contient les éléments de la liste déroulante de la boîte de dialogue.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QStringList comboBoxItems () const

void setComboBoxItems ( const QStringList & items )

doubleDecimals : int

Cette propriété définit la précision en nombre de décimales pour les valeurs en virgule flottante.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

int doubleDecimals () const

void setDoubleDecimals ( int decimals )

Voir aussi QDoubleSpinBox::setDecimals().

doubleMaximum : double

Cette propriété contient la valeur maximale acceptée des saisies en virgule flottante à double précision.

Cette propriété est pertinente uniquement lorsque la boîte de dialogue est utilisée avec le mode DoubleInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

double doubleMaximum () const

void setDoubleMaximum ( double max )

doubleMinimum : double

Cette propriété contient la valeur minimale acceptée des saisies en virgule flottante à double précision.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode DoubleInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

double doubleMinimum () const

void setDoubleMinimum ( double min )

doubleValeur : int

Cette propriété contient la valeur courante saisie en virgule flottante à double précision.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode DoubleInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

double doubleValeur () const

void setDoubleValeur ( double value )

Signal de notification :

void doubleValeurChanged ( double value )

inputMode : InputMode

Cette propriété contient le mode utilisé pour la saisie.

Cette propriété aide à déterminer quel widget est utilisé pour la saisie dans la boîte de dialogue.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

InputMode inputMode () const

void setInputMode ( InputMode mode )

intMaximum : int

Cette propriété contient la valeur maximale acceptée pour les saisies d'un nombre entier.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode IntInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

int intMaximum () const

void setIntMaximum ( int max )

intMinimum : int

Cette propriété contient la valeur minimale acceptée pour les saisies d'un nombre entier.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode IntInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

int intMinimum () const

void setIntMinimum ( int min )

intStep : int

Cette propriété contient le pas par lequel la valeur entière est incrémentée ou décrémentée.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode IntInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

int intStep () const

void setIntStep ( int step )

intValeur : int

Cette propriété contient la valeur courante pour les saisies d'un nombre entier.

Cette propriété est uniquement pertinente lorsque la boîte de dialogue est utilisée avec le mode IntInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

int intValeur () const

void setIntValeur ( int value )

Signal de notification :

void intValeurChanged ( int value )

labelText : QString

Cette propriété contient le texte du libellé décrivant ce qu'il faut saisir.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QString labelText () const

void setLabelText ( const QString & text )

okButtonText : QString

Cette propriété contient le texte du bouton utilisé pour valider la saisie dans la boîte de dialogue.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QString okButtonText () const

void setOkButtonText ( const QString & text )

options : InputDialogOptions

Cette propriété contient les différentes options qui affectent l'apparence de la boîte de dialogue.

Par défaut, toutes les options désactivées.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

InputDialogOptions options () const

void setOptions ( InputDialogOptions options )

Voir aussi setOption() and testOption().

textEchoMode : QLineEdit::EchoMode

Cette propriété contient le mode d'écho pour la valeur du texte.

Cette propriété est pertinente uniquement lorsque la boîte de dialogue utilise le mode TextInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QLineEdit::EchoMode textEchoMode () const

void setTextEchoMode ( QLineEdit::EchoMode mode )

textValeur : QString

Cette propriété contient la valeur du texte saisi de la boîte de dialogue.

Cette propriété est pertinente uniquement lorsque la boîte de dialogue utilise le mode TextInput.

Cette classe a été introduite dans Qt 4.5.

Fonction d'accès

QString textValeur () const

void setTextValeur ( const QString & text )

Signal de notification :

void textValeurChanged ( const QString & text )

Fonctions membres

QInputDialog::QInputDialog ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )

Construit une nouvelle boîte de dialogue de saisie avec le parent indiqué et les flags de la fenêtre.

Cette fonction a été introduite dans Qt 4.5.

QInputDialog::~QInputDialog ()

Détruit la boîte de dialogue.

Cette fonction a été introduite dans Qt 4.5.

void QInputDialog::done ( int result ) [virtual]

Réimplémentation de QDialog::done().

Ferme la boîte de dialogue et met le code résultat à result. Si la boîte dialogue est affichée avec exec(), done() déclenche la sortie de la boucle d'événement locale et exec() retourne result.

Voir aussi QDialog::done().

void QInputDialog::doubleValeurChanged ( double value ) [signal]

Ce signal est émis dès que la valeur en virgule flottante est modifiée dans la boîte de dialogue. La valeur courante est spécifiée par value.

Ce signal est pertinent uniquement lorsque la boîte de dialogue utilise le mode DoubleInput.

void QInputDialog::doubleValeurSelected ( double value ) [signal]

Ce signal est émis dès que l'utilisateur sélectionne une valeur en virgule flottante et la valide ; par exemple, en cliquant sur le bouton OK. La valeur sélectionnée est spécifiée par value.

Ce signal est pertinent uniquement lorsque la boîte de dialogue utilise le mode DoubleInput.

double QInputDialog::getDouble ( QWidget * parent, const QString & title, const QString & label, double value = 0, double min = -2147483647, double max = 2147483647, int decimals = 1, bool * ok = 0, Qt::WindowFlags flags = 0 ) [static]

Fonction statique de commodité pour obtenir un nombre à virgule flottante de la part de l'utilisateur.

title est le texte qui sera affiché dans la barre de titre de la boîte de dialogue. label est le texte affiché à l'utilisateur (il devrait indiquer ce qui est demandé en entrée). value est le nombre à virgule flottante par défaut que la ligne de saisie contiendra. min et max seront les valeurs minimum et maximum que l'utilisateur pourra choisir. decimals est le nombre maximal de décimales qui peut contenir le nombre.

Si ok est non nul, *ok sera mis à vrai si l'utilisateur appuie sur OK et à faux si l'utilisateur appuie sur Annuler. Le parent de la boîte de dialogue est parent. La boîte dialogue sera modale et utilisera les flags flags.

Cette fonction retourne le nombre en virgule flottante saisi par l'utilisateur.

Utilisez la fonction statique de cette manière :

     bool ok;
     double d = QInputDialog::getDouble(this, tr("QInputDialog::getDouble()"),
                                        tr("Amount:"), 37.56, -10000, 10000, 2, &ok);
     if (ok)
         doubleLabel->setText(QString("$%1").arg(d));

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QInputDialog.

Voir aussi getText(), getInt() et getItem().

int QInputDialog::getInt ( QWidget * parent, const QString & title, const QString & label, int value = 0, int min = -2147483647, int max = 2147483647, int step = 1, bool * ok = 0, Qt::WindowFlags flags = 0 ) [static]

Fonction statique de commodité pour obtenir un nombre entier de la part de l'utilisateur.

title est le texte qui sera affiché dans la barre de titre de la boîte de dialogue. label est le texte affiché à l'utilisateur (il devrait indiquer ce qui est demandé en entrée). value est l'entier par défaut que contiendra le compteur. min et max seront les valeurs minimum et maximum que l'utilisateur pourra choisir. step est le pas par lequel les valeurs changent quand l'utilisateur appuie sur les flèches pour incrémenter ou décrémenter la valeur.

Si ok est non nul, *ok sera mis à vrai si l'utilisateur appuie sur OK et à faux si l'utilisateur appuie sur Annuler. Le parent de la boîte de dialogue est parent. La boîte dialogue sera modale et utilisera les flags flags.

En cas de succès, cette fonction retournera l'entier qui a été entré par l'utilisateur ; en cas d'échec, elle retournera la valeur initiale value.

Utilisez la fonction statique de cette manière :

     bool ok;
     int i = QInputDialog::getInt(this, tr("QInputDialog::getInteger()"),
                                  tr("Percentage:"), 25, 0, 100, 1, &ok);
     if (ok)
         integerLabel->setText(tr("%1%").arg(i));

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QInputDialog.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi getText(), getDouble() et getItem().

QString QInputDialog::getItem ( QWidget * parent, const QString & title, const QString & label, const QStringList & items, int current = 0, bool editable = true, bool * ok = 0, Qt::WindowFlags flags = 0 ) [static]

Fonction statique de commodité pour permettre à l'utilisateur de choisir un élément dans une liste.

title est le texte qui sera affiché dans la barre de titre de la boîte de dialogue. label est le texte affiché à l'utilisateur (il devrait indiquer ce qui est demandé en entrée). items est la liste de chaînes de caractères qui sera insérée dans la liste déroulante. current est l'indice de l'élément qui sera l'élément courant.

Si editable vaut vrai, l'utilisateur peut entrer son propre texte; sinon l'utilisateur peut uniquement sélectionner l'un des éléments existants.

Si ok est non nul, *ok sera mis à vrai si l'utilisateur appuie sur OK et à faux si l'utilisateur appuie sur Annuler. Le parent de la boîte de dialogue est parent. La boîte dialogue sera modale et utilisera les flags flags.

Cette fonction retournera le texte de l'élément courant ou si editable vaut vrai, le texte courant de la liste déroulante.

Utilisez la fonction statique de cette manière :

     QStringList items;
     items << tr("Spring") << tr("Summer") << tr("Fall") << tr("Winter");
 
     bool ok;
     QString item = QInputDialog::getItem(this, tr("QInputDialog::getItem()"),
                                          tr("Season:"), items, 0, false, &ok);
     if (ok && !item.isEmpty())
         itemLabel->setText(item);

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QInputDialog.

Voir aussi getText(), getInt() et getDouble().

QString QInputDialog::getText ( QWidget * parent, const QString & title, const QString & label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString & text = QString(), bool * ok = 0, Qt::WindowFlags flags = 0 ) [static]

Fonction statique de commodité pour obtenir une chaîne de caractères de la part de l'utilisateur.

title est le texte qui sera affiché dans la barre de titre de la boîte de dialogue. label est le texte affiché à l'utilisateur (il devrait indiquer ce qui est demandé en entrée). text est la chaîne de caractères par défaut placée dans la ligne d'édition. mode est le mode d'écho (manière dont la ligne d'édition affichera le texte saisi ; par exemple : des astérisques pour les mots de passe) que la ligne d'édition utilisera.

Si editable vaut vrai, l'utilisateur peut entrer son propre texte; sinon l'utilisateur peut uniquement sélectionner l'un des items existants.

Si ok est non nul, *ok sera mis à vrai si l'utilisateur appuie sur OK et à faux si l'utilisateur appuie sur Annuler. Le parent de la boîte de dialogue est parent. La boîte dialogue sera modale et utilisera les flags flags.

Si la boîte de dialogue est validée, la fonction retournera le texte dans la ligne d'édition de la boîte de dialogue. Si elle est rejetée, ce sera un QString vide.

Utilisez la fonction statique de cette manière :

     bool ok;
     QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                          tr("User name:"), QLineEdit::Normal,
                                          QDir::home().dirName(), &ok);
     if (ok && !text.isEmpty())
         textLabel->setText(text);

Attention : ne détruisez pas parent durant l'exécution de la boîte de dialogue. Si vous voulez le faire, vous devez créer une boîte de dialogue vous-même en utilisant un des constructeurs de QInputDialog.

Voir aussi getInt(), getDouble() et getItem().

void QInputDialog::intValeurChanged ( int value ) [signal]

Ce signal est émis dès que la valeur entière est modifiée dans la boîte de dialogue. La valeur courante est spécifiée par value.

Ce signal est pertinent uniquement lorsque la boîte de dialogue utilise le mode IntInput.

void QInputDialog::intValeurSelected ( int value ) [signal]

Ce signal est émis dès que l'utilisateur sélectionne une valeur entière en acceptant la boîte de dialogue, par exemple en cliquant sur le bouton OK. La valeur sélectionnée est spécifiée par value.

Ce signal est pertinent uniquement lorsque la boîte de dialogue utilise le mode IntInput.

QSize QInputDialog::minimumSizeHint () const [virtual]

Réimplémentation de QWidget::minimumSizeHint().

void QInputDialog::open ( QObject * receiver, const char * member )

Il s'agit d'une fonction surchargée.

Cette fonction connecte un de ses signaux au slot spécifié par receiver et member. Le signal choisi dépend des arguments indiqués dans member. Ce sera :

• textValeurSelected() si member a un QString pour premier argument ;
• intValeurSelected() si member a un entier pour premier argument ;
• doubleValeurSelected() si member a un double pour premier argument ;
• accepted() si member n'a PAS arguments.

Le signal sera déconnecté du slot lorsque la boîte de dialogue sera fermée.

Cette fonction a été introduite dans Qt 4.5.

void QInputDialog::setDoubleRange ( double min, double max )

Fixe l'intervalle de valeurs flottantes en double précision acceptées par la boîte de dialogue lorsqu'elle est utilisée avec le mode DoubleInput, avec les valeurs minimum et maximum spécifiées respectivement par min et max.

void QInputDialog::setIntRange ( int min, int max )

Fixe l'intervalle de valeurs entières acceptées par la boîte de dialogue lorsqu'elle est utilisée avec le mode IntInput, avec les valeurs minimum et maximum spécifiées respectivement par min et max

void QInputDialog::setOption ( InputDialogOption option, bool on = true )

Active l‹option donnée si on vaut true ; sinon la désactive.

Voir aussi options and testOption().

void QInputDialog::setVisible ( bool visible ) [virtual]

Réimplémentation de QWidget::setVisible().

QSize QInputDialog::sizeHint () const [virtual]

Réimplémentation de QWidget::sizeHint().

bool QInputDialog::testOption ( InputDialogOption option ) const

Retourne true si l‹option donnée est active ; retourne false sinon.

Voir aussi options et setOption().

void QInputDialog::textValeurChanged ( const QString & text ) [signal]

Ce signal est émis dès que le texte change dans la boîte de dialogue. Le nouveau texte est spécifié par text.

Ce signal est pertinent uniquement lorsque la boîte de dialogue est utilisée avec le mode TextInput.

void QInputDialog::textValeurSelected ( const QString & text ) [signal]

Ce signal est émis dès que l'utilisateur sélectionne une valeur texte en acceptant la boîte de dialogue, par exemple en cliquant sur le bouton OK. La valeur sélectionnée est spécifiée par text.

Ce signal est pertinent uniquement lorsque la boîte de dialogue est utilisée avec le mode TextInput.

Remerciements

Merci à Dimitry Ernot pour la traduction, ainsi qu'à Ilya Diallo et Claude Leloup pour la relecture !