#include #include "elm_priv.h" /** * @defgroup File_Selector_Button File Selector Button * * A button that, when clicked, creates an Elementary window (or inner * window) with an Elementary File Selector within. When a file is * chosen, the (inner) window is closed and the selected file is * exposed as an evas_object_smart_callback_call() of the button. */ typedef struct _Widget_Data Widget_Data; struct _Widget_Data { Evas_Object *self, *btn, *fs, *fsw; const char *window_title; Evas_Coord w, h; struct { const char *path; Eina_Bool expandable:1; Eina_Bool folder_only:1; Eina_Bool is_save:1; } fsd; Eina_Bool inwin_mode:1; }; #define DEFAULT_WINDOW_TITLE "Select a file" static const char *widtype = NULL; static void _del_hook(Evas_Object *obj); static void _theme_hook(Evas_Object *obj); static void _disable_hook(Evas_Object *obj); static void _sizing_eval(Evas_Object *obj); static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info); static void _on_focus_hook(void *data, Evas_Object *obj); static void _selection_done(void *data, Evas_Object *obj, void *event_info); static void _activate(Widget_Data *wd); static const char SIG_FILE_CHOSEN[] = "file,chosen"; static const Evas_Smart_Cb_Description _signals[] = { {SIG_FILE_CHOSEN, "s"}, {NULL, NULL} }; static void _del_hook(Evas_Object *obj) { Evas_Object *win; Widget_Data *wd; wd = elm_widget_data_get(obj); if (!wd) return; if (wd->window_title) eina_stringshare_del(wd->window_title); if (wd->fsd.path) eina_stringshare_del(wd->fsd.path); if (wd->fs) { win = evas_object_data_del(obj, "win"); evas_object_del(win); } free(wd); } static void _on_focus_hook(void *data __UNUSED__, Evas_Object *obj) { Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; if (elm_widget_focus_get(obj)) elm_widget_focus_steal(wd->btn); } static void _theme_hook(Evas_Object *obj) { Widget_Data *wd = elm_widget_data_get(obj); char buf[4096]; if (!wd) return; snprintf(buf, sizeof(buf), "fileselector_button/%s", elm_widget_style_get(obj)); elm_object_style_set(wd->btn, buf); _sizing_eval(obj); } static void _disable_hook(Evas_Object *obj) { Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; elm_widget_disabled_set(wd->btn, elm_widget_disabled_get(obj)); } static void _sizing_eval(Evas_Object *obj) { Widget_Data *wd = elm_widget_data_get(obj); Evas_Coord minw = -1, minh = -1, maxw = -1, maxh = -1; if (!wd) return; evas_object_size_hint_min_get(wd->btn, &minw, &minh); evas_object_size_hint_max_get(wd->btn, &maxw, &maxh); evas_object_size_hint_min_set(obj, minw, minh); evas_object_size_hint_max_set(obj, maxw, maxh); } static void _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__) { Widget_Data *wd = elm_widget_data_get(data); if (!wd) return; _sizing_eval(data); } static void _activate_hook(Evas_Object *obj) { Widget_Data *wd; wd = elm_widget_data_get(obj); if (!wd) return; _activate(wd); } static void _button_clicked(void *data, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__) { _activate(data); } static Evas_Object * _parent_win_get(Evas_Object *obj) { while ((obj) && (strcmp(elm_widget_type_get(obj), "win"))) obj = elm_object_parent_widget_get(obj); return obj; } static Evas_Object * _new_window_add(Widget_Data *wd) { Evas_Object *win, *bg; win = elm_win_add(NULL, "fileselector_button", ELM_WIN_DIALOG_BASIC); elm_win_title_set(win, wd->window_title); elm_win_autodel_set(win, EINA_TRUE); bg = elm_bg_add(win); elm_win_resize_object_add(win, bg); evas_object_size_hint_weight_set(bg, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND); evas_object_show(bg); evas_object_resize(win, wd->w, wd->h); return win; } static void _activate(Widget_Data *wd) { Eina_Bool is_inwin = EINA_FALSE; if (wd->fs) return; if (wd->inwin_mode) { wd->fsw = _parent_win_get(wd->self); if (!wd->fsw) wd->fsw = _new_window_add(wd); else { wd->fsw = elm_win_inwin_add(wd->fsw); is_inwin = EINA_TRUE; } } else wd->fsw = _new_window_add(wd); wd->fs = elm_fileselector_add(wd->fsw); elm_fileselector_expandable_set(wd->fs, wd->fsd.expandable); elm_fileselector_folder_only_set(wd->fs, wd->fsd.folder_only); elm_fileselector_is_save_set(wd->fs, wd->fsd.is_save); elm_fileselector_selected_set(wd->fs, wd->fsd.path); evas_object_size_hint_weight_set(wd->fs, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND); evas_object_size_hint_align_set(wd->fs, EVAS_HINT_FILL, EVAS_HINT_FILL); evas_object_smart_callback_add(wd->fs, "done", _selection_done, wd); evas_object_show(wd->fs); if (is_inwin) { elm_win_inwin_content_set(wd->fsw, wd->fs); elm_win_inwin_activate(wd->fsw); } else { elm_win_resize_object_add(wd->fsw, wd->fs); evas_object_show(wd->fsw); } } static void _selection_done(void *data, Evas_Object *obj __UNUSED__, void *event_info) { const char *file = event_info; Widget_Data *wd = data; Evas_Object *del; if (!wd) return; if (file) eina_stringshare_replace(&wd->fsd.path, file); del = wd->fsw; wd->fs = NULL; wd->fsw = NULL; evas_object_del(del); evas_object_smart_callback_call(wd->self, SIG_FILE_CHOSEN, (void *)wd->fsd.path); } /** * Add a new file selector button into the parent object. * * @param parent The parent object * @return The new object or NULL if it cannot be created * * @ingroup File_Selector_Button */ EAPI Evas_Object * elm_fileselector_button_add(Evas_Object *parent) { Evas_Object *obj; Evas *e; Widget_Data *wd; wd = ELM_NEW(Widget_Data); wd->window_title = eina_stringshare_add(DEFAULT_WINDOW_TITLE); wd->fsd.path = eina_stringshare_add(getenv("HOME")); wd->fsd.expandable = _elm_config->fileselector_expand_enable; wd->inwin_mode = _elm_config->inwin_dialogs_enable; wd->w = 400; wd->h = 400; e = evas_object_evas_get(parent); obj = elm_widget_add(e); ELM_SET_WIDTYPE(widtype, "fileselector_button"); elm_widget_type_set(obj, "fileselector_button"); elm_widget_sub_object_add(parent, obj); wd->self = obj; elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL); elm_widget_data_set(obj, wd); elm_widget_del_hook_set(obj, _del_hook); elm_widget_theme_hook_set(obj, _theme_hook); elm_widget_disable_hook_set(obj, _disable_hook); elm_widget_can_focus_set(obj, EINA_TRUE); elm_widget_activate_hook_set(obj, _activate_hook); wd->btn = elm_button_add(parent); elm_widget_resize_object_set(obj, wd->btn); evas_object_event_callback_add(wd->btn, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj); evas_object_smart_callback_add(wd->btn, "clicked", _button_clicked, wd); elm_widget_sub_object_add(obj, wd->btn); _theme_hook(obj); evas_object_smart_callbacks_descriptions_set(obj, _signals); return obj; } /** * Set the label used in the file selector button. * * @param obj The button object * @param label The text label text to be displayed on the button * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; elm_button_label_set(wd->btn, label); } /** * Get the label used in the file selector button. * * @param obj The button object * @return The button label * * @ingroup File_Selector_Button */ EAPI const char * elm_fileselector_button_label_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) NULL; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return NULL; return elm_button_label_get(wd->btn); } /** * Set the title of the file selector button's window. * * @param obj The button object * @param title The title string * * Note that it will only take any effect if the fileselector button * not at "inwin mode". * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_window_title_set(Evas_Object *obj, const char *title) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; eina_stringshare_replace(&wd->window_title, title); if (wd->fsw) elm_win_title_set(wd->fsw, wd->window_title); } /** * Get the title of the file selector button's window. * * @param obj The button object * @return Title of the file selector button's window * * @ingroup File_Selector_Button */ EAPI const char * elm_fileselector_button_window_title_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) NULL; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return NULL; return wd->window_title; } /** * Set the size of the file selector button's window. * * @param obj The button object * @param width The width * @param height The height * * Note that it will only take any effect if the fileselector button not at * "inwin mode". Default size for the window (when applicable) is 400x400. * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_window_size_set(Evas_Object *obj, Evas_Coord width, Evas_Coord height) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; wd->w = width; wd->h = height; if (wd->fsw) evas_object_resize(wd->fsw, wd->w, wd->h); } /** * Get the size of the file selector button's window. * * @param obj The button object * @param width Pointer into which to store the width value * @param height Pointer into which to store the height value * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_window_size_get(const Evas_Object *obj, Evas_Coord *width, Evas_Coord *height) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; if (width) *width = wd->w; if (height) *height = wd->h; } /** * Set the starting path of the file selector button's window. * * @param obj The button object * @param path The path string * * It must be a directory path. * Default path is "HOME" environment variable's value. * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_path_set(Evas_Object *obj, const char *path) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; eina_stringshare_replace(&wd->fsd.path, path); if (wd->fs) elm_fileselector_selected_set(wd->fs, wd->fsd.path); } /** * Get the last path of the file selector button's window. * * @param obj The button object * * @ingroup File_Selector_Button */ EAPI const char * elm_fileselector_button_path_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) NULL; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return NULL; return wd->fsd.path; } /** * Set whether the button's file selector is to present itself as an * Elementary Generic List (which will expand its entries for nested * directories) or as canonical list, which will be rendered again * with the contents of each selected directory. * * @param obj The button object * @param value The expandable flag * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_expandable_set(Evas_Object *obj, Eina_Bool value) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; wd->fsd.expandable = value; if (wd->fs) elm_fileselector_expandable_set(wd->fs, wd->fsd.expandable); } /** * Get the button's file selector expandable flag. * * @param obj The button object * @return value The expandable flag * * @ingroup File_Selector_Button */ EAPI Eina_Bool elm_fileselector_button_expandable_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return EINA_FALSE; return wd->fsd.expandable; } /** * Set whether the button's file selector list is to display folders * only or the directory contents, as well. * * @param obj The button object * @param value The "folder only" flag * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_folder_only_set(Evas_Object *obj, Eina_Bool value) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; wd->fsd.folder_only = value; if (wd->fs) elm_fileselector_folder_only_set(wd->fs, wd->fsd.folder_only); } /** * Get the button's file selector "folder only" flag. * * @param obj The button object * @return value The "folder only" flag * * @ingroup File_Selector_Button */ EAPI Eina_Bool elm_fileselector_button_folder_only_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return EINA_FALSE; return wd->fsd.folder_only; } /** * Set whether the button's file selector has an editable text entry * which will hold its current selection. * * @param obj The button object * @param value The "is save" flag * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_is_save_set(Evas_Object *obj, Eina_Bool value) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; wd->fsd.is_save = value; if (wd->fs) elm_fileselector_is_save_set(wd->fs, wd->fsd.is_save); } /** * Get the button's file selector "is save" flag. * * @param obj The button object * @return value The "is save" flag * * @ingroup File_Selector_Button */ EAPI Eina_Bool elm_fileselector_button_is_save_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return EINA_FALSE; return wd->fsd.is_save; } /** * Set whether the button's file selector will raise an Elementary * Inner Window, instead of a dedicated Elementary Window. By default, * it won't. * * @param obj The button object * @param value The "inwin mode" flag * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_inwin_mode_set(Evas_Object *obj, Eina_Bool value) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return; wd->inwin_mode = value; } /** * Get the button's file selector "inwin mode" flag. * * @param obj The button object * @return value The "inwin mode" flag * * @ingroup File_Selector_Button */ EAPI Eina_Bool elm_fileselector_button_inwin_mode_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return EINA_FALSE; return wd->inwin_mode; } /** * Set the icon used for the button * * Once the icon object is set, a previously set one will be deleted. * If you want to keep that old content object, use the * elm_fileselector_button_icon_unset() function. * * @param obj The button object * @param icon The icon object for the button * * @ingroup File_Selector_Button */ EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon) { ELM_CHECK_WIDTYPE(obj, widtype); Widget_Data *wd = elm_widget_data_get(obj); if (!wd) { evas_object_del(icon); return; } elm_button_icon_set(wd->btn, icon); } /** * Get the icon used for the button * * @param obj The button object * @return The icon object that is being used * * @ingroup File_Selector_Button */ EAPI Evas_Object * elm_fileselector_button_icon_get(const Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) NULL; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return NULL; return elm_button_icon_get(wd->btn); } /** * Unset the icon used for the button * * Unparent and return the icon object which was set for this widget. * * @param obj The button object * @return The icon object that was being used * * @ingroup File_Selector_Button */ EAPI Evas_Object * elm_fileselector_button_icon_unset(Evas_Object *obj) { ELM_CHECK_WIDTYPE(obj, widtype) NULL; Widget_Data *wd = elm_widget_data_get(obj); if (!wd) return NULL; return elm_button_icon_unset(wd->btn); }