QInputDialog Class

Member Function Dokumentation

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

Konstruiert einen neuen Eingabedialog mit dem angegebenen parent und Fenster flags.

[virtual noexcept] QInputDialog::~QInputDialog()

Zerstört den Eingabedialog.

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

Reimplements: QDialog::done(int r).

Schließt den Dialog und setzt seinen Ergebniscode auf result. Wenn dieser Dialog mit exec() angezeigt wird, beendet done() die lokale Ereignisschleife, und exec() gibt result zurück.

Siehe auch QDialog::done().

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

Dieses Signal wird ausgegeben, wenn sich der Doppelwert im Dialog ändert. Der aktuelle Wert wird durch value angegeben.

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

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

Dieses Signal wird ausgegeben, wenn der Benutzer einen doppelten Wert auswählt, indem er den Dialog akzeptiert, z. B. durch Anklicken der 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 Komfortfunktion, um eine Fließkommazahl vom Benutzer zu erhalten.

title ist der Text, der in der Titelleiste des Dialogs angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte sagen, was eingegeben werden soll). value ist die Standard-Fließkommazahl, auf die die Zeilenbearbeitung eingestellt wird. min und max sind die Mindest- und Höchstwerte, die der Benutzer wählen kann. decimals ist die maximale Anzahl der 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 nicht null ist, * wirdok auf true gesetzt, wenn der Benutzer OK gedrückt hat, und auf false, wenn der Benutzer Cancel gedrückt hat. Das übergeordnete Element des Dialogs ist parent. Der Dialog ist modal und verwendet das Widget flags.

Diese Funktion gibt die Fließkommazahl zurück, die der Benutzer eingegeben hat.

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(QString("$%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 Komfortfunktion, um eine Integer-Eingabe vom Benutzer zu erhalten.

title ist der Text, der in der Titelleiste des Dialogs angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte sagen, was eingegeben werden soll). value ist die Standard-Ganzzahl, auf die die Spinbox gesetzt wird. min und max sind die Mindest- und Höchstwerte, die der Benutzer wä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 leer ist * wirdok auf true gesetzt, wenn der Benutzer OK gedrückt hat, und auf false, wenn der Benutzer Cancel gedrückt hat. Das übergeordnete Element des Dialogs ist parent. Der Dialog ist modal und verwendet das Widget flags.

Im Erfolgsfall gibt diese Funktion die vom Benutzer eingegebene Ganzzahl zurück; im Fehlerfall 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 Komfortfunktion, mit der der Benutzer ein Element aus einer Stringliste auswählen kann.

title ist der Text, der in der Titelleiste des Dialogs angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte sagen, was eingegeben werden soll). items ist die Stringliste, die in das Kombinationsfeld eingefügt wird. current ist die Nummer des Elements, das das aktuelle Element sein soll. inputMethodHints ist der Hinweis auf die Eingabemethode, die verwendet wird, wenn das Kombinationsfeld editierbar ist und eine Eingabemethode aktiv ist.

Wenn editable wahr ist, kann der Benutzer einen eigenen Text eingeben; andernfalls kann der Benutzer nur einen der vorhandenen Einträge auswählen.

Wenn ok nicht null ist, wird *ok auf true gesetzt, wenn der Benutzer OK gedrückt hat, und auf false, wenn der Benutzer Cancel gedrückt 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 wenn editable wahr ist, den aktuellen Text des Kombinationsfeldes.

Verwenden Sie diese statische Funktion wie folgt:

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

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 Komfortfunktion, um eine mehrzeilige Zeichenkette vom Benutzer zu erhalten.

title ist der Text, der in der Titelleiste des Dialogs angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte sagen, was eingegeben werden soll). text ist der Standardtext, der in der reinen Texteingabe platziert wird. inputMethodHints ist der Hinweis auf die Eingabemethode, die im Eingabewidget verwendet wird, wenn eine Eingabemethode aktiv ist.

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

Wenn der Dialog akzeptiert wird, gibt diese Funktion den Text in der Klartextbearbeitung des Dialogs zurück. Wenn der Dialog abgelehnt wird, wird eine Null QString zurückgegeben.

Verwenden Sie diese statische Funktion wie diese:

    bool ok;
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street", &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 Komfortfunktion, um eine Zeichenkette vom Benutzer zu erhalten.

title ist der Text, der in der Titelleiste des Dialogs angezeigt wird. label ist der Text, der dem Benutzer angezeigt wird (er sollte sagen, was eingegeben werden soll). text ist der Standardtext, der in der Eingabezeile platziert wird. mode ist der Echo-Modus, den die Eingabezeile verwendet. inputMethodHints ist der Hinweis auf die Eingabemethode, die im Eingabe-Widget verwendet wird, wenn eine Eingabemethode aktiv ist.

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

Wenn der Dialog akzeptiert wird, gibt diese Funktion den Text in der Bearbeitungszeile des Dialogs zurück. Wenn der Dialog abgelehnt wird, wird eine 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 ausgegeben, wenn sich der Integer-Wert im Dialog ändert. Der aktuelle Wert wird durch value angegeben.

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

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

Dieses Signal wird ausgegeben, wenn der Benutzer einen ganzzahligen Wert auswählt, indem er den Dialog akzeptiert, z. B. durch Anklicken der 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

Reimplements: QDialog::minimumSizeHint() const.

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

Diese Funktion verbindet eines ihrer Signale mit dem durch receiver und member angegebenen Steckplatz. Das spezifische Signal hängt von den Argumenten ab, die in member angegeben sind. Diese sind:

• textValueSelected() wenn member ein QString als erstes Argument hat.
• intValueSelected() wenn member ein int als erstes Argument hat.
• doubleValueSelected() wenn member ein double als erstes Argument hat.
• accepted() wenn member KEINE Argumente hat.

Das Signal wird vom Slot getrennt, wenn der Dialog geschlossen wird.

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

Legt den Bereich der Fließkommazahlen mit doppelter Genauigkeit fest, der vom Dialogfeld akzeptiert wird, wenn es im Modus DoubleInput verwendet wird, wobei die Mindest- und Höchstwerte durch min bzw. max angegeben werden.

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

Legt den Bereich der ganzzahligen Werte fest, die vom Dialogfeld akzeptiert werden, wenn es im Modus IntInput verwendet wird, wobei die Mindest- und Höchstwerte durch min bzw. max angegeben werden.

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

Setzt das angegebene option auf aktiv, wenn on wahr ist; andernfalls wird das angegebene option gelöscht.

Siehe auch options und testOption().

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

Reimplements: QDialog::setVisible(bool visible).

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

Reimplements: 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 ausgegeben, wenn sich die Textzeichenfolge im Dialog ändert. Die aktuelle Zeichenkette 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 ausgegeben, wenn der Benutzer eine Textzeichenfolge auswählt, indem er den Dialog akzeptiert, z. B. durch Anklicken der Schaltfläche OK. Die ausgewählte Zeichenfolge wird durch text angegeben.

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