QInputDialog Class

成员函数文档

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

根据给定的parent 和窗口flags 创建一个新的输入对话框。

[virtual noexcept] QInputDialog::~QInputDialog()

关闭输入对话框。

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

重写：QDialog::done(int r)。

关闭对话框，并将结果代码设置为result 。如果该对话框是通过exec()调用的，那么调用done()将导致本地事件循环结束，并且exec()将返回result 。

另请参阅 QDialog::done()。

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

每当对话框中的双精度数值发生变化时，都会触发此信号。当前数值由 `value` 指定。

仅当输入对话框处于DoubleInput 模式时，此信号才起作用。

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

每当用户通过接受对话框（例如，点击“OK ”按钮）选定一个双精度数值时，都会触发此信号。所选数值由value 指定。

仅当输入对话框以“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)

一个静态便利函数，用于从用户处获取一个浮点数。

title 是显示在对话框标题栏中的文本。label 是显示给用户的文本（应说明应输入的内容）。value 是行编辑框默认设置的浮点数。min 和max 分别是用户可选择的最小值和最大值。decimals 是该数值允许的小数位数上限。step 表示用户按下箭头按钮增减数值时，每次变化的量。

如果ok 不为空，则当用户按下OK 时，*ok 将被设置为 true；当用户按下Cancel 时，则被设置为 false。该对话框的父窗口是parent 。该对话框为模态对话框，并使用控件flags 。

该函数返回用户输入的浮点数。

请按以下方式使用此静态函数：

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

另请参阅 getText()、getInt()、getItem() 以及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())

一个静态便捷函数，用于从用户处获取整数输入。

title 是显示在对话框标题栏中的文本。label 是显示给用户的文本（应说明需要输入的内容）。value 是旋钮框的默认整数值。min 以及max 分别是用户可选择的最小值和最大值。step 表示用户按下箭头按钮增减数值时，每次变化的幅度。

如果ok 不为空，*ok 在用户按下OK 时将设置为 true，按下Cancel 时将设置为 false。该对话框的父对象是parent 。该对话框为模态对话框，并使用控件flags 。

成功时，该函数返回用户输入的整数；失败时，返回初始值value 。

请按以下方式使用此静态函数：

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

另请参阅 getText()、getDouble()、getItem() 以及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)

一个静态便利函数，用于让用户从字符串列表中选择一个项目。

title 是显示在对话框标题栏中的文本。label 是显示给用户的文本（应说明需要输入的内容）。items 是插入下拉列表框中的字符串列表。current 是作为当前项的条目编号。inputMethodHints 是当下拉列表框可编辑且有输入法处于活动状态时将使用的输入法提示。

如果 `editable ` 为 `true`，用户可以输入自定义文本；否则，用户只能从现有项目中进行选择。

如果ok 不为空，则当用户按下OK 时，*ok将被设置为 true；当用户按下Cancel 时，*ok将被设置为 false。该对话框的父级是parent 。该对话框为模态对话框，并使用小部件flags 。

该函数返回当前项目的文本；如果editable 为true，则返回下拉列表框的当前文本。

请按如下方式使用此静态函数：

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

另请参阅 getText()、getInt()、getDouble() 以及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)

一个静态便利函数，用于从用户处获取多行字符串。

title 是显示在对话框标题栏中的文本。label 是显示给用户的文本（应说明需要输入的内容）。text 是放置在纯文本编辑框中的默认文本。inputMethodHints 是当输入法处于活动状态时，将在编辑控件中使用的输入法提示。

如果ok 不为空，则当用户按下OK 时*ok将被设置为 true，按下Cancel 时则设置为 false。该对话框的父窗口为parent 。该对话框为模态对话框，并使用指定的控件flags 。

如果对话框被接受，该函数将返回对话框中纯文本编辑框中的文本；如果对话框被拒绝，则返回一个空的QString 。

此静态函数的使用方法如下：

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

另请参阅 getInt()、getDouble()、getItem() 以及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)

用于从用户处获取字符串的静态便利函数。

title 是显示在对话框标题栏中的文本。label 是显示给用户的文本（应说明需要输入的内容）。text 是行编辑框中的默认文本。mode 是行编辑框将使用的回显模式。inputMethodHints 是在输入法处于活动状态时，编辑控件中将使用的输入法提示。

如果ok 不为空，则当用户按下OK 时*ok将被设为 true，按下Cancel 时则设为 false。该对话框的父窗口为parent 。该对话框将以模态方式显示，并使用指定的控件flags 。

如果对话框被接受，该函数将返回对话框中行编辑框中的文本；如果对话框被拒绝，则返回一个空的QString 。

请按以下方式使用此静态函数：

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

另请参阅 getInt()、getDouble()、getItem() 和getMultiLineText()。

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

每当对话框中的整数值发生变化时，都会触发此信号。当前值由value 指定。

仅当输入对话框处于IntInput 模式时，此信号才有效。

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

每当用户通过接受对话框（例如，点击“OK ”按钮）选择一个整数值时，都会触发此信号。所选值由value 指定。

仅当输入对话框以IntInput 模式使用时，此信号才相关。

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

重新实现了：QDialog::minimumSizeHint() const。

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

该函数将其其中一个信号连接到由receiver 和member 指定的插槽。具体连接哪个信号取决于member 中指定的参数。这些参数包括：

• textValueSelected()，若member 的第一个参数为QString 。
• intValueSelected()，若member 的第一个参数为 int 类型。
• doubleValueSelected若member 的第一个参数为 double，则返回 ()。
• accepted() 若 `member ` 没有参数。

当对话框关闭时，该信号将与插槽断开连接。

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

设置对话框在DoubleInput 模式下接受的双精度浮点数范围，其中最小值和最大值分别由min 和max 指定。

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

设置对话框在IntInput 模式下接受的整数值范围，其中最小值和最大值分别由min 和max 指定。

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

如果on 为true，则启用指定的option ；否则，清除指定的option 。

另请参阅 options 和testOption()。

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

重写了：QDialog::setVisible （bool visible）。

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

重新实现了：QDialog::sizeHint() const。

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

如果给定的option 已启用，则返回true ；否则，返回false。

另请参阅 options 和setOption()。

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

每当对话框中的文本字符串发生变化时，都会触发此信号。当前字符串由text 指定。

仅当输入对话框处于TextInput 模式时，此信号才有效。

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

每当用户通过接受对话框（例如，点击“OK ”按钮）选中一个文本字符串时，都会触发此信号。所选字符串由text 指定。

仅当输入对话框以“TextInput ”模式使用时，此信号才相关。