（13）本源代码定义于头文件 qfiledialog . h ：

#ifndef QFILEDIALOG_H
#define QFILEDIALOG_H#include <QtWidgets/qtwidgetsglobal.h>
#include <QtCore/qdir.h>
#include <QtCore/qstring.h>
#include <QtCore/qurl.h>
#include <QtWidgets/qdialog.h>#include <functional>QT_REQUIRE_CONFIG(filedialog);QT_BEGIN_NAMESPACEclass QModelIndex;
class QItemSelection;
struct QFileDialogArgs;
class QFileDialogPrivate;
class QAbstractFileIconProvider;
class QAbstractItemDelegate;
class QAbstractProxyModel;/*
The QFileDialog class provides a dialog that allow users to select files or directories。Detailed Description  ：
QFileDialog类使用户能够浏览文件系统以选择一个或多个文件或目录。
创建QFileDialog的最简单方法是使用静态函数。fileName = QFileDialog::getOpenFileName(this,tr("Open Image"), "/home/jana", tr("Image Files (*.png *.jpg *.bmp)"));在上述示例中，使用一个静态函数创建了模态对话框 QFileDialog。该对话框最初会显示“/home/iana”目录的内容，并显示与字符串“lmage Files(*.png*jpg*.bmp)”中给出的模式匹配的文件。
文件对话框的父窗口被设置为该对话框，窗口标题被设置为“OpenImage",如果你想使用多个过滤器，请用两个分号 ;; 将它们分开。例如:"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"您可以通过不使用静态函数来创建自己的QFileDialog。
通过调用setFileMode()函数，您可以指定用户在对话框中必须选择的内容:QFileDialog dialog(this);dialog.setFileMode(QFileDialog::AnyFile);在上述示例中，文件对话框的模式被设置为“AnyFile”，这意味着用户可以选择任何文件，甚至指定一个不存在的文件。
这种模式对于创建“另存为”文件对话框非常有用。
如果用户必须选择已存在的文件，应使用“ExistingFile”;
如果只允许选择目录，则应使用“Directory”。有关模式完整列表，请参阅QFileDialog::FileMode枚举。fileMode`属性包含对话框的操作模式;这指示了期望用户选择的对象类型。
使用`setNameFilter()来设置对话框的文件筛选器。例如:dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg)"));在上述示例中，过滤器被设置为“Images(*.png*.xpm *.jpg)”，
这意味着只有扩展名为png、xpm或ipg的文件才会显示在QFileDialog中。
您可以通过调用setNameFilters()来应用多个过滤器。
使用selectNameFilter()来选择您设定的其中一个过滤器作为文件对话框的默认过滤器。文件对话框有两种视图模式:列表和详细。
列表以文件和目录名称的列表形式呈现当前目录的内容。
详细模式也展示文件和目录名称的列表，但会在每个名称旁提供额外信息，如文件大小和修改日期。
使用`setViewMode ()'方法来设置模式:dialog.setViewMode(QFileDialog::Detail);在创建自己的文件对话框时，你需要使用的最后一个重要函数是selectedFiles()。QStringList fileNames;if (dialog.exec())fileNames = dialog.selectedFiles();在上面的例子中，创建并显示了一个模态文件对话框。如果用户点击了确定，则所选的文件将被放入fileName中。可以通过setDirectory()设置对话框的工作目录。可以使用selectFile()函数选择当前目录中的每个文件。标准对话框示例展示了如何使用QFileDialog以及Qt库中的其他内置对话框.
默认情况下，如果平台有相应的原生文件对话框，将使用该原生对话框。
在这种情况下，原本用于构建对话框的控件将不会实例化，因此相关的访问器(如layout()和itemDelegate())将返回null。
您可以通过设置“DontUseNativeDialog”选项来确保使用基于控件的实现而非原生对话框。*/class Q_WIDGETS_EXPORT QFileDialog : public QDialog
{Q_OBJECT//enum ViewMode { Detail, List };//此属性用于控制文件和目录在对话框中显示的方式。//默认情况下，使用详细模式来显示文件和目录的信息。默认使用 Detail 模式。Q_PROPERTY(ViewMode viewMode READ viewMode WRITE setViewMode)//enum FileMode { AnyFile, ExistingFile, Directory, ExistingFiles };//此属性保存对话框的文件模式。文件模式定义了用户在对话框中应选择的项目数量和类型。//默认情况下，此属性设置为AnyFile。//此函数将设置文件名和接受对话框标签。在调用setFileMode()之后，可以设置自定义文本。Q_PROPERTY(FileMode fileMode READ fileMode WRITE setFileMode)//enum AcceptMode { AcceptOpen, AcceptSave };//此属性保存对话框的接受模式。操作模式定义了对话框是用于打开文件还是保存文件。//默认情况下，此属性设置为Acceptopen。Q_PROPERTY(AcceptMode acceptMode READ acceptMode WRITE setAcceptMode)//如果未指定其他后缀，则将后缀添加到文件名中。//该属性指定一个字符串，如果文件名没有后缀，这个字符串将被添加到文件名中。//后缀通常用于表示文件类型(例如，“txt”表示文本文件)。如果第一个字符是点dot ('.')，则将其移除。Q_PROPERTY(QString defaultSuffix READ defaultSuffix WRITE setDefaultSuffix)//此属性包含影响对话框外观和感觉的各种选项。 默认情况下，所有选项都已禁用。//选项(特别是DontUseNativeDialogs选项)应在更改对话框属性或显示对话框之前设置。//在对话框可见时设置选项并不能保证立即对对话框产生影响(这取决于选项和平台)。//在更改其他属性后设置选项可能会导致这些值无效。Q_PROPERTY(Options options READ options WRITE setOptions)//此属性包含文件对话框应允许导航的URL方案。   // scheme 方案[skiːm]；   主题 theme//设置此属性可限制用户能够选择的URL类型。这是应用程序声明其将支持的协议以获取文件内容的一种方式。//空列表表示未施加任何限制(为默认值)。//对于本地文件(“file”方案)的支持是默示的且总是开启的;无需将其包含在限制列表中。Q_PROPERTY(QStringList   supportedSchemesREAD      supportedSchemes   WRITE   setSupportedSchemes)private:Q_DECLARE_PRIVATE(QFileDialog)Q_DISABLE_COPY(QFileDialog)Q_PRIVATE_SLOT(d_func(), void _q_pathChanged(const QString &))Q_PRIVATE_SLOT(d_func(), void _q_navigateBackward())Q_PRIVATE_SLOT(d_func(), void _q_navigateForward())Q_PRIVATE_SLOT(d_func(), void _q_navigateToParent())Q_PRIVATE_SLOT(d_func(), void _q_createDirectory())Q_PRIVATE_SLOT(d_func(), void _q_showListView())Q_PRIVATE_SLOT(d_func(), void _q_showDetailsView())Q_PRIVATE_SLOT(d_func(), void _q_showContextMenu(const QPoint &))Q_PRIVATE_SLOT(d_func(), void _q_renameCurrent())Q_PRIVATE_SLOT(d_func(), void _q_deleteCurrent())Q_PRIVATE_SLOT(d_func(), void _q_showHidden())Q_PRIVATE_SLOT(d_func(), void _q_updateOkButton())Q_PRIVATE_SLOT(d_func(), void _q_currentChanged(const QModelIndex &index))Q_PRIVATE_SLOT(d_func(), void _q_enterDirectory(const QModelIndex &index))Q_PRIVATE_SLOT(d_func(), void _q_emitUrlSelected(const QUrl &))Q_PRIVATE_SLOT(d_func(), void _q_emitUrlsSelected(const QList<QUrl> &))Q_PRIVATE_SLOT(d_func(), void _q_nativeCurrentChanged(const QUrl &))Q_PRIVATE_SLOT(d_func(), void _q_nativeEnterDirectory(const QUrl&))Q_PRIVATE_SLOT(d_func(), void _q_goToDirectory(const QString &path))Q_PRIVATE_SLOT(d_func(), void _q_useNameFilter(int index))Q_PRIVATE_SLOT(d_func(), void _q_selectionChanged())Q_PRIVATE_SLOT(d_func(), void _q_goToUrl(const QUrl &url))Q_PRIVATE_SLOT(d_func(), void _q_goHome())Q_PRIVATE_SLOT(d_func(), void _q_showHeader(QAction *))Q_PRIVATE_SLOT(d_func(), void _q_autoCompleteFileName(const QString &text))Q_PRIVATE_SLOT(d_func(), void _q_rowsInserted(const QModelIndex & parent))Q_PRIVATE_SLOT(d_func(), void _q_fileRenamed(const QString &path,const QString &oldName,const QString &newName))friend class QPlatformDialogHelper;protected:QFileDialog(const QFileDialogArgs & args);void done       (int result) override; //这是重写了基类 QDialog 里的槽函数void accept     ()           override;void changeEvent(QEvent * e) override; //重写了基类里的事件public:enum DialogLabel { LookIn, FileName, FileType, Accept, Reject };//Constructs a file dialog with the given parent and widget flags.QFileDialog(QWidget * parent, Qt::WindowFlags flags);explicitQFileDialog(QWidget * parent    = nullptr  ,  const QString & caption = QString(),const   QString & directory = QString(),  const QString & filter  = QString());//Constructs a file dialog with the given parent and//  caption that initially displays the contents of the specified directory.//The contents of the directory are filtered before being shown in the dialog,//  using a semicolon-separated半角分隔符 list of filters specified by filter.~QFileDialog();enum ViewMode { Detail, List };Q_ENUM(ViewMode)
//  //此属性用于控制文件和目录在对话框中显示的方式。默认使用 Detail 模式。
//   Q_PROPERTY(ViewMode      viewMode
//              READ          viewMode      WRITE     setViewMode)ViewMode      viewMode() const;void       setViewMode(ViewMode mode);enum FileMode { AnyFile, ExistingFile, Directory, ExistingFiles };Q_ENUM(FileMode)
//  //此属性保存对话框的文件模式。文件模式定义了用户在对话框中应选择的项目数量和类型。
//  //默认情况下，此属性设置为AnyFile。
//   Q_PROPERTY(FileMode      fileMode
//              READ          fileMode      WRITE     setFileMode)FileMode      fileMode() const;void       setFileMode(FileMode mode);enum AcceptMode { AcceptOpen, AcceptSave };Q_ENUM(AcceptMode)
//  //此属性保存对话框的接受模式。操作模式定义了对话框是用于打开文件还是保存文件。
//  //默认情况下，此属性设置为Acceptopen。
//   Q_PROPERTY(AcceptMode    acceptMode
//              READ          acceptMode    WRITE     setAcceptMode)AcceptMode    acceptMode() const;void       setAcceptMode(AcceptMode mode);//  //如果未指定其他后缀，则将后缀添加到文件名中。如果第一个字符是点dot ('.')，则将其移除。
//   Q_PROPERTY(QString       defaultSuffix
//              READ          defaultSuffix   WRITE   setDefaultSuffix)QString       defaultSuffix() const;void       setDefaultSuffix(const QString & suffix);// keep this in sync with QFileDialogOption::FileDialogOptionsenum Option{   ShowDirsOnly                = 0x00000001,//仅在文件对话框中显示目录。默认情况下，会同时显示文件和目录。(仅在目录模式下有效。)DontResolveSymlinks         = 0x00000002,//不要在文件对话框中解析符号链接。默认情况下，符号链接会被解析。DontConfirmOverwrite        = 0x00000004, //要求确认有写操作//如果选择了现有文件，则不要求确认。默认情况下会请求确认//Note: This opption is not supported on macOS when using the native file dialog.DontUseNativeDialog         = 0x00000008,//请勿使用默认的本机文件对话框。除非您使用了包含QOBJECT宏的 QFileDialog子类，//或者该平台没有您所需类型的本机对话框，否则将使用默认的本机文件对话框。//Note: This option must be set before changing dialog properties or showing the dialog.ReadOnly                    = 0x00000010, //表示模型是只读的。HideNameFilterDetails       = 0x00000020,//指示文件名过滤器详细信息是否被隐藏。DontUseCustomDirectoryIcons = 0x00000040//请始终使用默认目录图标。某些平台允许用户设置不同的图标。此枚举值是在Qt 5.2中添加的。//自定义图标查找在网络或可移动驱动器上会产生显著的性能影响。//设置此选项将启用图标提供程序中的“QFileIconProvider::DontUseCustomDirectoryIcons”选项。};Q_ENUM(Option)Q_DECLARE_FLAGS(Options, Option) // Options = QFlags<Option>Q_FLAG(Options)
//  //此属性包含影响对话框外观和感觉的各种选项。 默认情况下，所有选项都已禁用。
//   Q_PROPERTY(Options       options
//              READ          options       WRITE     setOptions)Options       options() const;void       setOption (Option option, bool on = true);void       setOptions(Options options);bool      testOption (Option option) const;//  //此属性包含文件对话框应允许导航的URL方案。空列表表示未施加任何限制(为默认值)。
//  //对于本地文件(“file”方案)的支持是默示的且总是开启的;无需将其包含在限制列表中。
//   Q_PROPERTY(QStringList      supportedSchemes
//              READ             supportedSchemes      WRITE      setSupportedSchemes)QStringList      supportedSchemes() const;void          setSupportedSchemes(const QStringList & schemes);using   QDialog::open;void             open(QObject * receiver, const char * member);void       setVisible(bool visible) override;QDir        directory() const;void     setDirectory(const QString &directory);inlinevoid     setDirectory(const QDir &directory);{ setDirectory(directory.absolutePath()); }QUrl        directoryUrl() const;void     setDirectoryUrl(const QUrl & directory);void        selectFile   (const QString & filename);QStringList selectedFiles() const;void        selectUrl   (const QUrl &url);QList<QUrl> selectedUrls() const;QDir::Filters           filter() const;void                 setFilter(QDir::Filters filters);QStringList         nameFilters() const;void          selectNameFilter (const QString     & filter );QString     selectedNameFilter () const;void             setNameFilter (const QString     & filter );void             setNameFilters(const QStringList & filters);QStringList         mimeTypeFilters() const;void          selectMimeTypeFilter (const QString     & filter );QString     selectedMimeTypeFilter () const;void             setMimeTypeFilters(const QStringList & filters);QList<QUrl>         sidebarUrls() const;void             setSidebarUrls(const QList<QUrl> & urls);QByteArray          saveState() const;bool             restoreState(const QByteArray & state);QStringList         history() const;void             setHistory(const QStringList & paths);QAbstractItemDelegate *     itemDelegate() const;void                     setItemDelegate(QAbstractItemDelegate     * delegate);QAbstractFileIconProvider * iconProvider() const;void                     setIconProvider(QAbstractFileIconProvider * provider);QString             labelText(DialogLabel label) const;void             setLabelText(DialogLabel label, const QString & text);QAbstractProxyModel       * proxyModel() const;void                     setProxyModel(QAbstractProxyModel * model);Q_SIGNALS:void   fileSelected(const QString     & file );void  filesSelected(const QStringList & files);void    urlSelected(const QUrl        & url  );void   urlsSelected(const QList<QUrl> & urls);void filterSelected(const QString     & filter);void    currentChanged(const QString  & path);void currentUrlChanged(const QUrl     & url);void    directoryEntered(const QString   & directory);void directoryUrlEntered(const QUrl      & directory);public:/*//这是一个方便的静态函数，返回用户选择的现有文件。如果用户按下取消，则返回空字符串。//该函数使用给定的父控件 parent创建一个模态文件对话框。//如果父控件不为空，则对话框将居中显示在父控件上方.//文件对话框的工作目录将设置为 dir。如果 dir 中包含文件名，则该文件将被选中。//仅显示与给定筛选器 filter匹配的文件，选定的筛选器将设置为 selectedFilter。//参数 dir、filter和 selectedFilter可以是为空的字符串。//如果您想要多个筛选器，可以使用俩分号';;'分隔开来，例如://  "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"//参数 options包含了关于如何运行对话框的各种选项， Options = QFlags<Option>//请参阅 QFileDialog::Option 枚举以获取有关可传递标志的更多信息。//对话框的标题设置为caption。如果未指定标题，则将使用默认标题。//在Windows和macOS上，此静态函数将使用原生文件对话框而不是QFileDialog。//在Windows上，该对话框将启动一个阻塞的模态事件循环，不会派发任何QTimer，//  并且如果父对象不是 nullptr，则会将对话框定位在父对象的标题栏下方。//在Unix/X11上，文件对话框的正常行为是解析并遵循符号链接。例如，//如果/usr/tmp是到/var/tmp的符号链接,那么在输入/usr/tmp后，文件对话框将切换到/var/tmp。//如果选项 options包括“不解析符号链接”，则文件对话框会将符号链接视为普通目录。//警告:在对话框执行过程中请勿删除父窗体 parent。//如果您想这么做，应使用 QFileDialog构造函数之一自行创建对话框。*/static QString     getOpenFileName (QWidget     * parent           = nullptr  ,const   QString     & caption          = QString(),const   QString     & dir              = QString(),const   QString     & filter           = QString(),QString     * selectedFilter   = nullptr  ,Options       options          = Options() );static QUrl        getOpenFileUrl  (QWidget     * parent           = nullptr      ,const   QString     & caption          = QString    (),const   QUrl        & dir              = QUrl       (),const   QString     & filter           = QString    (),QString     * selectedFilter   = nullptr      ,Options       options          = Options    (),const   QStringList & supportedSchemes = QStringList()  );/*这是一个方便的静态函数，返回用户选择的现有文件。如果用户按下取消，则返回一个空URL。该函数的使用方式与 QFileDialog::getOpenFileName()类似。具体而言，parent、caption、dir、filterselectedFilter和 options 的使用方法完全相同。与QFileDialog:getOpenFileName ()的主要区别在于它为用户提供了选择远程文件的能力。正因如此，返回类型和dir的类型被设定为QUrl。supportedSchemes`参数允许限制用户能够选择的URL类型。这是应用程序声明其将支持的协议以获取文件内容的一种方式。空列表表示没有施加任何限制(默认为如此)。对于本地文件(“file”方案)的支持是默认且始终开启的;无需将其包含在限制列表中。在可能的情况下，这个静态函数将使用原生文件对话框而非QFileDialog。在不支持选择远程文件的平台上，Qt将仅允许选择本地文件。*//*这是一个方便的静态函数，将返回用户选择的一个或多个现有文件。该函数使用给定的父控件 parent创建一个模态文件对话框。如果父控件不为空，则对话框将居中显示在父控件上方。文件对话框的工作目录将设置为 dir。如果 dir 中包含文件名，则该文件将被选中。过滤器被设置为 filter，这样只有与过滤器匹配的文件才会显示。被选定的过滤器被设置为selectedfilter。dir、selectedFilter和filter 这些参数可以是空字符串。如果您需要多个过滤器，可以使用“;;”将它们分隔开，例如:"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"对话框的标题设置为caption。如果未指定标题，则将使用默认标题。在Windows和macOS上，此静态函数将使用原生文件对话框而不是QFileDialog。*/static QStringList getOpenFileNames(QWidget     * parent           = nullptr,const   QString     & caption          = QString(),const   QString     & dir              = QString(),const   QString     & filter           = QString(),QString     * selectedFilter   = nullptr,Options       options          = Options() );static QList<QUrl> getOpenFileUrls (QWidget     * parent           = nullptr  ,const   QString     & caption          = QString(),const   QUrl        & dir              = QUrl   (),const   QString     & filter           = QString(),QString     * selectedFilter   = nullptr  ,Options       options          = Options(),const   QStringList & supportedSchemes = QStringList());/*这是一个方便的自定义静态函数，将返回由用户选定的一个或多个现有文件。如果用户按下“取消”按钮,则返回一个空列表。该函数的使用方式与QFileDialog::getOpenFileNames()类似。特别是，parent、caption、dir、filter、selectedFilter和options的使用方式完全相同。与`QFileDialog::getOpenfileNames ()、的主要区别在于它为用户提供了选择远程文件的能力。这就是为什么返回类型和`dir`类型分别是`QList<QUrl>`和`QUrL`的原因。supportedSchemes`参数允许限制用户能够选择的URL类型。这是应用程序声明其将支持的协议以获取文件内容的一种方式。空列表表示没有施加任何限制(默认为如此)。对于本地文件(“file”方案)的支持是默认且始终开启的;无需将其包含在限制列表中。在可能的情况下，这个静态函数将使用原生文件对话框而非QFileDialog。在不支持选择远程文件的平台上，Qt将仅允许选择本地文件。*//*//这是一个方便的静态函数，将返回用户选择的文件名。该文件不必存在。//它会创建一个与给定父窗口 parent关联的模态文件对话框。//如果父窗口不为空指针，则对话框将显示在父窗口正中央。//getSaveFileName(this, tr("Save File"), "/home/aa.png", tr("Images (*.png *.jpg)"));//文件对话框的工作目录将设置为 dir。如果 dir 中包含文件名，则该文件将被选中。//仅显示与筛选器匹配的文件。选定的筛选器将设置为 selectedFilter。//dir、selectedFilter和 filter 参数可以设置为空字符串。多个筛选器之间用“;;”分隔。例如:// "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"//options参数包含了关于如何运行对话框的各种选项，//  请参阅 QFileDialog:.Option 枚举以获取有关可传递标志的更多信息。//可以通过将selectedFilter设置为所需值来选择默认过滤器。//对话框的标题设置为 caption。如果未指定标题，则将使用默认标题。//在Windows和macOS上，此静态函数将使用原生文件对话框而不是QFileDialog。//在Windows上，该对话框将启动一个阻塞的模态事件循环，不会派发任何QTimer，//而如果父对象不是nulptr，那么它会将对话框定位在父对象标题栏的下方。//在macOs上，由于其内置的文件对话框，过滤参数将被忽略。//在Unix/X11上，文件对话框的正常行为是解析并遵循符号链接。例如，//如果/usr/tmp是到/var/tmp的符号链接那么在输入/usr/tmp后，文件对话框将切换到/var/tmp。//如果选项包括“不解析符号链接”，则文件对话框会将夺号链接视为普通目录。//警告:在对话框执行过程中请勿删除父控件 parent。//如果您想这么做，应使用QFileDialog构造函数之-自行创建对话框。*/static QString     getSaveFileName (QWidget     * parent           = nullptr  ,const   QString     & caption          = QString(),const   QString     & dir              = QString(),const   QString     & filter           = QString(),QString     * selectedFilter   = nullptr  ,Options       options          = Options());static QUrl        getSaveFileUrl  (QWidget     * parent           = nullptr  ,const   QString     & caption          = QString(),const   QUrl        & dir              = QUrl   (),const   QString     & filter           = QString(),QString     * selectedFilter   = nullptr  ,Options       options          = Options(),const   QStringList & supportedSchemes = QStringList()  );/*这是一个方便的自定义静态函数，用于返回用户选择的一个文件。该文件不一定非得存在。如果用户按下取消”按钮，函数将返回一个空URL。该函数的使用方式与QFileDialog::getSaveFileName ()类似。具体而言，parent、caption、dir、filter、selectedFilter和options的使用方式完全相同。与`QFileDialog::getSaveFileName()、的主要区别在于它为用户提供了选择远程文件的能力。正因如此，返回类型和`dir`的类型被设定为`QUrl`。参数允许限制用户能够选择的URL类型。这是应用程序声明其将支持的协supportedSchemes议以保存文件内容的一种方式。空列表表示没有施加任何限制(默认为如此)。对于本地文件(“file”方案)的支持是默认且始终开启的;无需将其包含在限制列表中。在可能的情况下，这个静态函数将使用原生文件对话框而非QFileDialog。在不支持选择远程文件的平台上，Qt将仅允许选择本地文件。*//*这是一个方便的静态函数，将返回用户选择的现有目录。该函数使用给定的父控件 parent创建一个模态文件对话框。如果父控件不为空，则对话框将居中显示在父控件上方。该对话框的工作目录被设置为 dir，标题被设置为 caption。两者均可为空字符串，此时将分别使用当前目录和默认标题。options参数包含了关于如何运行对话框的各种选项，有关您可以传递的标记的详细信息，请参见QFileDialog::Option 枚举。为确保使用原生文件对话框，必须设置 ShowDirsOnly。在Windows和macOs上，这个静态函数将使用原生文件对话框而非OFileDialog。然而，原生的Windows文件对话框并不支持在目录选择器中显示文件。您需要传递DontUseNativeDialog参数，以便使用QFileDialog来显示文件。在Unix/X11上，文件对话框的正常行为是解析并遵循符号链接。例如，如果/usr/tmp是一个指向/var/tmp的符号涟接，那么在输入/usr/tmp后，文件对话框将切换至/ar/tmp。如果使用选项中的“Don't Resolve Symlinks,则文件对话框会将符号链接视为普通目录。在Windows上，该对话框将启动一个阻塞的模态事件循环，不会派发任何QTimer，并且如果父对象不是nullptr，则会将对话框定位在父对象的标题栏下方。警告:在对话框执行过程中请勿删除父对话框。如果您想这么做，应使用QFileDialog构造函数之一自行创建对话框。*/static QString      getExistingDirectory   (QWidget * parent       = nullptr  ,const   QString     & caption          = QString(),const   QString     & dir              = QString(),Options       options          = ShowDirsOnly );static QUrl         getExistingDirectoryUrl(QWidget * parent       = nullptr  ,const   QString     & caption          = QString(),const   QUrl        & dir              = QUrl()   ,Options       options          = ShowDirsOnly,const   QStringList & supportedSchemes = QStringList());/*这是一个方便的自定义静态函数，将返回由用户选择的现有目录。如果用户按下“取消”按钮，则返回一个空URL.该函数的使用方式类似于QFileDialog:getExistingDirectory()。特别是，parent、caption、dir和options在使用时完全相司。与`QFileDialog:getExistingDirectory()、的主要区别在于它为用户提供了选择远程目录的能力。这就是为什么返回类型和`dir'的类型是`QUrL'的原因。supportedSchemes`参数允许限制用户能够选择的URL类型。这是应用程序声明其将支持的协议以获取文件内容的一种方式。空列表表示没有施加任何限制(默认为如此)。对于本地文件(“file”方案)的支持是默认且始终开启的;无需将其包含在限制列表中。在可能的情况下，这个静态函数将使用原生文件对话框而非QFileDialog。在不支持选择远程文件的平台上，Qt将仅允许选择本地文件。此函数在Qt 5.2中引入。*//*这是一个方便的静态函数，将返回用户选择的文件内容。该函数用于在Qt for WebAssembly中访问本地文件，而Web沙箱会对此类访问可能发生的途径施加限制。其实现方式将使得浏览器显示一个原生文件对话框，用户可根据参数 nameFilter“进行文件选择。它也可以在其他平台上使用，当无法访问本地文件时，它将回退到使用QFileDialog。该函数是异步的，且会立即返回。当文件被选择且其内容被读取到内存中时，将调用“fileContentsReady”回调函数。auto fileContentReady = [](const QString & fileName, const QByteArray & fileContent) {if (fileName.isEmpty()) {// No file was selected                   //这是个范例} else {// Use fileName and fileContent}};QFileDialog::getOpenFileContent("Images (*.png *.xpm *.jpg)",  fileContentReady);*/static void        getOpenFileContent(const QString    & nameFilter ,const  std::function<void(  const QString    & fileName,const QByteArray & fileContent )> & fileContentsReady);static void           saveFileContent(const QByteArray & fileContent,const QString   &  fileNameHint = QString());/*这是一个便利的静态函数，用于将文件内容 fileContent保存到文件中，使用由用户选择的文件名和位置。可以提供文件名提示 fileNameHint，以向用户建议一个文件名。该函数用于将文件保存到Qtfor WebAssembly的本地文件系统中，而Web沙箱会对此类访问可能发生的途径施加限制。其实现方式将使得浏览器显示一个原生文件对话框，用户可以在其中进行文件选择。它也可以在其他平台上使用，当无法访问本地文件系统时，它将回退到使用QFileDialog。该函数是异步的，并立即返回。QByteArray imageData; // obtained from e.g. QImage::save()QFileDialog::saveFile("myimage.png", imageData);*/}; //完结 class QFileDialog : public QDialogQ_DECLARE_OPERATORS_FOR_FLAGS(QFileDialog::Options)QT_END_NAMESPACE#endif // QFILEDIALOG_H

（14）

谢谢