fileselector_entry Module

Widget description

This is an entry made to be filled with or display a file system path string.

Besides the entry itself, the widget has a FileselectorButton on its side, which will raise an internal Fileselector, when clicked, for path selection aided by file system navigation.

This file selector may appear in an Elementary window or in an inner window. When a file is chosen from it, the (inner) window is closed and the selected file’s path string is exposed both as a smart event and as the new text on the entry.

This widget encapsulates operations on its internal file selector on its own API. There is less control over its file selector than that one would have instantiating one directly.

Smart callbacks one can register to:

• "changed" - The text within the entry was changed
• "activated" - The entry has had editing finished and changes are to be “committed”
• "press" - The entry has been clicked
• "longpressed" - The entry has been clicked (and held) for a couple seconds
• "clicked" - The entry has been clicked
• "clicked,double" - The entry has been double clicked
• "focused" - The entry has received focus
• "unfocused" - The entry has lost focus
• "selection,paste" - A paste action has occurred on the entry
• "selection,copy" - A copy action has occurred on the entry
• "selection,cut" - A cut action has occurred on the entry
• "unpressed" - The file selector entry’s button was released after being pressed.
• "file,chosen" - The user has selected a path via the file selector entry’s internal file selector, whose string comes as the event_info data.

Default text parts of the fileselector_button widget that you can use for are:

• “default” - Label of the fileselector_button

Default content parts of the fileselector_entry widget that you can use for are:

• “button icon” - Button icon of the fileselector_entry

class efl.elementary.fileselector_entry.FileselectorEntry

Bases: efl.elementary.layout_class.LayoutClass

This is the class that actually implements the widget.

Changed in version 1.8: Inherits from LayoutClass.

callback_activated_add()

The entry has had editing finished and changes are to be committed.

callback_changed_add()

The text within the entry was changed.

callback_clicked_add()

The entry has been clicked.

callback_clicked_double_add()

The entry has been double clicked.

callback_file_chosen_add()

The user has selected a path via the file selector entry’s internal file selector, whose string comes as the event_info data.

callback_focused_add()

The entry has received focus.

callback_longpressed_add()

The entry has been clicked (and held) for a couple seconds.

callback_press_add()

The entry has been clicked.

callback_selection_copy_add()

A copy action has occurred on the entry.

callback_selection_cut_add()

A cut action has occurred on the entry.

callback_selection_paste_add()

A paste action has occurred on the entry.

callback_unfocused_add()

The entry has lost focus.

callback_unpressed_add()

The file selector entry’s button was released after being pressed.

expandable

Enable/disable a tree view in the given file selector entry widget’s internal file selector

This has the same effect as efl.elementary.fileselector.Fileselector.expandable, but now applied to a file selector entry’s internal file selector.

Note

There’s no way to put a file selector entry’s internal file selector in “grid mode”, as one may do with “pure” file selectors.

Type :bool

folder_only

Whether a given file selector entry widget’s internal file selector is to display folders only or the directory contents, as well.

This has the same effect as efl.elementary.fileselector.Fileselector.folder_only, but now applied to a file selector entry’s internal file selector.

Type :bool

inwin_mode

Whether a given file selector entry widget’s internal file selector will raise an Elementary “inner window”, instead of a dedicated Elementary window. By default, it won’t.

See also

InnerWindow for more information on inner windows

Type :bool

is_save

Enable/disable the file name entry box where the user can type in a name for a file, in a given file selector entry widget’s internal file selector.

This has the same effect as efl.elementary.fileselector.Fileselector.is_save, but now applied to a file selector entry’s internal file selector.

Type :bool

path

The initial file system path and the entry’s path string for a given file selector entry widget

It must be a directory path, which will have the contents displayed initially in the file selector’s view. The default initial path is the "HOME" environment variable’s value.

Type :string

selected

The initial file system path for a given file selector entry widget

It must be a directory path, which will have the contents displayed initially in the file selector’s view. The default initial path is the "HOME" environment variable’s value.

Type :string

window_size

The size of a given file selector entry widget’s window, holding the file selector itself.

Note

it will only take any effect if the file selector entry widget is not under “inwin mode”. The default size for the window (when applicable) is 400x400 pixels.

Type :tuple of Evas_Coords (int)

window_title

The title for a given file selector entry widget’s window

This is the window’s title, when the file selector pops out after a click on the entry’s button. Those windows have the default (unlocalized) value of "Select a file" as titles.

Note

It will only take any effect if the file selector entry widget is not under “inwin mode”.

Type :string