Fileselector¶

Widget description¶
A file selector is a widget that allows a user to navigate through a file system, reporting file selections back via its API.
It contains shortcut buttons for home directory (~) and to jump one
directory upwards (..), as well as cancel/ok buttons to confirm/cancel a
given selection. After either one of those two former actions, the file
selector will issue its "done"
smart callback.
There’s a text entry on it, too, showing the name of the current
selection. There’s the possibility of making it editable, so it is
useful on file saving dialogs on applications, where one gives a file
name to save contents to, in a given directory in the system. This
custom file name will be reported on the "done"
smart callback
(explained in sequence).
Finally, it has a view to display file system items into in two possible forms:
list
grid
If Elementary is built with support of the Ethumb thumbnailing library, the second form of view will display preview thumbnails of files which it supports.
Emitted signals¶
activated
- the user activated a file. This can happen by double-clicking or pressing Enter key. (event_info is a string with the activated file path)selected
- the user has clicked on a file (when not in folders-only mode) or directory (when in folders-only mode)directory,open
- the list has been populated with new content (event_info is the directory’s path)done
- the user has clicked on the “ok” or “cancel” buttons (event_info is the selection’s path)
Layout text parts¶
ok
- OK button label if the ok button is set. (since 1.8)cancel
- Cancel button label if the cancel button is set. (since 1.8)
Enumerations¶
Fileselector modes¶
- efl.elementary.ELM_FILESELECTOR_LIST¶
Layout as a list
- efl.elementary.ELM_FILESELECTOR_GRID¶
Layout as a grid
Fileselector sort method¶
- efl.elementary.ELM_FILESELECTOR_SORT_BY_FILENAME_ASC¶
Sort by filename in ascending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_FILENAME_DESC¶
Sort by filename in descending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_TYPE_ASC¶
Sort by file type in ascending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_TYPE_DESC¶
Sort by file type in descending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_SIZE_ASC¶
Sort by file size in ascending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_SIZE_DESC¶
Sort by file size in descending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_MODIFIED_ASC¶
Sort by file modification date in ascending order
Added in version 1.9.
- efl.elementary.ELM_FILESELECTOR_SORT_BY_MODIFIED_DESC¶
Sort by file modification date in descending order
Added in version 1.9.