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 changedactivated
- The entry has had editing finished and
changes are to be “committed”press
- The entry has been clickedlongpressed
- The entry has been clicked (and held) for a
couple secondsclicked
- The entry has been clickedclicked,double
- The entry has been double clickedselection,paste
- A paste action has occurred on the
entryselection,copy
- A copy action has occurred on the entryselection,cut
- A cut action has occurred on the entryunpressed
- 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_buttonbutton icon
- Button icon of the fileselector_entryThis 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.
Parameters: |
|
---|
callback_activated_add
(func, *args, **kwargs)¶See: | callback_activated_add() |
---|
Deprecated since version 1.9: Combine with Fileselector class instead
callback_activated_del
(func)¶Deprecated since version 1.9: Combine with Fileselector class instead
callback_changed_add
(func, *args, **kwargs)¶The text within the entry was changed.
callback_changed_del
(func)¶callback_clicked_add
(func, *args, **kwargs)¶The entry has been clicked.
callback_clicked_del
(func)¶callback_clicked_double_add
(func, *args, **kwargs)¶The entry has been double clicked.
callback_clicked_double_del
(func)¶callback_file_chosen_add
(func, *args, **kwargs)¶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
(func)¶callback_longpressed_add
(func, *args, **kwargs)¶The entry has been clicked (and held) for a couple seconds.
callback_longpressed_del
(func)¶callback_press_add
(func, *args, **kwargs)¶The entry has been clicked.
callback_press_del
(func)¶callback_selection_copy_add
(func, *args, **kwargs)¶A copy action has occurred on the entry.
callback_selection_copy_del
(func)¶callback_selection_cut_add
(func, *args, **kwargs)¶A cut action has occurred on the entry.
callback_selection_cut_del
(func)¶callback_selection_paste_add
(func, *args, **kwargs)¶A paste action has occurred on the entry.
callback_selection_paste_del
(func)¶callback_unpressed_add
(func, *args, **kwargs)¶The file selector entry’s button was released after being pressed.
callback_unpressed_del
(func)¶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
(expand)¶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
(folder_only)¶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
(inwin_mode)¶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
(is_save)¶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
(path)¶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
(path)¶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
(width, height)¶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
(title)¶