QInputDialog Class

Documentation sur les fonctions membres

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

Crée une nouvelle boîte de dialogue de saisie avec l'parent et l'flags de fenêtre indiqués.

[virtual noexcept] QInputDialog::~QInputDialog()

Ferme la boîte de dialogue de saisie.

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

Réimplémentation de : ` QDialog::done(int r)`.

Ferme la boîte de dialogue et définit son code de résultat sur ` result`. Si cette boîte de dialogue est affichée à l'aide de ` exec()`, la fonction `done()` provoque la fin de la boucle d'événements locale et le retour de ` exec()` avec le code ` result`.

Voir également QDialog::done().

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

Ce signal est émis chaque fois que la valeur du champ « double » change dans la boîte de dialogue. La valeur actuelle est spécifiée par value.

Ce signal n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « DoubleInput ».

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

Ce signal est émis chaque fois que l'utilisateur sélectionne une valeur de type double en validant 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 n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « DoubleInput ».

[static] 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 = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), double step = 1)

Fonction statique d'aide permettant de récupérer un nombre à virgule flottante saisi par l'utilisateur.

title est le texte affiché dans la barre de titre de la boîte de dialogue. label est le texte présenté à l’utilisateur (il doit indiquer ce qu’il faut saisir). value est le nombre à virgule flottante par défaut qui sera attribué au champ de saisie. min et max sont les valeurs minimale et maximale que l'utilisateur peut choisir. decimals correspond au nombre maximal de décimales que le nombre peut comporter. step correspond à l'incrément ou au décrément de la valeur lorsque l'utilisateur appuie sur les boutons fléchés.

Si ok n'est pas nul, *ok sera défini sur true si l'utilisateur a appuyé sur OK et sur false s'il a appuyé sur Cancel. Le parent de la boîte de dialogue est parent. La boîte de dialogue sera modale et utilisera le widget flags.

Cette fonction renvoie le nombre à virgule flottante saisi par l'utilisateur.

Utilisez cette fonction statique comme suit :

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

Voir également getText(), getInt(), getItem() et getMultiLineText().

[static] 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 = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Fonction statique d'aide permettant de récupérer une valeur entière saisie par l'utilisateur.

title est le texte affiché dans la barre de titre de la boîte de dialogue. label est le texte présenté à l’utilisateur (il doit indiquer ce qu’il faut saisir). value est la valeur entière par défaut à laquelle la zone de sélection sera réglée. min et max sont les valeurs minimale et maximale que l’utilisateur peut choisir. step correspond à l’incrément ou au décrément de la valeur lorsque l’utilisateur appuie sur les boutons fléchés pour augmenter ou diminuer la valeur.

Si ok est non nul, *ok sera défini sur true si l'utilisateur a cliqué sur OK et sur false s'il a cliqué sur Cancel. Le parent de la boîte de dialogue est parent. La boîte de dialogue sera modale et utilisera le widget flags.

En cas de réussite, cette fonction renvoie l’entier saisi par l’utilisateur ; en cas d’échec, elle renvoie la valeur initiale value.

Utilisez cette fonction statique comme suit :

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

Voir également getText(), getDouble(), getItem() et getMultiLineText().

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

Fonction statique pratique permettant à l'utilisateur de sélectionner un élément dans une liste de chaînes de caractères.

title est le texte affiché dans la barre de titre de la boîte de dialogue. label est le texte présenté à l'utilisateur (il doit indiquer ce qui doit être saisi). items est la liste de chaînes qui est insérée dans la liste déroulante. current est le numéro de l'élément qui doit être sélectionné par défaut. inputMethodHints correspond aux conseils de méthode de saisie qui seront utilisés si la liste déroulante est modifiable et qu'une méthode de saisie est active.

Si editable est vrai, l'utilisateur peut saisir son propre texte ; sinon, il ne peut sélectionner qu'un des éléments existants.

Si ok est non nul, *ok sera défini sur true si l’utilisateur a appuyé sur OK et sur false s’il a appuyé sur Cancel. Le parent de la boîte de dialogue est parent. La boîte de dialogue sera modale et utilisera le widget flags.

Cette fonction renvoie le texte de l'élément actuel ou, si editable est vrai, le texte actuel de la liste déroulante.

Utilisez cette fonction statique comme suit :

    const QStringList 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);

Voir également getText(), getInt(), getDouble() et getMultiLineText().

[static] QString QInputDialog::getMultiLineText(QWidget *parent, const QString &title, const QString &label, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Fonction statique d'aide permettant de récupérer une chaîne de caractères multiligne saisie par l'utilisateur.

title est le texte affiché dans la barre de titre de la boîte de dialogue. label est le texte présenté à l’utilisateur (il doit indiquer ce qu’il faut saisir). text est le texte par défaut placé dans le champ d’édition de texte brut. inputMethodHints correspond aux indications relatives à la méthode de saisie qui seront utilisées dans le widget d’édition si une méthode de saisie est active.

Si ok est non nul , *ok sera défini sur true si l’utilisateur a cliqué sur OK et sur false s’il a cliqué sur Cancel. Le parent de la boîte de dialogue est parent. La boîte de dialogue sera modale et utilisera le widget spécifié flags.

Si la boîte de dialogue est acceptée, cette fonction renvoie le texte contenu dans le champ d’édition de texte brut de la boîte de dialogue. Si la boîte de dialogue est rejetée, une valeur nulle QString est renvoyée.

Utilisez cette fonction statique comme suit :

    bool ok{};
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street"_L1, &ok);
    if (ok && !text.isEmpty())
        multiLineTextLabel->setText(text);

Voir également getInt(), getDouble(), getItem() et getText().

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

Fonction statique d'utilité permettant de récupérer une chaîne de caractères auprès de l'utilisateur.

title est le texte affiché dans la barre de titre de la boîte de dialogue. label est le texte présenté à l'utilisateur (il doit indiquer ce qu'il faut saisir). text est le texte par défaut qui s’affiche dans la zone de saisie. mode correspond au mode d’affichage que la zone de saisie utilisera. inputMethodHints correspond aux conseils relatifs à la méthode de saisie qui s’afficheront dans la zone de saisie si une méthode de saisie est active.

Si ok n’est pas nul, *ok sera défini sur true si l’utilisateur a cliqué sur OK et sur false s’il a cliqué sur Cancel. Le parent de la boîte de dialogue est parent. La boîte de dialogue sera modale et utilisera le widget spécifié flags.

Si la boîte de dialogue est acceptée, cette fonction renvoie le texte contenu dans le champ de saisie de la boîte de dialogue. Si la boîte de dialogue est rejetée, une valeur nulle QString est renvoyée.

Utilisez cette fonction statique comme suit :

    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);

Voir également getInt(), getDouble(), getItem() et getMultiLineText().

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

Ce signal est émis chaque fois que la valeur entière change dans la boîte de dialogue. La valeur actuelle est spécifiée par value.

Ce signal n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « IntInput ».

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

Ce signal est émis chaque fois que l'utilisateur sélectionne une valeur entière en validant 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 n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « IntInput ».

[override virtual] QSize QInputDialog::minimumSizeHint() const

Réimplémente : QDialog::minimumSizeHint() const.

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

Cette fonction relie l'un de ses signaux à l'emplacement spécifié par receiver et member. Le signal concerné dépend des arguments spécifiés dans member. Il s'agit des éléments suivants :

• textValueSelected() si member a un QString comme premier argument.
• intValueSelected() si member a un int comme premier argument.
• doubleValueSelected() si member a un double comme premier argument.
• accepted() si member n’a AUCUN argument.

Le signal sera déconnecté de l'emplacement lorsque la boîte de dialogue sera fermée.

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

Définit la plage des valeurs à virgule flottante en double précision acceptées par la boîte de dialogue lorsqu'elle est utilisée en mode « DoubleInput », les valeurs minimale et maximale étant respectivement spécifiées par min et max.

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

Définit la plage de valeurs entières acceptées par la boîte de dialogue lorsqu'elle est utilisée en mode « IntInput », les valeurs minimale et maximale étant respectivement spécifiées par min et max.

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

Active l'option spécifiée si la valeur de on est « true » ; dans le cas contraire, désactive l'option spécifiée.

Voir également options et testOption().

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

Réimplémente : QDialog::setVisible(bool visible).

[override virtual] QSize QInputDialog::sizeHint() const

Réimplémente : QDialog::sizeHint() const.

bool QInputDialog::testOption(QInputDialog::InputDialogOption option) const

Renvoie « true » si l'option spécifiée est activée ; sinon, renvoie « false ».

Voir également options et setOption().

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

Ce signal est émis chaque fois que la chaîne de texte change dans la boîte de dialogue. La chaîne actuelle est spécifiée par text.

Ce signal n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « TextInput ».

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

Ce signal est émis chaque fois que l'utilisateur sélectionne une chaîne de texte en validant la boîte de dialogue ; par exemple, en cliquant sur le bouton « OK ». La chaîne sélectionnée est indiquée par text.

Ce signal n'est pertinent que lorsque la boîte de dialogue de saisie est utilisée en mode « TextInput ».