Qt5.1文档翻译： QInputDialog 类，QInputDialog Class

详细说明

QInputDialog类提供了一种简单方便的对话框来从用户那里获取到单个的输入值。

对应的输入值可以是一个字符串、一个数字或者是某个列表中的一个条目（item）。必须设置一个文本标签，以告之用户该输入什么东西。

提供 了4个静态的便利函数： getText () 、 getInt () 、 getDouble () 和 getItem () 。 这4个函数都可以以相近的方式来使用，例如：

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

如果用户点击 了 OK ，则变量 ok 会被设置成真（true）；否则， 它将被设置为假（false）。

标准对话框 示例 中演示了如何使用 QInputDialog 及其它内置的 Qt对话框 。

参考 QMessageBox 及 标准对话框示例。

成员函数文档

QString QInputDialog:: getText ( QWidget * parent , const QString & title , const QString & label , QLineEdit::EchoMode mode = QLineEdit::Normal, const QString & text = QString(), bool * ok = 0, Qt::WindowFlags flags = 0, Qt::InputMethodHints inputMethodHints = Qt::ImhNone) [static]

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

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

警告： 不要在此对话框的执行过程中删除 parent 。如果 妳确实需要做这件事的话，那么，妳应当使用 QInputDialog 构造函数 来亲自创建对话框。

参考 getInt () 、 getDouble () 和 getItem () 。

未知美人