File Manager
Aurora OS Application demonstrates a dialog for multiple selecting files and directories
Terms of Use and Participation
The source code of the project is provided under the license, which allows its use in third-party applications.
The contributor agreement documents the rights granted by contributors of the Open Mobile Platform.
Information about the contributors is specified in the AUTHORS file.
Code of conduct is a current set of rules of the Open Mobile Platform which informs you how we expect the members of the community will interact while contributing and communicating.
Project Structure
The project has a standard structure of an application based on C++ and QML for Aurora OS.
- ru.auroraos.FileManager.pro file describes the project structure for the qmake build system.
- icons directory contains application icons for supported screen resolutions.
-
qml directory contains the QML source code and the UI resources.
-
components directory contains file manager components.
- CategoryItem.qml file describes component for displaying information about home and root directories.
- DirectoryDialog.qml file describes page of files multiselect dialog.
- DirectoryListView.qml file describes a sortable list of files and subdirectories in a directory.istView.qml)** file describes list with home and root directories.
- PickerDialog.qml file describes dialog with list of selected files.
- PickerDialogHeader.qml file describes header of select dialog with accept and cancel buttons and count of selected items.
- SelectedContentModel.qml file describes listmodel for selected files.
- SortingPage.qml file describes page for sorting rules selecting.
- cover directory contains the application cover implementations.
-
dialogs
- MultiSelectionDialog.qml file describes first lair of file picker dialog.
- icons directory contains the additional custom UI icons.
-
pages directory contains the application pages.
- MainPage.qml file describes initial page of application, contains button to open file selecting dialog.
- FileManager.qml file provides the application window implementation.
-
components directory contains file manager components.
-
rpm directory contains the rpm-package build settings.
- ru.auroraos.FileManager.spec file is used by rpmbuild tool.
-
src directory contains the C++ source code.
- main.cpp file is the application entry point.
- translations directory contains the UI translation files.
- ru.auroraos.FileManager.desktop file defines the display and parameters for launching the application.
Filter by file extension
The project provides an ability of filtering files with certain extensions. All of the file extensions will be displayed in the current configuration.
The filters should be set when opening MultiSelectionDialog.qml.
In this case, the nameFilters
parameter should be used. Different file extensions can be set:
- *.doc
- *.txt
- etc.
Thus, applying the .pdf and .doc filters will be as follows:
var dialog = pageStack.push(Qt.resolvedUrl("../dialogs/MultiSelectionDialog.qml"), {
"nameFilters": ['*.pdf', '*.doc']
});
Usage
In order to select directories and files using the mixed selection dialog, you should:
- Go to the directory containing the necessary files and directories. Short clicks on the directory name are used to navigate through the file system.
- In the top menu, you can configure the visibility of hidden files and sort the list of files and directories.
- The required files can be selected with a short click, and directories by holding for a long time.
- When confirming the dialog, the paths of the selected directories and files will be returned.