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)

每当对话框中的 double 值发生变化时，就会发出该信号。当前值由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 将被设置为 "true"（如果用户按了OK ）和 "false"（如果用户按了Cancel ）。对话框的父级是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将被设置为 true（如果用户按了OK ）��如果用户按了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 是显示给用户的文本（应说明应输入的内容）。 是放置在纯文本编辑器中的默认文本。 是输入法提示，如果输入法处于活动状态，将在编辑 widget 中使用。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将被设置为 "true"（如果用户按了OK ）和 "false"（如果用户按了Cancel ）。对话框的父级是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 模式下使用输入对话框时，才会出现此信号。