QInputDialog Class

Dokumentation der Member-Funktionen

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

Erstellt ein neues Eingabedialogfeld mit dem angegebenen „ parent “ und dem Fenster „ flags “.

[virtual noexcept] QInputDialog::~QInputDialog()

Löst den Eingabedialog auf.

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

Implementiert: ` QDialog::done(int r)`.

Schließt das Dialogfeld und setzt dessen Ergebniscode auf „ result “. Wenn dieses Dialogfeld mit „ exec()“ angezeigt wird, bewirkt „done()“, dass die lokale Ereignisschleife beendet wird, und „ exec()“ gibt „ result “ zurück.

Siehe auch „ QDialog::done()“.

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

Dieses Signal wird immer dann ausgelöst, wenn sich der Double-Wert im Dialogfeld ändert. Der aktuelle Wert wird durch „ value “ festgelegt.

Dieses Signal ist nur relevant, wenn der Eingabedialog im Modus „ DoubleInput “ verwendet wird.

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

Dieses Signal wird ausgelöst, sobald der Benutzer einen Double-Wert auswählt, indem er den Dialog bestätigt, beispielsweise durch Klicken auf die Schaltfläche „ OK “. Der ausgewählte Wert wird durch ` value` angegeben.

Dieses Signal ist nur relevant, wenn der Eingabedialog im Modus „ DoubleInput “ verwendet wird.

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

Statische Hilfsfunktion zum Abrufen einer Gleitkommazahl vom Benutzer.

title ist der Text, der in der Titelleiste des Dialogfelds angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte beschreiben, was eingegeben werden soll). value ist die Standard-Gleitkommazahl, auf die das Eingabefeld gesetzt wird. min und max sind der Mindest- und Höchstwert, die der Benutzer auswählen darf. decimals ist die maximale Anzahl an Dezimalstellen, die die Zahl haben darf. step ist der Betrag, um den sich die Werte ändern, wenn der Benutzer die Pfeiltasten drückt, um den Wert zu erhöhen oder zu verringern.

Wenn „ ok “ ungleich Null ist, wird „ok “ auf „true“ gesetzt, wenn der Benutzer „ OK “ drückt, und auf „false“, wenn der Benutzer „ Cancel “ drückt. Das übergeordnete Element des Dialogs ist „ parent “. Der Dialog ist modal und verwendet das Widget „ flags “.

Diese Funktion gibt die vom Benutzer eingegebene Gleitkommazahl zurück.

Verwenden Sie diese statische Funktion wie folgt:

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

Siehe auch „ getText()“, „ getInt()“, „ getItem()“ und „ 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())

Statische Hilfsfunktion zum Abrufen einer ganzzahligen Eingabe vom Benutzer.

title ist der Text, der in der Titelleiste des Dialogfelds angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte beschreiben, was eingegeben werden soll). value ist der Standardwert, auf den das Eingabefeld gesetzt wird. min und max sind die Minimal- und Maximalwerte, die der Benutzer auswählen kann. step ist der Betrag, um den sich die Werte ändern, wenn der Benutzer die Pfeiltasten drückt, um den Wert zu erhöhen oder zu verringern.

Wenn „ ok “ nicht null ist, wird „ok “ auf „true“ gesetzt, wenn der Benutzer „ OK “ drückt, und auf „false“, wenn der Benutzer „ Cancel “ drückt. Das übergeordnete Element des Dialogs ist „ parent “. Der Dialog ist modal und verwendet das Widget „ flags “.

Bei Erfolg gibt diese Funktion die vom Benutzer eingegebene Ganzzahl zurück; bei einem Fehler gibt sie den Ausgangswert „ value “ zurück.

Verwenden Sie diese statische Funktion wie folgt:

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

Siehe auch getText(), getDouble(), getItem() und 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)

Statische Hilfsfunktion, mit der der Benutzer ein Element aus einer Zeichenfolgenliste auswählen kann.

title ist der Text, der in der Titelleiste des Dialogfelds angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte angeben, was eingegeben werden soll). items ist die Zeichenfolgenliste, die in das Kombinationsfeld eingefügt wird. current ist die Nummer des Eintrags, der als aktueller Eintrag markiert werden soll. inputMethodHints sind die Eingabemethode-Hinweise, die verwendet werden, wenn das Kombinationsfeld bearbeitbar ist und eine Eingabemethode aktiv ist.

Ist editable wahr, kann der Benutzer eigenen Text eingeben; andernfalls darf der Benutzer nur eines der vorhandenen Elemente auswählen.

Ist ` ok ` nicht null, wird `*ok` auf `true` gesetzt, wenn der Benutzer auf „ OK “ geklickt hat, und auf `false`, wenn der Benutzer auf „ Cancel “ geklickt hat. Das übergeordnete Element des Dialogs ist ` parent`. Der Dialog ist modal und verwendet das Widget ` flags`.

Diese Funktion gibt den Text des aktuellen Elements zurück oder, falls „ editable “ auf „true“ gesetzt ist, den aktuellen Text der Kombinationsbox.

Verwenden Sie diese statische Funktion wie folgt:

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

Siehe auch „ getText()“, „ getInt()“, „ getDouble()“ und „ 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)

Statische Hilfsfunktion zum Abrufen einer mehrzeiligen Zeichenkette vom Benutzer.

title ist der Text, der in der Titelleiste des Dialogfelds angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte beschreiben, was eingegeben werden soll). text ist der Standardtext, der in das Klartext-Eingabefeld eingefügt wird. inputMethodHints sind die Eingabemethode-Hinweise, die im Eingabefeld verwendet werden, wenn eine Eingabemethode aktiv ist.

Ist ok nicht null, wird *ok auf „true“ gesetzt, wenn der Benutzer auf OK geklickt hat, und auf „false“, wenn der Benutzer auf Cancel geklickt hat. Das übergeordnete Element des Dialogs ist parent. Der Dialog ist modal und verwendet das angegebene Widget flags.

Wird der Dialog akzeptiert, gibt diese Funktion den Text im Klartext-Eingabefeld des Dialogs zurück. Wird der Dialog abgelehnt, wird ein Null- QString zurückgegeben.

Verwenden Sie diese statische Funktion wie folgt:

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

Siehe auch getInt(), getDouble(), getItem() und 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)

Statische Hilfsfunktion zum Abrufen einer Zeichenkette vom Benutzer.

title ist der Text, der in der Titelleiste des Dialogfelds angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte beschreiben, was eingegeben werden soll). text ist der Standardtext, der in das Zeilen-Edit-Feld eingefügt wird. mode ist der Echo-Modus, den das Zeilen-Edit-Feld verwendet. inputMethodHints sind die Eingabemethode-Hinweise, die im Edit-Widget verwendet werden, wenn eine Eingabemethode aktiv ist.

Wenn „ ok “ nicht null ist, wird „*ok“ auf „true“ gesetzt, wenn der Benutzer auf „ OK “ geklickt hat, und auf „false“, wenn der Benutzer auf „ Cancel “ geklickt hat. Das übergeordnete Element des Dialogs ist „ parent “. Der Dialog ist modal und verwendet das angegebene Widget „ flags “.

Wird der Dialog akzeptiert, gibt diese Funktion den Text im Zeilenbearbeitungsfeld des Dialogs zurück. Wird der Dialog abgelehnt, wird ein Null- QString zurückgegeben.

Verwenden Sie diese statische Funktion wie folgt:

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

Siehe auch „ getInt()“, „ getDouble()“, „ getItem()“ und „ getMultiLineText()“.

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

Dieses Signal wird immer dann ausgelöst, wenn sich der ganzzahlige Wert im Dialogfeld ändert. Der aktuelle Wert wird durch „ value “ festgelegt.

Dieses Signal ist nur relevant, wenn das Eingabedialogfeld im Modus „ IntInput “ verwendet wird.

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

Dieses Signal wird immer dann ausgelöst, wenn der Benutzer durch Bestätigen des Dialogfelds einen ganzzahligen Wert auswählt, beispielsweise durch Klicken auf die Schaltfläche „ OK “. Der ausgewählte Wert wird durch „ value “ angegeben.

Dieses Signal ist nur relevant, wenn der Eingabedialog im Modus „ IntInput “ verwendet wird.

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

Implementiert erneut: ` QDialog::minimumSizeHint()` const.

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

Diese Funktion verbindet eines ihrer Signale mit dem durch ` receiver ` und ` member` angegebenen Slot. Welches Signal genau, hängt von den in ` member` angegebenen Argumenten ab. Diese sind:

• textValueSelected() wenn member als erstes Argument eine QString hat.
• intValueSelected() wenn member als erstes Argument einen int hat.
• doubleValueSelected() wenn ` member ` als erstes Argument einen `double`-Wert hat.
• accepted() wenn „ member “ KEINE Argumente hat.

Das Signal wird vom Slot getrennt, wenn das Dialogfeld geschlossen wird.

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

Legt den Bereich der Gleitkommawerte mit doppelter Genauigkeit fest, die vom Dialogfeld im Modus „ DoubleInput “ akzeptiert werden, wobei die Minimal- und Maximalwerte durch „ min “ bzw. „ max “ festgelegt werden.

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

Legt den Bereich der ganzzahligen Werte fest, die vom Dialogfeld im Modus „ IntInput “ akzeptiert werden, wobei der Mindest- und der Höchstwert jeweils durch ` min ` und ` max ` festgelegt werden.

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

Setzt die angegebene Eigenschaft „ option “ auf „enabled“, wenn „ on “ den Wert „true“ hat; andernfalls wird die angegebene Eigenschaft „ option “ zurückgesetzt.

Siehe auch „ options “ und „ testOption()“.

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

Implementiert: ` QDialog::setVisible` (bool visible).

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

Implementiert: ` QDialog::sizeHint()` const.

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

Gibt „ true “ zurück, wenn die angegebene „ option “ aktiviert ist; andernfalls wird „false“ zurückgegeben.

Siehe auch „ options “ und „ setOption()“.

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

Dieses Signal wird immer dann ausgelöst, wenn sich die Textzeichenfolge im Dialogfeld ändert. Die aktuelle Zeichenfolge wird durch „ text “ festgelegt.

Dieses Signal ist nur relevant, wenn der Eingabedialog im Modus „ TextInput “ verwendet wird.

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

Dieses Signal wird immer dann ausgelöst, wenn der Benutzer eine Textzeichenfolge auswählt, indem er den Dialog bestätigt, beispielsweise durch Klicken auf die Schaltfläche „ OK “. Die ausgewählte Zeichenfolge wird durch „ text “ angegeben.

Dieses Signal ist nur relevant, wenn der Eingabedialog im Modus „ TextInput “ verwendet wird.