Fileselector Entry

../_images/fileselector-entry-preview.png

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.

Emitted signals

  • 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
  • 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.

Layout text parts

  • default - Label of the fileselector_button

Layout content parts

  • button icon - Button icon of the fileselector_entry

Fileselector Interface

This widget supports the fileselector interface.

If you wish to control the fileselector part using these functions, inherit both the widget class and the Fileselector class using multiple inheritance, for example:

class CustomFileselectorButton(Fileselector, FileselectorButton):
    def __init__(self, canvas, *args, **kwargs):
        FileselectorButton.__init__(self, canvas)

Inheritance diagram

class efl.elementary.FileselectorEntry(Object parent, *args, **kwargs)

Bases: efl.elementary.__init__.LayoutClass

Changed in version 1.8: Inherits from LayoutClass.

Parameters:
  • parent (efl.evas.Object) – The parent object
  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance
callback_activated_add
See:callback_activated_add()

Deprecated since version 1.9: Combine with Fileselector class instead

callback_activated_del

Deprecated since version 1.9: Combine with Fileselector class instead

callback_changed_add

The text within the entry was changed.

callback_changed_del
callback_clicked_add

The entry has been clicked.

callback_clicked_del
callback_clicked_double_add

The entry has been double clicked.

callback_clicked_double_del
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_file_chosen_del
callback_longpressed_add

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

callback_longpressed_del
callback_press_add

The entry has been clicked.

callback_press_del
callback_selection_copy_add

A copy action has occurred on the entry.

callback_selection_copy_del
callback_selection_cut_add

A cut action has occurred on the entry.

callback_selection_cut_del
callback_selection_paste_add

A paste action has occurred on the entry.

callback_selection_paste_del
callback_unpressed_add

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

callback_unpressed_del
expandable
See:expandable

Deprecated since version 1.9: Combine with Fileselector class instead

expandable_get

Deprecated since version 1.9: Combine with Fileselector class instead

expandable_set

Deprecated since version 1.9: Combine with Fileselector class instead

folder_only
See:folder_only

Deprecated since version 1.9: Combine with Fileselector class instead

folder_only_get

Deprecated since version 1.9: Combine with Fileselector class instead

folder_only_set

Deprecated since version 1.9: Combine with Fileselector class instead

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
inwin_mode_get
inwin_mode_set
is_save
See:is_save

Deprecated since version 1.9: Combine with Fileselector class instead

is_save_get

Deprecated since version 1.9: Combine with Fileselector class instead

is_save_set

Deprecated since version 1.9: Combine with Fileselector class instead

path
See:path

Deprecated since version 1.9: Combine with Fileselector class instead

path_get

Deprecated since version 1.9: Combine with Fileselector class instead

path_set

Deprecated since version 1.9: Combine with Fileselector class instead

selected
See:selected

Deprecated since version 1.9: Combine with Fileselector class instead

selected_get
selected_set
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_size_get
window_size_set
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
window_title_get
window_title_set