Fileselector Button

../_images/fileselector-button-preview.png

Widget description

This is a button that, when clicked, creates an Elementary window (or inner window) with a Fileselector within.

When a file is chosen, the (inner) window is closed and the button emits a signal having the selected file as it’s event_info.

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.

Available styles

  • default
  • anchor
  • hoversel_vertical
  • hoversel_vertical_entry

Emitted signals

  • file,chosen - the user has selected a path which comes as the event_info data
  • language,changed - the program’s language changed

Layout text parts

  • default - Label of the fileselector_button

Layout content parts

  • icon - Icon of the fileselector_button

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

Inheritance diagram of FileselectorButton

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

Bases: efl.elementary.__init__.Button

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

The user has selected a path which comes as the event_info data.

callback_file_chosen_del(func)
callback_language_changed_add(func, *args, **kwargs)

The program’s language changed.

New in version 1.8.1.

callback_language_changed_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 button 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

window_size

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

Note

Setting this will only take any effect if the file selector button 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 button widget’s window

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

Note

Setting this will only take effect if the file selector button widget is not under “inwin mode”.

Type:string
window_title_get()
window_title_set(title)