qfiledialog文件过滤_QFileDialog类 - Qt 参考中文帮助文档

QFileDialog类提供了允许用户选择文件或者目录的对话框。

详情请见……

#include

继承了QDialog。

所有成员函数的列表。

公有成员

QFileDialog ( constQString&dirName, constQString&filter = QString::null, QWidget*parent = 0, constchar*name = 0, boolmodal = FALSE )

QFileDialog ( QWidget*parent = 0, constchar*name = 0, boolmodal = FALSE )

~QFileDialog ()

QString selectedFile () const

QString selectedFilter () const

virtual void setSelectedFilter ( constQString&mask )

virtual void setSelectedFilter ( intn )

void setSelection ( constQString&filename )

void selectAll ( boolb )

QStringList selectedFiles () const

QString dirPath () const

void setDir ( constQDir&dir )

const QDir * dir () const

void setShowHiddenFiles ( bools )

bool showHiddenFiles () const

void rereadDir ()

void resortDir ()

enum Mode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly }

void setMode ( Mode )

Mode mode () const

enum ViewMode { Detail, List }

enum PreviewMode { NoPreview, Contents, Info }

void setViewMode ( ViewModem )

ViewMode viewMode () const

void setPreviewMode ( PreviewModem )

PreviewMode previewMode () const

bool isInfoPreviewEnabled () const

bool isContentsPreviewEnabled () const

void setInfoPreviewEnabled ( bool )

void setContentsPreviewEnabled ( bool )

void setInfoPreview ( QWidget*w, QFilePreview*preview )

void setContentsPreview ( QWidget*w, QFilePreview*preview )

QUrl url () const

void addFilter ( constQString&filter )

公有槽

void setDir ( constQString&pathstr )

void setUrl ( constQUrlOperator&url )

void setFilter ( constQString&newFilter )

void setFilters ( constQString&filters )

void setFilters ( constchar**types )

void setFilters ( const QStringList & )

信号

void fileHighlighted ( const QString & )

void fileSelected ( const QString & )

void filesSelected ( const QStringList & )

void dirEntered ( const QString & )

void filterSelected ( const QString & )

静态公有函数

QString getOpenFileName ( constQString&startWith = QString::null, constQString&filter = QString::null, QWidget*parent = 0, constchar*name = 0, constQString&caption = QString::null, QString*selectedFilter = 0, boolresolveSymlinks = TRUE )

QString getSaveFileName ( constQString&startWith = QString::null, constQString&filter = QString::null, QWidget*parent = 0, constchar*name = 0, constQString&caption = QString::null, QString*selectedFilter = 0, boolresolveSymlinks = TRUE )

QString getExistingDirectory ( constQString&dir = QString::null, QWidget*parent = 0, constchar*name = 0, constQString&caption = QString::null, booldirOnly = TRUE, boolresolveSymlinks = TRUE )

QStringList getOpenFileNames ( constQString&filter = QString::null, constQString&dir = QString::null, QWidget*parent = 0, constchar*name = 0, constQString&caption = QString::null, QString*selectedFilter = 0, boolresolveSymlinks = TRUE )

void setIconProvider ( QFileIconProvider*provider )

QFileIconProvider * iconProvider ()

属性

bool contentsPreview– 文件对话框是否提供当前选择文件的内容预览

QString dirPath– 文件对话框的工作目录(只读)

bool infoPreview– 文件对话框是否提供当前选择文件的信息预览

Mode mode– 文件对话框的模式

PreviewMode previewMode– 文件的对话框的预览模式

QString selectedFile– 选择的文件的名称(只读)

QStringList selectedFiles– 选择的文件的列表(只读)

QString selectedFilter– 文件对话框中用户选择文件的过滤器(只读)

bool showHiddenFiles– 文件对话框中隐藏文件是否显示

ViewMode viewMode– 文件对话框的视图模式

保护成员

void addWidgets ( QLabel*l, QWidget*w, QPushButton*b )

void addToolButton ( QButton*b, boolseparator = FALSE )

void addLeftWidget ( QWidget*w )

void addRightWidget ( QWidget*w )

详细描述

QFileDialog类提供了允许用户选择文件或者目录的对话框。

QFileDialog类允许用户在它们的文件系统上遍历来选择一个或多个文件或目录。

最简单的方式是使用静态函数来创建一个QFileDialog。在Windows上，这些静态函数将调用本地Windows文件对话框并且在Mac OS X上，这些静态函数将调用本地Mac OS X文件对话框。

QString s = QFileDialog::getOpenFileName(

"/home",

"Images (*.png *.xpm *.jpg)",

this,

"open file dialog"

"Choose a file" );

在上面的实例中，一个模式对话框被使用静态函数来创建。开始目录被设置为“/home”。文件过滤器被设置为“Images (*.png *.xpm *.jpg)”。文件对话框的父对象被设置为this并且它被给定一个标识名称——“open file dialog”。文件对话框上面的标题被设置为“Choose a file”。

你可以不使用静态函数创建你自己的QFileDialog。通过调用setMode()，你可以设置可以从QFileDialog返回什么。

QFileDialog* fd = new QFileDialog( this, "file dialog", TRUE );

fd->setMode( QFileDialog::AnyFile );

在上面的实例中，文件对话框的模式被设置为AnyFile，也就是说用户可以设置任何文件或者甚至指定一个不存在的文件。这个模式对于创建一个“File Save As”文件对话框。如果用户必须选择存在的文件，请使用ExistingFile，或者如果可以选择目录，请使用Directory。(模式的完整列表请参考QFileDialog::Mode枚举变量。)

你可以通过mode()重新得到对话框的模式。也可以使用setFilter()来设置对话框的文件过滤器。

fd->setFilter( "