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 !