Qt学习之路(18): Qt标准对话框之QInputDialog

这是Qt标准对话框的最后一部分。正如同其名字显示的一样，QInputDialog用于接收用户的输入。QInputDialog提供了一些简单的static函数，用于快速的建立一个对话框，正像QColorDialog提供了getColor函数一样。

 

首先来看看getText函数：

 

bool isOK;
QString text = QInputDialog::getText(NULL, "Input Dialog",
                                                    "Please input your comment",
                                                   QLineEdit::Normal,
                                                    "your comment",
                                                   &isOK);
if(isOK) {
       QMessageBox::information(NULL, "Information",
                                            "Your comment is: " + text + "",
                                           QMessageBox::Yes | QMessageBox::No,
                                           QMessageBox::Yes);
}

 

代码比较简单，使用getText函数就可以弹出一个可供用户输入的对话框：

 

 

下面来看一下这个函数的签名：

 

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

 

第一个参数parent，也就是那个熟悉的父组件的指针；第二个参数title就是对话框的标题；第三个参数label是在输入框上面的提示语句；第四个参数mode用于指明这个QLineEdit的输入模式，取值范围是QLineEdit::EchoMode，默认是Normal，也就是正常显示，你也可以声明为password，这样就是密码的输入显示了，具体请查阅API；第五个参数text是QLineEdit的默认字符串；第六个参数ok是可选的，如果非NLL，则当用户按下对话框的OK按钮时，这个bool变量会被置为true，可以由这个去判断用户是按下的OK还是Cancel，从而获知这个text是不是有意义；第七个参数flags用于指定对话框的样式。

 

虽然参数很多，但是每个参数的含义都比较明显，大家只要参照API就可以知道了。

 

函数的返回值是QString，也就是用户在QLineEdit里面输入的内容。至于这个内容有没有意义，那就要看那个ok参数是不是true了。

 

QInputDialog不仅提供了获取字符串的函数，还有getInteger，getDouble，getItem三个类似的函数，这里就不一一介绍。