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.
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.
default
- Label of the fileselector_button
button icon
- Button icon of the fileselector_entry
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)
efl.elementary.
FileselectorEntry
(Object parent, *args, **kwargs)¶Bases: efl.elementary.__init__.LayoutClass
Changed in version 1.8: Inherits from LayoutClass.
parent (efl.evas.Object
) – The parent object
**kwargs – All the remaining keyword arguments are interpreted as properties of the instance
callback_activated_add
¶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
¶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
¶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
bool
inwin_mode_get
¶inwin_mode_set
¶is_save
¶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
¶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
¶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.
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”.
string
window_title_get
¶window_title_set
¶