2 * DO NOT INCLUDE THIS HEADER INSIDE ANY SOURCE.
3 * THIS IS ONLY FOR ELEMENTARY API DEPRECATION HISTORY AND WILL BE REMOVED LATER.
4 * THIS WILL BE MAINLY MANAGED BY JIYOUN PARK (jypark).
6 * (deprecation process)
7 * 1. mark EINA_DEPRECATED and move declarations to elm_deprecated.h.
8 * 2. remove it from elm_deprecated.h and apply it to all trunk.
9 * 3. move it to elm_removed.h.
12 #error "do not include this"
15 * @image html img/widget/toggle/preview-00.png
16 * @image latex img/widget/toggle/preview-00.eps
18 * @brief A toggle is a slider which can be used to toggle between
19 * two values. It has two states: on and off.
21 * This widget is deprecated. Please use elm_check_add() instead using the
25 * obj = elm_check_add(parent);
26 * elm_object_style_set(obj, "toggle");
27 * elm_object_part_text_set(obj, "on", "ON");
28 * elm_object_part_text_set(obj, "off", "OFF");
31 * Signals that you can add callbacks for are:
32 * @li "changed" - Whenever the toggle value has been changed. Is not called
33 * until the toggle is released by the cursor (assuming it
34 * has been triggered by the cursor in the first place).
36 * Default content parts of the toggle widget that you can use for are:
37 * @li "icon" - An icon of the toggle
39 * Default text parts of the toggle widget that you can use for are:
40 * @li "elm.text" - Label of the toggle
42 * @ref tutorial_toggle show how to use a toggle.
47 * @brief Add a toggle to @p parent.
49 * @param parent The parent object
51 * @return The toggle object
53 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
56 * @brief Sets the label to be displayed with the toggle.
58 * @param obj The toggle object
59 * @param label The label to be displayed
61 * @deprecated use elm_object_text_set() instead.
63 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
66 * @brief Gets the label of the toggle
68 * @param obj toggle object
69 * @return The label of the toggle
71 * @deprecated use elm_object_text_get() instead.
73 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
76 * @brief Set the icon used for the toggle
78 * @param obj The toggle object
79 * @param icon The icon object for the button
81 * Once the icon object is set, a previously set one will be deleted
82 * If you want to keep that old content object, use the
83 * elm_toggle_icon_unset() function.
85 * @deprecated use elm_object_part_content_set() instead.
87 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
90 * @brief Get the icon used for the toggle
92 * @param obj The toggle object
93 * @return The icon object that is being used
95 * Return the icon object which is set for this widget.
97 * @deprecated use elm_object_part_content_get() instead.
99 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
102 * @brief Unset the icon used for the toggle
104 * @param obj The toggle object
105 * @return The icon object that was being used
107 * Unparent and return the icon object which was set for this widget.
109 * @deprecated use elm_object_part_content_unset() instead.
111 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
114 * @brief Sets the labels to be associated with the on and off states of the toggle.
116 * @param obj The toggle object
117 * @param onlabel The label displayed when the toggle is in the "on" state
118 * @param offlabel The label displayed when the toggle is in the "off" state
120 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
123 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
126 * @brief Gets the labels associated with the on and off states of the
129 * @param obj The toggle object
130 * @param onlabel A char** to place the onlabel of @p obj into
131 * @param offlabel A char** to place the offlabel of @p obj into
133 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
136 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
139 * @brief Sets the state of the toggle to @p state.
141 * @param obj The toggle object
142 * @param state The state of @p obj
144 * @deprecated use elm_check_state_set() instead.
146 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
149 * @brief Gets the state of the toggle to @p state.
151 * @param obj The toggle object
152 * @return The state of @p obj
154 * @deprecated use elm_check_state_get() instead.
156 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
159 * @brief Sets the state pointer of the toggle to @p statep.
161 * @param obj The toggle object
162 * @param statep The state pointer of @p obj
164 * @deprecated use elm_check_state_pointer_set() instead.
166 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
173 * @brief Get Elementary's rendering engine in use.
175 * @return The rendering engine's name
176 * @note there's no need to free the returned string, here.
178 * This gets the global rendering engine that is applied to all Elementary
181 * @see elm_engine_set()
182 * @deprecated Use elm_engine_get() instead.
184 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
187 * Set the configured finger size for all applications on the display
189 * This sets the globally configured finger size in pixels for all
190 * applications on the display
192 * @param size The finger size
194 * @deprecated Use elm_finger_size_set() and elm_config_all_flush()
196 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size);
199 * Set the global scaling factor for all applications on the display
201 * This sets the globally configured scaling factor that is applied to all
202 * objects for all applications.
203 * @param scale The scaling factor to set
205 * @deprecated use elm_scale_set() and elm_config_all_flush()
207 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale);
210 * Apply the changes made with elm_font_overlay_set() and
211 * elm_font_overlay_unset() on all Elementary application windows.
215 * This applies all font overlays set to all objects in the UI.
216 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
218 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void);
221 * Set the configured cache flush interval time for all applications on the
224 * This sets the globally configured cache flush interval time -- in ticks
225 * -- for all applications on the display.
227 * @param size The cache flush interval time
228 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
231 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size);
234 * Set the configured cache flush enabled state for all applications on the
237 * This sets the globally configured cache flush enabled state for all
238 * applications on the display.
240 * @param enabled The cache flush enabled state
241 * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
244 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled);
247 * Set the configured font cache size for all applications on the
250 * This sets the globally configured font cache size -- in bytes
251 * -- for all applications on the display.
253 * @param size The font cache size
254 * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
257 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size);
260 * Set the configured image cache size for all applications on the
263 * This sets the globally configured image cache size -- in bytes
264 * -- for all applications on the display.
266 * @param size The image cache size
267 * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
270 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size);
273 * Set the configured edje file cache size for all applications on the
276 * This sets the globally configured edje file cache size -- in number
277 * of files -- for all applications on the display.
279 * @param size The edje file cache size
280 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
283 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size);
286 * Set the configured edje collections (groups) cache size for all
287 * applications on the display
289 * This sets the globally configured edje collections cache size -- in
290 * number of collections -- for all applications on the display.
292 * @param size The edje collections cache size
293 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
296 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size);
299 * Set Elementary's profile.
301 * This sets the global profile that is applied to all Elementary
302 * applications. All running Elementary windows will be affected.
304 * @param profile The profile's name
305 * @deprecated Use elm_profile_set() and elm_config_all_flush()
309 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile);
312 * Set whether scrollers should bounce when they reach their
313 * viewport's edge during a scroll, for all Elementary application
316 * @param enabled the thumb scroll bouncing state
318 * @see elm_thumbscroll_bounce_enabled_get()
319 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
322 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
325 * Set the amount of inertia a scroller will impose at bounce
326 * animations, for all Elementary application windows.
328 * @param friction the thumb scroll bounce friction
330 * @see elm_thumbscroll_bounce_friction_get()
331 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
334 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction);
337 * Set the amount of inertia a <b>paged</b> scroller will impose at
338 * page fitting animations, for all Elementary application windows.
340 * @param friction the page scroll friction
342 * @see elm_thumbscroll_page_scroll_friction_get()
343 * @deprecated Use elm_scroll_page_scroll_friction_set() and
344 * elm_config_all_flush()
347 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
350 * Set the amount of inertia a scroller will impose at region bring
351 * animations, for all Elementary application windows.
353 * @param friction the bring in scroll friction
355 * @see elm_thumbscroll_bring_in_scroll_friction_get()
356 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
357 * elm_config_all_flush()
360 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
363 * Set the amount of inertia scrollers will impose at animations
364 * triggered by Elementary widgets' zooming API, for all Elementary
365 * application windows.
367 * @param friction the zoom friction
369 * @see elm_thumbscroll_zoom_friction_get()
370 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
373 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction);
376 * Set whether scrollers should be draggable from any point in their
377 * views, for all Elementary application windows.
379 * @param enabled the thumb scroll state
381 * @see elm_thumbscroll_enabled_get()
382 * @deprecated Use elm_scroll_thumbscroll_enabled_set()
383 * and elm_config_all_flush()
387 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
391 * Set the number of pixels one should travel while dragging a
392 * scroller's view to actually trigger scrolling, for all Elementary
393 * application windows.
395 * @param threshold the thumb scroll threshold
397 * @see elm_thumbscroll_threshold_get()
398 * @deprecated Use elm_scroll_thumbscroll_threshold_set()
399 * and elm_config_all_flush()
403 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
406 * Set the minimum speed of mouse cursor movement which will trigger
407 * list self scrolling animation after a mouse up event
408 * (pixels/second), for all Elementary application windows.
410 * @param threshold the thumb scroll momentum threshold
412 * @see elm_thumbscroll_momentum_threshold_get()
413 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
414 * and elm_config_all_flush()
418 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
421 * Set the amount of inertia a scroller will impose at self scrolling
422 * animations, for all Elementary application windows.
424 * @param friction the thumb scroll friction
426 * @see elm_thumbscroll_friction_get()
427 * @deprecated Use elm_scroll_thumbscroll_friction_set()
428 * and elm_config_all_flush()
432 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
435 * Set the amount of lag between your actual mouse cursor dragging
436 * movement and a scroller's view movement itself, while pushing it
437 * into bounce state manually, for all Elementary application windows.
439 * @param friction the thumb scroll border friction. @c 0.0 for
440 * perfect synchrony between two movements, @c 1.0 for maximum
443 * @see elm_thumbscroll_border_friction_get()
444 * @note parameter value will get bound to 0.0 - 1.0 interval, always
445 * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
446 * and elm_config_all_flush()
450 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
453 * Set the sensitivity amount which is be multiplied by the length of
454 * mouse dragging, for all Elementary application windows.
456 * @param friction the thumb scroll sensitivity friction. @c 0.1 for
457 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
460 * @see elm_thumbscroll_sensitivity_friction_get()
461 * @note parameter value will get bound to 0.1 - 1.0 interval, always
462 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
463 * and elm_config_all_flush()
467 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
469 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
470 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
471 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
472 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
473 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
474 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
475 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
476 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
477 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
478 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
479 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
481 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
482 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
483 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
484 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
485 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
486 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
487 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
488 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
489 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
490 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
493 * Get the widget object's handle which contains a given item
495 * @param it The Elementary object item
496 * @return The widget object
498 * @note This returns the widget object itself that an item belongs to.
499 * @note Every elm_object_item supports this API
500 * @deprecated Use elm_object_item_widget_get() instead
503 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it);
506 * Set the text to show in the anchorblock
508 * Sets the text of the anchorblock to @p text. This text can include markup
509 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
510 * of text that will be specially styled and react to click events, ended
511 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
512 * "anchor,clicked" signal that you can attach a callback to with
513 * evas_object_smart_callback_add(). The name of the anchor given in the
514 * event info struct will be the one set in the href attribute, in this
517 * Other markup can be used to style the text in different ways, but it's
518 * up to the style defined in the theme which tags do what.
519 * @deprecated use elm_object_text_set() instead.
521 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
524 * Get the markup text set for the anchorblock
526 * Retrieves the text set on the anchorblock, with markup tags included.
528 * @param obj The anchorblock object
529 * @return The markup text set or @c NULL if nothing was set or an error
531 * @deprecated use elm_object_text_set() instead.
533 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
536 * Set the text to show in the anchorview
538 * Sets the text of the anchorview to @p text. This text can include markup
539 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
540 * text that will be specially styled and react to click events, ended with
541 * either of \</a\> or \</\>. When clicked, the anchor will emit an
542 * "anchor,clicked" signal that you can attach a callback to with
543 * evas_object_smart_callback_add(). The name of the anchor given in the
544 * event info struct will be the one set in the href attribute, in this
547 * Other markup can be used to style the text in different ways, but it's
548 * up to the style defined in the theme which tags do what.
549 * @deprecated use elm_object_text_set() instead.
551 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
554 * Get the markup text set for the anchorview
556 * Retrieves the text set on the anchorview, with markup tags included.
558 * @param obj The anchorview object
559 * @return The markup text set or @c NULL if nothing was set or an error
561 * @deprecated use elm_object_text_set() instead.
563 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
566 * @brief Get the ctxpopup item's disabled/enabled state.
568 * @param it Ctxpopup item to be enabled/disabled
569 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
571 * @see elm_ctxpopup_item_disabled_set()
572 * @deprecated use elm_object_item_disabled_get() instead
576 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
579 * @brief Set the ctxpopup item's state as disabled or enabled.
581 * @param it Ctxpopup item to be enabled/disabled
582 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
584 * When disabled the item is greyed out to indicate it's state.
585 * @deprecated use elm_object_item_disabled_set() instead
589 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
592 * @brief Get the icon object for the given ctxpopup item.
594 * @param it Ctxpopup item
595 * @return icon object or @c NULL, if the item does not have icon or an error
598 * @see elm_ctxpopup_item_append()
599 * @see elm_ctxpopup_item_icon_set()
601 * @deprecated use elm_object_item_part_content_get() instead
605 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
608 * @brief Sets the side icon associated with the ctxpopup item
610 * @param it Ctxpopup item
611 * @param icon Icon object to be set
613 * Once the icon object is set, a previously set one will be deleted.
614 * @warning Setting the same icon for two items will cause the icon to
615 * disappear from the first item.
617 * @see elm_ctxpopup_item_append()
619 * @deprecated use elm_object_item_part_content_set() instead
623 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
626 * @brief Get the label for the given ctxpopup item.
628 * @param it Ctxpopup item
629 * @return label string or @c NULL, if the item does not have label or an
632 * @see elm_ctxpopup_item_append()
633 * @see elm_ctxpopup_item_label_set()
635 * @deprecated use elm_object_item_text_get() instead
639 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
642 * @brief (Re)set the label on the given ctxpopup item.
644 * @param it Ctxpopup item
645 * @param label String to set as label
647 * @deprecated use elm_object_item_text_set() instead
651 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
654 * @brief Set an elm widget as the content of the ctxpopup.
656 * @param obj Ctxpopup object
657 * @param content Content to be swallowed
659 * If the content object is already set, a previous one will be deleted. If
660 * you want to keep that old content object, use the
661 * elm_ctxpopup_content_unset() function.
663 * @warning Ctxpopup can't hold both a item list and a content at the same
664 * time. When a content is set, any previous items will be removed.
666 * @deprecated use elm_object_content_set() instead
670 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
673 * @brief Unset the ctxpopup content
675 * @param obj Ctxpopup object
676 * @return The content that was being used
678 * Unparent and return the content object which was set for this widget.
680 * @deprecated use elm_object_content_unset()
682 * @see elm_ctxpopup_content_set()
684 * @deprecated use elm_object_content_unset() instead
688 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
691 * @brief Delete the given item in a ctxpopup object.
693 * @param it Ctxpopup item to be deleted
695 * @deprecated Use elm_object_item_del() instead
696 * @see elm_ctxpopup_item_append()
700 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
703 * Set the label for a given file selector button widget
705 * @param obj The file selector button widget
706 * @param label The text label to be displayed on @p obj
708 * @deprecated use elm_object_text_set() instead.
710 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
713 * Get the label set for a given file selector button widget
715 * @param obj The file selector button widget
716 * @return The button label
718 * @deprecated use elm_object_text_set() instead.
720 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
723 * Set the icon on a given file selector button widget
725 * @param obj The file selector button widget
726 * @param icon The icon object for the button
728 * Once the icon object is set, a previously set one will be
729 * deleted. If you want to keep the latter, use the
730 * elm_fileselector_button_icon_unset() function.
732 * @deprecated Use elm_object_part_content_set() instead
733 * @see elm_fileselector_button_icon_get()
735 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
738 * Get the icon set for a given file selector button widget
740 * @param obj The file selector button widget
741 * @return The icon object currently set on @p obj or @c NULL, if
744 * @deprecated Use elm_object_part_content_get() instead
745 * @see elm_fileselector_button_icon_set()
747 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
750 * Unset the icon used in a given file selector button widget
752 * @param obj The file selector button widget
753 * @return The icon object that was being used on @p obj or @c
756 * Unparent and return the icon object which was set for this
759 * @deprecated Use elm_object_part_content_unset() instead
760 * @see elm_fileselector_button_icon_set()
762 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
765 * Set the label for a given file selector entry widget's button
767 * @param obj The file selector entry widget
768 * @param label The text label to be displayed on @p obj widget's
771 * @deprecated use elm_object_text_set() instead.
773 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
776 * Get the label set for a given file selector entry widget's button
778 * @param obj The file selector entry widget
779 * @return The widget button's label
781 * @deprecated use elm_object_text_set() instead.
783 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
786 * Set the icon on a given file selector entry widget's button
788 * @param obj The file selector entry widget
789 * @param icon The icon object for the entry's button
791 * Once the icon object is set, a previously set one will be
792 * deleted. If you want to keep the latter, use the
793 * elm_fileselector_entry_button_icon_unset() function.
795 * @deprecated Use elm_object_part_content_set() instead
796 * @see elm_fileselector_entry_button_icon_get()
798 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
801 * Get the icon set for a given file selector entry widget's button
803 * @param obj The file selector entry widget
804 * @return The icon object currently set on @p obj widget's button
805 * or @c NULL, if none is
807 * @deprecated Use elm_object_part_content_get() instead
808 * @see elm_fileselector_entry_button_icon_set()
810 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
813 * Unset the icon used in a given file selector entry widget's
816 * @param obj The file selector entry widget
817 * @return The icon object that was being used on @p obj widget's
818 * button or @c NULL, on errors
820 * Unparent and return the icon object which was set for this
823 * @deprecated Use elm_object_part_content_unset() instead
824 * @see elm_fileselector_entry_button_icon_set()
826 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
829 * @brief Sets the content of the hover object and the direction in which it
832 * @param obj The hover object
833 * @param swallow The direction that the object will be displayed
834 * at. Accepted values are "left", "top-left", "top", "top-right",
835 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
837 * @param content The content to place at @p swallow
839 * Once the content object is set for a given direction, a previously
840 * set one (on the same direction) will be deleted. If you want to
841 * keep that old content object, use the elm_object_part_content_unset()
844 * All directions may have contents at the same time, except for
845 * "smart". This is a special placement hint and its use case
846 * depends of the calculations coming from
847 * elm_hover_best_content_location_get(). Its use is for cases when
848 * one desires only one hover content, but with a dynamic special
849 * placement within the hover area. The content's geometry, whenever
850 * it changes, will be used to decide on a best location, not
851 * extrapolating the hover's parent object view to show it in (still
852 * being the hover's target determinant of its medium part -- move and
853 * resize it to simulate finger sizes, for example). If one of the
854 * directions other than "smart" are used, a previously content set
855 * using it will be deleted, and vice-versa.
857 * @deprecated Use elm_object_part_content_set() instead
859 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
862 * @brief Get the content of the hover object, in a given direction.
864 * Return the content object which was set for this widget in the
865 * @p swallow direction.
867 * @param obj The hover object
868 * @param swallow The direction that the object was display at.
869 * @return The content that was being used
871 * @deprecated Use elm_object_part_content_get() instead
872 * @see elm_object_part_content_set()
874 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
877 * @brief Unset the content of the hover object, in a given direction.
879 * Unparent and return the content object set at @p swallow direction.
881 * @param obj The hover object
882 * @param swallow The direction that the object was display at.
883 * @return The content that was being used.
885 * @deprecated Use elm_object_part_content_unset() instead
886 * @see elm_object_part_content_set()
888 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
891 * @brief Set the hoversel button label
893 * @param obj The hoversel object
894 * @param label The label text.
896 * This sets the label of the button that is always visible (before it is
897 * clicked and expanded).
899 * @deprecated elm_object_text_set()
901 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
904 * @brief Get the hoversel button label
906 * @param obj The hoversel object
907 * @return The label text.
909 * @deprecated elm_object_text_get()
911 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
914 * @brief Set the icon of the hoversel button
916 * @param obj The hoversel object
917 * @param icon The icon object
919 * Sets the icon of the button that is always visible (before it is clicked
920 * and expanded). Once the icon object is set, a previously set one will be
921 * deleted, if you want to keep that old content object, use the
922 * elm_hoversel_icon_unset() function.
924 * @see elm_object_content_set() for the button widget
925 * @deprecated Use elm_object_item_part_content_set() instead
927 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
930 * @brief Get the icon of the hoversel button
932 * @param obj The hoversel object
933 * @return The icon object
935 * Get the icon of the button that is always visible (before it is clicked
936 * and expanded). Also see elm_object_content_get() for the button widget.
938 * @see elm_hoversel_icon_set()
939 * @deprecated Use elm_object_item_part_content_get() instead
941 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
944 * @brief Get and unparent the icon of the hoversel button
946 * @param obj The hoversel object
947 * @return The icon object that was being used
949 * Unparent and return the icon of the button that is always visible
950 * (before it is clicked and expanded).
952 * @see elm_hoversel_icon_set()
953 * @see elm_object_content_unset() for the button widget
954 * @deprecated Use elm_object_item_part_content_unset() instead
956 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
959 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
960 * that will be passed to associated function callbacks.
962 * @param it The item to get the data from
963 * @return The data pointer set with elm_hoversel_item_add()
965 * @see elm_hoversel_item_add()
966 * @deprecated Use elm_object_item_data_get() instead
968 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
971 * @brief This returns the label text of the given hoversel item.
973 * @param it The item to get the label
974 * @return The label text of the hoversel item
976 * @see elm_hoversel_item_add()
977 * @deprecated Use elm_object_item_text_get() instead
979 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
982 * @brief Set the function to be called when an item from the hoversel is
985 * @param it The item to set the callback on
986 * @param func The function called
988 * That function will receive these parameters:
989 * @li void * item data
990 * @li Evas_Object * hoversel object
991 * @li Elm_Object_Item * hoversel item
993 * @see elm_hoversel_item_add()
994 * @deprecated Use elm_object_item_del_cb_set() instead
996 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
999 * @brief Delete an item from the hoversel
1001 * @param it The item to delete
1003 * This deletes the item from the hoversel (should not be called while the
1004 * hoversel is active; use elm_hoversel_expanded_get() to check first).
1006 * @deprecated Use elm_object_item_del() instead
1007 * @see elm_hoversel_item_add()
1009 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
1012 * Set the overlay object used for the background object.
1014 * @param obj The bg object
1015 * @param overlay The overlay object
1017 * This provides a way for elm_bg to have an 'overlay' that will be on top
1018 * of the bg. Once the over object is set, a previously set one will be
1019 * deleted, even if you set the new one to NULL. If you want to keep that
1020 * old content object, use the elm_bg_overlay_unset() function.
1022 * @deprecated use elm_object_part_content_set() instead
1027 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
1030 * Get the overlay object used for the background object.
1032 * @param obj The bg object
1033 * @return The content that is being used
1035 * Return the content object which is set for this widget
1037 * @deprecated use elm_object_part_content_get() instead
1041 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
1044 * Get the overlay object used for the background object.
1046 * @param obj The bg object
1047 * @return The content that was being used
1049 * Unparent and return the overlay object which was set for this widget
1051 * @deprecated use elm_object_part_content_unset() instead
1055 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
1059 * Set the label of the bubble
1061 * @param obj The bubble object
1062 * @param label The string to set in the label
1064 * This function sets the title of the bubble. Where this appears depends on
1065 * the selected corner.
1066 * @deprecated use elm_object_text_set() instead.
1068 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
1071 * Get the label of the bubble
1073 * @param obj The bubble object
1074 * @return The string of set in the label
1076 * This function gets the title of the bubble.
1077 * @deprecated use elm_object_text_get() instead.
1079 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
1082 * Set the info of the bubble
1084 * @param obj The bubble object
1085 * @param info The given info about the bubble
1087 * This function sets the info of the bubble. Where this appears depends on
1088 * the selected corner.
1089 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
1091 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
1094 * Get the info of the bubble
1096 * @param obj The bubble object
1098 * @return The "info" string of the bubble
1100 * This function gets the info text.
1101 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
1103 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
1106 * Set the content to be shown in the bubble
1108 * Once the content object is set, a previously set one will be deleted.
1109 * If you want to keep the old content object, use the
1110 * elm_bubble_content_unset() function.
1112 * @param obj The bubble object
1113 * @param content The given content of the bubble
1115 * This function sets the content shown on the middle of the bubble.
1117 * @deprecated use elm_object_content_set() instead
1120 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1123 * Get the content shown in the bubble
1125 * Return the content object which is set for this widget.
1127 * @param obj The bubble object
1128 * @return The content that is being used
1130 * @deprecated use elm_object_content_get() instead
1133 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1136 * Unset the content shown in the bubble
1138 * Unparent and return the content object which was set for this widget.
1140 * @param obj The bubble object
1141 * @return The content that was being used
1143 * @deprecated use elm_object_content_unset() instead
1146 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1149 * Set the icon of the bubble
1151 * Once the icon object is set, a previously set one will be deleted.
1152 * If you want to keep the old content object, use the
1153 * elm_icon_content_unset() function.
1155 * @param obj The bubble object
1156 * @param icon The given icon for the bubble
1158 * @deprecated use elm_object_part_content_set() instead
1161 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1164 * Get the icon of the bubble
1166 * @param obj The bubble object
1167 * @return The icon for the bubble
1169 * This function gets the icon shown on the top left of bubble.
1171 * @deprecated use elm_object_part_content_get() instead
1174 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1177 * Unset the icon of the bubble
1179 * Unparent and return the icon object which was set for this widget.
1181 * @param obj The bubble object
1182 * @return The icon that was being used
1184 * @deprecated use elm_object_part_content_unset() instead
1187 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1191 * Set the label used in the button
1193 * The passed @p label can be NULL to clean any existing text in it and
1194 * leave the button as an icon only object.
1196 * @param obj The button object
1197 * @param label The text will be written on the button
1198 * @deprecated use elm_object_text_set() instead.
1200 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1203 * Get the label set for the button
1205 * The string returned is an internal pointer and should not be freed or
1206 * altered. It will also become invalid when the button is destroyed.
1207 * The string returned, if not NULL, is a stringshare, so if you need to
1208 * keep it around even after the button is destroyed, you can use
1209 * eina_stringshare_ref().
1211 * @param obj The button object
1212 * @return The text set to the label, or NULL if nothing is set
1213 * @deprecated use elm_object_text_set() instead.
1215 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1218 * Set the icon used for the button
1220 * Setting a new icon will delete any other that was previously set, making
1221 * any reference to them invalid. If you need to maintain the previous
1222 * object alive, unset it first with elm_button_icon_unset().
1224 * @param obj The button object
1225 * @param icon The icon object for the button
1226 * @deprecated use elm_object_part_content_set() instead.
1228 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1231 * Get the icon used for the button
1233 * Return the icon object which is set for this widget. If the button is
1234 * destroyed or another icon is set, the returned object will be deleted
1235 * and any reference to it will be invalid.
1237 * @param obj The button object
1238 * @return The icon object that is being used
1240 * @deprecated use elm_object_part_content_get() instead
1242 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1245 * Remove the icon set without deleting it and return the object
1247 * This function drops the reference the button holds of the icon object
1248 * and returns this last object. It is used in case you want to remove any
1249 * icon, or set another one, without deleting the actual object. The button
1250 * will be left without an icon set.
1252 * @param obj The button object
1253 * @return The icon object that was being used
1254 * @deprecated use elm_object_part_content_unset() instead.
1256 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1259 * @brief Set the text label of the check object
1261 * @param obj The check object
1262 * @param label The text label string in UTF-8
1264 * @deprecated use elm_object_text_set() instead.
1266 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1269 * @brief Get the text label of the check object
1271 * @param obj The check object
1272 * @return The text label string in UTF-8
1274 * @deprecated use elm_object_text_get() instead.
1276 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1279 * @brief Set the icon object of the check object
1281 * @param obj The check object
1282 * @param icon The icon object
1284 * Once the icon object is set, a previously set one will be deleted.
1285 * If you want to keep that old content object, use the
1286 * elm_object_content_unset() function.
1288 * @deprecated use elm_object_part_content_set() instead.
1291 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1294 * @brief Get the icon object of the check object
1296 * @param obj The check object
1297 * @return The icon object
1299 * @deprecated use elm_object_part_content_get() instead.
1302 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1305 * @brief Unset the icon used for the check object
1307 * @param obj The check object
1308 * @return The icon object that was being used
1310 * Unparent and return the icon object which was set for this widget.
1312 * @deprecated use elm_object_part_content_unset() instead.
1315 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1318 * @brief Set the text label of the check object
1320 * @param obj The check object
1321 * @param label The text label string in UTF-8
1323 * @deprecated use elm_object_text_set() instead.
1325 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1328 * @brief Get the text label of the check object
1330 * @param obj The check object
1331 * @return The text label string in UTF-8
1333 * @deprecated use elm_object_text_get() instead.
1335 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1338 * @brief Set the icon object of the check object
1340 * @param obj The check object
1341 * @param icon The icon object
1343 * Once the icon object is set, a previously set one will be deleted.
1344 * If you want to keep that old content object, use the
1345 * elm_object_content_unset() function.
1347 * @deprecated use elm_object_part_content_set() instead.
1350 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1353 * @brief Get the icon object of the check object
1355 * @param obj The check object
1356 * @return The icon object
1358 * @deprecated use elm_object_part_content_get() instead.
1361 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1364 * @brief Unset the icon used for the check object
1366 * @param obj The check object
1367 * @return The icon object that was being used
1369 * Unparent and return the icon object which was set for this widget.
1371 * @deprecated use elm_object_part_content_unset() instead.
1374 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1376 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1377 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1381 * Set the interval on time updates for a user mouse button hold
1382 * on clock widgets' time edition.
1384 * @param obj The clock object
1385 * @param interval The (first) interval value in seconds
1387 * This interval value is @b decreased while the user holds the
1388 * mouse pointer either incrementing or decrementing a given the
1389 * clock digit's value.
1391 * This helps the user to get to a given time distant from the
1392 * current one easier/faster, as it will start to flip quicker and
1393 * quicker on mouse button holds.
1395 * The calculation for the next flip interval value, starting from
1396 * the one set with this call, is the previous interval divided by
1397 * 1.05, so it decreases a little bit.
1399 * The default starting interval value for automatic flips is
1402 * @deprecated elm_clock_first_interval_set()
1405 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval);
1408 * Get the interval on time updates for a user mouse button hold
1409 * on clock widgets' time edition.
1411 * @param obj The clock object
1412 * @return The (first) interval value, in seconds, set on it
1414 * @elm_clock_first_interval_get()
1416 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj);
1419 * Set what digits of the given clock widget should be editable
1420 * when in edition mode.
1422 * @param obj The clock object
1423 * @param digedit Bit mask indicating the digits to be editable
1424 * (values in #Elm_Clock_Edit_Mode).
1426 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
1427 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
1430 * @deprecated elm_clock_edit_mode_set()
1432 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
1435 * Retrieve what digits of the given clock widget should be
1436 * editable when in edition mode.
1438 * @param obj The clock object
1439 * @return Bit mask indicating the digits to be editable
1440 * (values in #Elm_Clock_Edit_Mode).
1442 * @deprecated elm_clock_edit_mode_get()
1444 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
1447 * Set the content of the conformant widget.
1449 * @param obj The conformant object.
1450 * @param content The content to be displayed by the conformant.
1452 * Content will be sized and positioned considering the space required
1453 * to display a virtual keyboard. So it won't fill all the conformant
1454 * size. This way is possible to be sure that content won't resize
1455 * or be re-positioned after the keyboard is displayed.
1457 * Once the content object is set, a previously set one will be deleted.
1458 * If you want to keep that old content object, use the
1459 * elm_object_content_unset() function.
1461 * @see elm_object_content_unset()
1462 * @see elm_object_content_get()
1464 * @deprecated use elm_object_content_set() instead
1466 * @ingroup Conformant
1468 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1471 * Get the content of the conformant widget.
1473 * @param obj The conformant object.
1474 * @return The content that is being used.
1476 * Return the content object which is set for this widget.
1477 * It won't be unparent from conformant. For that, use
1478 * elm_object_content_unset().
1480 * @see elm_object_content_set().
1481 * @see elm_object_content_unset()
1483 * @deprecated use elm_object_content_get() instead
1485 * @ingroup Conformant
1487 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1490 * Unset the content of the conformant widget.
1492 * @param obj The conformant object.
1493 * @return The content that was being used.
1495 * Unparent and return the content object which was set for this widget.
1497 * @see elm_object_content_set().
1499 * @deprecated use elm_object_content_unset() instead
1501 * @ingroup Conformant
1503 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1506 * Returns the Evas_Object that represents the content area.
1508 * @param obj The conformant object.
1509 * @return The content area of the widget.
1511 * @deprecated use elm_object_content_get() instead
1513 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
1516 * Get the side labels max length.
1518 * @deprecated use elm_diskselector_side_label_length_get() instead:
1520 * @param obj The diskselector object.
1521 * @return The max length defined for side labels, or 0 if not a valid
1524 * @ingroup Diskselector
1526 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1529 * Set the side labels max length.
1531 * @deprecated use elm_diskselector_side_label_length_set() instead:
1533 * @param obj The diskselector object.
1534 * @param len The max length defined for side labels.
1536 * @ingroup Diskselector
1538 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1541 * Get the data associated to the item.
1543 * @param it The diskselector item
1544 * @return The data associated to @p it
1546 * The return value is a pointer to data associated to @p item when it was
1547 * created, with function elm_diskselector_item_append(). If no data
1548 * was passed as argument, it will return @c NULL.
1550 * @see elm_diskselector_item_append()
1551 * @deprecated Use elm_object_item_data_get()
1553 * @ingroup Diskselector
1555 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1558 * Set the icon associated to the item.
1560 * @param it The diskselector item
1561 * @param icon The icon object to associate with @p it
1563 * The icon object to use at left side of the item. An
1564 * icon can be any Evas object, but usually it is an icon created
1565 * with elm_icon_add().
1567 * Once the icon object is set, a previously set one will be deleted.
1568 * @warning Setting the same icon for two items will cause the icon to
1569 * disappear from the first item.
1571 * If an icon was passed as argument on item creation, with function
1572 * elm_diskselector_item_append(), it will be already
1573 * associated to the item.
1575 * @see elm_diskselector_item_append()
1576 * @see elm_diskselector_item_icon_get()
1578 * @deprecated Use elm_object_item_part_content_set() instead
1579 * @ingroup Diskselector
1581 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1584 * Get the icon associated to the item.
1586 * @param it The diskselector item
1587 * @return The icon associated to @p it
1589 * The return value is a pointer to the icon associated to @p item when it was
1590 * created, with function elm_diskselector_item_append(), or later
1591 * with function elm_diskselector_item_icon_set. If no icon
1592 * was passed as argument, it will return @c NULL.
1594 * @see elm_diskselector_item_append()
1595 * @see elm_diskselector_item_icon_set()
1597 * @deprecated Use elm_object_item_part_content_set() instead
1598 * @ingroup Diskselector
1600 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1603 * Set the label of item.
1605 * @param it The item of diskselector.
1606 * @param label The label of item.
1608 * The label to be displayed by the item.
1610 * If no icon is set, label will be centered on item position, otherwise
1611 * the icon will be placed at left of the label, that will be shifted
1614 * An item with label "January" would be displayed on side position as
1615 * "Jan" if max length is set to 3 with function
1616 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1619 * When this @p item is selected, the entire label will be displayed,
1620 * except for width restrictions.
1621 * In this case label will be cropped and "..." will be concatenated,
1622 * but only for display purposes. It will keep the entire string, so
1623 * if diskselector is resized the remaining characters will be displayed.
1625 * If a label was passed as argument on item creation, with function
1626 * elm_diskselector_item_append(), it will be already
1627 * displayed by the item.
1629 * @see elm_diskselector_side_label_length_set()
1630 * @see elm_diskselector_item_label_get()
1631 * @see elm_diskselector_item_append()
1633 * @deprecated Use elm_object_item_text_set() instead
1634 * @ingroup Diskselector
1636 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1639 * Get the label of item.
1641 * @param it The item of diskselector.
1642 * @return The label of item.
1644 * The return value is a pointer to the label associated to @p item when it was
1645 * created, with function elm_diskselector_item_append(), or later
1646 * with function elm_diskselector_item_label_set. If no label
1647 * was passed as argument, it will return @c NULL.
1649 * @see elm_diskselector_item_label_set() for more details.
1650 * @see elm_diskselector_item_append()
1651 * @deprecated Use elm_object_item_text_get() instead
1653 * @ingroup Diskselector
1655 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1658 * Set the function called when a diskselector item is freed.
1660 * @param it The item to set the callback on
1661 * @param func The function called
1663 * If there is a @p func, then it will be called prior item's memory release.
1664 * That will be called with the following arguments:
1666 * @li item's Evas object;
1669 * This way, a data associated to a diskselector item could be properly
1671 * @deprecated Use elm_object_item_del_cb_set() instead
1673 * @ingroup Diskselector
1675 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1678 * Delete them item from the diskselector.
1680 * @param it The item of diskselector to be deleted.
1682 * If deleting all diskselector items is required, elm_diskselector_clear()
1683 * should be used instead of getting items list and deleting each one.
1685 * @deprecated Use elm_object_item_del() instead
1686 * @see elm_diskselector_clear()
1687 * @see elm_diskselector_item_append()
1689 * @ingroup Diskselector
1691 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1694 * Set the text to be shown in the diskselector item.
1696 * @param it Target item
1697 * @param text The text to set in the content
1699 * Setup the text as tooltip to object. The item can have only one tooltip,
1700 * so any previous tooltip data is removed.
1702 * @deprecated Use elm_object_item_tooltip_text_set() instead
1703 * @see elm_object_tooltip_text_set() for more details.
1705 * @ingroup Diskselector
1707 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1710 * Set the content to be shown in the tooltip item.
1712 * Setup the tooltip to item. The item can have only one tooltip,
1713 * so any previous tooltip data is removed. @p func(with @p data) will
1714 * be called every time that need show the tooltip and it should
1715 * return a valid Evas_Object. This object is then managed fully by
1716 * tooltip system and is deleted when the tooltip is gone.
1718 * @param it the diskselector item being attached a tooltip.
1719 * @param func the function used to create the tooltip contents.
1720 * @param data what to provide to @a func as callback data/context.
1721 * @param del_cb called when data is not needed anymore, either when
1722 * another callback replaces @p func, the tooltip is unset with
1723 * elm_diskselector_item_tooltip_unset() or the owner @a item
1724 * dies. This callback receives as the first parameter the
1725 * given @a data, and @c event_info is the item.
1727 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1728 * @see elm_object_tooltip_content_cb_set() for more details.
1730 * @ingroup Diskselector
1732 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
1735 * Unset tooltip from item.
1737 * @param it diskselector item to remove previously set tooltip.
1739 * Remove tooltip from item. The callback provided as del_cb to
1740 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1741 * it is not used anymore.
1743 * @deprecated Use elm_object_item_tooltip_unset() instead
1744 * @see elm_object_tooltip_unset() for more details.
1745 * @see elm_diskselector_item_tooltip_content_cb_set()
1747 * @ingroup Diskselector
1749 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1752 * Sets a different style for this item tooltip.
1754 * @note before you set a style you should define a tooltip with
1755 * elm_diskselector_item_tooltip_content_cb_set() or
1756 * elm_diskselector_item_tooltip_text_set()
1758 * @param it diskselector item with tooltip already set.
1759 * @param style the theme style to use (default, transparent, ...)
1761 * @deprecated Use elm_object_item_tooltip_style_set() instead
1762 * @see elm_object_tooltip_style_set() for more details.
1764 * @ingroup Diskselector
1766 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1769 * Get the style for this item tooltip.
1771 * @param it diskselector item with tooltip already set.
1772 * @return style the theme style in use, defaults to "default". If the
1773 * object does not have a tooltip set, then NULL is returned.
1775 * @deprecated Use elm_object_item_tooltip_style_get() instead
1776 * @see elm_object_tooltip_style_get() for more details.
1777 * @see elm_diskselector_item_tooltip_style_set()
1779 * @ingroup Diskselector
1781 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1784 * Set the cursor to be shown when mouse is over the diskselector item
1786 * @param it Target item
1787 * @param cursor the cursor name to be used.
1789 * @see elm_object_cursor_set() for more details.
1790 * @deprecated Use elm_object_item_cursor_set() instead
1792 * @ingroup Diskselector
1794 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1797 * Get the cursor to be shown when mouse is over the diskselector item
1799 * @param it diskselector item with cursor already set.
1800 * @return the cursor name.
1802 * @see elm_object_cursor_get() for more details.
1803 * @see elm_diskselector_item_cursor_set()
1804 * @deprecated Use elm_object_item_cursor_get() instead
1806 * @ingroup Diskselector
1808 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1811 * Unset the cursor to be shown when mouse is over the diskselector item
1813 * @param it Target item
1815 * @see elm_object_cursor_unset() for more details.
1816 * @see elm_diskselector_item_cursor_set()
1817 * @deprecated use elm_object_item_cursor_unset() instead
1819 * @ingroup Diskselector
1821 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1824 * Sets a different style for this item cursor.
1826 * @note before you set a style you should define a cursor with
1827 * elm_diskselector_item_cursor_set()
1829 * @param it diskselector item with cursor already set.
1830 * @param style the theme style to use (default, transparent, ...)
1832 * @see elm_object_cursor_style_set() for more details.
1833 * @deprecated Use elm_object_item_cursor_style_set() instead
1835 * @ingroup Diskselector
1837 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1840 * Get the style for this item cursor.
1842 * @param it diskselector item with cursor already set.
1843 * @return style the theme style in use, defaults to "default". If the
1844 * object does not have a cursor set, then @c NULL is returned.
1846 * @see elm_object_cursor_style_get() for more details.
1847 * @see elm_diskselector_item_cursor_style_set()
1848 * @deprecated Use elm_object_item_cursor_style_get() instead
1850 * @ingroup Diskselector
1852 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1855 * Set if the cursor set should be searched on the theme or should use
1856 * the provided by the engine, only.
1858 * @note before you set if should look on theme you should define a cursor
1859 * with elm_diskselector_item_cursor_set().
1860 * By default it will only look for cursors provided by the engine.
1862 * @param it widget item with cursor already set.
1863 * @param engine_only boolean to define if cursors set with
1864 * elm_diskselector_item_cursor_set() should be searched only
1865 * between cursors provided by the engine or searched on widget's
1868 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1870 * @ingroup Diskselector
1872 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1875 * Get the cursor engine only usage for this item cursor.
1877 * @param it widget item with cursor already set.
1878 * @return engine_only boolean to define it cursors should be looked only
1879 * between the provided by the engine or searched on widget's theme as well.
1880 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1882 * @see elm_diskselector_item_cursor_engine_only_set()
1883 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1885 * @ingroup Diskselector
1887 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1889 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1890 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1893 * Get the label of a given flip selector widget's item.
1895 * @param it The item to get label from
1896 * @return The text label of @p item or @c NULL, on errors
1898 * @see elm_object_item_text_set()
1900 * @deprecated see elm_object_item_text_get() instead
1901 * @ingroup Flipselector
1903 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1906 * Set the label of a given flip selector widget's item.
1908 * @param it The item to set label on
1909 * @param label The text label string, in UTF-8 encoding
1911 * @see elm_object_item_text_get()
1913 * @deprecated see elm_object_item_text_set() instead
1914 * @ingroup Flipselector
1916 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1919 * Delete a given item from a flip selector widget.
1921 * @param it The item to delete
1923 * @deprecated Use elm_object_item_del() instead
1924 * @ingroup Flipselector
1926 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1929 * Set the interval on time updates for a user mouse button hold
1930 * on a flip selector widget.
1932 * @param obj The flip selector object
1933 * @param interval The (first) interval value in seconds
1935 * This interval value is @b decreased while the user holds the
1936 * mouse pointer either flipping up or flipping down a given flip
1939 * This helps the user to get to a given item distant from the
1940 * current one easier/faster, as it will start to flip quicker and
1941 * quicker on mouse button holds.
1943 * The calculation for the next flip interval value, starting from
1944 * the one set with this call, is the previous interval divided by
1945 * 1.05, so it decreases a little bit.
1947 * The default starting interval value for automatic flips is
1950 * @see elm_flipselector_interval_get()
1951 * @deprecated Use elm_flipselector_first_interval_set()
1953 * @ingroup Flipselector
1955 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
1958 * Get the interval on time updates for an user mouse button hold
1959 * on a flip selector widget.
1961 * @param obj The flip selector object
1962 * @return The (first) interval value, in seconds, set on it
1964 * @see elm_flipselector_interval_set() for more details
1965 * @deprecated Use elm_flipselector_first_interval_get()
1967 * @ingroup Flipselector
1969 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
1972 * Make a given Elementary object the focused one.
1974 * @param obj The Elementary object to make focused.
1976 * @note This object, if it can handle focus, will take the focus
1977 * away from the one who had it previously and will, for now on, be
1978 * the one receiving input events.
1980 * @see elm_object_focus_get()
1981 * @deprecated use elm_object_focus_set() instead.
1985 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1988 * Give focus to next object in object tree.
1990 * Give focus to next object in focus chain of one object sub-tree.
1991 * If the last object of chain already have focus, the focus will go to the
1992 * first object of chain.
1994 * @param obj The object root of sub-tree
1995 * @param dir Direction to cycle the focus
1997 * @deprecated Use elm_object_focus_next() instead
2001 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
2004 * Remove the focus from an Elementary object
2006 * @param obj The Elementary to take focus from
2008 * This removes the focus from @p obj, passing it back to the
2009 * previous element in the focus chain list.
2011 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
2012 * @deprecated use elm_object_focus_set() instead.
2016 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
2019 * Give focus to near object in one direction.
2021 * Give focus to near object in direction of one object.
2022 * If none focusable object in given direction, the focus will not change.
2024 * @param obj The reference object
2025 * @param x Horizontal component of direction to focus
2026 * @param y Vertical component of direction to focus
2028 * @deprecated Support it later.
2031 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
2034 * @brief Set the frame label
2036 * @param obj The frame object
2037 * @param label The label of this frame object
2039 * @deprecated use elm_object_text_set() instead.
2041 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
2044 * @brief Get the frame label
2046 * @param obj The frame object
2048 * @return The label of this frame object or NULL if unable to get frame
2050 * @deprecated use elm_object_text_get() instead.
2052 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
2055 * @brief Set the content of the frame widget
2057 * Once the content object is set, a previously set one will be deleted.
2058 * If you want to keep that old content object, use the
2059 * elm_frame_content_unset() function.
2061 * @param obj The frame object
2062 * @param content The content will be filled in this frame object
2064 * @deprecated use elm_object_content_set() instead.
2066 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
2069 * @brief Get the content of the frame widget
2071 * Return the content object which is set for this widget
2073 * @param obj The frame object
2074 * @return The content that is being used
2076 * @deprecated use elm_object_content_get() instead.
2078 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
2081 * @brief Unset the content of the frame widget
2083 * Unparent and return the content object which was set for this widget
2085 * @param obj The frame object
2086 * @return The content that was being used
2088 * @deprecated use elm_object_content_unset() instead.
2090 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
2092 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
2093 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
2094 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
2096 * This sets the horizontal stretching mode.
2098 * @param obj The genlist object
2099 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
2101 * This sets the mode used for sizing items horizontally. Valid modes
2102 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
2103 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
2104 * the scroller will scroll horizontally. Otherwise items are expanded
2105 * to fill the width of the viewport of the scroller. If it is
2106 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
2107 * limited to that size.
2109 * @see elm_genlist_horizontal_get()
2111 * @deprecated use elm_genlist_mode_set()
2114 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
2117 * Gets the horizontal stretching mode.
2119 * @param obj The genlist object
2120 * @return The mode to use
2121 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
2123 * @see elm_genlist_horizontal_set()
2125 * @deprecated use elm_genlist_mode_get()
2128 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
2131 * Return the data associated to a given genlist item
2133 * @param it The genlist item.
2134 * @return the data associated to this item.
2136 * This returns the @c data value passed on the
2137 * elm_genlist_item_append() and related item addition calls.
2139 * @see elm_genlist_item_append()
2140 * @see elm_genlist_item_data_set()
2142 * @deprecated Use elm_object_item_data_get() instead
2145 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2148 * Set the data associated to a given genlist item
2150 * @param it The genlist item
2151 * @param data The new data pointer to set on it
2153 * This @b overrides the @c data value passed on the
2154 * elm_genlist_item_append() and related item addition calls. This
2155 * function @b won't call elm_genlist_item_update() automatically,
2156 * so you'd issue it afterwards if you want to hove the item
2157 * updated to reflect the that new data.
2159 * @see elm_genlist_item_data_get()
2161 * @deprecated Use elm_object_item_data_set() instead
2164 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2167 * Set whether a given genlist item is disabled or not.
2169 * @param it The item
2170 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2171 * to enable it back.
2173 * A disabled item cannot be selected or unselected. It will also
2174 * change its appearance, to signal the user it's disabled.
2176 * @see elm_genlist_item_disabled_get()
2177 * @deprecated Use elm_object_item_disabled_set() instead
2181 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2184 * Get whether a given genlist item is disabled or not.
2186 * @param it The item
2187 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2190 * @see elm_genlist_item_disabled_set() for more details
2191 * @deprecated Use elm_object_item_disabled_get() instead
2195 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2198 * Remove a genlist item from the its parent, deleting it.
2200 * @param it The item to be removed.
2201 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2203 * @see elm_genlist_clear(), to remove all items in a genlist at
2206 * @deprecated Use elm_object_item_del() instead
2209 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2212 * Get the genlist object's handle which contains a given genlist
2215 * @param it The item to fetch the container from
2216 * @return The genlist (parent) object
2218 * This returns the genlist object itself that an item belongs to.
2219 * @deprecated Use elm_object_item_widget_get() instead
2223 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2226 * Get the mode item style of items in the genlist
2227 * @param obj The genlist object
2228 * @return The mode item style string, or NULL if none is specified
2230 * This is a constant string and simply defines the name of the
2231 * style that will be used for mode animations. It can be
2232 * @c NULL if you don't plan to use Genlist mode. See
2233 * elm_genlist_item_mode_set() for more info.
2237 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2240 * Set the mode item style of items in the genlist
2241 * @param obj The genlist object
2242 * @param style The mode item style string, or NULL if none is desired
2244 * This is a constant string and simply defines the name of the
2245 * style that will be used for mode animations. It can be
2246 * @c NULL if you don't plan to use Genlist mode. See
2247 * elm_genlist_item_mode_set() for more info.
2251 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2254 * Get the Item's Flags
2256 * @param it The genlist item
2257 * @return The item type.
2259 * This function returns the item's type. Normally the item's type.
2260 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2262 * @deprecated Use elm_genlist_item_type_get() instead
2265 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2268 * Tells genlist to "orphan" contents fetched by the item class
2270 * @param it The item
2272 * This instructs genlist to release references to contents in the item,
2273 * meaning that they will no longer be managed by genlist and are
2274 * floating "orphans" that can be re-used elsewhere if the user wants
2277 * @deprecated Use elm_genlist_item_all_contents_unset() instead
2279 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it);
2281 #define ELM_IMAGE_ROTATE_90_CW 1
2282 #define ELM_IMAGE_ROTATE_180_CW 2
2283 #define ELM_IMAGE_ROTATE_90_CCW 3
2286 * Return the data associated with a given index widget item
2288 * @param item The index widget item handle
2289 * @return The data associated with @p it
2290 * @deprecated Use elm_object_item_data_get() instead
2292 * @see elm_index_item_data_set()
2295 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2298 * Set the data associated with a given index widget item
2300 * @param it The index widget item handle
2301 * @param data The new data pointer to set to @p it
2303 * This sets new item data on @p it.
2305 * @warning The old data pointer won't be touched by this function, so
2306 * the user had better to free that old data himself/herself.
2308 * @deprecated Use elm_object_item_data_set() instead
2310 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2313 * Set the function to be called when a given index widget item is freed.
2315 * @param it The item to set the callback on
2316 * @param func The function to call on the item's deletion
2318 * When called, @p func will have both @c data and @c event_info
2319 * arguments with the @p it item's data value and, naturally, the
2320 * @c obj argument with a handle to the parent index widget.
2322 * @deprecated Use elm_object_item_del_cb_set() instead
2324 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2327 * Remove an item from a given index widget, <b>to be referenced by
2328 * it's data value</b>.
2330 * @param obj The index object
2331 * @param item The item to be removed from @p obj
2333 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2334 * that callback function will be called by this one.
2336 * @deprecated Use elm_object_item_del() instead
2338 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2341 * @brief Set the label on the label object
2343 * @param obj The label object
2344 * @param label The label will be used on the label object
2345 * @deprecated See elm_object_text_set()
2347 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2350 * @brief Get the label used on the label object
2352 * @param obj The label object
2353 * @return The string inside the label
2354 * @deprecated See elm_object_text_get()
2356 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2360 * Set the layout content.
2362 * @param obj The layout object
2363 * @param swallow The swallow part name in the edje file
2364 * @param content The child that will be added in this layout object
2365 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2367 * Once the content object is set, a previously set one will be deleted.
2368 * If you want to keep that old content object, use the
2369 * elm_object_part_content_unset() function.
2371 * @note In an Edje theme, the part used as a content container is called @c
2372 * SWALLOW. This is why the parameter name is called @p swallow, but it is
2373 * expected to be a part name just like the second parameter of
2374 * elm_layout_box_append().
2376 * @see elm_layout_box_append()
2377 * @see elm_object_part_content_get()
2378 * @see elm_object_part_content_unset()
2380 * @deprecated use elm_object_part_content_set() instead
2383 EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2386 * Get the child object in the given content part.
2388 * @param obj The layout object
2389 * @param swallow The SWALLOW part to get its content
2391 * @return The swallowed object or NULL if none or an error occurred
2393 * @deprecated use elm_object_part_content_get() instead
2396 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2399 * Unset the layout content.
2401 * @param obj The layout object
2402 * @param swallow The swallow part name in the edje file
2403 * @return The content that was being used
2405 * Unparent and return the content object which was set for this part.
2407 * @deprecated use elm_object_part_content_unset() instead
2410 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2413 * Set the text of the given part
2415 * @param obj The layout object
2416 * @param part The TEXT part where to set the text
2417 * @param text The text to set
2418 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2420 * @deprecated use elm_object_part_text_set() instead.
2422 EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2425 * Get the text set in the given part
2427 * @param obj The layout object
2428 * @param part The TEXT part to retrieve the text off
2430 * @return The text set in @p part
2432 * @deprecated use elm_object_part_text_get() instead.
2434 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
2437 * @def elm_layout_label_set
2438 * Convenience macro to set the label in a layout that follows the
2439 * Elementary naming convention for its parts.
2441 * @deprecated use elm_object_text_set() instead.
2443 #define elm_layout_label_set(_ly, _txt) \
2444 elm_layout_text_set((_ly), "elm.text", (_txt))
2447 * @def elm_layout_label_get
2448 * Convenience macro to get the label in a layout that follows the
2449 * Elementary naming convention for its parts.
2451 * @deprecated use elm_object_text_set() instead.
2453 #define elm_layout_label_get(_ly) \
2454 elm_layout_text_get((_ly), "elm.text")
2456 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2460 * Set the content of the mapbuf.
2462 * @param obj The mapbuf object.
2463 * @param content The content that will be filled in this mapbuf object.
2465 * Once the content object is set, a previously set one will be deleted.
2466 * If you want to keep that old content object, use the
2467 * elm_mapbuf_content_unset() function.
2469 * To enable map, elm_mapbuf_enabled_set() should be used.
2471 * @deprecated use elm_object_content_set() instead
2474 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2477 * Get the content of the mapbuf.
2479 * @param obj The mapbuf object.
2480 * @return The content that is being used.
2482 * Return the content object which is set for this widget.
2484 * @see elm_mapbuf_content_set() for details.
2486 * @deprecated use elm_object_content_get() instead
2489 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2492 * Unset the content of the mapbuf.
2494 * @param obj The mapbuf object.
2495 * @return The content that was being used.
2497 * Unparent and return the content object which was set for this widget.
2499 * @see elm_mapbuf_content_set() for details.
2501 * @deprecated use elm_object_content_unset() instead
2504 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2507 * @brief Set the label of a menu item
2509 * @param it The menu item object.
2510 * @param label The label to set for @p item
2512 * @warning Don't use this function on items created with
2513 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2515 * @deprecated Use elm_object_item_text_set() instead
2517 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2520 * @brief Get the label of a menu item
2522 * @param it The menu item object.
2523 * @return The label of @p item
2524 * @deprecated Use elm_object_item_text_get() instead
2526 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2529 * @brief Set the content object of a menu item
2531 * @param it The menu item object
2532 * @param The content object or NULL
2533 * @return EINA_TRUE on success, else EINA_FALSE
2535 * Use this function to change the object swallowed by a menu item, deleting
2536 * any previously swallowed object.
2538 * @deprecated Use elm_object_item_content_set() instead
2540 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2543 * @brief Get the content object of a menu item
2545 * @param it The menu item object
2546 * @return The content object or NULL
2547 * @note If @p item was added with elm_menu_item_add_object, this
2548 * function will return the object passed, else it will return the
2551 * @see elm_menu_item_object_content_set()
2553 * @deprecated Use elm_object_item_content_get() instead
2555 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2558 * @brief Set the disabled state of @p item.
2560 * @param it The menu item object.
2561 * @param disabled The enabled/disabled state of the item
2562 * @deprecated Use elm_object_item_disabled_set() instead
2564 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2567 * @brief Get the disabled state of @p item.
2569 * @param it The menu item object.
2570 * @return The enabled/disabled state of the item
2572 * @see elm_menu_item_disabled_set()
2573 * @deprecated Use elm_object_item_disabled_get() instead
2575 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2578 * @brief Returns the data associated with menu item @p item.
2580 * @param it The item
2581 * @return The data associated with @p item or NULL if none was set.
2583 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2585 * @deprecated Use elm_object_item_data_get() instead
2587 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2590 * @brief Set the function called when a menu item is deleted.
2592 * @param it The item to set the callback on
2593 * @param func The function called
2595 * @see elm_menu_item_add()
2596 * @see elm_menu_item_del()
2597 * @deprecated Use elm_object_item_del_cb_set() instead
2599 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2602 * @brief Sets the data to be associated with menu item @p item.
2604 * @param it The item
2605 * @param data The data to be associated with @p item
2607 * @deprecated Use elm_object_item_data_set() instead
2609 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2612 * @brief Deletes an item from the menu.
2614 * @param it The item to delete.
2616 * @deprecated Use elm_object_item_del() instead
2617 * @see elm_menu_item_add()
2619 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2622 * @brief @brief Return a menu item's owner menu
2624 * @param it The menu item
2625 * @return The menu object owning @p item, or NULL on failure
2627 * Use this function to get the menu object owning an item.
2628 * @deprecated Use elm_object_item_widget_get() instead
2630 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2633 * @brief Set the icon of a menu item to the standard icon with name @p icon
2635 * @param it The menu item object.
2636 * @param icon The icon object to set for the content of @p item
2638 * @deprecated elm_menu_item_icon_name_set() instead
2639 * Once this icon is set, any previously set icon will be deleted.
2641 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2644 * @brief Get the string representation from the icon of a menu item
2646 * @param it The menu item object.
2647 * @return The string representation of @p item's icon or NULL
2649 * @deprecated elm_menu_item_icon_name_get() instead
2650 * @see elm_menu_item_icon_name_set()
2652 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2655 * @brief Set the content of the notify widget
2657 * @param obj The notify object
2658 * @param content The content will be filled in this notify object
2660 * Once the content object is set, a previously set one will be deleted. If
2661 * you want to keep that old content object, use the
2662 * elm_notify_content_unset() function.
2664 * @deprecated use elm_object_content_set() instead
2667 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2670 * @brief Unset the content of the notify widget
2672 * @param obj The notify object
2673 * @return The content that was being used
2675 * Unparent and return the content object which was set for this widget
2677 * @see elm_notify_content_set()
2678 * @deprecated use elm_object_content_unset() instead
2681 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2684 * @brief Return the content of the notify widget
2686 * @param obj The notify object
2687 * @return The content that is being used
2689 * @see elm_notify_content_set()
2690 * @deprecated use elm_object_content_get() instead
2693 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2696 * Set a label of an object
2698 * @param obj The Elementary object
2699 * @param part The text part name to set (NULL for the default label)
2700 * @param label The new text of the label
2702 * @note Elementary objects may have many labels (e.g. Action Slider)
2703 * @deprecated Use elm_object_part_text_set() instead.
2705 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2708 * Get a label of an object
2710 * @param obj The Elementary object
2711 * @param part The text part name to get (NULL for the default label)
2712 * @return text of the label or NULL for any error
2714 * @note Elementary objects may have many labels (e.g. Action Slider)
2715 * @deprecated Use elm_object_part_text_get() instead.
2717 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2720 * Set a content of an object
2722 * @param obj The Elementary object
2723 * @param part The content part name to set (NULL for the default content)
2724 * @param content The new content of the object
2726 * @note Elementary objects may have many contents
2727 * @deprecated Use elm_object_part_content_set instead.
2729 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2732 * Get a content of an object
2734 * @param obj The Elementary object
2735 * @param part The content part name to get (NULL for the default content)
2736 * @return content of the object or NULL for any error
2738 * @note Elementary objects may have many contents
2739 * @deprecated Use elm_object_part_content_get instead.
2741 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2744 * Unset a content of an object
2746 * @param obj The Elementary object
2747 * @param part The content part name to unset (NULL for the default content)
2749 * @note Elementary objects may have many contents
2750 * @deprecated Use elm_object_part_content_unset instead.
2752 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2755 * Set a content of an object item
2757 * @param it The Elementary object item
2758 * @param part The content part name to set (NULL for the default content)
2759 * @param content The new content of the object item
2761 * @note Elementary object items may have many contents
2762 * @deprecated Use elm_object_item_part_content_set instead.
2764 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2767 * Get a content of an object item
2769 * @param it The Elementary object item
2770 * @param part The content part name to unset (NULL for the default content)
2771 * @return content of the object item or NULL for any error
2773 * @note Elementary object items may have many contents
2774 * @deprecated Use elm_object_item_part_content_get instead.
2776 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2779 * Unset a content of an object item
2781 * @param it The Elementary object item
2782 * @param part The content part name to unset (NULL for the default content)
2784 * @note Elementary object items may have many contents
2785 * @deprecated Use elm_object_item_part_content_unset instead.
2787 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2790 * Get a label of an object item
2792 * @param it The Elementary object item
2793 * @param part The text part name to get (NULL for the default label)
2794 * @return text of the label or NULL for any error
2796 * @note Elementary object items may have many labels
2797 * @deprecated Use elm_object_item_part_text_get instead.
2799 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2802 * Set a label of an object item
2804 * @param it The Elementary object item
2805 * @param part The text part name to set (NULL for the default label)
2806 * @param label The new text of the label
2808 * @note Elementary object items may have many labels
2809 * @deprecated Use elm_object_item_part_text_set instead.
2811 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2814 * @brief Set the content of the panel.
2816 * @param obj The panel object
2817 * @param content The panel content
2819 * Once the content object is set, a previously set one will be deleted.
2820 * If you want to keep that old content object, use the
2821 * elm_panel_content_unset() function.
2823 * @deprecated use elm_object_content_set() instead
2826 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2829 * @brief Get the content of the panel.
2831 * @param obj The panel object
2832 * @return The content that is being used
2834 * Return the content object which is set for this widget.
2836 * @see elm_panel_content_set()
2838 * @deprecated use elm_object_content_get() instead
2841 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2844 * @brief Unset the content of the panel.
2846 * @param obj The panel object
2847 * @return The content that was being used
2849 * Unparent and return the content object which was set for this widget.
2851 * @see elm_panel_content_set()
2853 * @deprecated use elm_object_content_unset() instead
2856 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2859 * Set the left content of the panes widget.
2861 * @param obj The panes object.
2862 * @param content The new left content object.
2864 * Once the content object is set, a previously set one will be deleted.
2865 * If you want to keep that old content object, use the
2866 * elm_panes_content_left_unset() function.
2868 * If panes is displayed vertically, left content will be displayed at
2871 * @see elm_panes_content_left_get()
2872 * @see elm_panes_content_right_set() to set content on the other side.
2874 * @deprecated use elm_object_part_content_set() instead
2877 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2880 * Set the right content of the panes widget.
2882 * @param obj The panes object.
2883 * @param content The new right content object.
2885 * Once the content object is set, a previously set one will be deleted.
2886 * If you want to keep that old content object, use the
2887 * elm_panes_content_right_unset() function.
2889 * If panes is displayed vertically, left content will be displayed at
2892 * @see elm_panes_content_right_get()
2893 * @see elm_panes_content_left_set() to set content on the other side.
2895 * @deprecated use elm_object_part_content_set() instead
2898 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2901 * Get the left content of the panes.
2903 * @param obj The panes object.
2904 * @return The left content object that is being used.
2906 * Return the left content object which is set for this widget.
2908 * @see elm_panes_content_left_set() for details.
2910 * @deprecated use elm_object_part_content_get() instead
2913 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2916 * Get the right content of the panes.
2918 * @param obj The panes object
2919 * @return The right content object that is being used
2921 * Return the right content object which is set for this widget.
2923 * @see elm_panes_content_right_set() for details.
2925 * @deprecated use elm_object_part_content_get() instead
2928 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2931 * Unset the left content used for the panes.
2933 * @param obj The panes object.
2934 * @return The left content object that was being used.
2936 * Unparent and return the left content object which was set for this widget.
2938 * @see elm_panes_content_left_set() for details.
2939 * @see elm_panes_content_left_get().
2941 * @deprecated use elm_object_part_content_unset() instead
2944 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2947 * Unset the right content used for the panes.
2949 * @param obj The panes object.
2950 * @return The right content object that was being used.
2952 * Unparent and return the right content object which was set for this
2955 * @see elm_panes_content_right_set() for details.
2956 * @see elm_panes_content_right_get().
2958 * @deprecated use elm_object_part_content_unset() instead
2961 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2963 * Set the label of a given progress bar widget
2965 * @param obj The progress bar object
2966 * @param label The text label string, in UTF-8
2968 * @deprecated use elm_object_text_set() instead.
2970 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2973 * Get the label of a given progress bar widget
2975 * @param obj The progressbar object
2976 * @return The text label string, in UTF-8
2978 * @deprecated use elm_object_text_set() instead.
2980 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2983 * Set the icon object of a given progress bar widget
2985 * @param obj The progress bar object
2986 * @param icon The icon object
2988 * Use this call to decorate @p obj with an icon next to it.
2990 * @note Once the icon object is set, a previously set one will be
2991 * deleted. If you want to keep that old content object, use the
2992 * elm_progressbar_icon_unset() function.
2994 * @see elm_progressbar_icon_get()
2995 * @deprecated use elm_object_part_content_set() instead.
2998 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
3001 * Retrieve the icon object set for a given progress bar widget
3003 * @param obj The progress bar object
3004 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3005 * otherwise (and on errors)
3007 * @see elm_progressbar_icon_set() for more details
3008 * @deprecated use elm_object_part_content_get() instead.
3011 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
3014 * Unset an icon set on a given progress bar widget
3016 * @param obj The progress bar object
3017 * @return The icon object that was being used, if any was set, or
3018 * @c NULL, otherwise (and on errors)
3020 * This call will unparent and return the icon object which was set
3021 * for this widget, previously, on success.
3023 * @see elm_progressbar_icon_set() for more details
3024 * @deprecated use elm_object_part_content_unset() instead.
3027 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
3030 * @brief Set the text label of the radio object
3032 * @param obj The radio object
3033 * @param label The text label string in UTF-8
3035 * @deprecated use elm_object_text_set() instead.
3037 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
3040 * @brief Get the text label of the radio object
3042 * @param obj The radio object
3043 * @return The text label string in UTF-8
3045 * @deprecated use elm_object_text_set() instead.
3047 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
3050 * @brief Set the icon object of the radio object
3052 * @param obj The radio object
3053 * @param icon The icon object
3055 * Once the icon object is set, a previously set one will be deleted. If you
3056 * want to keep that old content object, use the elm_radio_icon_unset()
3059 * @deprecated use elm_object_part_content_set() instead.
3062 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
3065 * @brief Get the icon object of the radio object
3067 * @param obj The radio object
3068 * @return The icon object
3070 * @see elm_radio_icon_set()
3072 * @deprecated use elm_object_part_content_get() instead.
3075 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
3078 * @brief Unset the icon used for the radio object
3080 * @param obj The radio object
3081 * @return The icon object that was being used
3083 * Unparent and return the icon object which was set for this widget.
3085 * @see elm_radio_icon_set()
3086 * @deprecated use elm_object_part_content_unset() instead.
3089 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
3092 * Set the label of a given slider widget
3094 * @param obj The progress bar object
3095 * @param label The text label string, in UTF-8
3097 * @deprecated use elm_object_text_set() instead.
3099 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
3102 * Get the label of a given slider widget
3104 * @param obj The progressbar object
3105 * @return The text label string, in UTF-8
3107 * @deprecated use elm_object_text_get() instead.
3109 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
3112 * Set the icon object of the slider object.
3114 * @param obj The slider object.
3115 * @param icon The icon object.
3117 * On horizontal mode, icon is placed at left, and on vertical mode,
3120 * @note Once the icon object is set, a previously set one will be deleted.
3121 * If you want to keep that old content object, use the
3122 * elm_slider_icon_unset() function.
3124 * @warning If the object being set does not have minimum size hints set,
3125 * it won't get properly displayed.
3127 * @deprecated use elm_object_part_content_set() instead.
3129 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3132 * Unset an icon set on a given slider widget.
3134 * @param obj The slider object.
3135 * @return The icon object that was being used, if any was set, or
3136 * @c NULL, otherwise (and on errors).
3138 * On horizontal mode, icon is placed at left, and on vertical mode,
3141 * This call will unparent and return the icon object which was set
3142 * for this widget, previously, on success.
3144 * @see elm_slider_icon_set() for more details
3145 * @see elm_slider_icon_get()
3146 * @deprecated use elm_object_part_content_unset() instead.
3149 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3152 * Retrieve the icon object set for a given slider widget.
3154 * @param obj The slider object.
3155 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3156 * otherwise (and on errors).
3158 * On horizontal mode, icon is placed at left, and on vertical mode,
3161 * @see elm_slider_icon_set() for more details
3162 * @see elm_slider_icon_unset()
3164 * @deprecated use elm_object_part_content_get() instead.
3167 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3170 * Set the end object of the slider object.
3172 * @param obj The slider object.
3173 * @param end The end object.
3175 * On horizontal mode, end is placed at left, and on vertical mode,
3178 * @note Once the icon object is set, a previously set one will be deleted.
3179 * If you want to keep that old content object, use the
3180 * elm_slider_end_unset() function.
3182 * @warning If the object being set does not have minimum size hints set,
3183 * it won't get properly displayed.
3185 * @deprecated use elm_object_part_content_set() instead.
3188 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3191 * Unset an end object set on a given slider widget.
3193 * @param obj The slider object.
3194 * @return The end object that was being used, if any was set, or
3195 * @c NULL, otherwise (and on errors).
3197 * On horizontal mode, end is placed at left, and on vertical mode,
3200 * This call will unparent and return the icon object which was set
3201 * for this widget, previously, on success.
3203 * @see elm_slider_end_set() for more details.
3204 * @see elm_slider_end_get()
3206 * @deprecated use elm_object_part_content_unset() instead
3210 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3213 * Retrieve the end object set for a given slider widget.
3215 * @param obj The slider object.
3216 * @return The end object's handle, if @p obj had one set, or @c NULL,
3217 * otherwise (and on errors).
3219 * On horizontal mode, icon is placed at right, and on vertical mode,
3222 * @see elm_slider_end_set() for more details.
3223 * @see elm_slider_end_unset()
3226 * @deprecated use elm_object_part_content_get() instead
3230 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3233 * Return the data associated with a given slideshow item
3235 * @param it The slideshow item
3236 * @return Returns the data associated to this item
3238 * @deprecated use elm_object_item_data_get() instead
3240 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3243 * Delete a given item from a slideshow widget.
3245 * @param it The slideshow item
3247 * @deprecated Use elm_object_item_de() instead
3249 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
3252 * Display a given slideshow widget's item, programmatically.
3254 * @param it The item to display on @p obj's viewport
3256 * The change between the current item and @p item will use the
3257 * transition @p obj is set to use (@see
3258 * elm_slideshow_transition_set()).
3260 * @deprecated use elm_slideshow_item_show() instead
3262 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
3265 * Get the toolbar object from an item.
3267 * @param it The item.
3268 * @return The toolbar object.
3270 * This returns the toolbar object itself that an item belongs to.
3272 * @deprecated use elm_object_item_object_get() instead.
3274 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3277 * Get the label of item.
3279 * @param it The item of toolbar.
3280 * @return The label of item.
3282 * The return value is a pointer to the label associated to @p item when
3283 * it was created, with function elm_toolbar_item_append() or similar,
3285 * with function elm_toolbar_item_label_set. If no label
3286 * was passed as argument, it will return @c NULL.
3288 * @see elm_toolbar_item_label_set() for more details.
3289 * @see elm_toolbar_item_append()
3291 * @deprecated use elm_object_item_text_get() instead.
3293 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3296 * Set the label of item.
3298 * @param it The item of toolbar.
3299 * @param label The label of item.
3301 * The label to be displayed by the item.
3302 * Label will be placed at icons bottom (if set).
3304 * If a label was passed as argument on item creation, with function
3305 * elm_toolbar_item_append() or similar, it will be already
3306 * displayed by the item.
3308 * @see elm_toolbar_item_label_get()
3309 * @see elm_toolbar_item_append()
3311 * @deprecated use elm_object_item_text_set() instead
3313 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3316 * Return the data associated with a given toolbar widget item.
3318 * @param it The toolbar widget item handle.
3319 * @return The data associated with @p item.
3321 * @see elm_toolbar_item_data_set()
3323 * @deprecated use elm_object_item_data_get() instead.
3325 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3328 * Set the data associated with a given toolbar widget item.
3330 * @param it The toolbar widget item handle
3331 * @param data The new data pointer to set to @p item.
3333 * This sets new item data on @p item.
3335 * @warning The old data pointer won't be touched by this function, so
3336 * the user had better to free that old data himself/herself.
3338 * @deprecated use elm_object_item_data_set() instead.
3340 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3343 * Get a value whether toolbar item is disabled or not.
3345 * @param it The item.
3346 * @return The disabled state.
3348 * @see elm_toolbar_item_disabled_set() for more details.
3350 * @deprecated use elm_object_item_disabled_get() instead.
3352 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3355 * Sets the disabled/enabled state of a toolbar item.
3357 * @param it The item.
3358 * @param disabled The disabled state.
3360 * A disabled item cannot be selected or unselected. It will also
3361 * change its appearance (generally greyed out). This sets the
3362 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3365 * @deprecated use elm_object_item_disabled_set() instead.
3367 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3370 * Change a toolbar's orientation
3371 * @param obj The toolbar object
3372 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3373 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3374 * @deprecated use elm_toolbar_horizontal_set() instead.
3376 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3379 * Get a toolbar's orientation
3380 * @param obj The toolbar object
3381 * @return If @c EINA_TRUE, the toolbar is vertical
3382 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3383 * @deprecated use elm_toolbar_horizontal_get() instead.
3385 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3388 * Set the function called when a toolbar item is freed.
3390 * @param it The item to set the callback on.
3391 * @param func The function called.
3393 * If there is a @p func, then it will be called prior item's memory release.
3394 * That will be called with the following arguments:
3396 * @li item's Evas object;
3399 * This way, a data associated to a toolbar item could be properly freed.
3401 * @deprecated Use elm_object_item_del_cb_set() instead
3403 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3406 * Delete them item from the toolbar.
3408 * @param it The item of toolbar to be deleted.
3410 * @deprecated Use elm_object_item_del() instead
3411 * @see elm_toolbar_item_append()
3414 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3417 * Set the content to be shown in the tooltip item.
3419 * Setup the tooltip to item. The item can have only one tooltip,
3420 * so any previous tooltip data is removed. @p func(with @p data) will
3421 * be called every time that need show the tooltip and it should
3422 * return a valid Evas_Object. This object is then managed fully by
3423 * tooltip system and is deleted when the tooltip is gone.
3425 * @param it the toolbar item being attached a tooltip.
3426 * @param func the function used to create the tooltip contents.
3427 * @param data what to provide to @a func as callback data/context.
3428 * @param del_cb called when data is not needed anymore, either when
3429 * another callback replaces @a func, the tooltip is unset with
3430 * elm_toolbar_item_tooltip_unset() or the owner @a item
3431 * dies. This callback receives as the first parameter the
3432 * given @a data, and @c event_info is the item.
3434 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3435 * @see elm_object_tooltip_content_cb_set() for more details.
3438 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
3441 * Unset tooltip from item.
3443 * @param it toolbar item to remove previously set tooltip.
3445 * Remove tooltip from item. The callback provided as del_cb to
3446 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3447 * it is not used anymore.
3449 * @deprecated Use elm_object_item_tooltip_unset() instead
3450 * @see elm_object_tooltip_unset() for more details.
3451 * @see elm_toolbar_item_tooltip_content_cb_set()
3454 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3457 * Sets a different style for this item tooltip.
3459 * @note before you set a style you should define a tooltip with
3460 * elm_toolbar_item_tooltip_content_cb_set() or
3461 * elm_toolbar_item_tooltip_text_set()
3463 * @param it toolbar item with tooltip already set.
3464 * @param style the theme style to use (default, transparent, ...)
3466 * @deprecated Use elm_object_item_tooltip_style_set() instead
3467 * @see elm_object_tooltip_style_set() for more details.
3470 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3473 * Get the style for this item tooltip.
3475 * @param it toolbar item with tooltip already set.
3476 * @return style the theme style in use, defaults to "default". If the
3477 * object does not have a tooltip set, then NULL is returned.
3479 * @deprecated Use elm_object_item_style_get() instead
3480 * @see elm_object_tooltip_style_get() for more details.
3481 * @see elm_toolbar_item_tooltip_style_set()
3484 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3487 * Set the type of mouse pointer/cursor decoration to be shown,
3488 * when the mouse pointer is over the given toolbar widget item
3490 * @param it toolbar item to customize cursor on
3491 * @param cursor the cursor type's name
3493 * This function works analogously as elm_object_cursor_set(), but
3494 * here the cursor's changing area is restricted to the item's
3495 * area, and not the whole widget's. Note that that item cursors
3496 * have precedence over widget cursors, so that a mouse over an
3497 * item with custom cursor set will always show @b that cursor.
3499 * If this function is called twice for an object, a previously set
3500 * cursor will be unset on the second call.
3502 * @see elm_object_cursor_set()
3503 * @see elm_toolbar_item_cursor_get()
3504 * @see elm_toolbar_item_cursor_unset()
3506 * @deprecated use elm_object_item_cursor_set() instead
3509 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3512 * Get the type of mouse pointer/cursor decoration set to be shown,
3513 * when the mouse pointer is over the given toolbar widget item
3515 * @param it toolbar item with custom cursor set
3516 * @return the cursor type's name or @c NULL, if no custom cursors
3517 * were set to @p item (and on errors)
3519 * @see elm_object_cursor_get()
3520 * @see elm_toolbar_item_cursor_set()
3521 * @see elm_toolbar_item_cursor_unset()
3523 * @deprecated Use elm_object_item_cursor_get() instead
3526 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3529 * Unset any custom mouse pointer/cursor decoration set to be
3530 * shown, when the mouse pointer is over the given toolbar widget
3531 * item, thus making it show the @b default cursor again.
3533 * @param it a toolbar item
3535 * Use this call to undo any custom settings on this item's cursor
3536 * decoration, bringing it back to defaults (no custom style set).
3538 * @see elm_object_cursor_unset()
3539 * @see elm_toolbar_item_cursor_set()
3541 * @deprecated Use elm_object_item_cursor_unset() instead
3544 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3547 * Set a different @b style for a given custom cursor set for a
3550 * @param it toolbar item with custom cursor set
3551 * @param style the <b>theme style</b> to use (e.g. @c "default",
3552 * @c "transparent", etc)
3554 * This function only makes sense when one is using custom mouse
3555 * cursor decorations <b>defined in a theme file</b>, which can have,
3556 * given a cursor name/type, <b>alternate styles</b> on it. It
3557 * works analogously as elm_object_cursor_style_set(), but here
3558 * applies only to toolbar item objects.
3560 * @warning Before you set a cursor style you should have defined a
3561 * custom cursor previously on the item, with
3562 * elm_toolbar_item_cursor_set()
3564 * @see elm_toolbar_item_cursor_engine_only_set()
3565 * @see elm_toolbar_item_cursor_style_get()
3567 * @deprecated Use elm_object_item_cursor_style_set() instead
3570 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3573 * Get the current @b style set for a given toolbar item's custom
3576 * @param it toolbar item with custom cursor set.
3577 * @return style the cursor style in use. If the object does not
3578 * have a cursor set, then @c NULL is returned.
3580 * @see elm_toolbar_item_cursor_style_set() for more details
3582 * @deprecated Use elm_object_item_cursor_style_get() instead
3585 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3588 * Set if the (custom)cursor for a given toolbar item should be
3589 * searched in its theme, also, or should only rely on the
3592 * @param it item with custom (custom) cursor already set on
3593 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3594 * only on those provided by the rendering engine, @c EINA_FALSE to
3595 * have them searched on the widget's theme, as well.
3597 * @note This call is of use only if you've set a custom cursor
3598 * for toolbar items, with elm_toolbar_item_cursor_set().
3600 * @note By default, cursors will only be looked for between those
3601 * provided by the rendering engine.
3603 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3606 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3609 * Get if the (custom) cursor for a given toolbar item is being
3610 * searched in its theme, also, or is only relying on the rendering
3613 * @param it a toolbar item
3614 * @return @c EINA_TRUE, if cursors are being looked for only on
3615 * those provided by the rendering engine, @c EINA_FALSE if they
3616 * are being searched on the widget's theme, as well.
3618 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3620 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3623 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3626 * @brief Link a Elm_Payer with an Elm_Video object.
3628 * @param player the Elm_Player object.
3629 * @param video The Elm_Video object.
3631 * This mean that action on the player widget will affect the
3632 * video object and the state of the video will be reflected in
3633 * the player itself.
3635 * @see elm_player_add()
3636 * @see elm_video_add()
3637 * @deprecated use elm_object_part_content_set() instead
3640 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3643 * Set the label of item.
3645 * @param it The item of segment control.
3646 * @param label The label of item.
3648 * The label to be displayed by the item.
3649 * Label will be at right of the icon (if set).
3651 * If a label was passed as argument on item creation, with function
3652 * elm_control_segment_item_add(), it will be already
3653 * displayed by the item.
3655 * @see elm_segment_control_item_label_get()
3656 * @see elm_segment_control_item_add()
3657 * @deprecated Use elm_object_item_text_set() instead
3660 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3664 * Set the icon associated to the item.
3666 * @param it The segment control item.
3667 * @param icon The icon object to associate with @p it.
3669 * The icon object to use at left side of the item. An
3670 * icon can be any Evas object, but usually it is an icon created
3671 * with elm_icon_add().
3673 * Once the icon object is set, a previously set one will be deleted.
3674 * @warning Setting the same icon for two items will cause the icon to
3675 * disappear from the first item.
3677 * If an icon was passed as argument on item creation, with function
3678 * elm_segment_control_item_add(), it will be already
3679 * associated to the item.
3681 * @see elm_segment_control_item_add()
3682 * @see elm_segment_control_item_icon_get()
3683 * @deprecated Use elm_object_item_part_content_set() instead
3686 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3689 * Remove a segment control item from its parent, deleting it.
3691 * @param it The item to be removed.
3693 * Items can be added with elm_segment_control_item_add() or
3694 * elm_segment_control_item_insert_at().
3696 * @deprecated Use elm_object_item_del() instead
3698 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3703 * @param obj The multibuttonentry object
3704 * @return The label, or NULL if none
3706 * @deprecated Use elm_object_text_get() instead
3709 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3714 * @param obj The multibuttonentry object
3715 * @param label The text label string
3717 * @deprecated Use elm_object_text_set() instead
3720 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3723 * Get the label of a given item
3725 * @param it The item
3726 * @return The label of a given item, or NULL if none
3728 * @deprecated Use elm_object_item_text_get() instead
3731 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3734 * Set the label of a given item
3736 * @param it The item
3737 * @param str The text label string
3739 * @deprecated Use elm_object_item_text_set() instead
3741 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3744 * Delete a given item
3746 * @param it The item
3748 * @deprecated Use elm_object_item_del() instead
3751 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3754 * @brief Delete the given item instantly.
3756 * @param it The naviframe item
3758 * This just deletes the given item from the naviframe item list instantly.
3759 * So this would not emit any signals for view transitions but just change
3760 * the current view if the given item is a top one.
3762 * @deprecated Use elm_object_item_del() instead
3764 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3769 * Sets the disabled/enabled state of a list item.
3771 * @param it The item.
3772 * @param disabled The disabled state.
3774 * A disabled item cannot be selected or unselected. It will also
3775 * change its appearance (generally greyed out). This sets the
3776 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3779 * @deprecated Use elm_object_item_disabled_set() instead
3782 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3785 * Get a value whether list item is disabled or not.
3787 * @param it The item.
3788 * @return The disabled state.
3790 * @see elm_list_item_disabled_set() for more details.
3792 * @deprecated Use elm_object_item_disabled_get() instead
3795 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3798 * @brief Disable size restrictions on an object's tooltip
3799 * @param it The tooltip's anchor object
3800 * @param disable If EINA_TRUE, size restrictions are disabled
3801 * @return EINA_FALSE on failure, EINA_TRUE on success
3803 * This function allows a tooltip to expand beyond its parent window's canvas.
3804 * It will instead be limited only by the size of the display.
3806 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3809 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3812 * @brief Retrieve size restriction state of an object's tooltip
3813 * @param obj The tooltip's anchor object
3814 * @return If EINA_TRUE, size restrictions are disabled
3816 * This function returns whether a tooltip is allowed to expand beyond
3817 * its parent window's canvas.
3818 * It will instead be limited only by the size of the display.
3820 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3823 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3826 * Set the function called when a list item is freed.
3828 * @param it The item to set the callback on
3829 * @param func The function called
3831 * If there is a @p func, then it will be called prior item's memory release.
3832 * That will be called with the following arguments:
3834 * @li item's Evas object;
3837 * This way, a data associated to a list item could be properly freed.
3839 * @deprecated Please use elm_object_item_del_cb_set() instead.
3842 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3845 * Get the data associated to the item.
3847 * @param it The list item
3848 * @return The data associated to @p item
3850 * The return value is a pointer to data associated to @p item when it was
3851 * created, with function elm_list_item_append() or similar. If no data
3852 * was passed as argument, it will return @c NULL.
3854 * @see elm_list_item_append()
3856 * @deprecated Please use elm_object_item_data_get() instead.
3859 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
3862 * Get the left side icon associated to the item.
3864 * @param it The list item
3865 * @return The left side icon associated to @p item
3867 * The return value is a pointer to the icon associated to @p item when
3869 * created, with function elm_list_item_append() or similar, or later
3870 * with function elm_list_item_icon_set(). If no icon
3871 * was passed as argument, it will return @c NULL.
3873 * @see elm_list_item_append()
3874 * @see elm_list_item_icon_set()
3876 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3878 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
3881 * Set the left side icon associated to the item.
3883 * @param it The list item
3884 * @param icon The left side icon object to associate with @p item
3886 * The icon object to use at left side of the item. An
3887 * icon can be any Evas object, but usually it is an icon created
3888 * with elm_icon_add().
3890 * Once the icon object is set, a previously set one will be deleted.
3891 * @warning Setting the same icon for two items will cause the icon to
3892 * disappear from the first item.
3894 * If an icon was passed as argument on item creation, with function
3895 * elm_list_item_append() or similar, it will be already
3896 * associated to the item.
3898 * @see elm_list_item_append()
3899 * @see elm_list_item_icon_get()
3901 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3903 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3906 * Get the right side icon associated to the item.
3908 * @param it The list item
3909 * @return The right side icon associated to @p item
3911 * The return value is a pointer to the icon associated to @p item when
3913 * created, with function elm_list_item_append() or similar, or later
3914 * with function elm_list_item_icon_set(). If no icon
3915 * was passed as argument, it will return @c NULL.
3917 * @see elm_list_item_append()
3918 * @see elm_list_item_icon_set()
3920 * @deprecated Please use elm_object_item_part_content_get(item, "end");
3922 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
3925 * Set the right side icon associated to the item.
3927 * @param it The list item
3928 * @param end The right side icon object to associate with @p item
3930 * The icon object to use at right side of the item. An
3931 * icon can be any Evas object, but usually it is an icon created
3932 * with elm_icon_add().
3934 * Once the icon object is set, a previously set one will be deleted.
3935 * @warning Setting the same icon for two items will cause the icon to
3936 * disappear from the first item.
3938 * If an icon was passed as argument on item creation, with function
3939 * elm_list_item_append() or similar, it will be already
3940 * associated to the item.
3942 * @see elm_list_item_append()
3943 * @see elm_list_item_end_get()
3945 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3947 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3950 * Get the label of item.
3952 * @param it The item of list.
3953 * @return The label of item.
3955 * The return value is a pointer to the label associated to @p item when
3956 * it was created, with function elm_list_item_append(), or later
3957 * with function elm_list_item_label_set. If no label
3958 * was passed as argument, it will return @c NULL.
3960 * @see elm_list_item_label_set() for more details.
3961 * @see elm_list_item_append()
3963 * @deprecated Please use elm_object_item_text_get(item);
3965 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
3968 * Set the label of item.
3970 * @param it The item of list.
3971 * @param text The label of item.
3973 * The label to be displayed by the item.
3974 * Label will be placed between left and right side icons (if set).
3976 * If a label was passed as argument on item creation, with function
3977 * elm_list_item_append() or similar, it will be already
3978 * displayed by the item.
3980 * @see elm_list_item_label_get()
3981 * @see elm_list_item_append()
3983 * @deprecated Please use elm_object_item_text_set(item, text);
3985 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3988 * Set the text to be shown in a given list item's tooltips.
3990 * @param it Target item.
3991 * @param text The text to set in the content.
3993 * Setup the text as tooltip to object. The item can have only one tooltip,
3994 * so any previous tooltip data - set with this function or
3995 * elm_list_item_tooltip_content_cb_set() - is removed.
3997 * @deprecated Use elm_object_item_tooltip_text_set() instead
3998 * @see elm_object_tooltip_text_set() for more details.
4001 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
4004 * Set the content to be shown in the tooltip item.
4006 * Setup the tooltip to item. The item can have only one tooltip,
4007 * so any previous tooltip data is removed. @p func(with @p data) will
4008 * be called every time that need show the tooltip and it should
4009 * return a valid Evas_Object. This object is then managed fully by
4010 * tooltip system and is deleted when the tooltip is gone.
4012 * @param it the list item being attached a tooltip.
4013 * @param func the function used to create the tooltip contents.
4014 * @param data what to provide to @a func as callback data/context.
4015 * @param del_cb called when data is not needed anymore, either when
4016 * another callback replaces @a func, the tooltip is unset with
4017 * elm_list_item_tooltip_unset() or the owner @a item
4018 * dies. This callback receives as the first parameter the
4019 * given @a data, and @c event_info is the item.
4021 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
4023 * @see elm_object_tooltip_content_cb_set() for more details.
4026 EINA_DEPRECATED EAPI void elm_list_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
4029 * Unset tooltip from item.
4031 * @param it list item to remove previously set tooltip.
4033 * Remove tooltip from item. The callback provided as del_cb to
4034 * elm_list_item_tooltip_content_cb_set() will be called to notify
4035 * it is not used anymore.
4037 * @deprecated Use elm_object_item_tooltip_unset() instead
4038 * @see elm_object_tooltip_unset() for more details.
4039 * @see elm_list_item_tooltip_content_cb_set()
4042 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
4045 * Sets a different style for this item tooltip.
4047 * @note before you set a style you should define a tooltip with
4048 * elm_list_item_tooltip_content_cb_set() or
4049 * elm_list_item_tooltip_text_set()
4051 * @param it list item with tooltip already set.
4052 * @param style the theme style to use (default, transparent, ...)
4055 * @deprecated Use elm_object_item_tooltip_style_set() instead
4056 * @see elm_object_tooltip_style_set() for more details.
4059 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
4062 * Get the style for this item tooltip.
4064 * @param it list item with tooltip already set.
4065 * @return style the theme style in use, defaults to "default". If the
4066 * object does not have a tooltip set, then NULL is returned.
4068 * @deprecated Use elm_object_item_tooltip_style_get() instead
4070 * @see elm_object_tooltip_style_get() for more details.
4071 * @see elm_list_item_tooltip_style_set()
4074 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
4077 * Set the type of mouse pointer/cursor decoration to be shown,
4078 * when the mouse pointer is over the given list widget item
4080 * @param it list item to customize cursor on
4081 * @param cursor the cursor type's name
4083 * This function works analogously as elm_object_cursor_set(), but
4084 * here the cursor's changing area is restricted to the item's
4085 * area, and not the whole widget's. Note that that item cursors
4086 * have precedence over widget cursors, so that a mouse over an
4087 * item with custom cursor set will always show @b that cursor.
4089 * If this function is called twice for an object, a previously set
4090 * cursor will be unset on the second call.
4092 * @see elm_object_cursor_set()
4093 * @see elm_list_item_cursor_get()
4094 * @see elm_list_item_cursor_unset()
4096 * @deprecated Please use elm_object_item_cursor_set() instead
4098 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
4101 * Get the type of mouse pointer/cursor decoration set to be shown,
4102 * when the mouse pointer is over the given list widget item
4104 * @param it list item with custom cursor set
4105 * @return the cursor type's name or @c NULL, if no custom cursors
4106 * were set to @p item (and on errors)
4108 * @see elm_object_cursor_get()
4109 * @see elm_list_item_cursor_set()
4110 * @see elm_list_item_cursor_unset()
4112 * @deprecated Please use elm_object_item_cursor_get() instead
4114 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
4117 * Unset any custom mouse pointer/cursor decoration set to be
4118 * shown, when the mouse pointer is over the given list widget
4119 * item, thus making it show the @b default cursor again.
4121 * @param it a list item
4123 * Use this call to undo any custom settings on this item's cursor
4124 * decoration, bringing it back to defaults (no custom style set).
4126 * @see elm_object_cursor_unset()
4127 * @see elm_list_item_cursor_set()
4129 * @deprecated Please use elm_list_item_cursor_unset() instead
4131 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
4134 * Set a different @b style for a given custom cursor set for a
4137 * @param it list item with custom cursor set
4138 * @param style the <b>theme style</b> to use (e.g. @c "default",
4139 * @c "transparent", etc)
4141 * This function only makes sense when one is using custom mouse
4142 * cursor decorations <b>defined in a theme file</b>, which can have,
4143 * given a cursor name/type, <b>alternate styles</b> on it. It
4144 * works analogously as elm_object_cursor_style_set(), but here
4145 * applies only to list item objects.
4147 * @warning Before you set a cursor style you should have defined a
4148 * custom cursor previously on the item, with
4149 * elm_list_item_cursor_set()
4151 * @see elm_list_item_cursor_engine_only_set()
4152 * @see elm_list_item_cursor_style_get()
4154 * @deprecated Please use elm_list_item_cursor_style_set() instead
4156 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
4159 * Get the current @b style set for a given list item's custom
4162 * @param it list item with custom cursor set.
4163 * @return style the cursor style in use. If the object does not
4164 * have a cursor set, then @c NULL is returned.
4166 * @see elm_list_item_cursor_style_set() for more details
4168 * @deprecated Please use elm_list_item_cursor_style_get() instead
4170 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
4173 * Get if the (custom) cursor for a given list item is being
4174 * searched in its theme, also, or is only relying on the rendering
4177 * @param it a list item
4178 * @return @c EINA_TRUE, if cursors are being looked for only on
4179 * those provided by the rendering engine, @c EINA_FALSE if they
4180 * are being searched on the widget's theme, as well.
4182 * @see elm_list_item_cursor_engine_only_set(), for more details
4184 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
4186 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
4189 * Delete the item from the list.
4191 * @param it The item of list to be deleted.
4193 * If deleting all list items is required, elm_list_clear()
4194 * should be used instead of getting items list and deleting each one.
4196 * @see elm_list_clear()
4197 * @see elm_list_item_append()
4198 * @see elm_widget_item_del_cb_set()
4199 * @deprecated Use elm_object_item_del() instead
4202 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
4206 * This sets a widget to be displayed to the left of a scrolled entry.
4208 * @param obj The scrolled entry object
4209 * @param icon The widget to display on the left side of the scrolled
4212 * @note A previously set widget will be destroyed.
4213 * @note If the object being set does not have minimum size hints set,
4214 * it won't get properly displayed.
4216 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4217 * @see elm_entry_end_set()
4219 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4222 * Gets the leftmost widget of the scrolled entry. This object is
4223 * owned by the scrolled entry and should not be modified.
4225 * @param obj The scrolled entry object
4226 * @return the left widget inside the scroller
4228 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4230 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
4233 * Unset the leftmost widget of the scrolled entry, unparenting and
4236 * @param obj The scrolled entry object
4237 * @return the previously set icon sub-object of this entry, on
4240 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4241 * @see elm_entry_icon_set()
4243 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
4246 * This sets a widget to be displayed to the end of a scrolled entry.
4248 * @param obj The scrolled entry object
4249 * @param end The widget to display on the right side of the scrolled
4252 * @note A previously set widget will be destroyed.
4253 * @note If the object being set does not have minimum size hints set,
4254 * it won't get properly displayed.
4256 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4257 * @see elm_entry_icon_set
4259 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4262 * Gets the endmost widget of the scrolled entry. This object is owned
4263 * by the scrolled entry and should not be modified.
4265 * @param obj The scrolled entry object
4266 * @return the right widget inside the scroller
4268 * @deprecated Use elm_object_part_content_get(entry, "end") instead
4270 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
4273 * Unset the endmost widget of the scrolled entry, unparenting and
4276 * @param obj The scrolled entry object
4277 * @return the previously set icon sub-object of this entry, on
4280 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4281 * @see elm_entry_icon_set()
4283 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
4286 * Set route service to be used. By default used source is
4287 * #ELM_MAP_ROUTE_SOURCE_YOURS.
4289 * @see elm_map_route_source_set()
4290 * @see elm_map_route_source_get()
4295 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
4296 ELM_MAP_ROUTE_SOURCE_MONAV, /**< MoNav offers exact routing without heuristic assumptions. Its routing core is based on Contraction Hierarchies. It's not working with Map yet. */
4297 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
4298 ELM_MAP_ROUTE_SOURCE_LAST
4299 } Elm_Map_Route_Sources;
4302 * Convert a pixel coordinate into a rotated pixel coordinate.
4304 * @param obj The map object.
4305 * @param x horizontal coordinate of the point to rotate.
4306 * @param y vertical coordinate of the point to rotate.
4307 * @param cx rotation's center horizontal position.
4308 * @param cy rotation's center vertical position.
4309 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4310 * @param xx Pointer where to store rotated x.
4311 * @param yy Pointer where to store rotated y.
4313 * @deprecated Use elm_map_canvas_to_geo_convert() instead
4315 EINA_DEPRECATED EAPI void elm_map_utils_rotate_coord(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, const Evas_Coord cx, const Evas_Coord cy, const double degree, Evas_Coord *xx, Evas_Coord *yy);
4318 * Convert canvas coordinates into a geographic coordinate
4319 * (longitude, latitude).
4321 * @param obj The map object.
4322 * @param x horizontal coordinate of the point to convert.
4323 * @param y vertical coordinate of the point to convert.
4324 * @param lon A pointer to the longitude.
4325 * @param lat A pointer to the latitude.
4327 * This gets longitude and latitude from canvas x, y coordinates. The canvas
4328 * coordinates mean x, y coordinate from current viewport.
4330 * see elm_map_rotate_get()
4331 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
4334 EINA_DEPRECATED EAPI void elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat);
4337 * Get the current geographic coordinates of the map.
4339 * @param obj The map object.
4340 * @param lon Pointer to store longitude.
4341 * @param lat Pointer to store latitude.
4343 * This gets the current center coordinates of the map object. It can be
4344 * set by elm_map_region_bring_in() and elm_map_region_show().
4346 * @see elm_map_region_bring_in()
4347 * @see elm_map_region_show()
4349 * @deprecated Use elm_map_region_get() instead
4351 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
4354 * Animatedly bring in given coordinates to the center of the map.
4356 * @param obj The map object.
4357 * @param lon Longitude to center at.
4358 * @param lat Latitude to center at.
4360 * This causes map to jump to the given @p lat and @p lon coordinates
4361 * and show it (by scrolling) in the center of the viewport, if it is not
4362 * already centered. This will use animation to do so and take a period
4363 * of time to complete.
4365 * @see elm_map_region_show() for a function to avoid animation.
4366 * @see elm_map_region_get()
4368 * @deprecated Use elm_map_region_bring_in() instead
4370 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
4373 * Show the given coordinates at the center of the map, @b immediately.
4375 * @param obj The map object.
4376 * @param lon Longitude to center at.
4377 * @param lat Latitude to center at.
4379 * This causes map to @b redraw its viewport's contents to the
4380 * region containing the given @p lat and @p lon, that will be moved to the
4381 * center of the map.
4383 * @see elm_map_region_bring_in() for a function to move with animation.
4384 * @see elm_map_region_get()
4386 * @deprecated Use elm_map_region_show() instead
4388 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
4391 * Set the minimum zoom of the source.
4393 * @param obj The map object.
4394 * @param zoom New minimum zoom value to be used.
4396 * By default, it's 0.
4398 * @deprecated Use elm_map_zoom_min_set() instead
4400 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4403 * Get the minimum zoom of the source.
4405 * @param obj The map object.
4406 * @return Returns the minimum zoom of the source.
4408 * @see elm_map_zoom_min_set() for details.
4410 * @deprecated Use elm_map_zoom_min_get() instead
4412 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
4415 * Set the maximum zoom of the source.
4417 * @param obj The map object.
4418 * @param zoom New maximum zoom value to be used.
4420 * By default, it's 18.
4422 * @deprecated Use elm_map_zoom_max_set() instead
4424 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4427 * Get the maximum zoom of the source.
4429 * @param obj The map object.
4430 * @return Returns the maximum zoom of the source.
4432 * @see elm_map_zoom_min_set() for details.
4434 * @deprecated Use elm_map_zoom_max_get() instead
4436 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
4440 * Get the list of available sources.
4442 * @param obj The map object.
4443 * @return The source names list.
4445 * It will provide a list with all available sources, that can be set as
4446 * current source with elm_map_source_name_set(), or get with
4447 * elm_map_source_name_get().
4449 * Available sources:
4455 * @see elm_map_source_name_set() for more details.
4456 * @see elm_map_source_name_get()
4457 * @deprecated Use elm_map_sources_get() instead
4460 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
4463 * Set the source of the map.
4465 * @param obj The map object.
4466 * @param source_name The source to be used.
4468 * Map widget retrieves images that composes the map from a web service.
4469 * This web service can be set with this method.
4471 * A different service can return a different maps with different
4472 * information and it can use different zoom values.
4474 * The @p source_name need to match one of the names provided by
4475 * elm_map_source_names_get().
4477 * The current source can be get using elm_map_source_name_get().
4479 * @see elm_map_source_names_get()
4480 * @see elm_map_source_name_get()
4481 * @deprecated Use elm_map_source_set() instead
4484 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
4487 * Get the name of currently used source.
4489 * @param obj The map object.
4490 * @return Returns the name of the source in use.
4492 * @see elm_map_source_name_set() for more details.
4493 * @deprecated Use elm_map_source_get() instead
4496 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
4499 * Set the source of the route service to be used by the map.
4501 * @param obj The map object.
4502 * @param source The route service to be used, being it one of
4503 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4504 * and #ELM_MAP_ROUTE_SOURCE_ORS.
4506 * Each one has its own algorithm, so the route retrieved may
4507 * differ depending on the source route. Now, only the default is working.
4509 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4510 * http://www.yournavigation.org/.
4512 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4513 * assumptions. Its routing core is based on Contraction Hierarchies.
4515 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4517 * @see elm_map_route_source_get().
4518 * @deprecated Use elm_map_source_set() instead
4521 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4524 * Get the current route source.
4526 * @param obj The map object.
4527 * @return The source of the route service used by the map.
4529 * @see elm_map_route_source_set() for details.
4530 * @deprecated Use elm_map_source_get() instead
4533 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4536 * Set the maximum numbers of markers' content to be displayed in a group.
4538 * @param obj The map object.
4539 * @param max The maximum numbers of items displayed in a bubble.
4541 * A bubble will be displayed when the user clicks over the group,
4542 * and will place the content of markers that belong to this group
4545 * A group can have a long list of markers, consequently the creation
4546 * of the content of the bubble can be very slow.
4548 * In order to avoid this, a maximum number of items is displayed
4551 * By default this number is 30.
4553 * Marker with the same group class are grouped if they are close.
4555 * @see elm_map_marker_add()
4557 * @deprecated Use Elm_Map_Overlay instead
4559 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4562 * Set to show markers during zoom level changes or not.
4564 * @param obj The map object.
4565 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4568 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4571 * The default is off.
4573 * This will stop zooming using animation, changing zoom levels will
4574 * change instantly. This will stop any existing animations that are running.
4576 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4579 * The default is off.
4581 * Enabling it will force the map to stop displaying the markers during
4582 * zoom level changes. Set to on if you have a large number of markers.
4584 * @see elm_map_paused_markers_get()
4586 * @deprecated Use Elm_Map_Overlay instead
4588 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4591 * Get a value whether markers will be displayed on zoom level changes or not
4593 * @param obj The map object.
4594 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4595 * indicates it will.
4597 * This gets the current markers paused state for the map object.
4599 * @see elm_map_paused_markers_set() for details.
4601 * @deprecated Use Elm_Map_Overlay instead
4603 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj);
4606 * Close all the bubbles opened by the user.
4608 * @param obj The map object.
4610 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4611 * when the user clicks on a marker.
4613 * This functions is set for the marker class with
4614 * elm_map_marker_class_get_cb_set().
4616 * @deprecated Use Elm_Map_Overlay instead
4618 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj);
4621 * Set the marker's style of a group class.
4623 * @param clas The group class.
4624 * @param style The style to be used by markers.
4626 * Each marker must be associated to a group class, and will use the style
4627 * defined by such class when grouped to other markers.
4629 * The following styles are provided by default theme:
4630 * @li @c radio - blue circle
4631 * @li @c radio2 - green circle
4634 * @see elm_map_group_class_new() for more details.
4635 * @see elm_map_marker_add()
4637 * @deprecated Use Elm_Map_Overlay instead
4639 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4642 * Set the icon callback function of a group class.
4644 * @param clas The group class.
4645 * @param icon_get The callback function that will return the icon.
4647 * Each marker must be associated to a group class, and it can display a
4648 * custom icon. The function @p icon_get must return this icon.
4650 * @see elm_map_group_class_new() for more details.
4651 * @see elm_map_marker_add()
4653 * @deprecated Use Elm_Map_Overlay instead
4655 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4658 * Set the data associated to the group class.
4660 * @param clas The group class.
4661 * @param data The new user data.
4663 * This data will be passed for callback functions, like icon get callback,
4664 * that can be set with elm_map_group_class_icon_cb_set().
4666 * If a data was previously set, the object will lose the pointer for it,
4667 * so if needs to be freed, you must do it yourself.
4669 * @see elm_map_group_class_new() for more details.
4670 * @see elm_map_group_class_icon_cb_set()
4671 * @see elm_map_marker_add()
4673 * @deprecated Use Elm_Map_Overlay instead
4675 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4678 * Set the minimum zoom from where the markers are displayed.
4680 * @param clas The group class.
4681 * @param zoom The minimum zoom.
4683 * Markers only will be displayed when the map is displayed at @p zoom
4686 * @see elm_map_group_class_new() for more details.
4687 * @see elm_map_marker_add()
4689 * @deprecated Use Elm_Map_Overlay instead
4691 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4694 * Set the zoom from where the markers are no more grouped.
4696 * @param clas The group class.
4697 * @param zoom The maximum zoom.
4699 * Markers only will be grouped when the map is displayed at
4700 * less than @p zoom.
4702 * @see elm_map_group_class_new() for more details.
4703 * @see elm_map_marker_add()
4705 * @deprecated Use Elm_Map_Overlay instead
4707 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4710 * Set if the markers associated to the group class @p clas are hidden or not.
4712 * @param clas The group class.
4713 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4716 * @param obj The map object.
4717 * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4720 * @deprecated Use Elm_Map_Overlay instead
4722 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4725 * Set the marker's style of a marker class.
4727 * @param clas The marker class.
4728 * @param style The style to be used by markers.
4730 * Each marker must be associated to a marker class, and will use the style
4731 * defined by such class when alone, i.e., @b not grouped to other markers.
4733 * The following styles are provided by default theme:
4738 * @see elm_map_marker_class_new() for more details.
4739 * @see elm_map_marker_add()
4741 * @deprecated Use Elm_Map_Overlay instead
4743 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4746 * Set the icon callback function of a marker class.
4748 * @param clas The marker class.
4749 * @param icon_get The callback function that will return the icon.
4751 * Each marker must be associated to a marker class, and it can display a
4752 * custom icon. The function @p icon_get must return this icon.
4754 * @see elm_map_marker_class_new() for more details.
4755 * @see elm_map_marker_add()
4757 * @deprecated Use Elm_Map_Overlay instead
4759 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4762 * Set the bubble content callback function of a marker class.
4764 * @param clas The marker class.
4765 * @param get The callback function that will return the content.
4767 * Each marker must be associated to a marker class, and it can display a
4768 * a content on a bubble that opens when the user click over the marker.
4769 * The function @p get must return this content object.
4771 * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4774 * @see elm_map_marker_class_new() for more details.
4775 * @see elm_map_marker_class_del_cb_set()
4776 * @see elm_map_marker_add()
4778 * @deprecated Use Elm_Map_Overlay instead
4780 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4783 * Set the callback function used to delete bubble content of a marker class.
4785 * @param clas The marker class.
4786 * @param del The callback function that will delete the content.
4788 * Each marker must be associated to a marker class, and it can display a
4789 * a content on a bubble that opens when the user click over the marker.
4790 * The function to return such content can be set with
4791 * elm_map_marker_class_get_cb_set().
4793 * If this content must be freed, a callback function need to be
4794 * set for that task with this function.
4796 * If this callback is defined it will have to delete (or not) the
4797 * object inside, but if the callback is not defined the object will be
4798 * destroyed with evas_object_del().
4800 * @see elm_map_marker_class_new() for more details.
4801 * @see elm_map_marker_class_get_cb_set()
4802 * @see elm_map_marker_add()
4804 * @deprecated Use Elm_Map_Overlay instead
4806 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4809 * Set the route color.
4811 * @param route The route object.
4812 * @param r Red channel value, from 0 to 255.
4813 * @param g Green channel value, from 0 to 255.
4814 * @param b Blue channel value, from 0 to 255.
4815 * @param a Alpha channel value, from 0 to 255.
4817 * It uses an additive color model, so each color channel represents
4818 * how much of each primary colors must to be used. 0 represents
4819 * absence of this color, so if all of the three are set to 0,
4820 * the color will be black.
4822 * These component values should be integers in the range 0 to 255,
4823 * (single 8-bit byte).
4825 * This sets the color used for the route. By default, it is set to
4826 * solid red (r = 255, g = 0, b = 0, a = 255).
4828 * For alpha channel, 0 represents completely transparent, and 255, opaque.
4830 * @see elm_map_route_color_get()
4831 * @deprecated Use elm_map_overlay_color_set() instead
4834 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4837 * Get the route color.
4839 * @param route The route object.
4840 * @param r Pointer to store the red channel value.
4841 * @param g Pointer to store the green channel value.
4842 * @param b Pointer to store the blue channel value.
4843 * @param a Pointer to store the alpha channel value.
4845 * @see elm_map_route_color_set() for details.
4846 * @deprecated Use elm_map_overlay_color_get() instead
4849 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4852 * Remove a name from the map.
4854 * @param name The name to remove.
4856 * Basically the struct handled by @p name will be freed, so conversions
4857 * between address and coordinates will be lost.
4859 * @see elm_map_utils_convert_name_into_coord()
4860 * @see elm_map_utils_convert_coord_into_name()
4861 * @deprecated Use elm_map_name_del() instead
4864 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name);
4867 * Get the gengrid object's handle which contains a given gengrid item
4869 * @param it The item to fetch the container from
4870 * @return The gengrid (parent) object
4872 * This returns the gengrid object itself that an item belongs to.
4874 * @deprecated Use elm_object_item_widget_get() instead
4876 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4879 * Return the data associated to a given gengrid item
4881 * @param it The gengrid item.
4882 * @return the data associated with this item.
4884 * This returns the @c data value passed on the
4885 * elm_gengrid_item_append() and related item addition calls.
4887 * @see elm_gengrid_item_append()
4888 * @see elm_gengrid_item_data_set()
4889 * @deprecated Use elm_object_item_data_get() instead
4891 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4894 * Set the data associated with a given gengrid item
4896 * @param it The gengrid item
4897 * @param data The data pointer to set on it
4899 * This @b overrides the @c data value passed on the
4900 * elm_gengrid_item_append() and related item addition calls. This
4901 * function @b won't call elm_gengrid_item_update() automatically,
4902 * so you'd issue it afterwards if you want to have the item
4903 * updated to reflect the new data.
4905 * @see elm_gengrid_item_data_get()
4906 * @see elm_gengrid_item_update()
4907 * @deprecated Use elm_object_item_data_set() instead
4910 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4913 * Set whether a given gengrid item is disabled or not.
4915 * @param it The gengrid item
4916 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4917 * to enable it back.
4919 * A disabled item cannot be selected or unselected. It will also
4920 * change its appearance, to signal the user it's disabled.
4922 * @see elm_gengrid_item_disabled_get()
4923 * @deprecated Use elm_object_item_disabled_set() instead
4926 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4929 * Get whether a given gengrid item is disabled or not.
4931 * @param it The gengrid item
4932 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4935 * @see elm_gengrid_item_disabled_set() for more details
4936 * @deprecated Use elm_object_item_disabled_get() instead
4939 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4942 * Remove a gengrid item from its parent, deleting it.
4944 * @param it The item to be removed.
4945 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4947 * @see elm_gengrid_clear(), to remove all items in a gengrid at
4949 * @deprecated use elm_object_item_de() instead
4952 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
4955 * Update the item class of a gengrid item.
4957 * This sets another class of the item, changing the way that it is
4958 * displayed. After changing the item class, elm_gengrid_item_update() is
4959 * called on the item @p it.
4961 * @param it The gengrid item
4962 * @param gic The gengrid item class describing the function pointers and the item style.
4964 * @deprecated Use elm_gengrid_item_item_class_update instead
4966 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
4969 * Insert an item in a gengrid widget using a user-defined sort function.
4971 * @param obj The gengrid object.
4972 * @param gic The item class for the item.
4973 * @param data The item data.
4974 * @param comp User defined comparison function that defines the sort order
4975 * based on Elm_Gen_Item.
4976 * @param func Convenience function called when the item is selected.
4977 * @param func_data Data to be passed to @p func.
4978 * @return A handle to the item added or @c NULL, on errors.
4980 * This inserts an item in the gengrid based on user defined comparison function.
4982 * @see elm_gengrid_item_append()
4983 * @see elm_gengrid_item_prepend()
4984 * @see elm_gengrid_item_insert_after()
4985 * @see elm_object_item_del()
4986 * @see elm_gengrid_item_sorted_insert()
4988 * @deprecated Use elm_gengrid_item_sorted_insert() instead
4990 EINA_DEPRECATED EAPI Elm_Object_Item *elm_gengrid_item_direct_sorted_insert(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Eina_Compare_Cb comp, Evas_Smart_Cb func, const void *func_data);
4993 * Append a filter function for text inserted in the entry
4995 * Append the given callback to the list. This functions will be called
4996 * whenever any text is inserted into the entry, with the text to be inserted
4997 * as a parameter. The callback function is free to alter the text in any way
4998 * it wants, but it must remember to free the given pointer and update it.
4999 * If the new text is to be discarded, the function can free it and set its
5000 * text parameter to NULL. This will also prevent any following filters from
5003 * @param obj The entry object
5004 * @param func The function to use as text filter
5005 * @param data User data to pass to @p func
5006 * @deprecated use elm_entry_markup_filter_append() instead
5008 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5011 * Prepend a filter function for text inserted in the entry
5013 * Prepend the given callback to the list. See elm_entry_text_filter_append()
5014 * for more information
5016 * @param obj The entry object
5017 * @param func The function to use as text filter
5018 * @param data User data to pass to @p func
5019 * @deprecated use elm_entry_markup_filter_prepend() instead
5021 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5024 * Remove a filter from the list
5026 * Removes the given callback from the filter list. See
5027 * elm_entry_text_filter_append() for more information.
5029 * @param obj The entry object
5030 * @param func The filter function to remove
5031 * @param data The user data passed when adding the function
5032 * @deprecated use elm_entry_markup_filter_remove() instead
5034 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5037 * @brief Set the front content of the flip widget.
5039 * @param obj The flip object
5040 * @param content The new front content object
5042 * Once the content object is set, a previously set one will be deleted.
5043 * If you want to keep that old content object, use the
5044 * elm_flip_content_front_unset() function.
5046 * @deprecated Use elm_object_part_content_set(flip, "front") instead
5048 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
5051 * @brief Set the back content of the flip widget.
5053 * @param obj The flip object
5054 * @param content The new back content object
5056 * Once the content object is set, a previously set one will be deleted.
5057 * If you want to keep that old content object, use the
5058 * elm_flip_content_back_unset() function.
5060 * @deprecated Use elm_object_part_content_set(flip, "back") instead
5062 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
5065 * @brief Get the front content used for the flip
5067 * @param obj The flip object
5068 * @return The front content object that is being used
5070 * Return the front content object which is set for this widget.
5072 * @deprecated Use elm_object_part_content_get(flip, "front") instead
5074 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj);
5077 * @brief Get the back content used for the flip
5079 * @param obj The flip object
5080 * @return The back content object that is being used
5082 * Return the back content object which is set for this widget.
5084 * @deprecated Use elm_object_part_content_get(flip, "back") instead
5086 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj);
5089 * @brief Unset the front content used for the flip
5091 * @param obj The flip object
5092 * @return The front content object that was being used
5094 * Unparent and return the front content object which was set for this widget.
5096 * @deprecated Use elm_object_part_content_unset(flip, "front") instead
5098 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj);
5101 * @brief Unset the back content used for the flip
5103 * @param obj The flip object
5104 * @return The back content object that was being used
5106 * Unparent and return the back content object which was set for this widget.
5108 * @deprecated Use elm_object_part_content_unset(flip, "back") instead
5110 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj);
5113 * @brief Get flip front visibility state
5115 * @param obj The flip object
5116 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
5119 * @deprecated Use elm_flip_front_visible_get() instead
5121 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj);
5124 * @brief Set the font size on the label object.
5126 * @param obj The label object
5127 * @param size font size
5129 * @warning NEVER use this. It is for hyper-special cases only. use styles
5130 * instead. e.g. "default", "marker", "slide_long" etc.
5131 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
5133 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize);
5136 * @brief Set the text color on the label object
5138 * @param obj The label object
5139 * @param r Red property background color of The label object
5140 * @param g Green property background color of The label object
5141 * @param b Blue property background color of The label object
5142 * @param a Alpha property background color of The label object
5144 * @warning NEVER use this. It is for hyper-special cases only. use styles
5145 * instead. e.g. "default", "marker", "slide_long" etc.
5146 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
5148 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5151 * @brief Set the text align on the label object
5153 * @param obj The label object
5154 * @param align align mode ("left", "center", "right")
5156 * @warning NEVER use this. It is for hyper-special cases only. use styles
5157 * instead. e.g. "default", "marker", "slide_long" etc.
5158 * @deprecated Use <align> tag instead. about <align> tag - Either "auto" (meaning according to text direction), "left", "right", "center", "middle", a value between 0.0 and 1.0, or a value between 0% to 100%.
5160 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
5163 * @brief Set background color of the label
5165 * @param obj The label object
5166 * @param r Red property background color of The label object
5167 * @param g Green property background color of The label object
5168 * @param b Blue property background color of The label object
5169 * @param a Alpha property background alpha of The label object
5171 * @warning NEVER use this. It is for hyper-special cases only. use styles
5172 * instead. e.g. "default", "marker", "slide_long" etc.
5173 * @deprecated Just make colored background by yourself.
5175 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5178 * @brief Set wrap height of the label
5180 * @param obj The label object
5181 * @param h The wrap height in pixels at a minimum where words need to wrap
5183 * This function sets the maximum height size hint of the label.
5185 * @warning This is only relevant if the label is inside a container.
5186 * @deprecated This function should not be used because of wrong concept.
5188 EINA_DEPRECATED EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
5191 * @brief get wrap width of the label
5193 * @param obj The label object
5194 * @return The wrap height in pixels at a minimum where words need to wrap
5195 * @deprecated This function should not be used because of wrong concept.
5197 EINA_DEPRECATED EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj);
5200 * @brief Flush all caches.
5202 * Frees all data that was in cache and is not currently being used to reduce
5203 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
5204 * to calling all of the following functions:
5205 * @li edje_file_cache_flush()
5206 * @li edje_collection_cache_flush()
5207 * @li eet_clearcache()
5208 * @li evas_image_cache_flush()
5209 * @li evas_font_cache_flush()
5210 * @li evas_render_dump()
5211 * @note Evas caches are flushed for every canvas associated with a window.
5212 * @deprecated Use elm_cache_all_flush() instead.
5214 EINA_DEPRECATED EAPI void elm_all_flush(void);
5218 * @brief Define the uri that will be the video source.
5220 * @param video The video object to define the file for.
5221 * @param uri The uri to target.
5223 * This function will define an uri as a source for the video of the
5224 * Elm_Video object. URI could be remote source of video, like http:// or local
5225 * like for example WebCam who are most of the time v4l2:// (but that depend an
5226 * you should use Emotion API to request and list the available Webcam on your
5228 * @deprecated Use elm_video_file_set() instead.
5231 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri);
5234 * @brief Get the region of the image that is currently shown
5237 * @param x A pointer to the X-coordinate of region
5238 * @param y A pointer to the Y-coordinate of region
5239 * @param w A pointer to the width
5240 * @param h A pointer to the height
5242 * @deprecated Use elm_photocam_image_region_get() instead.
5244 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
5247 * @brief Set the gesture state for photocam.
5249 * @param obj The photocam object
5250 * @param gesture The gesture state to set
5252 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
5253 * photocam. The default is off. This will start multi touch zooming.
5255 * @deprecated Use elm_photocam_gesture_enabled_set() instead.
5257 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
5260 * @brief Get the gesture state for photocam.
5262 * @param obj The photocam object
5263 * @return The current gesture state
5265 * This gets the current gesture state for the photocam object.
5267 * @deprecated Use elm_photocam_gesture_enabled_get() instead.
5269 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj);
5270 /* No documentation for these API before.
5272 * @deprecated Use elm_route_latitude_min_max_get()
5273 * elm_route_longitude_min_max_get()
5276 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj);
5277 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj);
5278 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj);
5279 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj);
5283 * Get the duration after which tooltip will be shown.
5285 * @return Duration after which tooltip will be shown.
5286 * @deprecated Use elm_config_tooltip_delay_get(void);
5288 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void);
5291 * Set the duration after which tooltip will be shown.
5293 * @return EINA_TRUE if value is set.
5294 * @deprecated Use elm_config_tooltip_delay_set(double delay);
5296 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay);
5299 * Set the corner of the bubble
5301 * @param obj The bubble object.
5302 * @param corner The given corner for the bubble.
5304 * @deprecated Use elm_bubble_pos_set()
5307 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
5310 * Get the corner of the bubble
5312 * @param obj The bubble object.
5313 * @return The given corner for the bubble.
5315 * @deprecated Use elm_bubble_pos_get()
5317 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
5320 * Enable or disable day selection
5322 * @param obj The calendar object.
5323 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
5326 * @deprecated Use elm_calendar_day_selection_disabled_set()
5328 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
5331 * Get a value whether day selection is enabled or not.
5333 * @param obj The calendar object.
5334 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
5335 * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
5337 * @deprecated elm_calendar_day_selection_disabled_get()
5339 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
5342 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
5344 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
5347 * Get the configured font cache size
5349 * This gets the globally configured font cache size, in bytes.
5351 * @return The font cache size
5352 * @deprecated elm_cache_font_cache_size_get(void);
5354 EINA_DEPRECATED EAPI int elm_font_cache_get(void);
5357 * Set the configured font cache size
5359 * This sets the globally configured font cache size, in bytes
5361 * @param size The font cache size
5362 * @deprecated elm_cache_font_cache_size_set(int size);
5364 EINA_DEPRECATED EAPI void elm_font_cache_set(int size);
5367 * Get the configured image cache size
5369 * This gets the globally configured image cache size, in bytes
5371 * @return The image cache size
5373 EINA_DEPRECATED EAPI int elm_image_cache_get(void);
5374 EINA_DEPRECATED EAPI int elm_cache_image_cache_size_get(void);
5377 * Set the configured image cache size
5379 * This sets the globally configured image cache size, in bytes
5381 * @param size The image cache size
5382 * @deprecated Use elm_cache_image_cache_size_set(int size);
5384 EINA_DEPRECATED EAPI void elm_image_cache_set(int size);
5388 * Get the configured edje file cache size.
5390 * This gets the globally configured edje file cache size, in number
5393 * @return The edje file cache size
5394 * @deprecated Use elm_cache_edje_file_cache_size_get(void);
5396 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void);
5399 * Set the configured edje file cache size
5401 * This sets the globally configured edje file cache size, in number
5404 * @param size The edje file cache size
5405 * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
5407 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size);
5410 * Get the configured edje collections (groups) cache size.
5412 * This gets the globally configured edje collections cache size, in
5413 * number of collections.
5415 * @return The edje collections cache size
5416 * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
5418 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void);
5421 * Set the configured edje collections (groups) cache size
5423 * This sets the globally configured edje collections cache size, in
5424 * number of collections.
5426 * @param size The edje collections cache size
5427 * @deprecated elm_cache_edje_collection_cache_size_set(int size);
5429 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size);
5432 * Gets whether browsing history is enabled for the given object
5434 * @param obj The web object
5436 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
5438 * @deprecated Use elm_web_history_enabled_get()
5440 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj);
5443 * Enables or disables the browsing history
5445 * @param obj The web object
5446 * @param enable Whether to enable or disable the browsing history
5448 * @deprecated Use elm_web_history_enabled_set()
5451 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
5454 * @brief Add an object swallowed in an item at the end of the given menu
5457 * @param obj The menu object.
5458 * @param parent The parent menu item (optional)
5459 * @param subobj The object to swallow
5460 * @param func Function called when the user select the item.
5461 * @param data Data sent by the callback.
5462 * @return Returns the new item.
5464 * Add an evas object as an item to the menu.
5465 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
5467 EINA_DEPRECATED EAPI Elm_Object_Item *elm_menu_item_add_object(Evas_Object *obj, Elm_Object_Item *parent, Evas_Object *subobj, Evas_Smart_Cb func, const void *data);
5470 * @brief Sets whether events should be passed to by a click outside
5473 * @param obj The notify object
5474 * @param repeat EINA_TRUE Events are repeats, else no
5476 * When true if the user clicks outside the window the events will be caught
5477 * by the others widgets, else the events are blocked.
5479 * @note The default value is EINA_TRUE.
5480 * @deprecated Please use elm_notify_allow_events_set() instead
5482 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
5485 * @brief Return true if events are repeat below the notify object
5486 * @param obj the notify object
5488 * @see elm_notify_repeat_events_set()
5489 * @deprecated Please use elm_notify_allow_events_get() instead
5491 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj);
5494 * Set if the cursor set should be searched on the theme or should use
5495 * the provided by the engine, only.
5497 * @param obj an object with cursor already set.
5498 * @param engine_only boolean to define if cursors should be looked only
5499 * between the provided by the engine or searched on widget's theme as well.
5501 * @deprecated Use elm_object_cursor_theme_search_enabled_set()
5503 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5506 * Get the cursor engine only usage for this object cursor.
5508 * @param obj an object with cursor already set.
5509 * @return engine_only boolean to define it cursors should be
5510 * looked only between the provided by the engine or searched on
5511 * widget's theme as well. If the object does not have a cursor
5512 * set, then EINA_FALSE is returned.
5514 * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5516 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj);
5519 * Go to a given items level on a index widget
5521 * @param obj The index object
5522 * @param level The index level (one of @c 0 or @c 1)
5524 * @deprecated please use "elm_index_level_go" instead.
5526 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level);
5529 * Enable or disable auto hiding feature for a given index widget.
5531 * @param obj The index object
5532 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5534 * @see elm_index_active_get()
5536 * @deprecated please use "elm_index_autohide_disabled_set" instead.
5538 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5541 * Get whether auto hiding feature is enabled or not for a given index widget.
5543 * @param obj The index object
5544 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5546 * @see elm_index_active_set() for more details
5548 * @deprecated please use "elm_index_autohide_disabled_get" instead.
5550 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
5553 * Append a new item, on a given index widget, <b>after the item
5554 * having @p relative as data</b>.
5556 * @param obj The index object.
5557 * @param letter Letter under which the item should be indexed
5558 * @param item The item data to set for the index's item
5559 * @param relative The index item to be the predecessor of this new one
5560 * @return A handle to the item added or @c NULL, on errors
5562 * Despite the most common usage of the @p letter argument is for
5563 * single char strings, one could use arbitrary strings as index
5566 * @c item will be the pointer returned back on @c "changed", @c
5567 * "delay,changed" and @c "selected" smart events.
5569 * @note If @p relative is @c NULL this function will behave as
5570 * elm_index_item_append().
5572 * @deprecated please use "elm_index_item_insert_after" instead.
5574 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5577 * Prepend a new item, on a given index widget, <b>after the item
5578 * having @p relative as data</b>.
5580 * @param obj The index object.
5581 * @param letter Letter under which the item should be indexed
5582 * @param item The item data to set for the index's item
5583 * @param relative The index item to be the successor of this new one
5584 * @return A handle to the item added or @c NULL, on errors
5586 * Despite the most common usage of the @p letter argument is for
5587 * single char strings, one could use arbitrary strings as index
5590 * @c item will be the pointer returned back on @c "changed", @c
5591 * "delay,changed" and @c "selected" smart events.
5593 * @note If @p relative is @c NULL this function will behave as
5594 * elm_index_item_prepend().
5596 * @deprecated please use "elm_index_item_insert_before" instead.
5598 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5601 * Set the transparency state of a window.
5603 * Use elm_win_alpha_set() instead.
5605 * @param obj The window object
5606 * @param transparent If true, the window is transparent
5608 * @see elm_win_alpha_set()
5609 * @deprecated Please use elm_win_alpha_set()
5611 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5614 * Get the transparency state of a window.
5616 * @param obj The window object
5617 * @return If true, the window is transparent
5619 * @see elm_win_transparent_set()
5620 * @deprecated Please use elm_win_alpha_get()
5622 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj);
5625 * Set the theme for all elementary using applications on the current display
5627 * @param theme The name of the theme to use. Format same as the ELM_THEME
5628 * environment variable.
5629 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5631 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme);
5634 * Returns the Evas_Object that represents the content area.
5636 * @param obj The conformant object.
5637 * @return The content area of the widget.
5640 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
5643 * Set if the object is (up/down) resizable.
5645 * @param obj The image object
5646 * @param scale_up A bool to set if the object is resizable up. Default is
5648 * @param scale_down A bool to set if the object is resizable down. Default
5651 * This function limits the image resize ability. If @p scale_up is set to
5652 * @c EINA_FALSE, the object can't have its height or width resized to a value
5653 * higher than the original image size. Same is valid for @p scale_down.
5655 * @see elm_image_scale_get()
5656 * @deprecated Please use elm_image_resizable_set()
5659 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5662 * Get if the object is (up/down) resizable.
5664 * @param obj The image object
5665 * @param scale_up A bool to set if the object is resizable up
5666 * @param scale_down A bool to set if the object is resizable down
5668 * @see elm_image_scale_set()
5669 * @deprecated Please use elm_image_resizable_get()
5672 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5675 * Set if the object is (up/down) resizable.
5677 * @param obj The icon object
5678 * @param scale_up A bool to set if the object is resizable up. Default is
5680 * @param scale_down A bool to set if the object is resizable down. Default
5683 * This function limits the icon object resize ability. If @p scale_up is set to
5684 * @c EINA_FALSE, the object can't have its height or width resized to a value
5685 * higher than the original icon size. Same is valid for @p scale_down.
5687 * @see elm_icon_scale_get()
5688 * @deprecated Please use elm_icon_resizable_set()
5691 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5694 * Get if the object is (up/down) resizable.
5696 * @param obj The icon object
5697 * @param scale_up A bool to set if the object is resizable up
5698 * @param scale_down A bool to set if the object is resizable down
5700 * @see elm_icon_scale_set()
5701 * @deprecated Please use elm_icon_resizable_get()
5704 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5707 * Enable or disable preloading of the icon
5709 * @param obj The icon object
5710 * @param disable If EINA_TRUE, preloading will be disabled
5711 * @deprecated Use elm_icon_preload_disabled_set() instead
5713 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5716 * Returns the last selected item, for a given index widget.
5718 * @param obj The index object.
5719 * @return The last item @b selected on @p obj (or @c NULL, on errors).
5720 * @deprecated Please use elm_index_selected_item_get() instead.
5724 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
5727 * Get the value of shrink_mode state.
5729 * @deprecated elm_multibuttonentry_expanded_get()
5731 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5734 * Set/Unset the multibuttonentry to shrink mode state of single line
5736 * @deprecated elm_multibuttonentry_expanded_set()
5738 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5741 * Get the guide text
5743 * @param obj The multibuttonentry object
5744 * @return The guide text, or NULL if none
5746 * @deprecated Please use elm_object_part_text_get(obj, "guide");
5748 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5751 * Set the guide text
5753 * @param obj The multibuttonentry object
5754 * @param guidetext The guide text string
5756 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5758 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5761 * Make the elementary object and its children to be unfocusable
5764 * @param obj The Elementary object to operate on
5765 * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5766 * @c EINA_FALSE for focusable.
5768 * This sets whether the object @p obj and its children objects
5769 * are able to take focus or not. If the tree is set as unfocusable,
5770 * newest focused object which is not in this tree will get focus.
5771 * This API can be helpful for an object to be deleted.
5772 * When an object will be deleted soon, it and its children may not
5773 * want to get focus (by focus reverting or by other focus controls).
5774 * Then, just use this API before deleting.
5776 * @see elm_object_tree_unfocusable_get()
5778 * @deprecated Please use elm_object_tree_unfocusable_set()
5780 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5783 * Get whether an Elementary object and its children are unfocusable or not.
5785 * @param obj The Elementary object to get the information from
5786 * @return @c EINA_TRUE, if the tree is unfocussable,
5787 * @c EINA_FALSE if not (and on errors).
5789 * @see elm_object_tree_unfocusable_set()
5791 * @deprecated Please use elm_object_tree_unfocusable_get()
5793 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj);
5796 * Animatedly bring in, to the visible are of a genlist, a given
5799 * @deprecated elm_genlist_item_bring_in()
5801 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5804 * Animatedly bring in, to the visible are of a genlist, a given
5807 * @deprecated elm_genlist_item_bring_in()
5809 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5812 * Show the portion of a genlist's internal list containing a given
5813 * item, immediately.
5815 * @param it The item to display
5817 * @deprecated elm_genlist_item_show()
5820 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it);
5823 * Show the portion of a genlist's internal list containing a given
5824 * item, immediately.
5826 * @param it The item to display
5828 * @deprecated elm_genlist_item_show()
5831 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it);
5834 * Enable or disable round mode.
5836 * @param obj The diskselector object.
5837 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
5840 * Disabled by default. If round mode is enabled the items list will
5841 * work like a circle list, so when the user reaches the last item,
5842 * the first one will popup.
5844 * @see elm_diskselector_round_enabled_get()
5846 * @deprecated elm_diskselector_round_enabled_set()
5848 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
5851 * Set whether items on a given gengrid widget are to get their
5852 * selection callbacks issued for @b every subsequent selection
5853 * click on them or just for the first click.
5855 * @param obj The gengrid object
5856 * @param always_select @c EINA_TRUE to make items "always
5857 * selected", @c EINA_FALSE, otherwise
5859 * By default, grid items will only call their selection callback
5860 * function when firstly getting selected, any subsequent further
5861 * clicks will do nothing. With this call, you make those
5862 * subsequent clicks also to issue the selection callbacks.
5864 * @note <b>Double clicks</b> will @b always be reported on items.
5866 * @see elm_gengrid_always_select_mode_get()
5869 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5872 * Get whether items on a given gengrid widget have their selection
5873 * callbacks issued for @b every subsequent selection click on them
5874 * or just for the first click.
5876 * @param obj The gengrid object.
5877 * @return @c EINA_TRUE if the gengrid items are "always selected",
5878 * @c EINA_FALSE, otherwise
5880 * @see elm_gengrid_always_select_mode_set() for more details
5883 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj);
5886 * Set whether items on a given gengrid widget can be selected or not.
5888 * @param obj The gengrid object
5889 * @param no_select @c EINA_TRUE to make items selectable,
5890 * @c EINA_FALSE otherwise
5892 * This will make items in @p obj selectable or not. In the latter
5893 * case, any user interaction on the gengrid items will neither make
5894 * them appear selected nor them call their selection callback
5897 * @see elm_gengrid_no_select_mode_get()
5900 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5903 * Get whether items on a given gengrid widget can be selected or
5906 * @param obj The gengrid object
5907 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
5910 * @see elm_gengrid_no_select_mode_set() for more details
5913 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj);
5916 * Get the side labels max length.
5918 * @see elm_diskselector_side_text_max_length_set() for details.
5920 * @param obj The diskselector object.
5921 * @return The max length defined for side labels, or 0 if not a valid
5924 * @deprecated elm_diskselector_side_text_max_length_get()
5926 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj);
5929 * Set the side labels max length.
5931 * @param obj The diskselector object.
5932 * @param len The max length defined for side labels.
5934 * Length is the number of characters of items' label that will be
5935 * visible when it's set on side positions. It will just crop
5936 * the string after defined size. E.g.:
5938 * An item with label "January" would be displayed on side position as
5939 * "Jan" if max length is set to 3, or "Janu", if this property
5942 * When it's selected, the entire label will be displayed, except for
5943 * width restrictions. In this case label will be cropped and "..."
5944 * will be concatenated.
5946 * Default side label max length is 3.
5948 * This property will be applied over all items, included before or
5949 * later this function call.
5951 * @deprecated elm_diskselector_side_text_max_length_set()
5953 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
5956 * Set whether the toolbar should always have an item selected.
5958 * @param obj The toolbar object.
5959 * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to
5962 * This will cause the toolbar to always have an item selected, and clicking
5963 * the selected item will not cause a selected event to be emitted. Enabling this mode
5964 * will immediately select the first toolbar item.
5966 * Always-selected is disabled by default.
5968 * @see elm_toolbar_always_select_mode_get().
5972 EINA_DEPRECATED EAPI void elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5975 * Get whether the toolbar should always have an item selected.
5977 * @param obj The toolbar object.
5978 * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates
5979 * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned.
5981 * @see elm_toolbar_always_select_mode_set() for details.
5985 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_always_select_mode_get(const Evas_Object *obj);
5988 * Set whether the toolbar items' should be selected by the user or not.
5990 * @param obj The toolbar object.
5991 * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to
5994 * This will turn off the ability to select items entirely and they will
5995 * neither appear selected nor emit selected signals. The clicked
5996 * callback function will still be called.
5998 * Selection is enabled by default.
6000 * @see elm_toolbar_no_select_mode_get().
6004 EINA_DEPRECATED EAPI void elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6007 * Set whether the toolbar items' should be selected by the user or not.
6009 * @param obj The toolbar object.
6010 * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates
6011 * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned.
6013 * @see elm_toolbar_no_select_mode_set() for details.
6017 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_no_select_mode_get(const Evas_Object *obj);
6020 * Set the interval on time updates for a user mouse button hold
6021 * on clock widgets' time edition.
6023 * @param obj The clock object
6024 * @param interval The (first) interval value in seconds
6026 * This interval value is @b decreased while the user holds the
6027 * mouse pointer either incrementing or decrementing a given the
6028 * clock digit's value.
6030 * This helps the user to get to a given time distant from the
6031 * current one easier/faster, as it will start to flip quicker and
6032 * quicker on mouse button holds.
6034 * The calculation for the next flip interval value, starting from
6035 * the one set with this call, is the previous interval divided by
6036 * 1.05, so it decreases a little bit.
6038 * The default starting interval value for automatic flips is
6041 * @deprecated elm_clock_first_interval_set()
6044 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval);
6047 * Get the interval on time updates for a user mouse button hold
6048 * on clock widgets' time edition.
6050 * @param obj The clock object
6051 * @return The (first) interval value, in seconds, set on it
6053 * @elm_clock_first_interval_get()
6055 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj);
6058 * Set what digits of the given clock widget should be editable
6059 * when in edition mode.
6061 * @param obj The clock object
6062 * @param digedit Bit mask indicating the digits to be editable
6063 * (values in #Elm_Clock_Edit_Mode).
6065 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
6066 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
6069 * @deprecated elm_clock_edit_mode_set()
6071 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
6074 * Retrieve what digits of the given clock widget should be
6075 * editable when in edition mode.
6077 * @param obj The clock object
6078 * @return Bit mask indicating the digits to be editable
6079 * (values in #Elm_Clock_Edit_Mode).
6081 * @deprecated elm_clock_edit_mode_get()
6083 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
6086 * Queries whether it's possible to go back in history
6088 * @param obj The web object
6090 * @return EINA_TRUE if it's possible to back in history, EINA_FALSE
6092 * @deprecated elm_web_back_possible_get();
6094 EINA_DEPRECATED EAPI Eina_Bool elm_web_backward_possible(Evas_Object *obj);
6097 * Queries whether it's possible to go forward in history
6099 * @param obj The web object
6101 * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE
6104 * @deprecated elm_web_forward_possible_get();
6106 EINA_DEPRECATED EAPI Eina_Bool elm_web_forward_possible(Evas_Object *obj);
6109 * Queries whether it's possible to jump the given number of steps
6111 * @deprecated elm_web_navigate_possible_get();
6114 EINA_DEPRECATED EAPI Eina_Bool elm_web_navigate_possible(Evas_Object *obj, int steps);
6117 * @brief Set the content of the scroller widget (the object to be scrolled around).
6119 * @param obj The scroller object
6120 * @param content The new content object
6122 * Once the content object is set, a previously set one will be deleted.
6123 * If you want to keep that old content object, use the
6124 * elm_scroller_content_unset() function.
6125 * @deprecated use elm_object_content_set() instead
6127 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
6130 * @brief Get the content of the scroller widget
6132 * @param obj The slider object
6133 * @return The content that is being used
6135 * Return the content object which is set for this widget
6137 * @see elm_scroller_content_set()
6138 * @deprecated use elm_object_content_get() instead.
6140 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
6143 * @brief Unset the content of the scroller widget
6145 * @param obj The slider object
6146 * @return The content that was being used
6148 * Unparent and return the content object which was set for this widget
6150 * @see elm_scroller_content_set()
6151 * @deprecated use elm_object_content_unset() instead.
6153 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
6156 * Set the shrink state of toolbar @p obj.
6158 * @param obj The toolbar object.
6159 * @param shrink_mode Toolbar's items display behavior.
6161 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
6162 * but will enforce a minimum size so all the items will fit, won't scroll
6163 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
6164 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
6165 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
6167 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
6169 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
6172 * Get the shrink mode of toolbar @p obj.
6174 * @param obj The toolbar object.
6175 * @return Toolbar's items display behavior.
6177 * @see elm_toolbar_shrink_mode_set() for details.
6179 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
6181 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
6184 * Set the text to be shown in a given toolbar item's tooltips.
6186 * @param it toolbar item.
6187 * @param text The text to set in the content.
6189 * Setup the text as tooltip to object. The item can have only one tooltip,
6190 * so any previous tooltip data - set with this function or
6191 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
6193 * @deprecated Use elm_object_item_tooltip_text_set() instead
6194 * @see elm_object_tooltip_text_set() for more details.
6197 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
6200 * Enable or disable always select mode on the list object.
6202 * @param obj The list object
6203 * @param always_select @c EINA_TRUE to enable always select mode or
6204 * @c EINA_FALSE to disable it.
6206 * @note Always select mode is disabled by default.
6208 * Default behavior of list items is to only call its callback function
6209 * the first time it's pressed, i.e., when it is selected. If a selected
6210 * item is pressed again, and multi-select is disabled, it won't call
6211 * this function (if multi-select is enabled it will unselect the item).
6213 * If always select is enabled, it will call the callback function
6214 * every time a item is pressed, so it will call when the item is selected,
6215 * and again when a selected item is pressed.
6217 * @deprecated elm_list_always_select_mode_set()
6219 EINA_DEPRECATED EAPI void elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6222 * Get a value whether always select mode is enabled or not, meaning that
6223 * an item will always call its callback function, even if already selected.
6225 * @param obj The list object
6226 * @return @c EINA_TRUE means horizontal mode selection is enabled.
6227 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
6228 * @c EINA_FALSE is returned.
6230 * @see elm_list_always_select_mode_set() for details.
6232 * @deprecated elm_list_always_select_mode_get()
6234 EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj);
6237 * Get the real Evas object created to implement the view of a
6238 * given genlist item
6240 * @param it The genlist item.
6241 * @return the Evas object implementing this item's view.
6243 * This returns the actual Evas object used to implement the
6244 * specified genlist item's view. This may be @c NULL, as it may
6245 * not have been created or may have been deleted, at any time, by
6246 * the genlist. <b>Do not modify this object</b> (move, resize,
6247 * show, hide, etc.), as the genlist is controlling it. This
6248 * function is for querying, emitting custom signals or hooking
6249 * lower level callbacks for events on that object. Do not delete
6250 * this object under any circumstances.
6252 * @see elm_object_item_data_get()
6253 * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit().
6256 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
6259 * Set the always select mode.
6261 * @param obj The genlist object
6262 * @param always_select The always select mode (@c EINA_TRUE = on, @c
6263 * EINA_FALSE = off). Default is @c EINA_FALSE.
6265 * Items will only call their selection func and callback when first
6266 * becoming selected. Any further clicks will do nothing, unless you
6267 * enable always select with elm_genlist_always_select_mode_set().
6268 * This means that, even if selected, every click will make the selected
6269 * callbacks be called.
6271 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_ALWAYS); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode.
6274 EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6278 * Get the always select mode.
6280 * @param obj The genlist object
6281 * @return The always select mode
6282 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6284 * @deprecated use elm_genlist_select_mode_get instead.
6287 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj);
6290 * Enable/disable the no select mode.
6292 * @param obj The genlist object
6293 * @param no_select The no select mode
6294 * (EINA_TRUE = on, EINA_FALSE = off)
6296 * This will turn off the ability to select items entirely and they
6297 * will neither appear selected nor call selected callback functions.
6299 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_NONE); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode.
6302 EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6305 * Gets whether the no select mode is enabled.
6307 * @param obj The genlist object
6308 * @return The no select mode
6309 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6311 * @deprecated use elm_genlist_select_mode_get instead.
6314 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj);
6317 * Enable/disable compress mode.
6319 * @param obj The genlist object
6320 * @param compress The compress mode
6321 * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE.
6323 * This will enable the compress mode where items are "compressed"
6324 * horizontally to fit the genlist scrollable viewport width. This is
6325 * special for genlist. Do not rely on
6326 * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to
6327 * work as genlist needs to handle it specially.
6329 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6331 EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress);
6334 * Sets the display only state of an item.
6336 * @param it The item
6337 * @param display_only @c EINA_TRUE if the item is display only, @c
6338 * EINA_FALSE otherwise.
6340 * A display only item cannot be selected or unselected. It is for
6341 * display only and not selecting or otherwise clicking, dragging
6342 * etc. by the user, thus finger size rules will not be applied to
6345 * It's good to set group index items to display only state.
6347 * @see elm_genlist_item_display_only_get()
6349 * @deprecated elm_genlist_item_display_only_set()
6351 EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only);
6354 * Get the display only state of an item
6356 * @param it The item
6357 * @return @c EINA_TRUE if the item is display only, @c
6358 * EINA_FALSE otherwise.
6360 * @see elm_genlist_item_display_only_set()
6362 * @deprecated elm_genlist_item_display_only_get()
6364 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it);
6367 * Get whether the compress mode is enabled.
6369 * @param obj The genlist object
6370 * @return The compress mode
6371 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6373 * @deprecated elm_genlsit_mode_get()
6375 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj);
6378 * Enable/disable height-for-width mode.
6380 * @param obj The genlist object
6381 * @param height_for_width The height-for-width mode (@c EINA_TRUE = on,
6382 * @c EINA_FALSE = off). Default is @c EINA_FALSE.
6384 * With height-for-width mode the item width will be fixed (restricted
6385 * to a minimum of) to the list width when calculating its size in
6386 * order to allow the height to be calculated based on it. This allows,
6387 * for instance, text block to wrap lines if the Edje part is
6388 * configured with "text.min: 0 1".
6390 * @note This mode will make list resize slower as it will have to
6391 * recalculate every item height again whenever the list width
6394 * @note When height-for-width mode is enabled, it also enables
6395 * compress mode (see elm_genlist_compress_mode_set()) and
6396 * disables homogeneous (see elm_genlist_homogeneous_set()).
6398 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6400 EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width);
6403 * Get whether the height-for-width mode is enabled.
6405 * @param obj The genlist object
6406 * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE =
6409 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6411 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj);
6414 * Activate a genlist mode on an item
6416 * @param it The genlist item
6417 * @param mode_type Mode name
6418 * @param mode_set Boolean to define set or unset mode.
6420 * A genlist mode is a different way of selecting an item. Once a mode is
6421 * activated on an item, any other selected item is immediately unselected.
6422 * This feature provides an easy way of implementing a new kind of animation
6423 * for selecting an item, without having to entirely rewrite the item style
6424 * theme. However, the elm_genlist_selected_* API can't be used to get what
6425 * item is activate for a mode.
6427 * The current item style will still be used, but applying a genlist mode to
6428 * an item will select it using a different kind of animation.
6430 * The current active item for a mode can be found by
6431 * elm_genlist_decorated_item_get().
6433 * The characteristics of genlist mode are:
6434 * - Only one mode can be active at any time, and for only one item.
6435 * - Genlist handles deactivating other items when one item is activated.
6436 * - A mode is defined in the genlist theme (edc), and more modes can easily
6438 * - A mode style and the genlist item style are different things. They
6439 * can be combined to provide a default style to the item, with some kind
6440 * of animation for that item when the mode is activated.
6442 * When a mode is activated on an item, a new view for that item is created.
6443 * The theme of this mode defines the animation that will be used to transit
6444 * the item from the old view to the new view. This second (new) view will be
6445 * active for that item while the mode is active on the item, and will be
6446 * destroyed after the mode is totally deactivated from that item.
6448 * @deprecated elm_genlist_item_decorate_mode_set()
6450 EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set);
6453 * Get the last (or current) genlist mode used.
6455 * @param obj The genlist object
6457 * This function just returns the name of the last used genlist mode. It will
6458 * be the current mode if it's still active.
6460 * @deprecated elm_genlist_item_decorate_mode_get()
6462 EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj);
6465 * Get active genlist mode item
6467 * @param obj The genlist object
6468 * @return The active item for that current mode. Or @c NULL if no item is
6469 * activated with any mode.
6471 * This function returns the item that was activated with a mode, by the
6472 * function elm_genlist_item_decorate_mode_set().
6474 * @deprecated elm_genlist_decorated_item_get()
6476 EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj);
6479 * Set Genlist edit mode
6481 * This sets Genlist edit mode.
6483 * @param obj The Genlist object
6484 * @param The edit mode status
6485 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
6487 * @deprecated elm_genlist_decorate_mode_set
6489 EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode);
6492 * Get Genlist edit mode
6494 * @param obj The genlist object
6495 * @return The edit mode status
6496 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
6498 * @deprecated elm_genlist_decorate_mode_get()
6500 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj);