The FolderListModel provides a model of the contents of a file system folder. 更多...
| import 語句： | import Qt.labs.folderlistmodel 2.15 |
FolderListModel provides access to information about the contents of a folder in the local file system, exposing a list of files to views and other data components.
注意：
This type is made available by importing the
Qt.labs.folderlistmodel
模塊。
Elements in the Qt.labs module are not guaranteed to remain compatible in future versions.
import Qt.labs.folderlistmodel 2.15
The folder property specifies the folder to access. Information about the files and directories in the folder is supplied via the model's interface. Components access names and paths via the following roles:
fileName
filePath
fileURL
(since Qt 5.2; deprecated since Qt 5.15)
fileUrl
(since Qt 5.15)
fileBaseName
fileSuffix
fileSize
fileModified
fileAccessed
fileIsDir
Additionally a file entry can be differentiated from a folder entry via the isFolder() 方法。
Various properties can be set to filter the number of files and directories exposed by the model.
The nameFilters property can be set to contain a list of wildcard filters that are applied to names of files and directories, causing only those that match the filters to be exposed.
Directories can be included or excluded using the showDirs property, navigation directories can also be excluded by setting the showDotAndDotDot property to false, hidden files can be included or excluded using the showHidden 特性。
It is sometimes useful to limit the files and directories exposed to those that the user can access. The showOnlyReadable property can be set to enable this feature.
The following example shows a FolderListModel being used to provide a list of QML files in a ListView :
import QtQuick 2.15 import Qt.labs.folderlistmodel 2.15 ListView { width: 200; height: 400 FolderListModel { id: folderModel nameFilters: ["*.qml"] } Component { id: fileDelegate Text { text: fileName } } model: folderModel delegate: fileDelegate }
Qt uses "/" as a universal directory separator in the same way that "/" is used as a path separator in URLs. If you always use "/" as a directory separator, Qt will translate your paths to conform to the underlying operating system.
另請參閱 QML Data Models .
|
caseSensitive : bool |
Use case sensitive pattern matching.
默認情況下，此特性為 true。
該特性在 Qt 5.7 引入。
|
count : int |
Returns the number of items in the current folder that match the filter criteria.
|
folder : url |
The folder property holds a URL for the folder that the model currently provides.
The value must be a
file
: or
qrc
: URL, or a relative URL.
The default value is an invalid URL.
The nameFilters property contains a list of file name filters. The filters may include the ? and * wildcards.
The example below filters on PNG and JPEG files:
FolderListModel { nameFilters: [ "*.png", "*.jpg" ] }
注意： Directories are not excluded by filters.
|
parentFolder : url |
Returns the URL of the parent of the current folder .
|
rootFolder : url |
When this property is set, the given folder will be treated as the root in the file system, so that you can only traverse subfolders within it.
|
showDirs : bool |
If true, directories are included in the model; otherwise only files are included.
默認情況下，此特性為 true。
注意， nameFilters are not applied to directories.
另請參閱 showDotAndDotDot .
|
showDirsFirst : bool |
If true, if directories are included in the model they will always be shown first, then the files.
默認情況下，此特性為 false。
|
showDotAndDotDot : bool |
If true, the "." and ".." directories are included in the model; otherwise they are excluded.
默認情況下，此特性為 false。
另請參閱 showDirs .
|
showFiles : bool |
If true, files are included in the model; otherwise only directories are included.
默認情況下，此特性為 true。
該特性在 Qt 5.2 引入。
另請參閱 showDirs .
|
showHidden : bool |
If true, hidden files and directories are included in the model; otherwise they are excluded.
默認情況下，此特性為 false。
該特性在 Qt 5.2 引入。
|
showOnlyReadable : bool |
If true, only readable files and directories are shown; otherwise all files and directories are shown.
默認情況下，此特性為 false。
另請參閱 showDirs .
|
sortCaseSensitive : bool |
若設為
true
, the sort is case sensitive. This property is
true
在默認情況下。
該特性在 Qt 5.12 引入。
|
sortField : enumeration |
The sortField property contains field to use for sorting. sortField may be one of:
另請參閱 sortReversed .
|
sortReversed : bool |
If set to true, reverses the sort order. The default is false.
另請參閱 sortField .
|
status : enumeration |
This property holds the status of folder reading. It can be one of:
Use this status to provide an update or respond to the status change in some way. For example, you could:
State { name: 'loaded'; when: folderModel.status == FolderListModel.Ready }
onStatusChanged
signal handler:
FolderListModel { id : folderModel onStatusChanged : if ( folderModel . status == FolderListModel . Ready ) console . log ( 'Loaded' ) }
Text { text: folderModel.status == FolderListModel.Ready ? 'Loaded' : 'Not loaded' }
該特性在 Qt 5.11 引入。
Returns the folder property 為給定 index . The following properties are available:
fileName
filePath
fileURL
(since Qt 5.2; deprecated since Qt 5.15)
fileUrl
(since Qt 5.15)
fileBaseName
fileSuffix
fileSize
fileModified
fileAccessed
fileIsDir
返迴索引為給定 file URL if the model contains it, or -1 if not.
該方法在 Qt 5.6 引入。
Returns true if the entry index is a folder; otherwise returns false.