Qt中QFileDialog的使用

（一）

Qt之标准通用对话框的使用

文档名称	Qt之标准通用对话框的使用
创建时间	2012-9-4
修改时间	2012-9-4
创建人	Baifx
简介（收获）	QFileDialog（完成）、QFontDialog、QColorDialog（完成）、QInputDialog（完成）、QMessageBox（完成）、QErrorMessage、QPrintDialog、QProgressDialog

一、综述。

       操作系统一般都会提供一些列的标准对话框，如文件选择、字体选择、颜色选择等，这些标准对话框为应用层序提供了一致的观感。Qt对这些标准对话框都定义了相关的类，如：QFileDialog、QFontDialog、QColorDialog、QInputDialog、QMessageBox、QPrintDialog、QErrorMessage、QProgressDialog等

 

二、QFileDialog

1、getOpenFileName()是QFileDialog类的一个静态函数，返回用户选择的文件名，如果用户选择取消（Cancel），则返回一个空串。函数形式如下：

QString QFileDialog::getOpenFileName( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString * selectedFilter = 0, Options options = 0 );

       调用getOpenFileName()函数将创建一个模态的文件对话框。dir参数指定了默认的目录，如果dir参数带有文件名，则该文件将是默认的选中文件；filter参数对文件系统进行过滤，只有与过滤器匹配的文件类型才显示，filter可以同时指定多种过滤方式供用户选择，多种过滤器之间用“;;”隔开，用户选择的过滤器通过参数selectedFilter返回。

       QFileDialog的静态函数

静态函数	说明	备注
getOpenFileName	获取用户选择的文件名
getSaveFileName	获取用户保存的文件名
getExistingDirectory	获取用户选择的已存在的目录名
getOpenFileNames	获得用户选择的文件名列表

详情参见Qt Assist：

Static Public Members

QString	getExistingDirectory ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), Options options = ShowDirsOnly )
QString	getOpenFileName ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString *selectedFilter = 0, Options options = 0 )
QStringList	getOpenFileNames ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString *selectedFilter = 0, Options options = 0 )
QString	getSaveFileName ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString * selectedFilter= 0, Options options = 0 )

 例：(a) QString directory = QFileDialog::getExistingDirectory(this, tr("Find Files"), QDir::currentPath(),0);

          (b)QString directory = QFileDialog::getExistingDirectory(this, tr("Find Files"), QDir::currentPath());

          (c)QString directory = QFileDialog::getExistingDirectory(this, tr("Find Files"), QDir::currentPath(),ShowDirsOnly );

           (b)和(c)是等价的

 三、QFontDialog

1、getFont()是QFontDialog的一个静态函数，返回用户选择的字体，函数形式如下：

QFont getFont( bool * ok, QWidget * parent = 0 );

调用getFont()函数将创建一个模态的字体对话框。用户选择OK，参数*ok将为true，函数返回用户选择的字体，否则为false，此时函数返回默认字体。

 

 

四、QColorDialog

1、getColor()是QColorDialog的一个静态函数，返回用户选择的颜色值，函数形式如下：

QColor getColor( const QColor & initial = Qt::white, QWidget * parent = 0 );

调用getColor()函数将创建一个模态的颜色对话框。initial参数制定了默认选中的颜色，默认为白色。通过QColor::isValid()可以判断用户选择颜色是否有效，若用户选择取消（Cancel），QColor::isValid()将返回false。

QColorDialog的静态函数

静态函数	说明	备注
customColor
customCount
getColor
getColor
setCustomColor
setStandardColor

详情参见Qt Assist：

Static Public Members

QRgb	customColor ( int index )
int	customCount ()
QColor	getColor ( const QColor & initial, QWidget * parent, const QString & title, ColorDialogOptions options = 0 )
QColor	getColor ( const QColor & initial = Qt::white, QWidget * parent = 0 )
void	setCustomColor ( int index, QRgb color )
void	setStandardColor ( int index, QRgb color )

 

 

 

五、QInputDialog

       Qt提供了一个QInputDialog类，QInputDialogDialog类提供了一种简单方便的对话框来获得用户的单个输入信息，目前提供了4种数据类型的输入，可以使一个字符串、一个Int类型数据、一个double类型数据或者是一个下拉列表框的条目。一个标准输入对话框的基本结构如下图所示：

       其中包含一个提示标签，一个输入控件。如实调用字符串输入框，则为一个QLineEdit；若是调用Int类型或都报了类型输入框，则为一个QSpinBox；若是调用列表条目输入框，则为一个QComboBox；还包括一个确定输入（OK）按钮和一个取消输入（Cancel）按钮。

QInputDialog的静态函数

静态函数	说明	备注
getText
getItem
getInteger
getDouble

       1、getText()

QInputDialog的getText()函数弹出标准字符串输入对话框，getText()函数原型如下：

QString 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]

       此函数的第一个参数parent为标准输入对话框的父窗口；第二个参数title为标准输入对话框的标题名；第三个参数label为标准输入对话框的标签提示；第四个参数mode指定标准输入对话框中QLineEdit控件的输入模式；第五个参数text为标准字符串输入对话框弹出时QLineEdit控件中默认出现的文字；第六个参数ok用于指示标准输入对话框的哪个按钮被触发，若ok为true，则表示用户单击了OK（确定）按钮，若ok为false，则表示用户单击了Cancel（取消）按钮；最后一个参数f知名标准输入对话框的窗体标识。

      

       2、getItem()

       QInputDialog的getItem()函数弹出标准条目选择对话框，getItem()函数原型如下：

QString getItem( QWidget * parent, const QString & title, const QString & label, const QStringList & list, int current = 0, bool editable = true, bool * ok = 0, Qt::WindowFlags f = 0 ) ;  [static]

       此函数的第一个参数parent为标准输入对话框的父窗口；第二个参数title为标准输入对话框的标题名；第三个参数label为标准输入对话框的标签提示；第四个参数list指定标准输入对话框中QComboBox控件显示的可选条目，为一个QStringList对象；第五个参数current为标准条目选择对话框弹出时QComboBox控件中默认显示的条目序号；第六个参数额滴table指定QComboBox控件中显示的文字是否可编辑；第七个参数ok用于指定标准输入对话框的哪个那妞被触发，若ok为false，则表示用户单击了Cancel（取消）按钮；最后一个参数f知名标准输入对话框的窗体标识。

 

       3、getInteger()

       QInputDialog的getInteger()函数弹出标准int类型输入对话框，getInteger()函数原型如下：

int getInteger( QWidget * parent, const QString & title, const QString & label, int value = 0, int minValue = -2147483647, int maxValue = 2147483647, int step = 1, bool * ok = 0, Qt::WindowFlags f = 0 ) ;  [static]

       此函数的第一个参数parent为标准输入对话框的父窗口；第二个参数title为标准输入对话框的标题名；第三个参数label为标准输入对话框的标签提示；第四个参数value指定标准输入对话框中QSpinBox控件默认显示值；第五、六个参数minValue、maxValue指定QSpinBoxBox控件的数值范围；第七个参数step指定QSpinBox控件的步进值；第八个参数ok用于指定标准输入对话框的哪个那妞被触发，若ok为false，则表示用户单击了Cancel（取消）按钮；最后一个参数f知名标准输入对话框的窗体标识。

 

       4、getDouble()

       QInputDialog的getDouble()函数弹出标准double类型输入对话框，getDouble()函数原型如下：

double getDouble( QWidget * parent, const QString & title, const QString & label, double value = 0, double minValue = -2147483647, double maxValue 2147483647, int decimals = 1, bool * ok = 0, Qt::WindowFlags f = 0 ) ;  [static]

       此函数的第一个参数parent为标准输入对话框的父窗口；第二个参数title为标准输入对话框的标题名；第三个参数label为标准输入对话框的标签提示；第四个参数value指定标准输入对话框中QSpinBox控件默认显示值；第五、六个参数minValue、maxValue指定QSpinBoxBox控件的数值范围；第七个参数decimals指定QSpinBox控件的步进值；第八个参数ok用于指定标准输入对话框的哪个那妞被触发，若ok为false，则表示用户单击了Cancel（取消）按钮；最后一个参数f知名标准输入对话框的窗体标识。

 

       六、QMessageBox

       QMessageBox提供了6中类型的消息框，包括Question消息框、Information消息框、Warning消息框、Critical消息框、About（关于）消息框、About（关于）Qt消息框。其实用户完全可以自己定义消息框，本节最后给出一个例子。

       Question消息框、Information消息框、Warning消息框、Critical消息框用法大同小异，这些消息框一般都包含一条提示信息、一个图标以及如干个按钮，它们的作用都是给用户提供一些提醒或一些简单的询问。按图标的不同可分为以下四个级别。

Question：为正常的操作提供一个简单的询问。

Information：为正常的操作提供一个提示。

Warning：提醒用户发生了一个错误。

Critical：警告用户发生了一个严重错误。

QMessageBox的静态函数

静态函数	说明	备注
about
aboutQt
critical
warning
information
question

详情参见Qt Assist：

Static Public Members

void	about ( QWidget * parent, const QString & title, const QString & text )
void	aboutQt ( QWidget * parent, const QString & title = QString() )
StandardButton	critical ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton )
StandardButton	information ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton )
StandardButton	question ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton )
StandardButton	warning ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton )

       1、对于Question消息框，调用时直接使用QMessageBox::question()即可。第一个参数为消息框的父窗口指针；第二个参数为消息框的标题栏；第三个参数为消息框的文字提示信息，前三个参数对于其他几种消息框基本是一样的；后两个参数都是对消息框按钮的设定，QMessageBox类提供了许多标准按钮，如QMessageBox::OK、QMessageBox::Close、QMessageBox::Discard等，具体可查阅Qt帮助。第四个参数即填写希望在消息框中出现的按钮，可根据需要在标准按钮中选择，用“|”连写，默认为QMessageBox::OK。第五个参数为默认按钮，即消息框出现时，焦点默认处于哪个按钮上。函数的返回值为按下的按钮，当用户按Escape键时，相当于返回QMessageBox::Cancel。

 

       2、Information消息框使用频率最高也最简单，直接调用QMessageBox::information()即可。第一个参数为消息框的父窗口指针；第二个参数为消息框的标题栏；第三个参数为消息框的文字提示信息，前三个参数对于其他几种消息框基本是一样的；后两个参数与Question消息框的用法一样，但在使用的过程中，经常会省略后两个参数，直接使用默认的QMessageBox::Ok按钮。

       Information消息框和Question消息框可以通用，使用Question消息框的地方都可以用Information消息框替换。

 

       3、Warning消息框的最常用法为当用户进行了一个非正常操作时，提醒用户并询问是否进行某项操作，如关闭文档时，提醒并询问用户是否保存对文档的修改。

       函数调用方式与前面Question消息框的调用方式大致相同。第一个参数为消息框的父窗口指针；第二个参数为消息框的标题栏；第三个参数为消息框的文字提示信息；第四个参数为希望在消息框中出现的按钮，可根据需要在标准按钮中选择，用“|”连写，默认为QMessageBox::Ok。第五个参数为默认按钮，即消息框出现时，焦点默认处于哪个按钮上。

       注意：消息框的第四个参数的选择，虽是在QMessageBox::standardButtons中任意选择，但并不是随意选择，应注意按常规成对出现。如选择了QMessageBox::Save按钮则最好成对地选择QMessageBox::Discard按钮；而Abort、Retry、Ignore一般是一起出现的。

 

       4、Critical消息框是在系统出现严重错误时对用户进行提醒的。它的用法也相对简单，通常情况下和Information消息框一样，在调用时只填写前三个参数即可。

 

       5、About消息框一般用于提供系统的版本等信息。只需提供信息而不需要用户反馈信息，因此用法简单，直接调用QMessageBox::about()，并只用指定消息框父窗口、标题栏以及信息的内容即可。

 

       6、About Qt消息框是Qt预定好的一种消息框，用于提供Qt的相关信息，只需直接调用QMessageBox::aboutQt()，并指定父窗口和标题栏即可，其中显示的内容是Qt预定好的。

 

       7、自定义消息框。包括消息框的图标、按钮、内容等都可以根据需要进行设定。例子如下：

QMessageBox customMsgBox;

         customMsgBox.setWindowTitle( tr( "Custom message box" ) );

        

         QPushButton * lockButton = customMsgBox.addButton( tr( "Lock" ), QMessageBox::ActionRole );

         QPushButton * unlockButton = customMsgBox.addButton( tr( "UnLock" ), QMessageBox::ActionRole );

         QPushButton * cancelButton = customMsgBox.addButton( QMessageBox::Cancel );

 

         customMsgBox.setIconPixmap( QPixmap( ".//Resources//msn.bmp" ) );

         customMsgBox.setText( tr( "This is a custom messagebox!" ) );

         customMsgBox.exec();

 

         if ( customMsgBox.clickedButton == lockButton )

         {

                   //doWhat

         }

 

         if ( customMsgBox.clickedButton == unlockButton )

         {

                   //doWhat

         }

 

         if ( customMsgBox.clickedButton == cancelButton )

         {

                   //doWhat

         }

 

七、QerrorMessage

 

 

 

八、QprintDialog

 

 

 

九、QProgressDialog

       通常在处理长时间任务时需要提供进度条的显示，告诉用户当前任务的进展情况。Qt提供了两种显示进度的方式，一种是QProgressBar，另一种就是QProgressDialog。QProgressBar类提供了一种横向或者纵向显示进度的控件表示方式，用来描述任务的完成情况。QProgressDialog类提供了一种针对慢速过程的进度对话框表示方式，用于描述任务完成的进度情况。标准的QProgressDialog包括一个进度显示条、一个取消按钮以及一个标签。这里主要说QProgressDialog。

       QProgressDialog有几个重要的属性值，决定了进度条对话框何时出现，出现多长时间，分别是minimum、maximum和minimumDuration。其中，minimum和maximum分别表示进度条的最小值和最大值，决定了进度条的变化范围；minimumDuration为进度条对话框出现前的等待时间。系统根据所需要完成的工作量估算一个预计花费时间，若大于设定的等待时间minimumDuration，则出现进度条对话框；否则，不出现。例子如下：

QProgressDialog *progressDialog = new QProgressDialog(this);

              QFont font("ZYSong18030",12);

              progressDialog->setFont(font);             

              progressDialog->setWindowModality(Qt::WindowModal);

 

              progressDialog->setMinimumDuration(5);

              progressDialog->setWindowTitle(tr("Please Wait"));

              progressDialog->setLabelText(tr("Copying..."));

              progressDialog->setCancelButtonText(tr("Cancel"));             

              progressDialog->setRange(0,num);

              progressDialog->show();

 

              for (int i=1; i<num+1; i++)

              {

                     progressDialog->setValue(i);

                     qApp->processEvents();

                     /*此处模拟文件复制过程*/

                     QTest::qWait(1000);          

                     if (progressDialog->wasCanceled())

                            return;

              }            

       此处模拟每一个文件的复制过程，这里通过sleep(1)进行模拟，在实际中使用文件复制过程来替换，进度条的总的步进值为需要复制的文件数目，当复制完一个文件后，步进值增加1，这里需要使用qApp->processEvents();来正常相应事件循环，以确保应用程序不会出现阻塞。

       进度条对话框的使用有两种方法，即模态方式与非模态方式。模态方式较简单方便，但必须使用QApplication::processEvents()来使事件循环保持正常进行状态，从而确保应用不会阻塞。若使用非模态方式，则需要通过QTime来实现定时设置进度条的值。

 

(二)

QFileDialog是Qt中用于文件打开和保存的对话框，相当于Swing里面的JFileChooser。下面打开我们前面使用的工程。我们已经很有先见之明的写好了一个打开的action，还记得前面的代码吗？当时，我们只是弹出了一个消息对话框(这也是一种标准对话框哦~)用于告知这个信号槽已经联通，现在我们要写真正的打开代码了！

 

修改MainWindow的open函数：

 

void MainWindow::open()
{
        QString path = QFileDialog::getOpenFileName( this, tr( "Open Image"), ".", tr( "Image Files(*.jpg *.png)"));
         if(path.length() == 0) {
                QMessageBox::information(NULL, tr( "Path"), tr( "You didn't select any files."));
        } else {
                QMessageBox::information(NULL, tr( "Path"), tr( "You selected ") + path);
        }
}

 

编译之前别忘记include QFileDialog哦！然后运行一下吧！点击打开按钮，就会弹出打开对话框，然后选择文件或者直接点击取消，会有相应的消息提示。

 

QFileDialog提供了很多静态函数，用于获取用户选择的文件。这里我们使用的是getOpenFileName(), 也就是“获取打开文件名”，你也可以查看API找到更多的函数使用。不过，这个函数的参数蛮长的，而且类型都是QString，并不好记。考虑到这种情况，Qt提供了另外的写法：

 

        QFileDialog *fileDialog = new QFileDialog( this);
        fileDialog->setWindowTitle(tr( "Open Image"));
        fileDialog->setDirectory( ".");
        fileDialog->setFilter(tr( "Image Files(*.jpg *.png)"));
         if(fileDialog->exec() == QDialog::Accepted) {
                QString path = fileDialog->selectedFiles()[0];
                QMessageBox::information(NULL, tr( "Path"), tr( "You selected ") + path);
        } else {
                QMessageBox::information(NULL, tr( "Path"), tr( "You didn't select any files."));
        }

 

不过，这两种写法虽然功能差别不大，但是弹出的对话框却并不一样。getOpenFileName()函数在Windows和MacOS X平台上提供的是本地的对话框，而QFileDialog提供的始终是Qt自己绘制的对话框(还记得前面说过，Qt的组件和Swing类似，也是自己绘制的，而不都是调用系统资源API)。

 

为了说明QFileDialog::getOpenFileName()函数的用法，还是先把函数签名放在这里：

 

QString QFileDialog::getOpenFileName (

          QWidget * parent = 0,

          const QString & caption = QString(),

          const QString & dir = QString(),

          const QString & filter = QString(),

          QString * selectedFilter = 0,

          Options options = 0 )

 

第一个参数parent，用于指定父组件。注意，很多Qt组件的构造函数都会有这么一个parent参数，并提供一个默认值0；

 

第二个参数caption，是对话框的标题；

 

第三个参数dir，是对话框显示时默认打开的目录，"." 代表程序运行目录，"/" 代表当前盘符的根目录(Windows，Linux下/就是根目录了)，也可以是平台相关的，比如"C:\\"等；

 

第四个参数filter，是对话框的后缀名过滤器，比如我们使用"Image Files(*.jpg *.png)"就让它只能显示后缀名是jpg或者png的文件。如果需要使用多个过滤器，使用";;"分割，比如"JPEG Files(*.jpg);;PNG Files(*.png)"；

 

第五个参数selectedFilter，是默认选择的过滤器；

 

第六个参数options，是对话框的一些参数设定，比如只显示文件夹等等，它的取值是enum QFileDialog::Option，每个选项可以使用 | 运算组合起来。

 

如果我要想选择多个文件怎么办呢？Qt提供了getOpenFileNames()函数，其返回值是一个QStringList。你可以把它理解成一个只能存放QString的List，也就是STL中的list<string>。

例： QString directory=QFileDialog::getOpenFileName(this,"open this document",QDir::currentPath(),"allFiles(*.*)");

 

好了，我们已经能够选择打开文件了。保存也是类似的，QFileDialog类也提供了保存对话框的函数getSaveFileName，具体使用还是请查阅API。