QDirModel Class Reference · PyQt4 中文文檔

# QDirModel Class Reference ## [[QtGui](index.htm) module] 該QDirModel類提供了在本地文件系統的數據模型。[More...](#details) 繼承[QAbstractItemModel](qabstractitemmodel.html)。 ### Types * `enum Roles { FileIconRole, FilePathRole, FileNameRole }` ### Methods * `__init__ (self, QStringList?nameFilters, QDir.Filters?filters, QDir.SortFlags?sort, QObject?parent?=?None)` * `__init__ (self, QObject?parent?=?None)` * `int columnCount (self, QModelIndex?parent?=?QModelIndex())` * `QVariant data (self, QModelIndex?index, int?role?=?Qt.DisplayRole)` * `bool dropMimeData (self, QMimeData?data, Qt.DropAction?action, int?row, int?column, QModelIndex?parent)` * `QIcon fileIcon (self, QModelIndex?index)` * `QFileInfo fileInfo (self, QModelIndex?index)` * `QString fileName (self, QModelIndex?index)` * `QString filePath (self, QModelIndex?index)` * `QDir.Filters filter (self)` * `Qt.ItemFlags flags (self, QModelIndex?index)` * `bool hasChildren (self, QModelIndex?parent?=?QModelIndex())` * `QVariant headerData (self, int?section, Qt.Orientation?orientation, int?role?=?Qt.DisplayRole)` * `QFileIconProvider iconProvider (self)` * `QModelIndex index (self, int?row, int?column, QModelIndex?parent?=?QModelIndex())` * `QModelIndex index (self, QString?path, int?column?=?0)` * `bool isDir (self, QModelIndex?index)` * `bool isReadOnly (self)` * `bool lazyChildCount (self)` * `QMimeData mimeData (self, list-of-QModelIndex?indexes)` * `QStringList mimeTypes (self)` * `QModelIndex mkdir (self, QModelIndex?parent, QString?name)` * `QStringList nameFilters (self)` * `QModelIndex parent (self, QModelIndex?child)` * `QObject parent (self)` * `refresh (self, QModelIndex?parent?=?QModelIndex())` * `bool remove (self, QModelIndex?index)` * `bool resolveSymlinks (self)` * `bool rmdir (self, QModelIndex?index)` * `int rowCount (self, QModelIndex?parent?=?QModelIndex())` * `bool setData (self, QModelIndex?index, QVariant?value, int?role?=?Qt.EditRole)` * `setFilter (self, QDir.Filters?filters)` * `setIconProvider (self, QFileIconProvider?provider)` * `setLazyChildCount (self, bool?enable)` * `setNameFilters (self, QStringList?filters)` * `setReadOnly (self, bool?enable)` * `setResolveSymlinks (self, bool?enable)` * `setSorting (self, QDir.SortFlags?sort)` * `sort (self, int?column, Qt.SortOrder?order?=?Qt.AscendingOrder)` * `QDir.SortFlags sorting (self)` * `Qt.DropActions supportedDropActions (self)` * * * ## Detailed Description 該QDirModel類提供了在本地文件系統的數據模型。 QDirModel的使用是不推薦了。該[QFileSystemModel](qfilesystemmodel.html)類是一個更高性能的替代方案。這個類提供了訪問本地文件系統，提供了功能重命名和刪除文件和目錄，并創建新的目錄。在最簡單的情況下，它可以用于與合適的顯示部件作為一個瀏覽器或者文件管理器的一部分。 QDirModel保持與文件信息的高速緩存。緩存需要與被更新[refresh](qdirmodel.html#refresh)（）。 QDirModel可以使用所提供的標準接口來訪問[QAbstractItemModel](qabstractitemmodel.html)的，但它也提供了一些方便的功能所特有的一個目錄模型。該[fileInfo](qdirmodel.html#fileInfo)（）和[isDir](qdirmodel.html#isDir)（）函數提供了有關與模型中的項目相關的文件和目錄信息。目錄中可以創建和刪除使用[mkdir](qdirmodel.html#mkdir)（）[rmdir](qdirmodel.html#rmdir)（），模型會自動更新，以變化考慮在內。 **Note:**QDirModel需要一個GUI應用程序的一個實例。 * * * ## Type Documentation ``` QDirModel.Roles ``` | Constant | Value | | --- | --- | | `QDirModel.FileIconRole` | `Qt.DecorationRole` | | `QDirModel.FilePathRole` | `Qt.UserRole + 1` | | `QDirModel.FileNameRole` | ？ | * * * ## Method Documentation ``` QDirModel.__init__ (self, QStringList?nameFilters, QDir.Filters?filters, QDir.SortFlags?sort, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的目錄模式與給定_parent_。只有那些匹配的文件_nameFilters_和_filters_被包括在模型中。排序順序是由給定_sort_標志。 ``` QDirModel.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個目錄模式與給定_parent_。 ``` int QDirModel.columnCount (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.columnCount](qabstractitemmodel.html#columnCount)（）。返回列中的數_parent_模型項目。 ``` QVariant QDirModel.data (self, QModelIndex?index, int?role?=?Qt.DisplayRole) ``` 從重新實現[QAbstractItemModel.data](qabstractitemmodel.html#data)（）。返回的數據為模型項目_index_用給定的_role_。 **See also** [setData](qdirmodel.html#setData)（）。 ``` bool QDirModel.dropMimeData (self, QMimeData?data, Qt.DropAction?action, int?row, int?column, QModelIndex?parent) ``` 從重新實現[QAbstractItemModel.dropMimeData](qabstractitemmodel.html#dropMimeData)（）。處理_data_通過拖放操作，與給定的供給結束_action_過在由指定的模型中的行_row_和_column_以及由_parent_索引。 **See also** [supportedDropActions](qdirmodel.html#supportedDropActions)（）。 ``` QIcon QDirModel.fileIcon (self, QModelIndex?index) ``` [ 返回根據給定的存儲在模型中的圖標的項_index_。 ](qicon.html) ``` QFileInfo QDirModel.fileInfo (self, QModelIndex?index) ``` [ 返回文件信息指定模型_index_。 ](qfileinfo.html) [**Note:**如果模型指數代表了底層的文件系統的符號鏈接時，返回的文件信息，將包含有關符號鏈接本身的信息，而不管是否](qfileinfo.html)[resolveSymlinks](qdirmodel.html#resolveSymlinks-prop)啟用與否。 **See also** [QFileInfo.symLinkTarget](qfileinfo.html#symLinkTarget)（）。 ``` QString QDirModel.fileName (self, QModelIndex?index) ``` 返回根據存儲在模型中的項的名稱_index_給出。 ``` QString QDirModel.filePath (self, QModelIndex?index) ``` 返回根據存儲在模型中的項的路徑_index_給出。 ``` QDir.Filters QDirModel.filter (self) ``` [ 返回過濾器規格為目錄模式。 ](index.htm) [**See also**](index.htm) [setFilter](qdirmodel.html#setFilter)（）和[QDir.Filters](qdir.html#Filter-enum)。 ``` Qt.ItemFlags QDirModel.flags (self, QModelIndex?index) ``` [](index.htm) [從重新實現](index.htm)[QAbstractItemModel.flags](qabstractitemmodel.html#flags)（）。返回項標志為給定的_index_在模型中。 **See also** [Qt.ItemFlags](qt.html#ItemFlag-enum)。 ``` bool QDirModel.hasChildren (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.hasChildren](qabstractitemmodel.html#hasChildren)（）。返回True如果_parent_模型項目有孩子，否則返回False 。 ``` QVariant QDirModel.headerData (self, int?section, Qt.Orientation?orientation, int?role?=?Qt.DisplayRole) ``` 從重新實現[QAbstractItemModel.headerData](qabstractitemmodel.html#headerData)（）。返回下指定存儲的數據_role_為指定的_section_與給定的標頭_orientation_。 ``` QFileIconProvider QDirModel.iconProvider (self) ``` [ 返回文件的圖標提供商此目錄的模式。 ](qfileiconprovider.html) [**See also**](qfileiconprovider.html) [setIconProvider](qdirmodel.html#setIconProvider)（）。 ``` QModelIndex QDirModel.index (self, int?row, int?column, QModelIndex?parent?=?QModelIndex()) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemModel.index](qabstractitemmodel.html#index)（）。返回在模型項目索引項_parent_用給定的_row_和_column_。 ``` QModelIndex QDirModel.index (self, QString?path, int?column?=?0) ``` [ 這是一個重載函數。返回模型項指數為給定的_path_。 ``` bool QDirModel.isDir (self, QModelIndex?index) ``` 返回True如果模型項目_index_表示一個目錄，否則返回False 。 ``` bool QDirModel.isReadOnly (self) ``` ``` bool QDirModel.lazyChildCount (self) ``` ](qmodelindex.html) ``` QMimeData QDirModel.mimeData (self, list-of-QModelIndex?indexes) ``` [ 該_QMimeData_結果 ](qmimedata.html) [從重新實現](qmimedata.html)[QAbstractItemModel.mimeData](qabstractitemmodel.html#mimeData)（）。返回一個對象，該對象包含指定的序列化描述_indexes_。用于描述對應于該索引的項的格式是從所獲得的[mimeTypes](qdirmodel.html#mimeTypes)（）函數。如果索引的列表為空，則返回0 ，而不是一個序列化的空單。 ``` QStringList QDirModel.mimeTypes (self) ``` 從重新實現[QAbstractItemModel.mimeTypes](qabstractitemmodel.html#mimeTypes)（）。返回可用于描述在模型中的項列表的MIME類型的列表。 ``` QModelIndex QDirModel.mkdir (self, QModelIndex?parent, QString?name) ``` [ 創建具有一個目錄_name_在_parent_模型項目。 ``` QStringList QDirModel.nameFilters (self) ``` 返回應用到該模型中的名稱的過濾器列表。 ](qmodelindex.html) [**See also**](qmodelindex.html) [setNameFilters](qdirmodel.html#setNameFilters)（）。 ``` QModelIndex QDirModel.parent (self, QModelIndex?child) ``` [](qmodelindex.html) [從重新實現](qmodelindex.html)[QAbstractItemModel.parent](qabstractitemmodel.html#parent)（）。返回給定的父_child_模型項目。 ``` QObject QDirModel.parent (self) ``` [ ``` QDirModel.refresh (self, QModelIndex?parent?=?QModelIndex()) ``` ](qobject.html) [](qobject.html)[QDirModel](qdirmodel.html)緩存文件信息。這個函數更新緩存。該_parent_參數是從該模型被更新的目錄中，默認值將更新從文件系統（整個模型）的根目錄中的模型。 ``` bool QDirModel.remove (self, QModelIndex?index) ``` 刪除模型項目_index_從目錄模型和**deletes the corresponding file from the file system**，返回True，如果成功的。如果該項目不能被刪除，則返回False。 **Warning:**此函數刪除從文件系統中的文件，它**not**它們移動到那里他們可以恢復的位置。 **See also** [rmdir](qdirmodel.html#rmdir)（）。 ``` bool QDirModel.resolveSymlinks (self) ``` ``` bool QDirModel.rmdir (self, QModelIndex?index) ``` 刪除對應的模型項目的目錄_index_在目錄中的模型和**deletes the corresponding directory from the file system**，返回True，如果成功的。如果目錄不能被刪除，則返回False。 **Warning:**此函數刪除目錄的文件系統;它**not**它們移動到那里他們可以恢復的位置。 **See also** [remove](qdirmodel.html#remove)（）。 ``` int QDirModel.rowCount (self, QModelIndex?parent?=?QModelIndex()) ``` 從重新實現[QAbstractItemModel.rowCount](qabstractitemmodel.html#rowCount)（）。返回行的數目_parent_模型項目。 ``` bool QDirModel.setData (self, QModelIndex?index, QVariant?value, int?role?=?Qt.EditRole) ``` 從重新實現[QAbstractItemModel.setData](qabstractitemmodel.html#setData)（）。設置數據模型項目_index_用給定的_role_由所引用的數據_value_。成功返回True ，否則返回False 。 **See also** [data](qdirmodel.html#data)（）和[Qt.ItemDataRole](qt.html#ItemDataRole-enum)。 ``` QDirModel.setFilter (self, QDir.Filters?filters) ``` 設置目錄型號的過濾器，通過指定_filters_。請注意，您設置的過濾器應始終包含[QDir.AllDirs](qdir.html#Filter-enum)枚舉值，否則[QDirModel](qdirmodel.html)將無法讀取的目錄結構。 **See also** [filter](qdirmodel.html#filter)（）和[QDir.Filters](qdir.html#Filter-enum)。 ``` QDirModel.setIconProvider (self, QFileIconProvider?provider) ``` 設置_provider_文件圖標的目錄模式。 **See also** [iconProvider](qdirmodel.html#iconProvider)（）。 ``` QDirModel.setLazyChildCount (self, bool?enable) ``` ``` QDirModel.setNameFilters (self, QStringList?filters) ``` 設置名稱_filters_該目錄模型。 **See also** [nameFilters](qdirmodel.html#nameFilters)（）。 ``` QDirModel.setReadOnly (self, bool?enable) ``` ``` QDirModel.setResolveSymlinks (self, bool?enable) ``` ``` QDirModel.setSorting (self, QDir.SortFlags?sort) ``` 設置目錄模式的排序順序，通過指定_sort_。 **See also** [sorting](qdirmodel.html#sorting)（）和[QDir.SortFlags](qdir.html#SortFlag-enum)。 ``` QDirModel.sort (self, int?column, Qt.SortOrder?order?=?Qt.AscendingOrder) ``` 從重新實現[QAbstractItemModel.sort](qabstractitemmodel.html#sort)（）。排序的模型項目_column_使用_order_給出。該命令是在定義的值[Qt.SortOrder](qt.html#SortOrder-enum)。 ``` QDir.SortFlags QDirModel.sorting (self) ``` [ 返回用于目錄模型的排序方法。 ](index.htm) [**See also**](index.htm) [setSorting](qdirmodel.html#setSorting)（）和[QDir.SortFlags](qdir.html#SortFlag-enum)。 ``` Qt.DropActions QDirModel.supportedDropActions (self) ``` [](index.htm) [從重新實現](index.htm)[QAbstractItemModel.supportedDropActions](qabstractitemmodel.html#supportedDropActions)（）。返回此模型所支持的放置動作。 **See also** [Qt.DropActions](qt.html#DropAction-enum)。