QFileDialog 类

成员函数文档

QFileDialog::QFileDialog(QWidget *parent, Qt::WindowFlags flags)

使用指定的 parent 和控件 flags 构造文件对话框。

[显式] QFileDialog::QFileDialog(QWidget *parent = nullptr, const QString &caption = QString(), const QString &directory = QString(), const QString &filter = QString())

使用指定的 parent 和 caption 构造文件对话框，并最初显示指定 directory 的内容。目录的内容将通过一个由 filter 指定的分号分隔的过滤器列表进行过滤，然后再显示在对话框中。

[虚拟 noexcept] QFileDialog::~QFileDialog()

销毁文件对话框。

[覆盖虚拟受保护] void QFileDialog::accept()

重新实现: QDialog::accept.

[覆盖虚拟受保护] void QFileDialog::changeEvent(QEvent *e)

重新实现: QWidget::changeEvent(QEvent *event).

[信号] void QFileDialog::currentChanged(const QString &path)

当地当前文件更改时，此信号会发出新的文件名作为 path 参数。

另请参阅filesSelected.

[信号] void QFileDialog::currentUrlChanged(const QUrl &url)

当地当前文件更改时，此信号会发出新的文件 URL 作为 url 参数。

另请参阅urlsSelected.

QDir QFileDialog::directory() const

返回对话框中目前显示的目录。

另请参阅setDirectory.

[信号] void QFileDialog::directoryEntered(const QString &directory)

在本地操作中，当用户输入 directory 时，会发出此信号。

QUrl QFileDialog::directoryUrl() const

返回对话框中目前显示的目录的 URL。

另请参阅setDirectoryUrl.

[信号] void QFileDialog::directoryUrlEntered(const QUrl &directory)

当用户输入一个目录时，会发出此信号。

[重写虚保护] void QFileDialog::done(int result)

重实现： QDialog::done(int r)。

[信号] void QFileDialog::fileSelected(const QString &file)

当选择改变且对话框被接受时，此信号会发出所选择的（可能为空）文件。

也见： currentChanged() 以及 QDialog::Accepted。

[信号] void QFileDialog::filesSelected(const QStringList &selected)

当选择改变且对话框被接受时，此信号会发出所选择的（可能为空）文件列表。

也见： currentChanged() 以及 QDialog::Accepted。

QDir::Filters QFileDialog::filter() const

返回用于显示文件时使用的过滤器。

也见： setFilter。

[信号] void QFileDialog::filterSelected(const QString &filter)

当用户选择一个过滤器时，会发出此信号。

[静态] QString QFileDialog::getExistingDirectory(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), QFileDialog::Options options = ShowDirsOnly)

这是一个便利的静态函数，它返回用户选择的现有目录。

QString dir = QFileDialog::getExistingDirectory(this, tr("Open Directory"),
                                                "/home",
                                                QFileDialog::ShowDirsOnly
                                                | QFileDialog::DontResolveSymlinks);

此函数创建了一个具有给定 parent 小部件的模态文件对话框。如果 parent 不是 nullptr，则对话框会在其父窗口上居中显示。

对话框的工作目录设置为 dir，标题设置为 caption。这两者都可以是空字符串，此时分别使用当前目录和默认标题。

options 参数保存有关如何运行对话框的各种选项。有关可以传递的标志的更多信息，请参阅 QFileDialog::Option 枚举。要确保原生文件对话框，必须设置 ShowDirsOnly。

在 Windows 和 macOS 上，此静态函数使用原生文件对话框而不是 QFileDialog。然而，原生的 Windows 文件对话框不支持在目录选择器中显示文件。您需要传递 DontUseNativeDialog 选项，或将全局 Qt::AA_DontUseNativeDialogs 应用程序属性设置为使用 QFileDialog 显示文件。

请注意，macOS原生的文件对话框不会显示标题栏。

在Unix/X11上，文件对话框的正常行为是解析和跟随符号链接。例如，如果/usr/tmp是一个指向/var/tmp的符号链接，当输入/usr/tmp后，文件对话框将切换到/var/tmp。如果options包含DontResolveSymlinks，则文件对话框将把符号链接当作普通目录处理。

在Windows上，对话框会旋转一个阻塞的模态事件循环，不调度任何QTimers，如果parent不是nullptr，则将对话框定位在父窗口标题栏下方。

另请参阅getOpenFileName（），getOpenFileNames（）和getSaveFileName（）。

[静态] QUrl QFileDialog::getExistingDirectoryUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), QFileDialog::Options options = ShowDirsOnly, const QStringList &supportedSchemes = QStringList())

这是一个便利的静态函数，它返回用户选择的现有目录。如果用户按下取消，则返回一个空url。

该函数的使用方式与QFileDialog::getExistingDirectory相同。特别是parent，caption，dir和options的用法完全相同。

与QFileDialog::getExistingDirectory()相比，主要区别在于用户选择远程目录的能力。这就是为什么返回类型和dir的类型是QUrl的原因。

supportedSchemes参数允许限制用户能够选择的URL的类型。这是应用程序声明支持获取文件内容协议的一种方式。空列表表示不应用任何限制（默认值）。对本地文件（"file"方案）的支持是隐含的，并始终启用；不需要包含它在内的限制。

如果可能，此静态函数会使用原生文件对话框而不是QFileDialog。在不支持选择远程文件的平台，Qt允许选择仅本地文件。

另请参阅getExistingDirectory（），getOpenFileUrl（），getOpenFileUrls（）和getSaveFileUrl（）。

[静态] void QFileDialog::getOpenFileContent(const QString &nameFilter, const std::function<void (const QString &, const QByteArray &)> &fileOpenCompleted, QWidget *parent = nullptr)

这是一个便利的静态函数，它返回用户选择的文件的内容。

使用此函数来访问Qt for WebAssembly上的本地文件，如果Web沙箱限制了文件访问。其实现在浏览器中显示原生文件对话框，用户根据nameFilter参数选择文件。

父在WebAssembly版本的Qt中会被忽略。在其他平台上传递父参数，以便使弹出窗口成为另一个小部件的孩子。如果平台不支持原生文件对话框，则函数会回退到QFileDialog。

该函数是异步的，会立即返回。当文件被选中并将文件内容读取到内存中时，将调用fileOpenCompleted回调。

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

[静态] QString QFileDialog::getOpenFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QFileDialog::Options options = Options())

这是一个方便的静态函数，它返回用户选择的现有文件。如果用户点击取消，则返回空字符串。

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"),
                                                "/home",
                                                tr("Images (*.png *.xpm *.jpg)"));

该函数创建一个具有指定父小部件的模式文件对话框。如果父不为nullptr，则对话框显示在父小部件的中心。

文件对话框的工作目录设置为dir。如果dir中包含文件名，则选择该文件。只显示与给定filter匹配的文件。选择的过滤器设置为selectedFilter。参数dir、selectedFilter和filter可以是空字符串。如果您需要多个过滤器，请用';;'分隔，例如

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

参数options包含有关如何运行对话框的各种选项。有关可以传递的标志的更多信息，请参阅QFileDialog::Option枚举。

对话框的标题设置为caption。如果没有指定caption，则将使用默认标题。

在Windows和macOS上，这个静态函数使用原生文件对话框而不是QFileDialog。请注意，macOS的原生文件对话框不显示标题栏。

在Windows上，对话框会阻塞模式事件循环以阻塞任何QTimers，并且如果parent不为nullptr，则对话框将位于父小部件的标题栏下方。

在Unix/X11上，文件对话框的正常行为是解析和跟随符号链接。例如，如果/usr/tmp是一个指向/var/tmp的符号链接，当输入/usr/tmp后，文件对话框将切换到/var/tmp。如果options包含DontResolveSymlinks，则文件对话框将把符号链接当作普通目录处理。

另请参阅getOpenFileNames()、getSaveFileName()和getExistingDirectory。

[静态] QStringList QFileDialog::getOpenFileNames(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QFileDialog::Options options = Options())

这是一个方便的静态函数，它返回用户选择的任意一个或多个现有文件。

QStringList files = QFileDialog::getOpenFileNames(
                        this,
                        "Select one or more files to open",
                        "/home",
                        "Images (*.png *.xpm *.jpg)");

此函数创建了一个具有给定 parent 小部件的模态文件对话框。如果 parent 不是 nullptr，则对话框会在其父窗口上居中显示。

文件对话框的工作目录设置为dir。如果dir中包含文件名，则选择该文件。设置为filter的过滤器，因此仅显示与过滤器匹配的文件。选择的过滤器设置为selectedFilter。参数dir、selectedFilter和filter可以是空字符串。如果您需要多个过滤器，请用';;'分隔，例如

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

对话框的标题设置为 caption。如果未指定 caption，则使用默认标题。

在 Windows 和 macOS 上，此静态函数使用原生文件对话框，而不是 QFileDialog。请注意，macOS 的原生文件对话框不显示标题栏。

在Windows上，对话框会阻塞模式事件循环以阻塞任何QTimers，并且如果parent不为nullptr，则对话框将位于父小部件的标题栏下方。

在 Unix/X11 上，文件对话框的正常行为是解析并跟进符号链接。例如，如果 /usr/tmp 是 /var/tmp 的符号链接，则在输入 /usr/tmp 后，文件对话框将切换到 /var/tmp。options 参数包含运行对话框的各种选项，有关可以传递的标志信息，请参阅 QFileDialog::Option 枚举。

另请参阅 getOpenFileName()，getSaveFileName() 及 getExistingDirectory()。

[静态] QUrl QFileDialog::getOpenFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

这是一个方便的静态函数，它返回用户选择的现有文件。如果用户按下取消按钮，它将返回一个空的 URL。

此函数的用法与 QFileDialog::getOpenFileName 类似。特别是 parent、caption、dir、filter、selectedFilter 和 options 的使用方式完全相同。

与 QFileDialog::getOpenFileName() 的主要区别在于提供给用户的选远程文件的能力。这就是为什么返回类型和 dir 的类型都是 QUrl。

supportedSchemes 参数允许限制用户可以选择的 URL 类型。这是应用程序声明将支持以获取文件内容协议的一种方式。空列表表示不应用限制（默认值）。对于本地文件（“file”方案）的支持是隐式的，始终启用；不需要将其包含在限制中。

当可能时，此静态函数使用原生文件对话框而不是 QFileDialog。在不支持选择远程文件的平台上，Qt 允许选择仅为本地文件。

另请参阅 getOpenFileName()、getOpenFileUrls()、getSaveFileUrl() 和 getExistingDirectoryUrl()。

[静态] QList<QUrl> QFileDialog::getOpenFileUrls(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::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 允许选择仅为本地文件。

另请参阅getOpenFileNames()、getOpenFileUrl()、getSaveFileUrl() 和 getExistingDirectoryUrl。

[静态] QString QFileDialog::getSaveFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

这是一个便利的静态函数，它返回用户选择的文件名。文件不一定存在。

它创建一个具有给定parent小部件的模态文件对话框。如果 parent 不是 nullptr，则对话框将在父小部件上居中显示。

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"),
                           "/home/jana/untitled.png",
                           tr("Images (*.png *.xpm *.jpg)"));

文件对话框的工作目录设置为dir。如果dir包含文件名，则选择该文件。仅显示与filter 匹配的文件。设置的筛选器为selectedFilter。参数 dir、selectedFilter 和 filter 可以为空字符串。多个筛选器由';;'分隔。例如

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

options 参数包含有关如何运行对话框的不同选项，有关可以传递的标志的更多信息，请参阅 QFileDialog::Option 枚举。

可以通过将 selectedFilter 设置为所需的值来选择默认筛选器。

对话框的标题设置为caption。如果未指定caption，则使用默认标题。

在 Windows 和 macOS 上，这个静态函数使用原生文件对话框而不是 QFileDialog。

在 Windows 上，对话框会启动一个阻塞的模式事件循环，不会调度任何 QTimers；如果 parent 不是 nullptr，则将对话框置于父窗口标题栏下方。在 macOS 上，使用其原生文件对话框时，过滤参数将被忽略。

在Unix/X11上，文件对话框的正常行为是解析和跟随符号链接。例如，如果/usr/tmp是一个指向/var/tmp的符号链接，当输入/usr/tmp后，文件对话框将切换到/var/tmp。如果options包含DontResolveSymlinks，则文件对话框将把符号链接当作普通目录处理。

另请参阅getOpenFileName()，getOpenFileNames() 和 getExistingDirectory()。

[静态] QUrl QFileDialog::getSaveFileUrl(QWidget *parent = nullptr, const QString &caption = QString(), const QUrl &dir = QUrl(), const QString &filter = QString(), QFileDialog::Options options = Options(), const QStringList &supportedSchemes = QStringList())

这是一个方便的静态函数，它返回用户选择的文件。该文件不需要存在。如果用户按下取消，它返回一个空的 URL。

此函数的使用方式类似于 QFileDialog::getSaveFileName。特别是 parent、caption、dir、filter、selectedFilter 和 options 正是以完全相同的方式使用的。

与 QFileDialog::getSaveFileName() 的主要区别在于提供给用户选择远程文件的能力。这就是为什么返回类型和 dir 的类型是 QUrl。

supportedSchemes 参数允许限制用户可以选择的 URL 类型。这是应用程序声明其支持的协议以保存文件内容的一种方式。空列表表示不应用任何限制（默认）。对本地文件（"file"方案）的支持是隐含的并且总是启用的；不需要将其包含在限制中。

当可能时，此静态函数使用原生文件对话框而不是 QFileDialog。在不支持选择远程文件的平台上，Qt 允许选择仅为本地文件。

另请参阅getSaveFileName，getOpenFileUrl，getOpenFileUrls 和 getExistingDirectoryUrl。

QStringList QFileDialog::history() const

以路径列表的形式返回文件对话框的浏览历史。

另请参阅setHistory。

QAbstractFileIconProvider *QFileDialog::iconProvider() const

返回文件对话框使用图标提供者。

另请参阅setIconProvider。

QAbstractItemDelegate *QFileDialog::itemDelegate() const

返回用于在文件对话框视图中的项渲染所使用项代理。

另请参阅setItemDelegate。

QString QFileDialog::labelText(QFileDialog::DialogLabel label) const

在文件对话框的指定 label 中返回显示的文本。

另请参阅 setLabelText().

QStringList QFileDialog::mimeTypeFilters() const

返回当前文件对话框中正在使用的MIME类型过滤器。

另请参阅 setMimeTypeFilters().

QStringList QFileDialog::nameFilters() const

返回当前文件对话框中正在使用的文件类型过滤器。

另请参阅 setNameFilters().

void QFileDialog::open(QObject *receiver, const char *member)

此函数显示对话框，并将由receiver和member指定的槽连接到通知选择变化的信号。如果fileMode是ExistingFiles，则这是filesSelected()信号，否则是fileSelected()信号。

当对话框关闭时，信号将断开与槽的连接。

QAbstractProxyModel *QFileDialog::proxyModel() const

返回由文件对话框使用的代理模型。默认不设置代理。

另请参阅 setProxyModel().

bool QFileDialog::restoreState(const QByteArray &state)

将对话框的布局、历史和当前目录恢复到指定的state。

通常与QSettings一起使用以从过去会话中还原大小。

如果有错误返回false

[静态] void QFileDialog::saveFileContent(const QByteArray &fileContent, const QString &fileNameHint, QWidget *parent = nullptr)

这是一个方便的静态函数，它将fileContent保存到用户选择的文件名和位置中。fileNameHint可以提供以向用户建议文件名。

用于将内容保存到本地文件的WebAssembly上的Qt，如果Web沙盒限制了文件访问。其实现在浏览器中显示原生文件对话框，用户根据fileNameHint参数指定输出文件。

父在WebAssembly版本的Qt中会被忽略。在其他平台上传递父参数，以便使弹出窗口成为另一个小部件的孩子。如果平台不支持原生文件对话框，则函数会回退到QFileDialog。

该函数是异步的，并立即返回。

QByteArray imageData; // obtained from e.g. QImage::save()
QFileDialog::saveFileContent(imageData, "myimage.png"); // with filename hint
// OR
QFileDialog::saveFileContent(imageData); // no filename hint

QByteArray QFileDialog::saveState() const

保存对话框布局、历史和当前目录的状态。

通常与QSettings一起使用以记住未来会话的大小。版本号作为数据的一部分存储。

void QFileDialog::selectFile(const QString &filename)

在文件对话框中选中给定的filename。

另请参阅 selectedFiles ()。

void QFileDialog::selectMimeTypeFilter (const QString &filter)

设置当前 MIME 类型 filter。

void QFileDialog::selectNameFilter (const QString &filter)

设置当前文件类型 filter。可以通过分号或空格分隔多个过滤器传递到 filter 中。

另请参阅 setNameFilter ()，setNameFilters ()，以及 selectedNameFilter ()。

void QFileDialog::selectUrl (const QUrl &url)

在文件对话框中选中给定的 url。

另请参阅 selectedUrls ()。

QStringList QFileDialog::selectedFiles () const

返回一个包含在对话框中选定的文件绝对路径的字符串列表。如果没有选择文件或模式不是 ExistingFiles 或 ExistingFile，则 selectedFiles () 包含视图中当前路径。

另请参阅 selectedNameFilter () 和 selectFile ()。

QString QFileDialog::selectedMimeTypeFilter () const

返回用户在文件对话框中选定的文件的 MIME 类型。

QString QFileDialog::selectedNameFilter () const

返回用户在文件对话框中选定的过滤器。

另请参阅 selectedFiles ()。

QList<QUrl> QFileDialog::selectedUrls () const

返回一个包含对话框中选定的文件的 URL 列表。如果没有选择文件或模式不是 ExistingFiles 或 ExistingFile，则 selectedUrls () 包含视图中当前路径。

另请参阅 selectedNameFilter () 和 selectUrl ()。

void QFileDialog::setDirectory (const QString &directory)

设置文件对话框的当前 directory。

另请参阅 directory ()。

void QFileDialog::setDirectory (const QDir &directory)

这是一个重载的函数。

void QFileDialog::setDirectoryUrl(const QUrl &directory)

设置文件对话框的当前目录url。

另请参阅：directoryUrl() 和 QUuid。

void QFileDialog::setFilter(QDir::Filters filters)

将模型所使用的过滤器设为filters。此过滤器用于指定应显示的文件种类。

另请参阅：filter。

void QFileDialog::setHistory(const QStringList &paths)

将文件对话框的浏览历史设置为包含指定的paths。

另请参阅：history。

void QFileDialog::setIconProvider(QAbstractFileIconProvider *provider)

将文件对话框使用的图标提供者设置为指定的provider。

另请参阅：iconProvider。

void QFileDialog::setItemDelegate(QAbstractItemDelegate *delegate)

将用于在文件对话框中的视图中渲染项目的项目委托设置为给定的delegate。

任何现有的委托都将被移除，但不会被删除。《QFileDialog》不对delegate拥有权。

请注意所使用的模型是QFileSystemModel。它有自定义的项目数据角色，这由Roles枚举描述。如果你想只使用自定义图标，你可以使用QFileIconProvider。

另请参阅：itemDelegate，setIconProvider 和 QFileSystemModel。

void QFileDialog::setLabelText(QFileDialog::DialogLabel label, const QString &text)

将文件对话框在指定的label中显示的text设置为。

另请参阅：labelText。

void QFileDialog::setMimeTypeFilters(const QStringList &filters)

将文件对话框中使用的筛选器从MIME类型列表中设置。

是setNameFilters()的便捷方法。使用QMIMEType根据每个MIME类型中定义的glob模式和描述创建一个名称筛选器。

使用“所有文件(*)”筛选器的application/octet-stream，因为这是所有文件的基础MIME类型。

调用setMimeTypeFilters会覆盖先前设置的名称筛选器，并更改nameFilters()的返回值。

QStringList mimeTypeFilters({"image/jpeg", // will show "JPEG image (*.jpeg *.jpg *.jpe)
                             "image/png",  // will show "PNG image (*.png)"
                             "application/octet-stream" // will show "All files (*)"
                            });

QFileDialog dialog(this);
dialog.setMimeTypeFilters(mimeTypeFilters);
dialog.exec();

另请参阅 mimeTypeFilters。

void QFileDialog::setNameFilter(const QString &filter)

将文件对话框中使用的筛选器设置为给定的筛选器。

如果筛选器包含包含一个或多个文件名通配符模式的一对圆括号，并用空格分隔，则只使用括号内的文本作为筛选器。这意味着这些调用都是等价的

dialog.setNameFilter("All C++ files (*.cpp *.cc *.C *.cxx *.c++)");
dialog.setNameFilter("*.cpp *.cc *.C *.cxx *.c++");

另请参阅：setMimeTypeFilters()和setNameFilters。

void QFileDialog::setNameFilters(const QStringList &filters)

设置文件对话框使用的筛选器。

请注意，筛选器*.*不可移植，因为文件扩展名确定文件类型的假设在各个操作系统上并不一致。可能有不带点的文件名（例如，Makefile）。在原生Windows文件对话框中，*.*匹配此类文件，而在其他类型的文件对话框中可能不匹配。所以，如果你想选择任意文件，最好使用*

const QStringList filters({"Image files (*.png *.xpm *.jpg)",
                           "Text files (*.txt)",
                           "Any files (*)"
                          });
QFileDialog dialog(this);
dialog.setNameFilters(filters);
dialog.exec();

setMimeTypeFilters()的优点在于为每种文件类型提供所有可能的名字筛选器。例如，JPEG图像有三个可能的扩展名；如果您的应用程序可以打开此类文件，将image/jpeg MIME类型作为筛选器可以让您打开所有这些文件。

另请参阅：nameFilters。

void QFileDialog::setOption(QFileDialog::Option option, bool on = true)

如果on为true，则将给定的option设置为启用；否则，清除给定的option。

在更改对话框属性或显示对话框之前应设置选项（特别是不使用本地对话框选项）。

在对话框可见时设置选项不保证立即影响对话框（取决于选项和平台）。

更改其他属性后设置选项可能导致这些值没有效果。

另请参阅：options和testOption。

void QFileDialog::setProxyModel(QAbstractProxyModel *proxyModel)

将视图的模型设置为给定的proxyModel。如果想要修改底层模型（例如，添加列、筛选数据或添加驱动器），这很有用。

任何现有的代理模型将被移除，但不会删除。文件对话框将拥有proxyModel的所有权。

另请参阅：proxyModel。

void QFileDialog::setSidebarUrls(const QList<QUrl> &urls)

将侧导航栏中的urls设置为侧边栏。

例如

    QList<QUrl> urls;
    urls << QUrl::fromLocalFile("/Users/foo/Code/qt5")
         << QUrl::fromLocalFile(QStandardPaths::standardLocations(QStandardPaths::MusicLocation).first());

    QFileDialog dialog;
    dialog.setSidebarUrls(urls);
    dialog.setFileMode(QFileDialog::AnyFile);
    if (dialog.exec()) {
        // ...
    }

则文件对话框看起来像这样

另请参阅 sidebarUrls().

[重写虚函数] void QFileDialog::setVisible(bool visible)

重写: QDialog::setVisible(bool visible).

QList<QUrl> QFileDialog::sidebarUrls() const

返回当前侧边栏中的url列表

另请参阅 setSidebarUrls().

bool QFileDialog::testOption(QFileDialog::Option option) const

如果给定的option启用，则返回true；否则返回false。

另请参阅 options 和 setOption().

[信号] void QFileDialog::urlSelected(const QUrl &url)

当选择更改且对话框被接受时，将以（可能为空）选中url发出此信号。

另请参阅 currentUrlChanged() 和 QDialog::Accepted.

[信号] void QFileDialog::urlsSelected(const QList<QUrl> &urls)

当选择更改且对话框被接受时，将以（可能为空）选中urls的列表发出此信号。

另请参阅 currentUrlChanged() 和 QDialog::Accepted.