QFileDialog Class Reference · PyQt4 中文文檔

# QFileDialog Class Reference ## [[QtGui](index.htm) module] 該QFileDialog中的類提供了一個對話框，讓用戶選擇文件或目錄。[More...](#details) 繼承[QDialog](qdialog.html)。 ### Types * `enum AcceptMode { AcceptOpen, AcceptSave }` * `enum DialogLabel { LookIn, FileName, FileType, Accept, Reject }` * `enum FileMode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly }` * `enum Option { ShowDirsOnly, DontResolveSymlinks, DontConfirmOverwrite, DontUseSheet, ..., HideNameFilterDetails }` * `class **[Options](index.htm)**` * `enum ViewMode { Detail, List }` ### Methods * `__init__ (self, QWidget?parent, Qt.WindowFlags?f)` * `__init__ (self, QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString())` * `accept (self)` * `AcceptMode acceptMode (self)` * `changeEvent (self, QEvent?e)` * `bool confirmOverwrite (self)` * `QString defaultSuffix (self)` * `QDir directory (self)` * `done (self, int?result)` * `FileMode fileMode (self)` * `QDir.Filters filter (self)` * `QStringList filters (self)` * `QStringList history (self)` * `QFileIconProvider iconProvider (self)` * `bool isNameFilterDetailsVisible (self)` * `bool isReadOnly (self)` * `QAbstractItemDelegate itemDelegate (self)` * `QString labelText (self, DialogLabel?label)` * `QStringList nameFilters (self)` * `open (self)` * `open (self, QObject?receiver, SLOT()SLOT()?member)` * `open (self, callable?receiver)` * `Options options (self)` * `QAbstractProxyModel proxyModel (self)` * `bool resolveSymlinks (self)` * `bool restoreState (self, QByteArray?state)` * `QByteArray saveState (self)` * `QStringList selectedFiles (self)` * `QString selectedFilter (self)` * `QString selectedNameFilter (self)` * `selectFile (self, QString?filename)` * `selectFilter (self, QString?filter)` * `selectNameFilter (self, QString?filter)` * `setAcceptMode (self, AcceptMode?mode)` * `setConfirmOverwrite (self, bool?enabled)` * `setDefaultSuffix (self, QString?suffix)` * `setDirectory (self, QString?directory)` * `setDirectory (self, QDir?adirectory)` * `setFileMode (self, FileMode?mode)` * `setFilter (self, QString?filter)` * `setFilter (self, QDir.Filters?filters)` * `setFilters (self, QStringList?filters)` * `setHistory (self, QStringList?paths)` * `setIconProvider (self, QFileIconProvider?provider)` * `setItemDelegate (self, QAbstractItemDelegate?delegate)` * `setLabelText (self, DialogLabel?label, QString?text)` * `setNameFilter (self, QString?filter)` * `setNameFilterDetailsVisible (self, bool?enabled)` * `setNameFilters (self, QStringList?filters)` * `setOption (self, Option?option, bool?on?=?True)` * `setOptions (self, Options?options)` * `setProxyModel (self, QAbstractProxyModel?model)` * `setReadOnly (self, bool?enabled)` * `setResolveSymlinks (self, bool?enabled)` * `setSidebarUrls (self, list-of-QUrl?urls)` * `setViewMode (self, ViewMode?mode)` * `setVisible (self, bool?visible)` * `list-of-QUrl sidebarUrls (self)` * `bool testOption (self, Option?option)` * `ViewMode viewMode (self)` ### Static Methods * `QString getExistingDirectory (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), Options?options?=?QFileDialog.ShowDirsOnly)` * `QString getOpenFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0)` * `QString getOpenFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0)` * `(QString, QString) getOpenFileNameAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0)` * `QStringList getOpenFileNames (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0)` * `QStringList getOpenFileNames (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0)` * `(QString, QString) getOpenFileNamesAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0)` * `QString getSaveFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0)` * `QString getSaveFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0)` * `(QString, QString) getSaveFileNameAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0)` ### Qt Signals * `void currentChanged (const QString&)` * `void directoryEntered (const QString&)` * `void fileSelected (const QString&)` * `void filesSelected (const QStringList&)` * `void filterSelected (const QString&)` * * * ## Detailed Description 該QFileDialog中的類提供了一個對話框，讓用戶選擇文件或目錄。在QFileDialog中類使用戶可以遍歷文件系統，以選擇一個或多個文件或目錄。創建一個QFileDialog中最簡單的方法是使用靜態函數。在Windows，Mac OS X ， KDE和GNOME ，這些靜態函數將調用本地文件對話框時可能的。 ``` fileName = QFileDialog.getOpenFileName(this, tr("Open Image"), "/home/jana", tr("Image Files (*.png *.jpg *.bmp)")); ``` 在上面的例子中，一個模態QFileDialog中使用靜態函數創建。該對話框最初顯示“ /首頁/賈納”目錄中的內容，并顯示文件匹配字符串中給定的模式“圖像文件（ * 。 PNG ，JPG等圖片。 BMP ） ” 。文件對話框的父被設置為_this_和窗口標題設置為“打開圖像” 。如果你想使用多個過濾器，分離與每一個_two_分號。例如： ``` "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)" ``` 你可以創建自己的QFileDialog中不使用靜態函數。通過調用[setFileMode](qfiledialog.html#fileMode-prop)（），您可以指定哪些用戶必須在對話框中進行選擇： ``` QFileDialog dialog(this); dialog.setFileMode(QFileDialog.AnyFile); ``` 在上面的例子中，文件對話框的模式被設置為[AnyFile](qfiledialog.html#FileMode-enum)的，這意味著用戶可以選擇任何文件，甚至指定不存在的文件。這種模式是建立一個“另存為”文件對話框是有用的。使用[ExistingFile](qfiledialog.html#FileMode-enum)如果用戶必須選擇一個現有的文件，或[Directory](qfiledialog.html#FileMode-enum)如果只有一個目錄可能被選中。請參閱[QFileDialog.FileMode](qfiledialog.html#FileMode-enum)枚舉類型的模式的完整列表。該[fileMode](qfiledialog.html#fileMode-prop)屬性包含操作對話框的模式，這表示，預計選擇什么類型的對象的用戶。使用[setNameFilter](qfiledialog.html#setNameFilter)（）來設置對話框的文件過濾器。例如： ``` dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg)")); ``` 在上面的例子中，過濾器被設置為`"Images (*.png *.xpm *.jpg)"`，這意味著只有與擴展名的文件`png`，`xpm`或`jpg`將被顯示在QFileDialog中進行。您可以通過使用應用多種濾鏡[setNameFilters](qfiledialog.html#setNameFilters)（）。使用[selectNameFilter](qfiledialog.html#selectNameFilter)（）來選擇你給的文件對話框的缺省過濾器的過濾器之一。文件對話框有兩種視圖模式：[List](qfiledialog.html#ViewMode-enum)和[Detail](qfiledialog.html#ViewMode-enum)。[List](qfiledialog.html#ViewMode-enum)介紹了當前目錄中的內容作為文件名和目錄名的列表。[Detail](qfiledialog.html#ViewMode-enum)還顯示文件和目錄名的列表，但提供了額外的信息，并排的名字，如文件大小和修改日期。與設定的模式[setViewMode](qfiledialog.html#viewMode-prop)（）： ``` dialog.setViewMode(QFileDialog.Detail); ``` 創建自己的文件對話框時，你將需要使用的最后一個重要的功能是[selectedFiles](qfiledialog.html#selectedFiles)（）。 ``` [QStringList](qstringlist.html) fileNames; if (dialog.exec()) fileNames = dialog.selectedFiles(); ``` 在上面的示例中，創建并顯示一個模式文件對話框。如果用戶單擊OK（確定），他們所選擇的文件放在`fileName`。對話框的工作目錄可以被設置[setDirectory](qfiledialog.html#setDirectory)（）。在當前目錄下的每個文件可以使用被選擇的[selectFile](qfiledialog.html#selectFile)（）函數。該[Standard Dialogs](index.htm)示例顯示了如何使用QFileDialog中以及其他內置Qt對話框。 * * * ## Type Documentation ``` QFileDialog.AcceptMode ``` | Constant | Value | | --- | --- | | `QFileDialog.AcceptOpen` | `0` | | `QFileDialog.AcceptSave` | `1` | ``` QFileDialog.DialogLabel ``` | Constant | Value | | --- | --- | | `QFileDialog.LookIn` | `0` | | `QFileDialog.FileName` | `1` | | `QFileDialog.FileType` | `2` | | `QFileDialog.Accept` | `3` | | `QFileDialog.Reject` | `4` | ``` QFileDialog.FileMode ``` 此枚舉用于指示哪些用戶可以在文件對話框中選擇，即如果用戶單擊OK（確定）對話框將返回什么。 | Constant | Value | Description | | --- | --- | --- | | `QFileDialog.AnyFile` | `0` | 一個文件的文件名，無論是否存在。 | | `QFileDialog.ExistingFile` | `1` | 現有的單個文件的名稱。 | | `QFileDialog.Directory` | `2` | 一個目錄的名稱。這兩個文件和目錄都顯示出來。 | | `QFileDialog.ExistingFiles` | `3` | 零個或多個現有文件的名稱。 | 這個值是過時的，因為Qt的4.5 ： | Constant | Value | Description | | --- | --- | --- | | `QFileDialog.DirectoryOnly` | `4` | 使用`Directory`和的SetOption （[ShowDirsOnly](qfiledialog.html#Option-enum)，真正的）來代替。 | **See also** [setFileMode](qfiledialog.html#fileMode-prop)（）。 ``` QFileDialog.Option ``` | Constant | Value | Description | | --- | --- | --- | | `QFileDialog.ShowDirsOnly` | `0x00000001` | 只顯示在文件對話框的目錄。默認情況下這兩個文件和目錄都顯示。（只適用于[Directory](qfiledialog.html#FileMode-enum)文件模式。） | | `QFileDialog.DontResolveSymlinks` | `0x00000002` | 不解決符號鏈接的文件對話框。默認情況下符號鏈接都解決了。 | | `QFileDialog.DontConfirmOverwrite` | `0x00000004` | 不要求確認如果選擇現有文件。默認情況下請求確認。 | | `QFileDialog.DontUseNativeDialog` | `0x00000010` | 不要使用本地文件對話框。默認情況下，使用本地文件對話框，除非你用的子類[QFileDialog](qfiledialog.html)包含[Q_OBJECT](qobject.html#Q_OBJECT)宏。 | | `QFileDialog.ReadOnly` | `0x00000020` | 表明該模型是只讀的。 | | `QFileDialog.HideNameFilterDetails` | `0x00000040` | 表示如果文件名過濾器的細節被隱藏與否。 | | `QFileDialog.DontUseSheet` | `0x00000008` | 在Qt的早期版本中，靜態函數會默認創建一個表，如果靜態函數被賦予了父母。這不再支持和不執行任何操作在Qt的4.5 ，靜態函數將永遠是一個應用程序的模態對話框。如果你想使用表，使用[QFileDialog.open](qfiledialog.html#open)（）來代替。 | 該選項類型是一個typedef為[QFlags](index.htm)\u003cOPTION\u003e 。它存儲選項值的一個或組合。 ``` QFileDialog.ViewMode ``` 這個枚舉變量描述文件對話框的視圖模式，即什么有關每個文件的信息將被顯示。 | Constant | Value | Description | | --- | --- | --- | | `QFileDialog.Detail` | `0` | 顯示一個圖標，名稱，詳細目錄中的每個項目。 | | `QFileDialog.List` | `1` | 只顯示目錄中的圖標，并為每個項目的名稱。 | **See also** [setViewMode](qfiledialog.html#viewMode-prop)（）。 * * * ## Method Documentation ``` QFileDialog.__init__ (self, QWidget?parent, Qt.WindowFlags?f) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個文件對話框給定的_parent_和widget_flags_。 ``` QFileDialog.__init__ (self, QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString()) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個文件對話框給定的_parent_和_caption_最初顯示指定的內容_directory_。該目錄中的內容被過濾所示的對話框中之前，使用的過濾器通過指定一個分號分隔的列表_filter_。 ``` QFileDialog.accept (self) ``` 從重新實現[QDialog.accept](qdialog.html#accept)（）。 ``` AcceptMode QFileDialog.acceptMode (self) ``` [ ``` QFileDialog.changeEvent (self, QEvent?e) ``` ](qfiledialog.html#AcceptMode-enum) [從重新實現](qfiledialog.html#AcceptMode-enum)[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` bool QFileDialog.confirmOverwrite (self) ``` ``` QString QFileDialog.defaultSuffix (self) ``` ``` QDir QFileDialog.directory (self) ``` [ 返回目錄當前顯示在對話框中。 ](qdir.html) [**See also**](qdir.html) [setDirectory](qfiledialog.html#setDirectory)（）。 ``` QFileDialog.done (self, int?result) ``` 從重新實現[QDialog.done](qdialog.html#done)（）。 ``` FileMode QFileDialog.fileMode (self) ``` [](qfiledialog.html#FileMode-enum) ``` QDir.Filters QFileDialog.filter (self) ``` [ 返回顯示的是文件時所使用的過濾器。此功能被引入Qt的4.4 。 ](index.htm) [**See also**](index.htm) [setFilter](qfiledialog.html#setFilter)（）。 ``` QStringList QFileDialog.filters (self) ``` ``` QString QFileDialog.getExistingDirectory (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), Options?options?=?QFileDialog.ShowDirsOnly) ``` 這是一個方便的靜態函數將返回由用戶選擇一個已存在的目錄。 ``` [QString](qstring.html) dir = [QFileDialog](qfiledialog.html).getExistingDirectory(this, tr("Open Directory"), "/home", [QFileDialog](qfiledialog.html).ShowDirsOnly | [QFileDialog](qfiledialog.html).DontResolveSymlinks); ``` 這個函數創建具有給定一個模式文件對話框_parent_小工具。如果_parent_不為0時，將顯示該對話框居中在父窗口部件。對話框的工作目錄設置為_dir_和標題設置為_caption_。無論這些可能是在這種情況下，當前目錄和默認的標題將分別使用一個空字符串。該_options_參數包含有關如何運行對話框中的各種選項，請參閱[QFileDialog.Option](qfiledialog.html#Option-enum)枚舉就可以傳遞標志的更多信息。為確保本地文件對話框，[ShowDirsOnly](qfiledialog.html#Option-enum)必須設置。在Windows，Mac OS X和Symbian ^ 3系統，這個靜態函數將使用本地文件對話框，而不是一個[QFileDialog](qfiledialog.html)。在Windows CE上，如果設備沒有本地文件對話框中，[QFileDialog](qfiledialog.html)將被使用。上UNIX/X11 ，文件對話框的正常行為是解決并按照符號鏈接。例如，如果`/usr/tmp`是一個符號鏈接`/var/tmp`，文件對話框將變為`/var/tmp`進入后`/usr/tmp`。如果_options_包括[DontResolveSymlinks](qfiledialog.html#Option-enum)，文件對話框將把符號連接作為常規目錄。在Windows的對話框會打滑阻塞模式的事件循環，不會派遣任何QTimers ，如果_parent_是不是0，那么它將使該對話框下方父的標題欄。在Symbian ^ 3_options_參數僅用于定義如果使用本地文件對話框。 **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QFileDialog](qfiledialog.html)構造函數。 **See also** [getOpenFileName](qfiledialog.html#getOpenFileName)（）[getOpenFileNames](qfiledialog.html#getOpenFileNames)（）和[getSaveFileName](qfiledialog.html#getSaveFileName)（）。 ``` QString QFileDialog.getOpenFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0) ``` 這是一個方便的靜態函數，返回由用戶選擇一個已存在的文件。如果用戶按下Cancel ，則返回一個空字符串。 ``` [QString](qstring.html) fileName = [QFileDialog](qfiledialog.html).getOpenFileName(this, tr("Open File"), "/home", tr("Images (*.png *.xpm *.jpg)")); ``` 用給定的函數創建一個樣式文件對話框_parent_小工具。如果_parent_不為0時，將顯示該對話框居中在父窗口部件。文件對話框的工作目錄將被設置為_dir_。如果_dir_包括一個文件名，該文件將被選中。只有匹配給定的文件_filter_示。選定的過濾器設置為_selectedFilter_。參數_dir_，_selectedFilter_和_filter_可能是空字符串。如果你想多個過濾器，將它們分開，以'; “; ，例如： ``` "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)" ``` 該_options_參數包含有關如何運行對話框中的各種選項，請參閱[QFileDialog.Option](qfiledialog.html#Option-enum)枚舉就可以傳遞標志的更多信息。該對話框的標題設置為_caption_。如果_caption_不指定，那么默認的標題將被使用。在Windows，Mac OS X和Symbian ^ 3系統，這個靜態函數將使用本地文件對話框，而不是一個[QFileDialog](qfiledialog.html)。在Windows的對話框會打滑阻塞模式的事件循環，不會派遣任何QTimers ，如果_parent_是不是0，那么它將使該對話框下方父的標題欄。上UNIX/X11 ，文件對話框的正常行為是解決并按照符號鏈接。例如，如果`/usr/tmp`是一個符號鏈接`/var/tmp`，文件對話框將變為`/var/tmp`進入后`/usr/tmp`。如果_options_包括[DontResolveSymlinks](qfiledialog.html#Option-enum)，文件對話框將把符號連接作為常規目錄。在Symbian ^ 3的參數_selectedFilter_已經沒有任何意義和_options_參數僅用于定義如果使用本地文件對話框。 **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QFileDialog](qfiledialog.html)構造函數。 **See also** [getOpenFileNames](qfiledialog.html#getOpenFileNames)（）[getSaveFileName](qfiledialog.html#getSaveFileName)（）和[getExistingDirectory](qfiledialog.html#getExistingDirectory)（）。 ``` QString QFileDialog.getOpenFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0) ``` ``` (QString, QString) QFileDialog.getOpenFileNameAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0) ``` ``` QStringList QFileDialog.getOpenFileNames (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0) ``` 這是一個方便的靜態函數，將返回一個或多個由用戶選擇現有的文件。 ``` [QStringList](qstringlist.html) files = [QFileDialog](qfiledialog.html).getOpenFileNames( this, "Select one or more files to open", "/home", "Images (*.png *.xpm *.jpg)"); ``` 這個函數創建具有給定一個模式文件對話框_parent_小工具。如果_parent_不為0時，將顯示該對話框居中在父窗口部件。文件對話框的工作目錄將被設置為_dir_。如果_dir_包括一個文件名，該文件將被選中。該過濾器被設置為_filter_使只顯示那些匹配過濾文件。選定的過濾器設置為_selectedFilter_。參數_dir_，_selectedFilter_和_filter_可能是空字符串。如果你需要多個過濾器，將它們分開，以'; “; ，例如： ``` "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)" ``` 該對話框的標題設置為_caption_。如果_caption_不指定，那么默認的標題將被使用。在Windows，Mac OS X和Symbian ^ 3系統，這個靜態函數將使用本地文件對話框，而不是一個[QFileDialog](qfiledialog.html)。在Windows的對話框會打滑阻塞模式的事件循環，不會派遣任何QTimers ，如果_parent_是不是0，那么它將使該對話框下方父的標題欄。上UNIX/X11 ，文件對話框的正常行為是解決并按照符號鏈接。例如，如果`/usr/tmp`是一個符號鏈接`/var/tmp`，文件對話框將變為`/var/tmp`進入后`/usr/tmp`。該_options_參數包含有關如何運行對話框中的各種選項，請參閱[QFileDialog.Option](qfiledialog.html#Option-enum)枚舉就可以傳遞標志的更多信息。 **Note:**如果你想遍歷文件的列表，你應該遍歷一個副本。例如： ``` [QStringList](qstringlist.html) list = files; [QStringList](qstringlist.html).Iterator it = list.begin(); while(it != list.end()) { myProcessing(*it); ++it; } ``` 在Symbian ^ 3的參數_selectedFilter_已經沒有任何意義和_options_參數僅用于定義如果使用本地文件對話框。在Symbian ^ 3 ，這個函數只能返回一個文件名。 **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QFileDialog](qfiledialog.html)構造函數。 **See also** [getOpenFileName](qfiledialog.html#getOpenFileName)（）[getSaveFileName](qfiledialog.html#getSaveFileName)（）和[getExistingDirectory](qfiledialog.html#getExistingDirectory)（）。 ``` QStringList QFileDialog.getOpenFileNames (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0) ``` ``` (QString, QString) QFileDialog.getOpenFileNamesAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0) ``` ``` QString QFileDialog.getSaveFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), Options?options?=?0) ``` 這是一個方便的靜態函數將返回由用戶選擇的文件名。該文件沒有存在。它創建具有給定一個模式文件對話框_parent_小工具。如果_parent_不為0時，將顯示該對話框居中在父窗口部件。 ``` [QString](qstring.html) fileName = [QFileDialog](qfiledialog.html).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](qfiledialog.html#Option-enum)枚舉就可以傳遞標志的更多信息。默認的過濾器可以通過設置選擇_selectedFilter_到所需的值。該對話框的標題設置為_caption_。如果_caption_沒有被指定，默認字幕將被使用。在Windows，Mac OS X和Symbian ^ 3系統，這個靜態函數將使用本地文件對話框，而不是一個[QFileDialog](qfiledialog.html)。在Windows的對話框會打滑阻塞模式的事件循環，不會派遣任何QTimers ，如果_parent_是不是0，那么它將使該對話框下方父的標題欄。在Mac OS X ，其本地文件對話框，濾波器參數將被忽略。上UNIX/X11 ，文件對話框的正常行為是解決并按照符號鏈接。例如，如果`/usr/tmp`是一個符號鏈接`/var/tmp`，文件對話框將變為`/var/tmp`進入后`/usr/tmp`。如果_options_包括[DontResolveSymlinks](qfiledialog.html#Option-enum)文件對話框將把符號連接作為常規目錄。在Symbian ^ 3的參數_filter_和_selectedFilter_沒有任何意義。該_options_參數僅用于定義如果使用本地文件對話框。 **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QFileDialog](qfiledialog.html)構造函數。 **See also** [getOpenFileName](qfiledialog.html#getOpenFileName)（）[getOpenFileNames](qfiledialog.html#getOpenFileNames)（）和[getExistingDirectory](qfiledialog.html#getExistingDirectory)（）。 ``` QString QFileDialog.getSaveFileName (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?selectedFilter?=?None, Options?options?=?0) ``` ``` (QString, QString) QFileDialog.getSaveFileNameAndFilter (QWidget?parent?=?None, QString?caption?=?QString(), QString?directory?=?QString(), QString?filter?=?QString(), QString?initialFilter?=?QString(), Options?options?=?0) ``` ``` QStringList QFileDialog.history (self) ``` 返回的FileDialog的瀏覽歷史記錄作為路徑的列表。 **See also** [setHistory](qfiledialog.html#setHistory)（）。 ``` QFileIconProvider QFileDialog.iconProvider (self) ``` [ 返回所使用的文件對話框的圖標提供商。 ](qfileiconprovider.html) [**See also**](qfileiconprovider.html) [setIconProvider](qfiledialog.html#setIconProvider)（）。 ``` bool QFileDialog.isNameFilterDetailsVisible (self) ``` ``` bool QFileDialog.isReadOnly (self) ``` ``` QAbstractItemDelegate QFileDialog.itemDelegate (self) ``` [ 返回用于呈現在文件對話框的意見項目的項目委讬。 ](qabstractitemdelegate.html) [**See also**](qabstractitemdelegate.html) [setItemDelegate](qfiledialog.html#setItemDelegate)（）。 ``` QString QFileDialog.labelText (self, DialogLabel?label) ``` 返回在指定的文件對話框上顯示的文本_label_。 **See also** [setLabelText](qfiledialog.html#setLabelText)（）。 ``` QStringList QFileDialog.nameFilters (self) ``` 返回文件類型過濾器，在操作這個文件對話框。此功能被引入Qt的4.4 。 **See also** [setNameFilters](qfiledialog.html#setNameFilters)（）。 ``` QFileDialog.open (self) ``` 這是一個重載函數。此功能連接它的信號之一，由指定的插槽_receiver_和_member_。特定信號取決于是[filesSelected](qfiledialog.html#filesSelected)（）如果[fileMode](qfiledialog.html#fileMode-prop) is [ExistingFiles](qfiledialog.html#FileMode-enum)和[fileSelected](qfiledialog.html#fileSelected)（）如果[fileMode](qfiledialog.html#fileMode-prop)是其他任何東西。該信號會從插槽中斷開時，關閉對話框。此功能被引入Qt的4.5 。 ``` QFileDialog.open (self, QObject?receiver, SLOT()SLOT()?member) ``` ``` QFileDialog.open (self, callable?receiver) ``` ``` Options QFileDialog.options (self) ``` [](index.htm) ``` QAbstractProxyModel QFileDialog.proxyModel (self) ``` [ 返回所使用的文件對話框的代理模型。默認情況下沒有代理設置。 ](qabstractproxymodel.html) [**See also**](qabstractproxymodel.html) [setProxyModel](qfiledialog.html#setProxyModel)（）。 ``` bool QFileDialog.resolveSymlinks (self) ``` ``` bool QFileDialog.restoreState (self, QByteArray?state) ``` 恢復對話框的布局，歷史和當前目錄到_state_規定。通常，這是配合使用[QSettings](qsettings.html)從過去的會話還原大小。如果有錯誤，則返回False 此功能被引入Qt的4.3 。 ``` QByteArray QFileDialog.saveState (self) ``` [ 保存對話框的布局，歷史和當前目錄的狀態。 ](qbytearray.html) [通常，這是配合使用](qbytearray.html)[QSettings](qsettings.html)要記住的大小為今后的會議。版本號碼被存儲作為數據的一部分。此功能被引入Qt的4.3 。 ``` QStringList QFileDialog.selectedFiles (self) ``` 返回包含在對話框中選定的文件的絕對路徑的字符串列表。如果沒有文件被選中，或模式是不[ExistingFiles](qfiledialog.html#FileMode-enum) or [ExistingFile](qfiledialog.html#FileMode-enum)， selectedFiles （）包含在視口中當前路徑。 **See also** [selectedNameFilter](qfiledialog.html#selectedNameFilter)（）和[selectFile](qfiledialog.html#selectFile)（）。 ``` QString QFileDialog.selectedFilter (self) ``` ``` QString QFileDialog.selectedNameFilter (self) ``` 返回用戶在文件對話框中選擇過濾器。此功能被引入Qt的4.4 。 **See also** [selectedFiles](qfiledialog.html#selectedFiles)（）。 ``` QFileDialog.selectFile (self, QString?filename) ``` 選擇給定的_filename_在文件對話框。 **See also** [selectedFiles](qfiledialog.html#selectedFiles)（）。 ``` QFileDialog.selectFilter (self, QString?filter) ``` ``` QFileDialog.selectNameFilter (self, QString?filter) ``` 設置當前文件類型_filter_。多個過濾器可以被傳遞_filter_用分號或空格分隔。此功能被引入Qt的4.4 。 **See also** [setNameFilter](qfiledialog.html#setNameFilter)（）[setNameFilters](qfiledialog.html#setNameFilters)（）和[selectedNameFilter](qfiledialog.html#selectedNameFilter)（）。 ``` QFileDialog.setAcceptMode (self, AcceptMode?mode) ``` ``` QFileDialog.setConfirmOverwrite (self, bool?enabled) ``` ``` QFileDialog.setDefaultSuffix (self, QString?suffix) ``` ``` QFileDialog.setDirectory (self, QString?directory) ``` 設置文件對話框的電流_directory_。 **See also** [directory](qfiledialog.html#directory)（）。 ``` QFileDialog.setDirectory (self, QDir?adirectory) ``` 這是一個重載函數。 ``` QFileDialog.setFileMode (self, FileMode?mode) ``` ``` QFileDialog.setFilter (self, QString?filter) ``` 設置模型使用的過濾器_filters_。該過濾器是用于指定類型的文件應該被顯示。此功能被引入Qt的4.4 。 **See also** [filter](qfiledialog.html#filter)（）。 ``` QFileDialog.setFilter (self, QDir.Filters?filters) ``` ``` QFileDialog.setFilters (self, QStringList?filters) ``` ``` QFileDialog.setHistory (self, QStringList?paths) ``` 設置文件對話框的瀏覽歷史記錄包含給定_paths_。 **See also** [history](qfiledialog.html#history)（）。 ``` QFileDialog.setIconProvider (self, QFileIconProvider?provider) ``` 設置使用的文件對話框，以指定的圖標提供商_provider_。 **See also** [iconProvider](qfiledialog.html#iconProvider)（）。 ``` QFileDialog.setItemDelegate (self, QAbstractItemDelegate?delegate) ``` 設置用于渲染的意見項目在文件對話框中給定的項目代表_delegate_。 **Warning:**你不應該共享視圖之間的委讬的同一實例。否則會導致不正確或不直觀的編輯行為，因為在一個給定的委讬每個視圖可能會收到[closeEditor()](qabstractitemdelegate.html#closeEditor)信號，并試圖訪問，修改或關閉一個已經被關閉的編輯器。注意，所用的模型是[QFileSystemModel](qfilesystemmodel.html)。它具有自定義項目角色的數據，這是由所描述的[Roles](qfilesystemmodel.html#Roles-enum)枚舉。您可以使用[QFileIconProvider](qfileiconprovider.html)如果只想自定義圖標。 **See also** [itemDelegate](qfiledialog.html#itemDelegate)（）[setIconProvider](qfiledialog.html#setIconProvider)（）和[QFileSystemModel](qfilesystemmodel.html)。 ``` QFileDialog.setLabelText (self, DialogLabel?label, QString?text) ``` 設置_text_在所指定的文件對話框顯示_label_。 **See also** [labelText](qfiledialog.html#labelText)（）。 ``` QFileDialog.setNameFilter (self, QString?filter) ``` 設置在文件對話框中使用的過濾器給定_filter_。 If _filter_包含一對含有一個或多個括號中的**anything*something**，用空格隔開，那么只有包含在括號內的文字被用作過濾器。這意味著，這些電話都是等價的： ``` dialog.setNameFilter("All C++ files (*.cpp *.cc *.C *.cxx *.c++)"); dialog.setNameFilter("*.cpp *.cc *.C *.cxx *.c++"); ``` 此功能被引入Qt的4.4 。 **See also** [setNameFilters](qfiledialog.html#setNameFilters)（）。 ``` QFileDialog.setNameFilterDetailsVisible (self, bool?enabled) ``` ``` QFileDialog.setNameFilters (self, QStringList?filters) ``` 設置_filters_在文件對話框中使用。 ``` [QStringList](qstringlist.html) filters; filters << "Image files (*.png *.xpm *.jpg)" << "Text files (*.txt)" << "Any files (*)"; [QFileDialog](qfiledialog.html) dialog(this); dialog.setNameFilters(filters); dialog.exec_(); ``` 此功能被引入Qt的4.4 。 **See also** [nameFilters](qfiledialog.html#nameFilters)（）。 ``` QFileDialog.setOption (self, Option?option, bool?on?=?True) ``` 設置給定_option_被啟用，如果_on_是真的，否則，清除給定的_option_。此功能被引入Qt的4.5 。 **See also** [options](qfiledialog.html#options-prop)和[testOption](qfiledialog.html#testOption)（）。 ``` QFileDialog.setOptions (self, Options?options) ``` ``` QFileDialog.setProxyModel (self, QAbstractProxyModel?model) ``` 該_model_說法有它的所有權轉移給Qt的。該模型提出的意見設置為給定_proxyModel_。如果您要修改的基礎模型，這非常有用，例如，添加列，過濾數據或添加驅動器。任何現有的代理模型將被刪除，但不會被刪除。文件對話框將采取的所有權_proxyModel_。此功能被引入Qt的4.3 。 **See also** [proxyModel](qfiledialog.html#proxyModel)（）。 ``` QFileDialog.setReadOnly (self, bool?enabled) ``` ``` QFileDialog.setResolveSymlinks (self, bool?enabled) ``` ``` QFileDialog.setSidebarUrls (self, list-of-QUrl?urls) ``` 設置_urls_位于側邊欄的。例如： ``` [QList](index.htm)<[QUrl](qurl.html)> urls; urls << [QUrl](qurl.html).fromLocalFile("/home/gvatteka/dev/qt-45") << [QUrl](qurl.html).fromLocalFile([QDesktopServices](qdesktopservices.html).storageLocation([QDesktopServices](qdesktopservices.html).MusicLocation)); [QFileDialog](qfiledialog.html) dialog; dialog.setSidebarUrls(urls); dialog.setFileMode([QFileDialog](qfiledialog.html).AnyFile); if(dialog.exec()) { // ... } ``` 文件對話框就會看起來像這樣： ![](https://img.kancloud.cn/04/55/0455ebf48a475011b1f750e03b5a9b95_300x206.png) 此功能被引入Qt的4.3 。 **See also** [sidebarUrls](qfiledialog.html#sidebarUrls)（）。 ``` QFileDialog.setViewMode (self, ViewMode?mode) ``` ``` QFileDialog.setVisible (self, bool?visible) ``` 從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（）。 ``` list-of-QUrl QFileDialog.sidebarUrls (self) ``` 返回的URL是目前在側邊欄的列表此功能被引入Qt的4.3 。 **See also** [setSidebarUrls](qfiledialog.html#setSidebarUrls)（）。 ``` bool QFileDialog.testOption (self, Option?option) ``` 返回True如果給定的_option_被啟用，否則返回False 。此功能被引入Qt的4.5 。 **See also** [options](qfiledialog.html#options-prop)和[setOption](qfiledialog.html#setOption)（）。 ``` ViewMode QFileDialog.viewMode (self) ``` [ * * * ## Qt Signal Documentation ``` void currentChanged (const QString&) ``` 這是該信號的默認超載。如果當前文件的變化，這個信號被發射的新的文件名作為_path_參數。 ](qfiledialog.html#ViewMode-enum) [**See also**](qfiledialog.html#ViewMode-enum) [filesSelected](qfiledialog.html#filesSelected)（）。 ``` void directoryEntered (const QString&) ``` 這是該信號的默認超載。當用戶輸入這個信號被發射的_directory_。此功能被引入Qt的4.3 。 ``` void fileSelected (const QString&) ``` 這是該信號的默認超載。當選擇的變化和對話框被接受，這個信號被發射的（可能為空）選中_file_。 **See also** [currentChanged](qfiledialog.html#currentChanged)（）和[QDialog.Accepted](qdialog.html#DialogCode-enum)。 ``` void filesSelected (const QStringList&) ``` 這是該信號的默認超載。當選擇的變化和對話框被接受，這個信號被發射用的（可能為空）名單_selected_文件。 **See also** [currentChanged](qfiledialog.html#currentChanged)（）和[QDialog.Accepted](qdialog.html#DialogCode-enum)。 ``` void filterSelected (const QString&) ``` 這是該信號的默認超載。當用戶選擇這個信號被發射的_filter_。此功能被引入Qt的4.3 。