1 #include <Elementary.h>
5 * @defgroup File_Selector_Entry File Selector Entry
7 * An entry that shows to enter/display path and have an associated
8 * button to allow selecting the file from a dialog.
10 * The button, when clicked, creates an Elementary window (or inner
11 * window) with an Elementary File Selector within. When a file is
12 * chosen, the (inner) window is closed and the selected file is
13 * exposed as an evas_object_smart_callback_call() of the button.
16 typedef struct _Widget_Data Widget_Data;
25 static const char *widtype = NULL;
27 static const char SIG_CHANGED[] = "changed";
28 static const char SIG_ACTIVATED[] = "activated";
29 static const char SIG_PRESS[] = "press";
30 static const char SIG_LONGPRESSED[] = "longpressed";
31 static const char SIG_CLICKED[] = "clicked";
32 static const char SIG_CLICKED_DOUBLE[] = "clicked,double";
33 static const char SIG_FOCUSED[] = "focused";
34 static const char SIG_UNFOCUSED[] = "unfocused";
35 static const char SIG_SELECTION_PASTE[] = "selection,paste";
36 static const char SIG_SELECTION_COPY[] = "selection,copy";
37 static const char SIG_SELECTION_CUT[] = "selection,cut";
38 static const char SIG_UNPRESSED[] = "unpressed";
39 static const char SIG_FILE_CHOSEN[] = "file,chosen";
40 static const Evas_Smart_Cb_Description _signals[] =
45 {SIG_LONGPRESSED, ""},
47 {SIG_CLICKED_DOUBLE, ""},
50 {SIG_SELECTION_PASTE, ""},
51 {SIG_SELECTION_COPY, ""},
52 {SIG_SELECTION_CUT, ""},
54 {SIG_FILE_CHOSEN, "s"},
58 #define SIG_FWD(name) \
60 _##name##_fwd(void *data, Evas_Object *obj __UNUSED__, void *event_info) \
62 evas_object_smart_callback_call(data, SIG_##name, event_info); \
68 SIG_FWD(CLICKED_DOUBLE)
71 SIG_FWD(SELECTION_PASTE)
72 SIG_FWD(SELECTION_COPY)
73 SIG_FWD(SELECTION_CUT)
77 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
80 _FILE_CHOSEN_fwd(void *data, Evas_Object *obj __UNUSED__, void *event_info)
82 Widget_Data *wd = elm_widget_data_get(data);
83 const char *file = event_info;
84 elm_entry_entry_set(wd->entry, file);
85 evas_object_smart_callback_call(data, SIG_FILE_CHOSEN, event_info);
89 _ACTIVATED_fwd(void *data, Evas_Object *obj __UNUSED__, void *event_info)
91 Widget_Data *wd = elm_widget_data_get(data);
92 const char *file = elm_entry_entry_get(wd->entry);
93 elm_fileselector_button_path_set(wd->button, file);
94 evas_object_smart_callback_call(data, SIG_ACTIVATED, event_info);
98 _del_hook(Evas_Object *obj)
100 Widget_Data *wd = elm_widget_data_get(obj);
105 _sizing_eval(Evas_Object *obj)
107 Widget_Data *wd = elm_widget_data_get(obj);
108 Evas_Coord minw = -1, minh = -1;
110 edje_object_size_min_calc(wd->edje, &minw, &minh);
111 evas_object_size_hint_min_set(obj, minw, minh);
112 evas_object_size_hint_max_set(obj, -1, -1);
116 _elm_fileselector_entry_focus_next_hook(const Evas_Object *obj, Elm_Focus_Direction dir, Evas_Object **next)
118 Widget_Data *wd = elm_widget_data_get(obj);
123 Evas_Object *chain[2];
126 if (dir == ELM_FOCUS_PREVIOUS)
128 chain[0] = wd->button;
129 chain[1] = wd->entry;
131 else if (dir == ELM_FOCUS_NEXT)
133 chain[0] = wd->entry;
134 chain[1] = wd->button;
139 unsigned char i = elm_widget_focus_get(chain[1]);
141 if (elm_widget_focus_next_get(chain[i], dir, next))
146 Evas_Object *to_focus;
147 if (elm_widget_focus_next_get(chain[i], dir, &to_focus))
157 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
159 Widget_Data *wd = elm_widget_data_get(obj);
161 elm_widget_mirrored_set(wd->button, rtl);
162 edje_object_mirrored_set(wd->edje, rtl);
166 _theme_hook(Evas_Object *obj)
168 Widget_Data *wd = elm_widget_data_get(obj);
169 const char *style = elm_widget_style_get(obj);
173 _elm_widget_mirrored_reload(obj);
174 _mirrored_set(obj, elm_widget_mirrored_get(obj));
176 _elm_theme_object_set(obj, wd->edje, "fileselector_entry", "base", style);
177 if (elm_object_disabled_get(obj))
178 edje_object_signal_emit(wd->edje, "elm,state,disabled", "elm");
180 if (!style) style = "default";
181 snprintf(buf, sizeof(buf), "fileselector_entry/%s", style);
182 elm_widget_style_set(wd->button, buf);
183 elm_widget_style_set(wd->entry, buf);
185 edje_object_part_swallow(obj, "elm.swallow.button", wd->button);
186 edje_object_part_swallow(obj, "elm.swallow.entry", wd->entry);
188 edje_object_message_signal_process(wd->edje);
189 edje_object_scale_set
190 (wd->edje, elm_widget_scale_get(obj) * _elm_config->scale);
195 _disable_hook(Evas_Object *obj)
197 Widget_Data *wd = elm_widget_data_get(obj);
198 Eina_Bool val = elm_widget_disabled_get(obj);
201 edje_object_signal_emit(wd->edje, "elm,state,disabled", "elm");
203 edje_object_signal_emit(wd->edje, "elm,state,enabled", "elm");
205 elm_widget_disabled_set(wd->button, val);
206 elm_widget_disabled_set(wd->entry, val);
210 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
216 _elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *item, const char *label)
218 ELM_CHECK_WIDTYPE(obj, widtype);
219 Widget_Data *wd = elm_widget_data_get(obj);
220 if (item && strcmp(item, "default")) return;
222 elm_object_text_set(wd->button, label);
226 _elm_fileselector_entry_button_label_get(const Evas_Object *obj, const char *item)
228 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
229 Widget_Data *wd = elm_widget_data_get(obj);
230 if (item && strcmp(item, "default")) return NULL;
231 if (!wd) return NULL;
232 return elm_object_text_get(wd->button);
236 * Add a new file selector entry into the parent object.
238 * @param parent The parent object
239 * @return The new object or NULL if it cannot be created
241 * @ingroup File_Selector_Entry
244 elm_fileselector_entry_add(Evas_Object *parent)
250 ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
252 ELM_SET_WIDTYPE(widtype, "fileselector_entry");
253 elm_widget_type_set(obj, "fileselector_entry");
254 elm_widget_sub_object_add(parent, obj);
255 elm_widget_data_set(obj, wd);
256 elm_widget_del_hook_set(obj, _del_hook);
257 elm_widget_disable_hook_set(obj, _disable_hook);
258 elm_widget_focus_next_hook_set(obj, _elm_fileselector_entry_focus_next_hook);
259 elm_widget_can_focus_set(obj, EINA_FALSE);
260 elm_widget_theme_hook_set(obj, _theme_hook);
261 elm_widget_text_set_hook_set(obj, _elm_fileselector_entry_button_label_set);
262 elm_widget_text_get_hook_set(obj, _elm_fileselector_entry_button_label_get);
264 wd->edje = edje_object_add(e);
265 _elm_theme_object_set(obj, wd->edje, "fileselector_entry", "base", "default");
266 elm_widget_resize_object_set(obj, wd->edje);
268 wd->button = elm_fileselector_button_add(obj);
269 elm_widget_mirrored_automatic_set(wd->button, EINA_FALSE);
270 ELM_SET_WIDTYPE(widtype, "fileselector_entry");
271 elm_widget_style_set(wd->button, "fileselector_entry/default");
272 edje_object_part_swallow(wd->edje, "elm.swallow.button", wd->button);
273 elm_widget_sub_object_add(obj, wd->button);
274 evas_object_event_callback_add
275 (wd->button, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj);
276 elm_fileselector_button_expandable_set(wd->button,
277 _elm_config->fileselector_expand_enable);
279 #define SIG_FWD(name) \
280 evas_object_smart_callback_add(wd->button, SIG_##name, _##name##_fwd, obj)
283 SIG_FWD(FILE_CHOSEN);
286 wd->entry = elm_entry_add(obj);
287 elm_entry_scrollable_set(wd->entry, EINA_TRUE);
288 elm_widget_mirrored_automatic_set(wd->entry, EINA_FALSE);
289 elm_widget_style_set(wd->entry, "fileselector_entry/default");
290 elm_entry_single_line_set(wd->entry, EINA_TRUE);
291 elm_entry_editable_set(wd->entry, EINA_TRUE);
292 edje_object_part_swallow(wd->edje, "elm.swallow.entry", wd->entry);
293 elm_widget_sub_object_add(obj, wd->entry);
294 evas_object_event_callback_add
295 (wd->entry, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj);
297 #define SIG_FWD(name) \
298 evas_object_smart_callback_add(wd->entry, SIG_##name, _##name##_fwd, obj)
302 SIG_FWD(LONGPRESSED);
304 SIG_FWD(CLICKED_DOUBLE);
307 SIG_FWD(SELECTION_PASTE);
308 SIG_FWD(SELECTION_COPY);
309 SIG_FWD(SELECTION_CUT);
312 _mirrored_set(obj, elm_widget_mirrored_get(obj));
315 // TODO: convert Elementary to subclassing of Evas_Smart_Class
316 // TODO: and save some bytes, making descriptions per-class and not instance!
317 evas_object_smart_callbacks_descriptions_set(obj, _signals);
322 * Set the label used in the file selector entry.
324 * @param obj The entry object
325 * @param label The text label text to be displayed on the entry
327 * @ingroup File_Selector_Entry
328 * @deprecated use elm_object_text_set() instead.
331 elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label)
333 _elm_fileselector_entry_button_label_set(obj, NULL, label);
337 elm_fileselector_entry_button_label_get(const Evas_Object *obj)
339 return _elm_fileselector_entry_button_label_get(obj, NULL);
343 * Set the path to start the entry's file selector with, when clicked.
345 * @param obj The entry object
346 * @param path Path to a file/directory
348 * Default path is "HOME" environment variable's value.
350 * @ingroup File_Selector_Entry
353 elm_fileselector_entry_selected_set(Evas_Object *obj, const char *path)
355 ELM_CHECK_WIDTYPE(obj, widtype);
356 Widget_Data *wd = elm_widget_data_get(obj);
358 elm_fileselector_button_path_set(wd->button, path);
362 * Get the <b>last</b> path which the entry's file selector was set to.
364 * @param obj The entry object
365 * @param path Path to a file/directory
367 * Default path is "HOME" environment variable's value.
369 * @ingroup File_Selector_Entry
372 elm_fileselector_entry_selected_get(const Evas_Object *obj)
374 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
375 Widget_Data *wd = elm_widget_data_get(obj);
376 if (!wd) return NULL;
377 return elm_fileselector_button_path_get(wd->button);
381 * Set the title of the file selector entry's window.
383 * @param obj The entry object
384 * @param title The title string
386 * Note that it will only take any effect if the fileselector entry
387 * not at "inwin mode".
389 * @ingroup File_Selector_Entry
392 elm_fileselector_entry_window_title_set(Evas_Object *obj, const char *title)
394 ELM_CHECK_WIDTYPE(obj, widtype);
395 Widget_Data *wd = elm_widget_data_get(obj);
397 elm_fileselector_button_window_title_set(wd->button, title);
401 * Get the title of the file selector entry's window.
403 * @param obj The entry object
405 * @ingroup File_Selector_Entry
408 elm_fileselector_entry_window_title_get(const Evas_Object *obj)
410 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
411 Widget_Data *wd = elm_widget_data_get(obj);
412 if (!wd) return NULL;
413 return elm_fileselector_button_window_title_get(wd->button);
417 * Set the size of the file selector entry's window.
419 * @param obj The entry object
420 * @param width The width
421 * @param height The height
423 * Note that it will only take any effect if the fileselector entry not at
424 * "inwin mode". Default size for the window (when applicable) is 400x400.
426 * @ingroup File_Selector_Entry
429 elm_fileselector_entry_window_size_set(Evas_Object *obj, Evas_Coord width, Evas_Coord height)
431 ELM_CHECK_WIDTYPE(obj, widtype);
432 Widget_Data *wd = elm_widget_data_get(obj);
434 elm_fileselector_button_window_size_set(wd->button, width, height);
438 * Get the size of the file selector entry's window.
440 * @param obj The entry object
441 * @param width Pointer into which to store the width value
442 * @param height Pointer into which to store the height value
444 * @ingroup File_Selector_Entry
447 elm_fileselector_entry_window_size_get(const Evas_Object *obj, Evas_Coord *width, Evas_Coord *height)
449 ELM_CHECK_WIDTYPE(obj, widtype);
450 Widget_Data *wd = elm_widget_data_get(obj);
452 elm_fileselector_button_window_size_get(wd->button, width, height);
456 * Set the starting path of the file selector entry's window.
458 * @param obj The entry object
459 * @param path The path string
461 * It must be a <b>directory</b> path.
463 * @ingroup File_Selector_Entry
466 elm_fileselector_entry_path_set(Evas_Object *obj, const char *path)
468 ELM_CHECK_WIDTYPE(obj, widtype);
469 Widget_Data *wd = elm_widget_data_get(obj);
471 elm_fileselector_button_path_set(wd->button, path);
472 elm_entry_entry_set(wd->entry, path);
476 * Get the <b>last</b> path of the file selector entry's window.
478 * @param obj The entry object
480 * @ingroup File_Selector_Entry
483 elm_fileselector_entry_path_get(const Evas_Object *obj)
485 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
486 Widget_Data *wd = elm_widget_data_get(obj);
487 if (!wd) return NULL;
488 return elm_entry_entry_get(wd->entry);
492 * Set whether the entry's file selector is to present itself as an
493 * Elementary Generic List (which will expand its entries for nested
494 * directories) or as canonical list, which will be rendered again
495 * with the contents of each selected directory.
497 * @param obj The entry object
498 * @param value The expandable flag
500 * @ingroup File_Selector_Entry
503 elm_fileselector_entry_expandable_set(Evas_Object *obj, Eina_Bool value)
505 ELM_CHECK_WIDTYPE(obj, widtype);
506 Widget_Data *wd = elm_widget_data_get(obj);
508 elm_fileselector_button_expandable_set(wd->button, value);
512 * Get the entry's file selector expandable flag.
514 * @param obj The entry object
515 * @return value The expandable flag
517 * @ingroup File_Selector_Entry
520 elm_fileselector_entry_expandable_get(const Evas_Object *obj)
522 ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
523 Widget_Data *wd = elm_widget_data_get(obj);
524 if (!wd) return EINA_FALSE;
525 return elm_fileselector_button_expandable_get(wd->button);
529 * Set whether the entry's file selector list is to display folders
530 * only or the directory contents, as well.
532 * @param obj The entry object
533 * @param value The "folder only" flag
535 * @ingroup File_Selector_Entry
538 elm_fileselector_entry_folder_only_set(Evas_Object *obj, Eina_Bool value)
540 ELM_CHECK_WIDTYPE(obj, widtype);
541 Widget_Data *wd = elm_widget_data_get(obj);
543 elm_fileselector_button_folder_only_set(wd->button, value);
547 * Get the entry's file selector "folder only" flag.
549 * @param obj The entry object
550 * @return value The "folder only" flag
552 * @ingroup File_Selector_Entry
555 elm_fileselector_entry_folder_only_get(const Evas_Object *obj)
557 ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
558 Widget_Data *wd = elm_widget_data_get(obj);
559 if (!wd) return EINA_FALSE;
560 return elm_fileselector_button_folder_only_get(wd->button);
564 * Set whether the entry's file selector has an editable text entry
565 * which will hold its current selection.
567 * @param obj The entry object
568 * @param value The "is save" flag
570 * @ingroup File_Selector_Entry
573 elm_fileselector_entry_is_save_set(Evas_Object *obj, Eina_Bool value)
575 ELM_CHECK_WIDTYPE(obj, widtype);
576 Widget_Data *wd = elm_widget_data_get(obj);
578 elm_fileselector_button_is_save_set(wd->button, value);
582 * Get the entry's file selector "is save" flag.
584 * @param obj The entry object
585 * @return value The "is save" flag
587 * @ingroup File_Selector_Entry
590 elm_fileselector_entry_is_save_get(const Evas_Object *obj)
592 ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
593 Widget_Data *wd = elm_widget_data_get(obj);
594 if (!wd) return EINA_FALSE;
595 return elm_fileselector_button_is_save_get(wd->button);
599 * Set whether the entry's file selector will raise an Elementary
600 * Inner Window, instead of a dedicated Elementary Window. By default,
603 * @param obj The entry object
604 * @param value The "inwin mode" flag
606 * @ingroup File_Selector_Entry
609 elm_fileselector_entry_inwin_mode_set(Evas_Object *obj, Eina_Bool value)
611 ELM_CHECK_WIDTYPE(obj, widtype);
612 Widget_Data *wd = elm_widget_data_get(obj);
614 elm_fileselector_button_inwin_mode_set(wd->button, value);
618 * Get the entry's file selector "inwin mode" flag.
620 * @param obj The entry object
621 * @return value The "inwin mode" flag
623 * @ingroup File_Selector_Entry
626 elm_fileselector_entry_inwin_mode_get(const Evas_Object *obj)
628 ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
629 Widget_Data *wd = elm_widget_data_get(obj);
630 if (!wd) return EINA_FALSE;
631 return elm_fileselector_button_inwin_mode_get(wd->button);
635 * Set the icon used for the entry button
637 * Once the icon object is set, a previously set one will be deleted.
639 * @param obj The entry object
640 * @param icon The image for the entry
642 * @ingroup File_Selector_Entry
645 elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon)
647 ELM_CHECK_WIDTYPE(obj, widtype);
648 Widget_Data *wd = elm_widget_data_get(obj);
650 elm_fileselector_button_icon_set(wd->button, icon);
654 * Get the icon used for the entry button
656 * @param obj The entry object
657 * @return The image for the entry
659 * @ingroup File_Selector_Entry
662 elm_fileselector_entry_button_icon_get(const Evas_Object *obj)
664 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
665 Widget_Data *wd = elm_widget_data_get(obj);
666 if (!wd) return NULL;
667 return elm_fileselector_button_icon_get(wd->button);
671 * Unset the icon used for the entry button
673 * Unparent and return the icon object which was set for this widget.
675 * @param obj The entry object
676 * @return The icon object that was being used
678 * @ingroup File_Selector_Entry
681 elm_fileselector_entry_button_icon_unset(Evas_Object *obj)
683 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
684 Widget_Data *wd = elm_widget_data_get(obj);
685 if (!wd) return NULL;
686 return elm_fileselector_button_icon_unset(wd->button);