QInputDialog 类

成员函数文档

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

以给定的 父对象 和窗口 标志 构造一个新的输入对话框。

[虚函数 无异常抛出] QInputDialog::~QInputDialog()

销毁输入对话框。

[重写虚函数] void QInputDialog::done(int result)

重写了： QDialog::done(int r).

关闭对话框并将结果代码设置为 result。如果以 exec() 调用显示此对话框，则 done() 会导致本地事件循环结束，并从 exec() 返回 result。

也请参阅 QDialog::done。

[信号] void QInputDialog::doubleValueChanged(double value)

每当在对话框中双精度值发生变化时，此信号就会被触发。当前值由value指定。

此信号仅在输入对话框用于双精度输入模式时才有意义。

[信号] void QInputDialog::doubleValueSelected(double value)

每当用户通过接受对话框（例如，通过单击确定按钮）选中一个双精度值时，都会发出此信号。选中的值由value指定。

此信号仅在输入对话框用于双精度输入模式时才有意义。

[静态] 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将在用户按确定按钮时设置为true，在用户按取消按钮时设置为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(QString("$%1").arg(d));

也请参阅 getText、getInt、getItem和getMultiLineText。

[静态] 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())

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

标题 是显示在对话框标题栏中的文本。 标签 是显示给用户的文本（它应该说明应该输入什么）。 值 是spinbox将被设置为的默认整数。 最小值 和 最大值 是用户可以选择的最小和最大值。 步长 是用户按箭头按钮增减值时值变化的量。

如果 确定 非空 *确定 将设置为 true，如果用户按下 确定，如果用户按下 取消 则设置为 false。对话框的父级是 父级。对话框将是模态的，并使用小部件 标志。

在成功的情况下，该函数返回用户输入的整数；在失败的情况下，它返回初始的 值。

可以这样使用这个静态函数

    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。

[静态] 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)

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

标题 是显示在对话框标题栏中的文本。 标签 是显示给用户的文本（它应该说明应该输入什么）。 项目 是插入到组合框中的字符串列表。 当前值 是应该作为当前项的项目编号。 输入法提示 是如果组合框可编辑且输入法处于活动状态时将使用的输入法提示。

如果 可编辑 为 true，用户可以输入自己的文本；否则，用户只能选择现有项目之一。

如果 ok 非空，*ok 将被设置为 true，如果用户按下 确定，如果用户按下 取消 将被设置为 false。对话框的父级是 父级。对话框将是模态的，并使用小部件 标志。

这个函数返回当前项的文本，如果 可编辑 为 true，则返回组合框当前文本。

可以这样使用这个静态函数

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

另请参阅 getText()，getInt()，getDouble() 和 getMultiLineText。

[静态] 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)

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

标题是显示在对话框标题栏中的文本。标签是显示给用户的文本（它应该指明需要输入的内容）。文本是放置在纯文本编辑框中的默认文本。inputMethodHints是如果输入法处于活动状态将用于编辑小部件的输入法提示。

如果ok非空，则当用户按下确定时，将*i*设置为true，当用户按下取消时，设置为false。对话框的父级是parent。对话框将是模态的，并使用指定的flags小部件。

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

可以这样使用这个静态函数

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

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

[静态] 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)

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

标题是显示在对话框标题栏中的文本。标签是显示给用户的文本（它应该指明需要输入的内容）。文本是放置在行编辑中的默认文本。mode是行编辑将使用的回声模式。inputMethodHints是如果输入法处于活动状态将用于编辑小部件的输入法提示。

如果ok非空，则当用户按下确定时，将*i*设置为true，当用户按下取消时，设置为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()。

[信号] void QInputDialog::intValueChanged(int value)

每次在对话框中更改整数值时都会发出此信号。当前值由value指定。

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

[信号] void QInputDialog::intValueSelected(int value)

用户接受对话框（例如通过单击确定按钮）选择整数值时，将发出此信号；选定的值由value指定。

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

[覆盖虚函数] 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模式下使用时，由对话框接受的double精度浮点值的范围，分别通过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。

[覆盖虚函数] void QInputDialog::setVisible(bool visible)

重新实现: QDialog::setVisible(bool visible).

[覆盖虚函数] QSize QInputDialog::sizeHint() const

重新实现: QDialog::sizeHint() const.

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

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

另请参阅options和setOption。

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

每当对话框中的文本字符串更改时，都会发出此信号。当前字符串由 text 指定。

此信号仅在输入对话框使用在 TextInput 模式时相关。

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

当用户通过接受对话框选择文本字符串（例如，通过单击 OK 按钮）时，会发出此信号。所选字符串由 text 指定。

此信号仅在输入对话框使用在 TextInput 模式时相关。