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 * @brief Get Elementary's rendering engine in use.
17 * @return The rendering engine's name
18 * @note there's no need to free the returned string, here.
20 * This gets the global rendering engine that is applied to all Elementary
23 * @see elm_engine_set()
24 * @deprecated Use elm_engine_get() instead.
26 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
29 * Set the configured finger size for all applications on the display
31 * This sets the globally configured finger size in pixels for all
32 * applications on the display
34 * @param size The finger size
36 * @deprecated Use elm_finger_size_set() and elm_config_all_flush()
38 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size);
41 * Set the global scaling factor for all applications on the display
43 * This sets the globally configured scaling factor that is applied to all
44 * objects for all applications.
45 * @param scale The scaling factor to set
47 * @deprecated use elm_scale_set() and elm_config_all_flush()
49 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale);
52 * Apply the changes made with elm_font_overlay_set() and
53 * elm_font_overlay_unset() on all Elementary application windows.
57 * This applies all font overlays set to all objects in the UI.
58 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
60 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void);
63 * Set the configured cache flush interval time for all applications on the
66 * This sets the globally configured cache flush interval time -- in ticks
67 * -- for all applications on the display.
69 * @param size The cache flush interval time
70 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
73 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size);
76 * Set the configured cache flush enabled state for all applications on the
79 * This sets the globally configured cache flush enabled state for all
80 * applications on the display.
82 * @param enabled The cache flush enabled state
83 * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
86 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled);
89 * Set the configured font cache size for all applications on the
92 * This sets the globally configured font cache size -- in bytes
93 * -- for all applications on the display.
95 * @param size The font cache size
96 * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
99 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size);
102 * Set the configured image cache size for all applications on the
105 * This sets the globally configured image cache size -- in bytes
106 * -- for all applications on the display.
108 * @param size The image cache size
109 * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
112 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size);
115 * Set the configured edje file cache size for all applications on the
118 * This sets the globally configured edje file cache size -- in number
119 * of files -- for all applications on the display.
121 * @param size The edje file cache size
122 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
125 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size);
128 * Set the configured edje collections (groups) cache size for all
129 * applications on the display
131 * This sets the globally configured edje collections cache size -- in
132 * number of collections -- for all applications on the display.
134 * @param size The edje collections cache size
135 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
138 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size);
141 * Set Elementary's profile.
143 * This sets the global profile that is applied to all Elementary
144 * applications. All running Elementary windows will be affected.
146 * @param profile The profile's name
147 * @deprecated Use elm_profile_set() and elm_config_all_flush()
151 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile);
154 * Set whether scrollers should bounce when they reach their
155 * viewport's edge during a scroll, for all Elementary application
158 * @param enabled the thumb scroll bouncing state
160 * @see elm_thumbscroll_bounce_enabled_get()
161 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
164 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
167 * Set the amount of inertia a scroller will impose at bounce
168 * animations, for all Elementary application windows.
170 * @param friction the thumb scroll bounce friction
172 * @see elm_thumbscroll_bounce_friction_get()
173 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
176 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction);
179 * Set the amount of inertia a <b>paged</b> scroller will impose at
180 * page fitting animations, for all Elementary application windows.
182 * @param friction the page scroll friction
184 * @see elm_thumbscroll_page_scroll_friction_get()
185 * @deprecated Use elm_scroll_page_scroll_friction_set() and
186 * elm_config_all_flush()
189 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
192 * Set the amount of inertia a scroller will impose at region bring
193 * animations, for all Elementary application windows.
195 * @param friction the bring in scroll friction
197 * @see elm_thumbscroll_bring_in_scroll_friction_get()
198 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
199 * elm_config_all_flush()
202 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
205 * Set the amount of inertia scrollers will impose at animations
206 * triggered by Elementary widgets' zooming API, for all Elementary
207 * application windows.
209 * @param friction the zoom friction
211 * @see elm_thumbscroll_zoom_friction_get()
212 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
215 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction);
218 * Set whether scrollers should be draggable from any point in their
219 * views, for all Elementary application windows.
221 * @param enabled the thumb scroll state
223 * @see elm_thumbscroll_enabled_get()
224 * @deprecated Use elm_scroll_thumbscroll_enabled_set()
225 * and elm_config_all_flush()
229 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
233 * Set the number of pixels one should travel while dragging a
234 * scroller's view to actually trigger scrolling, for all Elementary
235 * application windows.
237 * @param threshold the thumb scroll threshold
239 * @see elm_thumbscroll_threshold_get()
240 * @deprecated Use elm_scroll_thumbscroll_threshold_set()
241 * and elm_config_all_flush()
245 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
248 * Set the minimum speed of mouse cursor movement which will trigger
249 * list self scrolling animation after a mouse up event
250 * (pixels/second), for all Elementary application windows.
252 * @param threshold the thumb scroll momentum threshold
254 * @see elm_thumbscroll_momentum_threshold_get()
255 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
256 * and elm_config_all_flush()
260 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
263 * Set the amount of inertia a scroller will impose at self scrolling
264 * animations, for all Elementary application windows.
266 * @param friction the thumb scroll friction
268 * @see elm_thumbscroll_friction_get()
269 * @deprecated Use elm_scroll_thumbscroll_friction_set()
270 * and elm_config_all_flush()
274 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
277 * Set the amount of lag between your actual mouse cursor dragging
278 * movement and a scroller's view movement itself, while pushing it
279 * into bounce state manually, for all Elementary application windows.
281 * @param friction the thumb scroll border friction. @c 0.0 for
282 * perfect synchrony between two movements, @c 1.0 for maximum
285 * @see elm_thumbscroll_border_friction_get()
286 * @note parameter value will get bound to 0.0 - 1.0 interval, always
287 * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
288 * and elm_config_all_flush()
292 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
295 * Set the sensitivity amount which is be multiplied by the length of
296 * mouse dragging, for all Elementary application windows.
298 * @param friction the thumb scroll sensitivity friction. @c 0.1 for
299 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
302 * @see elm_thumbscroll_sensitivity_friction_get()
303 * @note parameter value will get bound to 0.1 - 1.0 interval, always
304 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
305 * and elm_config_all_flush()
309 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
311 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
312 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
313 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
314 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
315 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
316 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
317 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
318 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
319 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
320 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
321 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
323 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
324 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
325 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
326 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
327 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
328 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
329 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
330 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
331 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
332 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
335 * Get the widget object's handle which contains a given item
337 * @param it The Elementary object item
338 * @return The widget object
340 * @note This returns the widget object itself that an item belongs to.
341 * @note Every elm_object_item supports this API
342 * @deprecated Use elm_object_item_widget_get() instead
345 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it);
348 * Set the text to show in the anchorblock
350 * Sets the text of the anchorblock to @p text. This text can include markup
351 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
352 * of text that will be specially styled and react to click events, ended
353 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
354 * "anchor,clicked" signal that you can attach a callback to with
355 * evas_object_smart_callback_add(). The name of the anchor given in the
356 * event info struct will be the one set in the href attribute, in this
359 * Other markup can be used to style the text in different ways, but it's
360 * up to the style defined in the theme which tags do what.
361 * @deprecated use elm_object_text_set() instead.
363 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
366 * Get the markup text set for the anchorblock
368 * Retrieves the text set on the anchorblock, with markup tags included.
370 * @param obj The anchorblock object
371 * @return The markup text set or @c NULL if nothing was set or an error
373 * @deprecated use elm_object_text_set() instead.
375 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
378 * Set the text to show in the anchorview
380 * Sets the text of the anchorview to @p text. This text can include markup
381 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
382 * text that will be specially styled and react to click events, ended with
383 * either of \</a\> or \</\>. When clicked, the anchor will emit an
384 * "anchor,clicked" signal that you can attach a callback to with
385 * evas_object_smart_callback_add(). The name of the anchor given in the
386 * event info struct will be the one set in the href attribute, in this
389 * Other markup can be used to style the text in different ways, but it's
390 * up to the style defined in the theme which tags do what.
391 * @deprecated use elm_object_text_set() instead.
393 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
396 * Get the markup text set for the anchorview
398 * Retrieves the text set on the anchorview, with markup tags included.
400 * @param obj The anchorview object
401 * @return The markup text set or @c NULL if nothing was set or an error
403 * @deprecated use elm_object_text_set() instead.
405 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
408 * @brief Get the ctxpopup item's disabled/enabled state.
410 * @param it Ctxpopup item to be enabled/disabled
411 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
413 * @see elm_ctxpopup_item_disabled_set()
414 * @deprecated use elm_object_item_disabled_get() instead
418 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
421 * @brief Set the ctxpopup item's state as disabled or enabled.
423 * @param it Ctxpopup item to be enabled/disabled
424 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
426 * When disabled the item is greyed out to indicate it's state.
427 * @deprecated use elm_object_item_disabled_set() instead
431 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
434 * @brief Get the icon object for the given ctxpopup item.
436 * @param it Ctxpopup item
437 * @return icon object or @c NULL, if the item does not have icon or an error
440 * @see elm_ctxpopup_item_append()
441 * @see elm_ctxpopup_item_icon_set()
443 * @deprecated use elm_object_item_part_content_get() instead
447 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
450 * @brief Sets the side icon associated with the ctxpopup item
452 * @param it Ctxpopup item
453 * @param icon Icon object to be set
455 * Once the icon object is set, a previously set one will be deleted.
456 * @warning Setting the same icon for two items will cause the icon to
457 * disappear from the first item.
459 * @see elm_ctxpopup_item_append()
461 * @deprecated use elm_object_item_part_content_set() instead
465 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
468 * @brief Get the label for the given ctxpopup item.
470 * @param it Ctxpopup item
471 * @return label string or @c NULL, if the item does not have label or an
474 * @see elm_ctxpopup_item_append()
475 * @see elm_ctxpopup_item_label_set()
477 * @deprecated use elm_object_item_text_get() instead
481 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
484 * @brief (Re)set the label on the given ctxpopup item.
486 * @param it Ctxpopup item
487 * @param label String to set as label
489 * @deprecated use elm_object_item_text_set() instead
493 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
496 * @brief Set an elm widget as the content of the ctxpopup.
498 * @param obj Ctxpopup object
499 * @param content Content to be swallowed
501 * If the content object is already set, a previous one will be deleted. If
502 * you want to keep that old content object, use the
503 * elm_ctxpopup_content_unset() function.
505 * @warning Ctxpopup can't hold both a item list and a content at the same
506 * time. When a content is set, any previous items will be removed.
508 * @deprecated use elm_object_content_set() instead
512 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
515 * @brief Unset the ctxpopup content
517 * @param obj Ctxpopup object
518 * @return The content that was being used
520 * Unparent and return the content object which was set for this widget.
522 * @deprecated use elm_object_content_unset()
524 * @see elm_ctxpopup_content_set()
526 * @deprecated use elm_object_content_unset() instead
530 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
533 * @brief Delete the given item in a ctxpopup object.
535 * @param it Ctxpopup item to be deleted
537 * @deprecated Use elm_object_item_del() instead
538 * @see elm_ctxpopup_item_append()
542 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
545 * Set the label for a given file selector button widget
547 * @param obj The file selector button widget
548 * @param label The text label to be displayed on @p obj
550 * @deprecated use elm_object_text_set() instead.
552 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
555 * Get the label set for a given file selector button widget
557 * @param obj The file selector button widget
558 * @return The button label
560 * @deprecated use elm_object_text_set() instead.
562 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
565 * Set the icon on a given file selector button widget
567 * @param obj The file selector button widget
568 * @param icon The icon object for the button
570 * Once the icon object is set, a previously set one will be
571 * deleted. If you want to keep the latter, use the
572 * elm_fileselector_button_icon_unset() function.
574 * @deprecated Use elm_object_part_content_set() instead
575 * @see elm_fileselector_button_icon_get()
577 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
580 * Get the icon set for a given file selector button widget
582 * @param obj The file selector button widget
583 * @return The icon object currently set on @p obj or @c NULL, if
586 * @deprecated Use elm_object_part_content_get() instead
587 * @see elm_fileselector_button_icon_set()
589 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
592 * Unset the icon used in a given file selector button widget
594 * @param obj The file selector button widget
595 * @return The icon object that was being used on @p obj or @c
598 * Unparent and return the icon object which was set for this
601 * @deprecated Use elm_object_part_content_unset() instead
602 * @see elm_fileselector_button_icon_set()
604 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
607 * Set the label for a given file selector entry widget's button
609 * @param obj The file selector entry widget
610 * @param label The text label to be displayed on @p obj widget's
613 * @deprecated use elm_object_text_set() instead.
615 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
618 * Get the label set for a given file selector entry widget's button
620 * @param obj The file selector entry widget
621 * @return The widget button's label
623 * @deprecated use elm_object_text_set() instead.
625 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
628 * Set the icon on a given file selector entry widget's button
630 * @param obj The file selector entry widget
631 * @param icon The icon object for the entry's button
633 * Once the icon object is set, a previously set one will be
634 * deleted. If you want to keep the latter, use the
635 * elm_fileselector_entry_button_icon_unset() function.
637 * @deprecated Use elm_object_part_content_set() instead
638 * @see elm_fileselector_entry_button_icon_get()
640 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
643 * Get the icon set for a given file selector entry widget's button
645 * @param obj The file selector entry widget
646 * @return The icon object currently set on @p obj widget's button
647 * or @c NULL, if none is
649 * @deprecated Use elm_object_part_content_get() instead
650 * @see elm_fileselector_entry_button_icon_set()
652 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
655 * Unset the icon used in a given file selector entry widget's
658 * @param obj The file selector entry widget
659 * @return The icon object that was being used on @p obj widget's
660 * button or @c NULL, on errors
662 * Unparent and return the icon object which was set for this
665 * @deprecated Use elm_object_part_content_unset() instead
666 * @see elm_fileselector_entry_button_icon_set()
668 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
671 * @brief Sets the content of the hover object and the direction in which it
674 * @param obj The hover object
675 * @param swallow The direction that the object will be displayed
676 * at. Accepted values are "left", "top-left", "top", "top-right",
677 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
679 * @param content The content to place at @p swallow
681 * Once the content object is set for a given direction, a previously
682 * set one (on the same direction) will be deleted. If you want to
683 * keep that old content object, use the elm_object_part_content_unset()
686 * All directions may have contents at the same time, except for
687 * "smart". This is a special placement hint and its use case
688 * depends of the calculations coming from
689 * elm_hover_best_content_location_get(). Its use is for cases when
690 * one desires only one hover content, but with a dynamic special
691 * placement within the hover area. The content's geometry, whenever
692 * it changes, will be used to decide on a best location, not
693 * extrapolating the hover's parent object view to show it in (still
694 * being the hover's target determinant of its medium part -- move and
695 * resize it to simulate finger sizes, for example). If one of the
696 * directions other than "smart" are used, a previously content set
697 * using it will be deleted, and vice-versa.
699 * @deprecated Use elm_object_part_content_set() instead
701 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
704 * @brief Get the content of the hover object, in a given direction.
706 * Return the content object which was set for this widget in the
707 * @p swallow direction.
709 * @param obj The hover object
710 * @param swallow The direction that the object was display at.
711 * @return The content that was being used
713 * @deprecated Use elm_object_part_content_get() instead
714 * @see elm_object_part_content_set()
716 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
719 * @brief Unset the content of the hover object, in a given direction.
721 * Unparent and return the content object set at @p swallow direction.
723 * @param obj The hover object
724 * @param swallow The direction that the object was display at.
725 * @return The content that was being used.
727 * @deprecated Use elm_object_part_content_unset() instead
728 * @see elm_object_part_content_set()
730 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
733 * @brief Set the hoversel button label
735 * @param obj The hoversel object
736 * @param label The label text.
738 * This sets the label of the button that is always visible (before it is
739 * clicked and expanded).
741 * @deprecated elm_object_text_set()
743 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
746 * @brief Get the hoversel button label
748 * @param obj The hoversel object
749 * @return The label text.
751 * @deprecated elm_object_text_get()
753 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
756 * @brief Set the icon of the hoversel button
758 * @param obj The hoversel object
759 * @param icon The icon object
761 * Sets the icon of the button that is always visible (before it is clicked
762 * and expanded). Once the icon object is set, a previously set one will be
763 * deleted, if you want to keep that old content object, use the
764 * elm_hoversel_icon_unset() function.
766 * @see elm_object_content_set() for the button widget
767 * @deprecated Use elm_object_item_part_content_set() instead
769 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
772 * @brief Get the icon of the hoversel button
774 * @param obj The hoversel object
775 * @return The icon object
777 * Get the icon of the button that is always visible (before it is clicked
778 * and expanded). Also see elm_object_content_get() for the button widget.
780 * @see elm_hoversel_icon_set()
781 * @deprecated Use elm_object_item_part_content_get() instead
783 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
786 * @brief Get and unparent the icon of the hoversel button
788 * @param obj The hoversel object
789 * @return The icon object that was being used
791 * Unparent and return the icon of the button that is always visible
792 * (before it is clicked and expanded).
794 * @see elm_hoversel_icon_set()
795 * @see elm_object_content_unset() for the button widget
796 * @deprecated Use elm_object_item_part_content_unset() instead
798 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
801 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
802 * that will be passed to associated function callbacks.
804 * @param it The item to get the data from
805 * @return The data pointer set with elm_hoversel_item_add()
807 * @see elm_hoversel_item_add()
808 * @deprecated Use elm_object_item_data_get() instead
810 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
813 * @brief This returns the label text of the given hoversel item.
815 * @param it The item to get the label
816 * @return The label text of the hoversel item
818 * @see elm_hoversel_item_add()
819 * @deprecated Use elm_object_item_text_get() instead
821 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
824 * @brief Set the function to be called when an item from the hoversel is
827 * @param it The item to set the callback on
828 * @param func The function called
830 * That function will receive these parameters:
831 * @li void * item data
832 * @li Evas_Object * hoversel object
833 * @li Elm_Object_Item * hoversel item
835 * @see elm_hoversel_item_add()
836 * @deprecated Use elm_object_item_del_cb_set() instead
838 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
841 * @brief Delete an item from the hoversel
843 * @param it The item to delete
845 * This deletes the item from the hoversel (should not be called while the
846 * hoversel is active; use elm_hoversel_expanded_get() to check first).
848 * @deprecated Use elm_object_item_del() instead
849 * @see elm_hoversel_item_add()
851 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
854 * Set actionslider labels.
856 * @param obj The actionslider object
857 * @param left_label The label to be set on the left.
858 * @param center_label The label to be set on the center.
859 * @param right_label The label to be set on the right.
860 * @deprecated use elm_object_text_set() instead.
862 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
865 * Get actionslider labels.
867 * @param obj The actionslider object
868 * @param left_label A char** to place the left_label of @p obj into.
869 * @param center_label A char** to place the center_label of @p obj into.
870 * @param right_label A char** to place the right_label of @p obj into.
871 * @deprecated use elm_object_text_set() instead.
873 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
876 * Set the label used on the indicator.
878 * @param obj The actionslider object
879 * @param label The label to be set on the indicator.
880 * @deprecated use elm_object_text_set() instead.
882 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
885 * Get the label used on the indicator object.
887 * @param obj The actionslider object
888 * @return The indicator label
889 * @deprecated use elm_object_text_get() instead.
891 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
894 * Set the overlay object used for the background object.
896 * @param obj The bg object
897 * @param overlay The overlay object
899 * This provides a way for elm_bg to have an 'overlay' that will be on top
900 * of the bg. Once the over object is set, a previously set one will be
901 * deleted, even if you set the new one to NULL. If you want to keep that
902 * old content object, use the elm_bg_overlay_unset() function.
904 * @deprecated use elm_object_part_content_set() instead
909 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
912 * Get the overlay object used for the background object.
914 * @param obj The bg object
915 * @return The content that is being used
917 * Return the content object which is set for this widget
919 * @deprecated use elm_object_part_content_get() instead
923 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
926 * Get the overlay object used for the background object.
928 * @param obj The bg object
929 * @return The content that was being used
931 * Unparent and return the overlay object which was set for this widget
933 * @deprecated use elm_object_part_content_unset() instead
937 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
941 * Set the label of the bubble
943 * @param obj The bubble object
944 * @param label The string to set in the label
946 * This function sets the title of the bubble. Where this appears depends on
947 * the selected corner.
948 * @deprecated use elm_object_text_set() instead.
950 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
953 * Get the label of the bubble
955 * @param obj The bubble object
956 * @return The string of set in the label
958 * This function gets the title of the bubble.
959 * @deprecated use elm_object_text_get() instead.
961 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
964 * Set the info of the bubble
966 * @param obj The bubble object
967 * @param info The given info about the bubble
969 * This function sets the info of the bubble. Where this appears depends on
970 * the selected corner.
971 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
973 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
976 * Get the info of the bubble
978 * @param obj The bubble object
980 * @return The "info" string of the bubble
982 * This function gets the info text.
983 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
985 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
988 * Set the content to be shown in the bubble
990 * Once the content object is set, a previously set one will be deleted.
991 * If you want to keep the old content object, use the
992 * elm_bubble_content_unset() function.
994 * @param obj The bubble object
995 * @param content The given content of the bubble
997 * This function sets the content shown on the middle of the bubble.
999 * @deprecated use elm_object_content_set() instead
1002 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1005 * Get the content shown in the bubble
1007 * Return the content object which is set for this widget.
1009 * @param obj The bubble object
1010 * @return The content that is being used
1012 * @deprecated use elm_object_content_get() instead
1015 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1018 * Unset the content shown in the bubble
1020 * Unparent and return the content object which was set for this widget.
1022 * @param obj The bubble object
1023 * @return The content that was being used
1025 * @deprecated use elm_object_content_unset() instead
1028 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1031 * Set the icon of the bubble
1033 * Once the icon object is set, a previously set one will be deleted.
1034 * If you want to keep the old content object, use the
1035 * elm_icon_content_unset() function.
1037 * @param obj The bubble object
1038 * @param icon The given icon for the bubble
1040 * @deprecated use elm_object_part_content_set() instead
1043 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1046 * Get the icon of the bubble
1048 * @param obj The bubble object
1049 * @return The icon for the bubble
1051 * This function gets the icon shown on the top left of bubble.
1053 * @deprecated use elm_object_part_content_get() instead
1056 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1059 * Unset the icon of the bubble
1061 * Unparent and return the icon object which was set for this widget.
1063 * @param obj The bubble object
1064 * @return The icon that was being used
1066 * @deprecated use elm_object_part_content_unset() instead
1069 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1073 * Set the label used in the button
1075 * The passed @p label can be NULL to clean any existing text in it and
1076 * leave the button as an icon only object.
1078 * @param obj The button object
1079 * @param label The text will be written on the button
1080 * @deprecated use elm_object_text_set() instead.
1082 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1085 * Get the label set for the button
1087 * The string returned is an internal pointer and should not be freed or
1088 * altered. It will also become invalid when the button is destroyed.
1089 * The string returned, if not NULL, is a stringshare, so if you need to
1090 * keep it around even after the button is destroyed, you can use
1091 * eina_stringshare_ref().
1093 * @param obj The button object
1094 * @return The text set to the label, or NULL if nothing is set
1095 * @deprecated use elm_object_text_set() instead.
1097 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1100 * Set the icon used for the button
1102 * Setting a new icon will delete any other that was previously set, making
1103 * any reference to them invalid. If you need to maintain the previous
1104 * object alive, unset it first with elm_button_icon_unset().
1106 * @param obj The button object
1107 * @param icon The icon object for the button
1108 * @deprecated use elm_object_part_content_set() instead.
1110 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1113 * Get the icon used for the button
1115 * Return the icon object which is set for this widget. If the button is
1116 * destroyed or another icon is set, the returned object will be deleted
1117 * and any reference to it will be invalid.
1119 * @param obj The button object
1120 * @return The icon object that is being used
1122 * @deprecated use elm_object_part_content_get() instead
1124 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1127 * Remove the icon set without deleting it and return the object
1129 * This function drops the reference the button holds of the icon object
1130 * and returns this last object. It is used in case you want to remove any
1131 * icon, or set another one, without deleting the actual object. The button
1132 * will be left without an icon set.
1134 * @param obj The button object
1135 * @return The icon object that was being used
1136 * @deprecated use elm_object_part_content_unset() instead.
1138 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1141 * Set a day text color to the same that represents Saturdays.
1143 * @param obj The calendar object.
1144 * @param pos The text position. Position is the cell counter, from left
1145 * to right, up to down. It starts on 0 and ends on 41.
1147 * @deprecated use elm_calendar_mark_add() instead like:
1150 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1151 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1154 * @see elm_calendar_mark_add()
1158 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1161 * Set a day text color to the same that represents Sundays.
1163 * @param obj The calendar object.
1164 * @param pos The text position. Position is the cell counter, from left
1165 * to right, up to down. It starts on 0 and ends on 41.
1167 * @deprecated use elm_calendar_mark_add() instead like:
1170 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1171 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1174 * @see elm_calendar_mark_add()
1178 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1181 * Set a day text color to the same that represents Weekdays.
1183 * @param obj The calendar object
1184 * @param pos The text position. Position is the cell counter, from left
1185 * to right, up to down. It starts on 0 and ends on 41.
1187 * @deprecated use elm_calendar_mark_add() instead like:
1190 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1192 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1193 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1194 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1195 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1196 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1197 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1198 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1199 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1200 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1203 * @see elm_calendar_mark_add()
1207 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1211 * @brief Set the text label of the check object
1213 * @param obj The check object
1214 * @param label The text label string in UTF-8
1216 * @deprecated use elm_object_text_set() instead.
1218 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1221 * @brief Get the text label of the check object
1223 * @param obj The check object
1224 * @return The text label string in UTF-8
1226 * @deprecated use elm_object_text_get() instead.
1228 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1231 * @brief Set the icon object of the check object
1233 * @param obj The check object
1234 * @param icon The icon object
1236 * Once the icon object is set, a previously set one will be deleted.
1237 * If you want to keep that old content object, use the
1238 * elm_object_content_unset() function.
1240 * @deprecated use elm_object_part_content_set() instead.
1243 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1246 * @brief Get the icon object of the check object
1248 * @param obj The check object
1249 * @return The icon object
1251 * @deprecated use elm_object_part_content_get() instead.
1254 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1257 * @brief Unset the icon used for the check object
1259 * @param obj The check object
1260 * @return The icon object that was being used
1262 * Unparent and return the icon object which was set for this widget.
1264 * @deprecated use elm_object_part_content_unset() instead.
1267 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1270 * @brief Set the text label of the check object
1272 * @param obj The check object
1273 * @param label The text label string in UTF-8
1275 * @deprecated use elm_object_text_set() instead.
1277 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1280 * @brief Get the text label of the check object
1282 * @param obj The check object
1283 * @return The text label string in UTF-8
1285 * @deprecated use elm_object_text_get() instead.
1287 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1290 * @brief Set the icon object of the check object
1292 * @param obj The check object
1293 * @param icon The icon object
1295 * Once the icon object is set, a previously set one will be deleted.
1296 * If you want to keep that old content object, use the
1297 * elm_object_content_unset() function.
1299 * @deprecated use elm_object_part_content_set() instead.
1302 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1305 * @brief Get the icon object of the check object
1307 * @param obj The check object
1308 * @return The icon object
1310 * @deprecated use elm_object_part_content_get() instead.
1313 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1316 * @brief Unset the icon used for the check object
1318 * @param obj The check object
1319 * @return The icon object that was being used
1321 * Unparent and return the icon object which was set for this widget.
1323 * @deprecated use elm_object_part_content_unset() instead.
1326 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1328 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1329 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1333 * Set the content of the conformant widget.
1335 * @param obj The conformant object.
1336 * @param content The content to be displayed by the conformant.
1338 * Content will be sized and positioned considering the space required
1339 * to display a virtual keyboard. So it won't fill all the conformant
1340 * size. This way is possible to be sure that content won't resize
1341 * or be re-positioned after the keyboard is displayed.
1343 * Once the content 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 * @see elm_object_content_unset()
1348 * @see elm_object_content_get()
1350 * @deprecated use elm_object_content_set() instead
1352 * @ingroup Conformant
1354 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1357 * Get the content of the conformant widget.
1359 * @param obj The conformant object.
1360 * @return The content that is being used.
1362 * Return the content object which is set for this widget.
1363 * It won't be unparent from conformant. For that, use
1364 * elm_object_content_unset().
1366 * @see elm_object_content_set().
1367 * @see elm_object_content_unset()
1369 * @deprecated use elm_object_content_get() instead
1371 * @ingroup Conformant
1373 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1376 * Unset the content of the conformant widget.
1378 * @param obj The conformant object.
1379 * @return The content that was being used.
1381 * Unparent and return the content object which was set for this widget.
1383 * @see elm_object_content_set().
1385 * @deprecated use elm_object_content_unset() instead
1387 * @ingroup Conformant
1389 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1392 * Get the side labels max length.
1394 * @deprecated use elm_diskselector_side_label_length_get() instead:
1396 * @param obj The diskselector object.
1397 * @return The max length defined for side labels, or 0 if not a valid
1400 * @ingroup Diskselector
1402 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1405 * Set the side labels max length.
1407 * @deprecated use elm_diskselector_side_label_length_set() instead:
1409 * @param obj The diskselector object.
1410 * @param len The max length defined for side labels.
1412 * @ingroup Diskselector
1414 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1417 * Get the data associated to the item.
1419 * @param it The diskselector item
1420 * @return The data associated to @p it
1422 * The return value is a pointer to data associated to @p item when it was
1423 * created, with function elm_diskselector_item_append(). If no data
1424 * was passed as argument, it will return @c NULL.
1426 * @see elm_diskselector_item_append()
1427 * @deprecated Use elm_object_item_data_get()
1429 * @ingroup Diskselector
1431 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1434 * Set the icon associated to the item.
1436 * @param it The diskselector item
1437 * @param icon The icon object to associate with @p it
1439 * The icon object to use at left side of the item. An
1440 * icon can be any Evas object, but usually it is an icon created
1441 * with elm_icon_add().
1443 * Once the icon object is set, a previously set one will be deleted.
1444 * @warning Setting the same icon for two items will cause the icon to
1445 * disappear from the first item.
1447 * If an icon was passed as argument on item creation, with function
1448 * elm_diskselector_item_append(), it will be already
1449 * associated to the item.
1451 * @see elm_diskselector_item_append()
1452 * @see elm_diskselector_item_icon_get()
1454 * @deprecated Use elm_object_item_part_content_set() instead
1455 * @ingroup Diskselector
1457 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1460 * Get the icon associated to the item.
1462 * @param it The diskselector item
1463 * @return The icon associated to @p it
1465 * The return value is a pointer to the icon associated to @p item when it was
1466 * created, with function elm_diskselector_item_append(), or later
1467 * with function elm_diskselector_item_icon_set. If no icon
1468 * was passed as argument, it will return @c NULL.
1470 * @see elm_diskselector_item_append()
1471 * @see elm_diskselector_item_icon_set()
1473 * @deprecated Use elm_object_item_part_content_set() instead
1474 * @ingroup Diskselector
1476 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1479 * Set the label of item.
1481 * @param it The item of diskselector.
1482 * @param label The label of item.
1484 * The label to be displayed by the item.
1486 * If no icon is set, label will be centered on item position, otherwise
1487 * the icon will be placed at left of the label, that will be shifted
1490 * An item with label "January" would be displayed on side position as
1491 * "Jan" if max length is set to 3 with function
1492 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1495 * When this @p item is selected, the entire label will be displayed,
1496 * except for width restrictions.
1497 * In this case label will be cropped and "..." will be concatenated,
1498 * but only for display purposes. It will keep the entire string, so
1499 * if diskselector is resized the remaining characters will be displayed.
1501 * If a label was passed as argument on item creation, with function
1502 * elm_diskselector_item_append(), it will be already
1503 * displayed by the item.
1505 * @see elm_diskselector_side_label_length_set()
1506 * @see elm_diskselector_item_label_get()
1507 * @see elm_diskselector_item_append()
1509 * @deprecated Use elm_object_item_text_set() instead
1510 * @ingroup Diskselector
1512 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1515 * Get the label of item.
1517 * @param it The item of diskselector.
1518 * @return The label of item.
1520 * The return value is a pointer to the label associated to @p item when it was
1521 * created, with function elm_diskselector_item_append(), or later
1522 * with function elm_diskselector_item_label_set. If no label
1523 * was passed as argument, it will return @c NULL.
1525 * @see elm_diskselector_item_label_set() for more details.
1526 * @see elm_diskselector_item_append()
1527 * @deprecated Use elm_object_item_text_get() instead
1529 * @ingroup Diskselector
1531 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1534 * Set the function called when a diskselector item is freed.
1536 * @param it The item to set the callback on
1537 * @param func The function called
1539 * If there is a @p func, then it will be called prior item's memory release.
1540 * That will be called with the following arguments:
1542 * @li item's Evas object;
1545 * This way, a data associated to a diskselector item could be properly
1547 * @deprecated Use elm_object_item_del_cb_set() instead
1549 * @ingroup Diskselector
1551 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1554 * Delete them item from the diskselector.
1556 * @param it The item of diskselector to be deleted.
1558 * If deleting all diskselector items is required, elm_diskselector_clear()
1559 * should be used instead of getting items list and deleting each one.
1561 * @deprecated Use elm_object_item_del() instead
1562 * @see elm_diskselector_clear()
1563 * @see elm_diskselector_item_append()
1565 * @ingroup Diskselector
1567 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1570 * Set the text to be shown in the diskselector item.
1572 * @param it Target item
1573 * @param text The text to set in the content
1575 * Setup the text as tooltip to object. The item can have only one tooltip,
1576 * so any previous tooltip data is removed.
1578 * @deprecated Use elm_object_item_tooltip_text_set() instead
1579 * @see elm_object_tooltip_text_set() for more details.
1581 * @ingroup Diskselector
1583 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1586 * Set the content to be shown in the tooltip item.
1588 * Setup the tooltip to item. The item can have only one tooltip,
1589 * so any previous tooltip data is removed. @p func(with @p data) will
1590 * be called every time that need show the tooltip and it should
1591 * return a valid Evas_Object. This object is then managed fully by
1592 * tooltip system and is deleted when the tooltip is gone.
1594 * @param it the diskselector item being attached a tooltip.
1595 * @param func the function used to create the tooltip contents.
1596 * @param data what to provide to @a func as callback data/context.
1597 * @param del_cb called when data is not needed anymore, either when
1598 * another callback replaces @p func, the tooltip is unset with
1599 * elm_diskselector_item_tooltip_unset() or the owner @a item
1600 * dies. This callback receives as the first parameter the
1601 * given @a data, and @c event_info is the item.
1603 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1604 * @see elm_object_tooltip_content_cb_set() for more details.
1606 * @ingroup Diskselector
1608 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);
1611 * Unset tooltip from item.
1613 * @param it diskselector item to remove previously set tooltip.
1615 * Remove tooltip from item. The callback provided as del_cb to
1616 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1617 * it is not used anymore.
1619 * @deprecated Use elm_object_item_tooltip_unset() instead
1620 * @see elm_object_tooltip_unset() for more details.
1621 * @see elm_diskselector_item_tooltip_content_cb_set()
1623 * @ingroup Diskselector
1625 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1628 * Sets a different style for this item tooltip.
1630 * @note before you set a style you should define a tooltip with
1631 * elm_diskselector_item_tooltip_content_cb_set() or
1632 * elm_diskselector_item_tooltip_text_set()
1634 * @param it diskselector item with tooltip already set.
1635 * @param style the theme style to use (default, transparent, ...)
1637 * @deprecated Use elm_object_item_tooltip_style_set() instead
1638 * @see elm_object_tooltip_style_set() for more details.
1640 * @ingroup Diskselector
1642 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1645 * Get the style for this item tooltip.
1647 * @param it diskselector item with tooltip already set.
1648 * @return style the theme style in use, defaults to "default". If the
1649 * object does not have a tooltip set, then NULL is returned.
1651 * @deprecated Use elm_object_item_tooltip_style_get() instead
1652 * @see elm_object_tooltip_style_get() for more details.
1653 * @see elm_diskselector_item_tooltip_style_set()
1655 * @ingroup Diskselector
1657 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1660 * Set the cursor to be shown when mouse is over the diskselector item
1662 * @param it Target item
1663 * @param cursor the cursor name to be used.
1665 * @see elm_object_cursor_set() for more details.
1666 * @deprecated Use elm_object_item_cursor_set() instead
1668 * @ingroup Diskselector
1670 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1673 * Get the cursor to be shown when mouse is over the diskselector item
1675 * @param it diskselector item with cursor already set.
1676 * @return the cursor name.
1678 * @see elm_object_cursor_get() for more details.
1679 * @see elm_diskselector_item_cursor_set()
1680 * @deprecated Use elm_object_item_cursor_get() instead
1682 * @ingroup Diskselector
1684 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1687 * Unset the cursor to be shown when mouse is over the diskselector item
1689 * @param it Target item
1691 * @see elm_object_cursor_unset() for more details.
1692 * @see elm_diskselector_item_cursor_set()
1693 * @deprecated use elm_object_item_cursor_unset() instead
1695 * @ingroup Diskselector
1697 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1700 * Sets a different style for this item cursor.
1702 * @note before you set a style you should define a cursor with
1703 * elm_diskselector_item_cursor_set()
1705 * @param it diskselector item with cursor already set.
1706 * @param style the theme style to use (default, transparent, ...)
1708 * @see elm_object_cursor_style_set() for more details.
1709 * @deprecated Use elm_object_item_cursor_style_set() instead
1711 * @ingroup Diskselector
1713 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1716 * Get the style for this item cursor.
1718 * @param it diskselector item with cursor already set.
1719 * @return style the theme style in use, defaults to "default". If the
1720 * object does not have a cursor set, then @c NULL is returned.
1722 * @see elm_object_cursor_style_get() for more details.
1723 * @see elm_diskselector_item_cursor_style_set()
1724 * @deprecated Use elm_object_item_cursor_style_get() instead
1726 * @ingroup Diskselector
1728 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1731 * Set if the cursor set should be searched on the theme or should use
1732 * the provided by the engine, only.
1734 * @note before you set if should look on theme you should define a cursor
1735 * with elm_diskselector_item_cursor_set().
1736 * By default it will only look for cursors provided by the engine.
1738 * @param it widget item with cursor already set.
1739 * @param engine_only boolean to define if cursors set with
1740 * elm_diskselector_item_cursor_set() should be searched only
1741 * between cursors provided by the engine or searched on widget's
1744 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1746 * @ingroup Diskselector
1748 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1751 * Get the cursor engine only usage for this item cursor.
1753 * @param it widget item with cursor already set.
1754 * @return engine_only boolean to define it cursors should be looked only
1755 * between the provided by the engine or searched on widget's theme as well.
1756 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1758 * @see elm_diskselector_item_cursor_engine_only_set()
1759 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1761 * @ingroup Diskselector
1763 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1765 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1766 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1769 * Get the label of a given flip selector widget's item.
1771 * @param it The item to get label from
1772 * @return The text label of @p item or @c NULL, on errors
1774 * @see elm_object_item_text_set()
1776 * @deprecated see elm_object_item_text_get() instead
1777 * @ingroup Flipselector
1779 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1782 * Set the label of a given flip selector widget's item.
1784 * @param it The item to set label on
1785 * @param label The text label string, in UTF-8 encoding
1787 * @see elm_object_item_text_get()
1789 * @deprecated see elm_object_item_text_set() instead
1790 * @ingroup Flipselector
1792 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1795 * Delete a given item from a flip selector widget.
1797 * @param it The item to delete
1799 * @deprecated Use elm_object_item_del() instead
1800 * @ingroup Flipselector
1802 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1805 * Set the interval on time updates for a user mouse button hold
1806 * on a flip selector widget.
1808 * @param obj The flip selector object
1809 * @param interval The (first) interval value in seconds
1811 * This interval value is @b decreased while the user holds the
1812 * mouse pointer either flipping up or flipping down a given flip
1815 * This helps the user to get to a given item distant from the
1816 * current one easier/faster, as it will start to flip quicker and
1817 * quicker on mouse button holds.
1819 * The calculation for the next flip interval value, starting from
1820 * the one set with this call, is the previous interval divided by
1821 * 1.05, so it decreases a little bit.
1823 * The default starting interval value for automatic flips is
1826 * @see elm_flipselector_interval_get()
1827 * @deprecated Use elm_flipselector_first_interval_set()
1829 * @ingroup Flipselector
1831 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
1834 * Get the interval on time updates for an user mouse button hold
1835 * on a flip selector widget.
1837 * @param obj The flip selector object
1838 * @return The (first) interval value, in seconds, set on it
1840 * @see elm_flipselector_interval_set() for more details
1841 * @deprecated Use elm_flipselector_first_interval_get()
1843 * @ingroup Flipselector
1845 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
1848 * Make a given Elementary object the focused one.
1850 * @param obj The Elementary object to make focused.
1852 * @note This object, if it can handle focus, will take the focus
1853 * away from the one who had it previously and will, for now on, be
1854 * the one receiving input events.
1856 * @see elm_object_focus_get()
1857 * @deprecated use elm_object_focus_set() instead.
1861 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1864 * Remove the focus from an Elementary object
1866 * @param obj The Elementary to take focus from
1868 * This removes the focus from @p obj, passing it back to the
1869 * previous element in the focus chain list.
1871 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1872 * @deprecated use elm_object_focus_set() instead.
1876 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1879 * Give focus to near object in one direction.
1881 * Give focus to near object in direction of one object.
1882 * If none focusable object in given direction, the focus will not change.
1884 * @param obj The reference object
1885 * @param x Horizontal component of direction to focus
1886 * @param y Vertical component of direction to focus
1888 * @deprecated Support it later.
1891 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1894 * @brief Set the frame label
1896 * @param obj The frame object
1897 * @param label The label of this frame object
1899 * @deprecated use elm_object_text_set() instead.
1901 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1904 * @brief Get the frame label
1906 * @param obj The frame object
1908 * @return The label of this frame object or NULL if unable to get frame
1910 * @deprecated use elm_object_text_get() instead.
1912 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1915 * @brief Set the content of the frame widget
1917 * Once the content object is set, a previously set one will be deleted.
1918 * If you want to keep that old content object, use the
1919 * elm_frame_content_unset() function.
1921 * @param obj The frame object
1922 * @param content The content will be filled in this frame object
1924 * @deprecated use elm_object_content_set() instead.
1926 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1929 * @brief Get the content of the frame widget
1931 * Return the content object which is set for this widget
1933 * @param obj The frame object
1934 * @return The content that is being used
1936 * @deprecated use elm_object_content_get() instead.
1938 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1941 * @brief Unset the content of the frame widget
1943 * Unparent and return the content object which was set for this widget
1945 * @param obj The frame object
1946 * @return The content that was being used
1948 * @deprecated use elm_object_content_unset() instead.
1950 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1952 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1953 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1954 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1956 * This sets the horizontal stretching mode.
1958 * @param obj The genlist object
1959 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1961 * This sets the mode used for sizing items horizontally. Valid modes
1962 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1963 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1964 * the scroller will scroll horizontally. Otherwise items are expanded
1965 * to fill the width of the viewport of the scroller. If it is
1966 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1967 * limited to that size.
1969 * @see elm_genlist_horizontal_get()
1971 * @deprecated use elm_genlist_mode_set()
1974 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1977 * Gets the horizontal stretching mode.
1979 * @param obj The genlist object
1980 * @return The mode to use
1981 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1983 * @see elm_genlist_horizontal_set()
1985 * @deprecated use elm_genlist_mode_get()
1988 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
1991 * Return the data associated to a given genlist item
1993 * @param it The genlist item.
1994 * @return the data associated to this item.
1996 * This returns the @c data value passed on the
1997 * elm_genlist_item_append() and related item addition calls.
1999 * @see elm_genlist_item_append()
2000 * @see elm_genlist_item_data_set()
2002 * @deprecated Use elm_object_item_data_get() instead
2005 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2008 * Set the data associated to a given genlist item
2010 * @param it The genlist item
2011 * @param data The new data pointer to set on it
2013 * This @b overrides the @c data value passed on the
2014 * elm_genlist_item_append() and related item addition calls. This
2015 * function @b won't call elm_genlist_item_update() automatically,
2016 * so you'd issue it afterwards if you want to hove the item
2017 * updated to reflect the that new data.
2019 * @see elm_genlist_item_data_get()
2021 * @deprecated Use elm_object_item_data_set() instead
2024 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2027 * Set whether a given genlist item is disabled or not.
2029 * @param it The item
2030 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2031 * to enable it back.
2033 * A disabled item cannot be selected or unselected. It will also
2034 * change its appearance, to signal the user it's disabled.
2036 * @see elm_genlist_item_disabled_get()
2037 * @deprecated Use elm_object_item_disabled_set() instead
2041 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2044 * Get whether a given genlist item is disabled or not.
2046 * @param it The item
2047 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2050 * @see elm_genlist_item_disabled_set() for more details
2051 * @deprecated Use elm_object_item_disabled_get() instead
2055 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2058 * Remove a genlist item from the its parent, deleting it.
2060 * @param it The item to be removed.
2061 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2063 * @see elm_genlist_clear(), to remove all items in a genlist at
2066 * @deprecated Use elm_object_item_del() instead
2069 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2072 * Get the genlist object's handle which contains a given genlist
2075 * @param it The item to fetch the container from
2076 * @return The genlist (parent) object
2078 * This returns the genlist object itself that an item belongs to.
2079 * @deprecated Use elm_object_item_widget_get() instead
2083 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2086 * Get the mode item style of items in the genlist
2087 * @param obj The genlist object
2088 * @return The mode item style string, or NULL if none is specified
2090 * This is a constant string and simply defines the name of the
2091 * style that will be used for mode animations. It can be
2092 * @c NULL if you don't plan to use Genlist mode. See
2093 * elm_genlist_item_mode_set() for more info.
2097 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2100 * Set the mode item style of items in the genlist
2101 * @param obj The genlist object
2102 * @param style The mode item style string, or NULL if none is desired
2104 * This is a constant string and simply defines the name of the
2105 * style that will be used for mode animations. It can be
2106 * @c NULL if you don't plan to use Genlist mode. See
2107 * elm_genlist_item_mode_set() for more info.
2111 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2114 * Get the real Evas object created to implement the view of a
2115 * given genlist item
2117 * @param it The genlist item.
2118 * @return the Evas object implementing this item's view.
2120 * This returns the actual Evas object used to implement the
2121 * specified genlist item's view. This may be @c NULL, as it may
2122 * not have been created or may have been deleted, at any time, by
2123 * the genlist. <b>Do not modify this object</b> (move, resize,
2124 * show, hide, etc.), as the genlist is controlling it. This
2125 * function is for querying, emitting custom signals or hooking
2126 * lower level callbacks for events on that object. Do not delete
2127 * this object under any circumstances.
2129 * @see elm_object_item_data_get()
2130 * @deprecated No more support
2134 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
2137 * Get the Item's Flags
2139 * @param it The genlist item
2140 * @return The item type.
2142 * This function returns the item's type. Normally the item's type.
2143 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2145 * @deprecated Use elm_genlist_item_type_get() instead
2148 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2151 * Tells genlist to "orphan" contents fetched by the item class
2153 * @param it The item
2155 * This instructs genlist to release references to contents in the item,
2156 * meaning that they will no longer be managed by genlist and are
2157 * floating "orphans" that can be re-used elsewhere if the user wants
2160 * @deprecated Use elm_genlist_item_all_contents_unset() instead
2164 #define ELM_IMAGE_ROTATE_90_CW 1
2165 #define ELM_IMAGE_ROTATE_180_CW 2
2166 #define ELM_IMAGE_ROTATE_90_CCW 3
2169 * Return the data associated with a given index widget item
2171 * @param item The index widget item handle
2172 * @return The data associated with @p it
2173 * @deprecated Use elm_object_item_data_get() instead
2175 * @see elm_index_item_data_set()
2178 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2181 * Set the data associated with a given index widget item
2183 * @param it The index widget item handle
2184 * @param data The new data pointer to set to @p it
2186 * This sets new item data on @p it.
2188 * @warning The old data pointer won't be touched by this function, so
2189 * the user had better to free that old data himself/herself.
2191 * @deprecated Use elm_object_item_data_set() instead
2193 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2196 * Set the function to be called when a given index widget item is freed.
2198 * @param it The item to set the callback on
2199 * @param func The function to call on the item's deletion
2201 * When called, @p func will have both @c data and @c event_info
2202 * arguments with the @p it item's data value and, naturally, the
2203 * @c obj argument with a handle to the parent index widget.
2205 * @deprecated Use elm_object_item_del_cb_set() instead
2207 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2210 * Remove an item from a given index widget, <b>to be referenced by
2211 * it's data value</b>.
2213 * @param obj The index object
2214 * @param item The item to be removed from @p obj
2216 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2217 * that callback function will be called by this one.
2219 * @deprecated Use elm_object_item_del() instead
2221 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2224 * @brief Set the label on the label object
2226 * @param obj The label object
2227 * @param label The label will be used on the label object
2228 * @deprecated See elm_object_text_set()
2230 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2233 * @brief Get the label used on the label object
2235 * @param obj The label object
2236 * @return The string inside the label
2237 * @deprecated See elm_object_text_get()
2239 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2243 * Set the layout content.
2245 * @param obj The layout object
2246 * @param swallow The swallow part name in the edje file
2247 * @param content The child that will be added in this layout object
2248 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2250 * Once the content object is set, a previously set one will be deleted.
2251 * If you want to keep that old content object, use the
2252 * elm_object_part_content_unset() function.
2254 * @note In an Edje theme, the part used as a content container is called @c
2255 * SWALLOW. This is why the parameter name is called @p swallow, but it is
2256 * expected to be a part name just like the second parameter of
2257 * elm_layout_box_append().
2259 * @see elm_layout_box_append()
2260 * @see elm_object_part_content_get()
2261 * @see elm_object_part_content_unset()
2263 * @deprecated use elm_object_part_content_set() instead
2266 EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2269 * Get the child object in the given content part.
2271 * @param obj The layout object
2272 * @param swallow The SWALLOW part to get its content
2274 * @return The swallowed object or NULL if none or an error occurred
2276 * @deprecated use elm_object_part_content_get() instead
2279 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2282 * Unset the layout content.
2284 * @param obj The layout object
2285 * @param swallow The swallow part name in the edje file
2286 * @return The content that was being used
2288 * Unparent and return the content object which was set for this part.
2290 * @deprecated use elm_object_part_content_unset() instead
2293 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2296 * Set the text of the given part
2298 * @param obj The layout object
2299 * @param part The TEXT part where to set the text
2300 * @param text The text to set
2301 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2303 * @deprecated use elm_object_part_text_set() instead.
2305 EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2308 * Get the text set in the given part
2310 * @param obj The layout object
2311 * @param part The TEXT part to retrieve the text off
2313 * @return The text set in @p part
2315 * @deprecated use elm_object_part_text_get() instead.
2317 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
2320 * @def elm_layout_label_set
2321 * Convenience macro to set the label in a layout that follows the
2322 * Elementary naming convention for its parts.
2324 * @deprecated use elm_object_text_set() instead.
2326 #define elm_layout_label_set(_ly, _txt) \
2327 elm_layout_text_set((_ly), "elm.text", (_txt))
2330 * @def elm_layout_label_get
2331 * Convenience macro to get the label in a layout that follows the
2332 * Elementary naming convention for its parts.
2334 * @deprecated use elm_object_text_set() instead.
2336 #define elm_layout_label_get(_ly) \
2337 elm_layout_text_get((_ly), "elm.text")
2339 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2343 * Set the content of the mapbuf.
2345 * @param obj The mapbuf object.
2346 * @param content The content that will be filled in this mapbuf object.
2348 * Once the content object is set, a previously set one will be deleted.
2349 * If you want to keep that old content object, use the
2350 * elm_mapbuf_content_unset() function.
2352 * To enable map, elm_mapbuf_enabled_set() should be used.
2354 * @deprecated use elm_object_content_set() instead
2357 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2360 * Get the content of the mapbuf.
2362 * @param obj The mapbuf object.
2363 * @return The content that is being used.
2365 * Return the content object which is set for this widget.
2367 * @see elm_mapbuf_content_set() for details.
2369 * @deprecated use elm_object_content_get() instead
2372 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2375 * Unset the content of the mapbuf.
2377 * @param obj The mapbuf object.
2378 * @return The content that was being used.
2380 * Unparent and return the content object which was set for this widget.
2382 * @see elm_mapbuf_content_set() for details.
2384 * @deprecated use elm_object_content_unset() instead
2387 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2390 * @brief Set the label of a menu item
2392 * @param it The menu item object.
2393 * @param label The label to set for @p item
2395 * @warning Don't use this function on items created with
2396 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2398 * @deprecated Use elm_object_item_text_set() instead
2400 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2403 * @brief Get the label of a menu item
2405 * @param it The menu item object.
2406 * @return The label of @p item
2407 * @deprecated Use elm_object_item_text_get() instead
2409 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2412 * @brief Set the content object of a menu item
2414 * @param it The menu item object
2415 * @param The content object or NULL
2416 * @return EINA_TRUE on success, else EINA_FALSE
2418 * Use this function to change the object swallowed by a menu item, deleting
2419 * any previously swallowed object.
2421 * @deprecated Use elm_object_item_content_set() instead
2423 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2426 * @brief Get the content object of a menu item
2428 * @param it The menu item object
2429 * @return The content object or NULL
2430 * @note If @p item was added with elm_menu_item_add_object, this
2431 * function will return the object passed, else it will return the
2434 * @see elm_menu_item_object_content_set()
2436 * @deprecated Use elm_object_item_content_get() instead
2438 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2441 * @brief Set the disabled state of @p item.
2443 * @param it The menu item object.
2444 * @param disabled The enabled/disabled state of the item
2445 * @deprecated Use elm_object_item_disabled_set() instead
2447 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2450 * @brief Get the disabled state of @p item.
2452 * @param it The menu item object.
2453 * @return The enabled/disabled state of the item
2455 * @see elm_menu_item_disabled_set()
2456 * @deprecated Use elm_object_item_disabled_get() instead
2458 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2461 * @brief Returns the data associated with menu item @p item.
2463 * @param it The item
2464 * @return The data associated with @p item or NULL if none was set.
2466 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2468 * @deprecated Use elm_object_item_data_get() instead
2470 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2473 * @brief Set the function called when a menu item is deleted.
2475 * @param it The item to set the callback on
2476 * @param func The function called
2478 * @see elm_menu_item_add()
2479 * @see elm_menu_item_del()
2480 * @deprecated Use elm_object_item_del_cb_set() instead
2482 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2485 * @brief Sets the data to be associated with menu item @p item.
2487 * @param it The item
2488 * @param data The data to be associated with @p item
2490 * @deprecated Use elm_object_item_data_set() instead
2492 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2495 * @brief Deletes an item from the menu.
2497 * @param it The item to delete.
2499 * @deprecated Use elm_object_item_del() instead
2500 * @see elm_menu_item_add()
2502 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2505 * @brief @brief Return a menu item's owner menu
2507 * @param it The menu item
2508 * @return The menu object owning @p item, or NULL on failure
2510 * Use this function to get the menu object owning an item.
2511 * @deprecated Use elm_object_item_widget_get() instead
2513 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2516 * @brief Set the icon of a menu item to the standard icon with name @p icon
2518 * @param it The menu item object.
2519 * @param icon The icon object to set for the content of @p item
2521 * @deprecated elm_menu_item_icon_name_set() instead
2522 * Once this icon is set, any previously set icon will be deleted.
2524 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2527 * @brief Get the string representation from the icon of a menu item
2529 * @param it The menu item object.
2530 * @return The string representation of @p item's icon or NULL
2532 * @deprecated elm_menu_item_icon_name_get() instead
2533 * @see elm_menu_item_icon_name_set()
2535 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2538 * @brief Set the content of the notify widget
2540 * @param obj The notify object
2541 * @param content The content will be filled in this notify object
2543 * Once the content object is set, a previously set one will be deleted. If
2544 * you want to keep that old content object, use the
2545 * elm_notify_content_unset() function.
2547 * @deprecated use elm_object_content_set() instead
2550 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2553 * @brief Unset the content of the notify widget
2555 * @param obj The notify object
2556 * @return The content that was being used
2558 * Unparent and return the content object which was set for this widget
2560 * @see elm_notify_content_set()
2561 * @deprecated use elm_object_content_unset() instead
2564 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2567 * @brief Return the content of the notify widget
2569 * @param obj The notify object
2570 * @return The content that is being used
2572 * @see elm_notify_content_set()
2573 * @deprecated use elm_object_content_get() instead
2576 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2579 * Set a label of an object
2581 * @param obj The Elementary object
2582 * @param part The text part name to set (NULL for the default label)
2583 * @param label The new text of the label
2585 * @note Elementary objects may have many labels (e.g. Action Slider)
2586 * @deprecated Use elm_object_part_text_set() instead.
2588 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2591 * Get a label of an object
2593 * @param obj The Elementary object
2594 * @param part The text part name to get (NULL for the default label)
2595 * @return text of the label or NULL for any error
2597 * @note Elementary objects may have many labels (e.g. Action Slider)
2598 * @deprecated Use elm_object_part_text_get() instead.
2600 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2603 * Set a content of an object
2605 * @param obj The Elementary object
2606 * @param part The content part name to set (NULL for the default content)
2607 * @param content The new content of the object
2609 * @note Elementary objects may have many contents
2610 * @deprecated Use elm_object_part_content_set instead.
2612 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2615 * Get a content of an object
2617 * @param obj The Elementary object
2618 * @param part The content part name to get (NULL for the default content)
2619 * @return content of the object or NULL for any error
2621 * @note Elementary objects may have many contents
2622 * @deprecated Use elm_object_part_content_get instead.
2624 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2627 * Unset a content of an object
2629 * @param obj The Elementary object
2630 * @param part The content part name to unset (NULL for the default content)
2632 * @note Elementary objects may have many contents
2633 * @deprecated Use elm_object_part_content_unset instead.
2635 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2638 * Set a content of an object item
2640 * @param it The Elementary object item
2641 * @param part The content part name to set (NULL for the default content)
2642 * @param content The new content of the object item
2644 * @note Elementary object items may have many contents
2645 * @deprecated Use elm_object_item_part_content_set instead.
2647 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2650 * Get a content of an object item
2652 * @param it The Elementary object item
2653 * @param part The content part name to unset (NULL for the default content)
2654 * @return content of the object item or NULL for any error
2656 * @note Elementary object items may have many contents
2657 * @deprecated Use elm_object_item_part_content_get instead.
2659 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2662 * Unset a content of an object item
2664 * @param it The Elementary object item
2665 * @param part The content part name to unset (NULL for the default content)
2667 * @note Elementary object items may have many contents
2668 * @deprecated Use elm_object_item_part_content_unset instead.
2670 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2673 * Get a label of an object item
2675 * @param it The Elementary object item
2676 * @param part The text part name to get (NULL for the default label)
2677 * @return text of the label or NULL for any error
2679 * @note Elementary object items may have many labels
2680 * @deprecated Use elm_object_item_part_text_get instead.
2682 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2685 * Set a label of an object item
2687 * @param it The Elementary object item
2688 * @param part The text part name to set (NULL for the default label)
2689 * @param label The new text of the label
2691 * @note Elementary object items may have many labels
2692 * @deprecated Use elm_object_item_part_text_set instead.
2694 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2697 * @brief Set the content of the panel.
2699 * @param obj The panel object
2700 * @param content The panel content
2702 * Once the content object is set, a previously set one will be deleted.
2703 * If you want to keep that old content object, use the
2704 * elm_panel_content_unset() function.
2706 * @deprecated use elm_object_content_set() instead
2709 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2712 * @brief Get the content of the panel.
2714 * @param obj The panel object
2715 * @return The content that is being used
2717 * Return the content object which is set for this widget.
2719 * @see elm_panel_content_set()
2721 * @deprecated use elm_object_content_get() instead
2724 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2727 * @brief Unset the content of the panel.
2729 * @param obj The panel object
2730 * @return The content that was being used
2732 * Unparent and return the content object which was set for this widget.
2734 * @see elm_panel_content_set()
2736 * @deprecated use elm_object_content_unset() instead
2739 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2742 * Set the left content of the panes widget.
2744 * @param obj The panes object.
2745 * @param content The new left content object.
2747 * Once the content object is set, a previously set one will be deleted.
2748 * If you want to keep that old content object, use the
2749 * elm_panes_content_left_unset() function.
2751 * If panes is displayed vertically, left content will be displayed at
2754 * @see elm_panes_content_left_get()
2755 * @see elm_panes_content_right_set() to set content on the other side.
2757 * @deprecated use elm_object_part_content_set() instead
2760 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2763 * Set the right content of the panes widget.
2765 * @param obj The panes object.
2766 * @param content The new right content object.
2768 * Once the content object is set, a previously set one will be deleted.
2769 * If you want to keep that old content object, use the
2770 * elm_panes_content_right_unset() function.
2772 * If panes is displayed vertically, left content will be displayed at
2775 * @see elm_panes_content_right_get()
2776 * @see elm_panes_content_left_set() to set content on the other side.
2778 * @deprecated use elm_object_part_content_set() instead
2781 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2784 * Get the left content of the panes.
2786 * @param obj The panes object.
2787 * @return The left content object that is being used.
2789 * Return the left content object which is set for this widget.
2791 * @see elm_panes_content_left_set() for details.
2793 * @deprecated use elm_object_part_content_get() instead
2796 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2799 * Get the right content of the panes.
2801 * @param obj The panes object
2802 * @return The right content object that is being used
2804 * Return the right content object which is set for this widget.
2806 * @see elm_panes_content_right_set() for details.
2808 * @deprecated use elm_object_part_content_get() instead
2811 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2814 * Unset the left content used for the panes.
2816 * @param obj The panes object.
2817 * @return The left content object that was being used.
2819 * Unparent and return the left content object which was set for this widget.
2821 * @see elm_panes_content_left_set() for details.
2822 * @see elm_panes_content_left_get().
2824 * @deprecated use elm_object_part_content_unset() instead
2827 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2830 * Unset the right content used for the panes.
2832 * @param obj The panes object.
2833 * @return The right content object that was being used.
2835 * Unparent and return the right content object which was set for this
2838 * @see elm_panes_content_right_set() for details.
2839 * @see elm_panes_content_right_get().
2841 * @deprecated use elm_object_part_content_unset() instead
2844 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2846 * Set the label of a given progress bar widget
2848 * @param obj The progress bar object
2849 * @param label The text label string, in UTF-8
2851 * @deprecated use elm_object_text_set() instead.
2853 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2856 * Get the label of a given progress bar widget
2858 * @param obj The progressbar object
2859 * @return The text label string, in UTF-8
2861 * @deprecated use elm_object_text_set() instead.
2863 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2866 * Set the icon object of a given progress bar widget
2868 * @param obj The progress bar object
2869 * @param icon The icon object
2871 * Use this call to decorate @p obj with an icon next to it.
2873 * @note Once the icon object is set, a previously set one will be
2874 * deleted. If you want to keep that old content object, use the
2875 * elm_progressbar_icon_unset() function.
2877 * @see elm_progressbar_icon_get()
2878 * @deprecated use elm_object_part_content_set() instead.
2881 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2884 * Retrieve the icon object set for a given progress bar widget
2886 * @param obj The progress bar object
2887 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2888 * otherwise (and on errors)
2890 * @see elm_progressbar_icon_set() for more details
2891 * @deprecated use elm_object_part_content_get() instead.
2894 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2897 * Unset an icon set on a given progress bar widget
2899 * @param obj The progress bar object
2900 * @return The icon object that was being used, if any was set, or
2901 * @c NULL, otherwise (and on errors)
2903 * This call will unparent and return the icon object which was set
2904 * for this widget, previously, on success.
2906 * @see elm_progressbar_icon_set() for more details
2907 * @deprecated use elm_object_part_content_unset() instead.
2910 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2913 * @brief Set the text label of the radio object
2915 * @param obj The radio object
2916 * @param label The text label string in UTF-8
2918 * @deprecated use elm_object_text_set() instead.
2920 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
2923 * @brief Get the text label of the radio object
2925 * @param obj The radio object
2926 * @return The text label string in UTF-8
2928 * @deprecated use elm_object_text_set() instead.
2930 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
2933 * @brief Set the icon object of the radio object
2935 * @param obj The radio object
2936 * @param icon The icon object
2938 * Once the icon object is set, a previously set one will be deleted. If you
2939 * want to keep that old content object, use the elm_radio_icon_unset()
2942 * @deprecated use elm_object_part_content_set() instead.
2945 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2948 * @brief Get the icon object of the radio object
2950 * @param obj The radio object
2951 * @return The icon object
2953 * @see elm_radio_icon_set()
2955 * @deprecated use elm_object_part_content_get() instead.
2958 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2961 * @brief Unset the icon used for the radio object
2963 * @param obj The radio object
2964 * @return The icon object that was being used
2966 * Unparent and return the icon object which was set for this widget.
2968 * @see elm_radio_icon_set()
2969 * @deprecated use elm_object_part_content_unset() instead.
2972 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2975 * @brief Set the content of the scroller widget (the object to be scrolled around).
2977 * @param obj The scroller object
2978 * @param content The new content object
2980 * Once the content object is set, a previously set one will be deleted.
2981 * If you want to keep that old content object, use the
2982 * elm_scroller_content_unset() function.
2983 * @deprecated use elm_object_content_set() instead
2985 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2988 * @brief Get the content of the scroller widget
2990 * @param obj The slider object
2991 * @return The content that is being used
2993 * Return the content object which is set for this widget
2995 * @see elm_scroller_content_set()
2996 * @deprecated use elm_object_content_get() instead.
2998 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
3001 * @brief Unset the content of the scroller widget
3003 * @param obj The slider object
3004 * @return The content that was being used
3006 * Unparent and return the content object which was set for this widget
3008 * @see elm_scroller_content_set()
3009 * @deprecated use elm_object_content_unset() instead.
3011 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
3014 * Set the label of a given slider widget
3016 * @param obj The progress bar object
3017 * @param label The text label string, in UTF-8
3019 * @deprecated use elm_object_text_set() instead.
3021 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
3024 * Get the label of a given slider widget
3026 * @param obj The progressbar object
3027 * @return The text label string, in UTF-8
3029 * @deprecated use elm_object_text_get() instead.
3031 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
3034 * Set the icon object of the slider object.
3036 * @param obj The slider object.
3037 * @param icon The icon object.
3039 * On horizontal mode, icon is placed at left, and on vertical mode,
3042 * @note Once the icon object is set, a previously set one will be deleted.
3043 * If you want to keep that old content object, use the
3044 * elm_slider_icon_unset() function.
3046 * @warning If the object being set does not have minimum size hints set,
3047 * it won't get properly displayed.
3049 * @deprecated use elm_object_part_content_set() instead.
3051 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3054 * Unset an icon set on a given slider widget.
3056 * @param obj The slider object.
3057 * @return The icon object that was being used, if any was set, or
3058 * @c NULL, otherwise (and on errors).
3060 * On horizontal mode, icon is placed at left, and on vertical mode,
3063 * This call will unparent and return the icon object which was set
3064 * for this widget, previously, on success.
3066 * @see elm_slider_icon_set() for more details
3067 * @see elm_slider_icon_get()
3068 * @deprecated use elm_object_part_content_unset() instead.
3071 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3074 * Retrieve the icon object set for a given slider widget.
3076 * @param obj The slider object.
3077 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3078 * otherwise (and on errors).
3080 * On horizontal mode, icon is placed at left, and on vertical mode,
3083 * @see elm_slider_icon_set() for more details
3084 * @see elm_slider_icon_unset()
3086 * @deprecated use elm_object_part_content_get() instead.
3089 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3092 * Set the end object of the slider object.
3094 * @param obj The slider object.
3095 * @param end The end object.
3097 * On horizontal mode, end is placed at left, and on vertical mode,
3100 * @note Once the icon object is set, a previously set one will be deleted.
3101 * If you want to keep that old content object, use the
3102 * elm_slider_end_unset() function.
3104 * @warning If the object being set does not have minimum size hints set,
3105 * it won't get properly displayed.
3107 * @deprecated use elm_object_part_content_set() instead.
3110 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3113 * Unset an end object set on a given slider widget.
3115 * @param obj The slider object.
3116 * @return The end object that was being used, if any was set, or
3117 * @c NULL, otherwise (and on errors).
3119 * On horizontal mode, end is placed at left, and on vertical mode,
3122 * This call will unparent and return the icon object which was set
3123 * for this widget, previously, on success.
3125 * @see elm_slider_end_set() for more details.
3126 * @see elm_slider_end_get()
3128 * @deprecated use elm_object_part_content_unset() instead
3132 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3135 * Retrieve the end object set for a given slider widget.
3137 * @param obj The slider object.
3138 * @return The end object's handle, if @p obj had one set, or @c NULL,
3139 * otherwise (and on errors).
3141 * On horizontal mode, icon is placed at right, and on vertical mode,
3144 * @see elm_slider_end_set() for more details.
3145 * @see elm_slider_end_unset()
3148 * @deprecated use elm_object_part_content_get() instead
3152 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3155 * Return the data associated with a given slideshow item
3157 * @param it The slideshow item
3158 * @return Returns the data associated to this item
3160 * @deprecated use elm_object_item_data_get() instead
3162 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3165 * Delete a given item from a slideshow widget.
3167 * @param it The slideshow item
3169 * @deprecated Use elm_object_item_de() instead
3171 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
3174 * Display a given slideshow widget's item, programmatically.
3176 * @param it The item to display on @p obj's viewport
3178 * The change between the current item and @p item will use the
3179 * transition @p obj is set to use (@see
3180 * elm_slideshow_transition_set()).
3182 * @deprecated use elm_slideshow_item_show() instead
3184 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
3187 * Get the toolbar object from an item.
3189 * @param it The item.
3190 * @return The toolbar object.
3192 * This returns the toolbar object itself that an item belongs to.
3194 * @deprecated use elm_object_item_object_get() instead.
3196 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3199 * Get the label of item.
3201 * @param it The item of toolbar.
3202 * @return The label of item.
3204 * The return value is a pointer to the label associated to @p item when
3205 * it was created, with function elm_toolbar_item_append() or similar,
3207 * with function elm_toolbar_item_label_set. If no label
3208 * was passed as argument, it will return @c NULL.
3210 * @see elm_toolbar_item_label_set() for more details.
3211 * @see elm_toolbar_item_append()
3213 * @deprecated use elm_object_item_text_get() instead.
3215 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3218 * Set the label of item.
3220 * @param it The item of toolbar.
3221 * @param label The label of item.
3223 * The label to be displayed by the item.
3224 * Label will be placed at icons bottom (if set).
3226 * If a label was passed as argument on item creation, with function
3227 * elm_toolbar_item_append() or similar, it will be already
3228 * displayed by the item.
3230 * @see elm_toolbar_item_label_get()
3231 * @see elm_toolbar_item_append()
3233 * @deprecated use elm_object_item_text_set() instead
3235 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3238 * Return the data associated with a given toolbar widget item.
3240 * @param it The toolbar widget item handle.
3241 * @return The data associated with @p item.
3243 * @see elm_toolbar_item_data_set()
3245 * @deprecated use elm_object_item_data_get() instead.
3247 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3250 * Set the data associated with a given toolbar widget item.
3252 * @param it The toolbar widget item handle
3253 * @param data The new data pointer to set to @p item.
3255 * This sets new item data on @p item.
3257 * @warning The old data pointer won't be touched by this function, so
3258 * the user had better to free that old data himself/herself.
3260 * @deprecated use elm_object_item_data_set() instead.
3262 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3265 * Get a value whether toolbar item is disabled or not.
3267 * @param it The item.
3268 * @return The disabled state.
3270 * @see elm_toolbar_item_disabled_set() for more details.
3272 * @deprecated use elm_object_item_disabled_get() instead.
3274 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3277 * Sets the disabled/enabled state of a toolbar item.
3279 * @param it The item.
3280 * @param disabled The disabled state.
3282 * A disabled item cannot be selected or unselected. It will also
3283 * change its appearance (generally greyed out). This sets the
3284 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3287 * @deprecated use elm_object_item_disabled_set() instead.
3289 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3292 * Change a toolbar's orientation
3293 * @param obj The toolbar object
3294 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3295 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3296 * @deprecated use elm_toolbar_horizontal_set() instead.
3298 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3301 * Get a toolbar's orientation
3302 * @param obj The toolbar object
3303 * @return If @c EINA_TRUE, the toolbar is vertical
3304 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3305 * @deprecated use elm_toolbar_horizontal_get() instead.
3307 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3310 * Set the function called when a toolbar item is freed.
3312 * @param it The item to set the callback on.
3313 * @param func The function called.
3315 * If there is a @p func, then it will be called prior item's memory release.
3316 * That will be called with the following arguments:
3318 * @li item's Evas object;
3321 * This way, a data associated to a toolbar item could be properly freed.
3323 * @deprecated Use elm_object_item_del_cb_set() instead
3325 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3328 * Delete them item from the toolbar.
3330 * @param it The item of toolbar to be deleted.
3332 * @deprecated Use elm_object_item_del() instead
3333 * @see elm_toolbar_item_append()
3336 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3339 * Set the text to be shown in a given toolbar item's tooltips.
3341 * @param it toolbar item.
3342 * @param text The text to set in the content.
3344 * Setup the text as tooltip to object. The item can have only one tooltip,
3345 * so any previous tooltip data - set with this function or
3346 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
3348 * @deprecated Use elm_object_item_tooltip_text_set() instead
3349 * @see elm_object_tooltip_text_set() for more details.
3352 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3355 * Set the content to be shown in the tooltip item.
3357 * Setup the tooltip to item. The item can have only one tooltip,
3358 * so any previous tooltip data is removed. @p func(with @p data) will
3359 * be called every time that need show the tooltip and it should
3360 * return a valid Evas_Object. This object is then managed fully by
3361 * tooltip system and is deleted when the tooltip is gone.
3363 * @param it the toolbar item being attached a tooltip.
3364 * @param func the function used to create the tooltip contents.
3365 * @param data what to provide to @a func as callback data/context.
3366 * @param del_cb called when data is not needed anymore, either when
3367 * another callback replaces @a func, the tooltip is unset with
3368 * elm_toolbar_item_tooltip_unset() or the owner @a item
3369 * dies. This callback receives as the first parameter the
3370 * given @a data, and @c event_info is the item.
3372 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3373 * @see elm_object_tooltip_content_cb_set() for more details.
3376 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);
3379 * Unset tooltip from item.
3381 * @param it toolbar item to remove previously set tooltip.
3383 * Remove tooltip from item. The callback provided as del_cb to
3384 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3385 * it is not used anymore.
3387 * @deprecated Use elm_object_item_tooltip_unset() instead
3388 * @see elm_object_tooltip_unset() for more details.
3389 * @see elm_toolbar_item_tooltip_content_cb_set()
3392 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3395 * Sets a different style for this item tooltip.
3397 * @note before you set a style you should define a tooltip with
3398 * elm_toolbar_item_tooltip_content_cb_set() or
3399 * elm_toolbar_item_tooltip_text_set()
3401 * @param it toolbar item with tooltip already set.
3402 * @param style the theme style to use (default, transparent, ...)
3404 * @deprecated Use elm_object_item_tooltip_style_set() instead
3405 * @see elm_object_tooltip_style_set() for more details.
3408 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3411 * Get the style for this item tooltip.
3413 * @param it toolbar item with tooltip already set.
3414 * @return style the theme style in use, defaults to "default". If the
3415 * object does not have a tooltip set, then NULL is returned.
3417 * @deprecated Use elm_object_item_style_get() instead
3418 * @see elm_object_tooltip_style_get() for more details.
3419 * @see elm_toolbar_item_tooltip_style_set()
3422 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3425 * Set the type of mouse pointer/cursor decoration to be shown,
3426 * when the mouse pointer is over the given toolbar widget item
3428 * @param it toolbar item to customize cursor on
3429 * @param cursor the cursor type's name
3431 * This function works analogously as elm_object_cursor_set(), but
3432 * here the cursor's changing area is restricted to the item's
3433 * area, and not the whole widget's. Note that that item cursors
3434 * have precedence over widget cursors, so that a mouse over an
3435 * item with custom cursor set will always show @b that cursor.
3437 * If this function is called twice for an object, a previously set
3438 * cursor will be unset on the second call.
3440 * @see elm_object_cursor_set()
3441 * @see elm_toolbar_item_cursor_get()
3442 * @see elm_toolbar_item_cursor_unset()
3444 * @deprecated use elm_object_item_cursor_set() instead
3447 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3450 * Get the type of mouse pointer/cursor decoration set to be shown,
3451 * when the mouse pointer is over the given toolbar widget item
3453 * @param it toolbar item with custom cursor set
3454 * @return the cursor type's name or @c NULL, if no custom cursors
3455 * were set to @p item (and on errors)
3457 * @see elm_object_cursor_get()
3458 * @see elm_toolbar_item_cursor_set()
3459 * @see elm_toolbar_item_cursor_unset()
3461 * @deprecated Use elm_object_item_cursor_get() instead
3464 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3467 * Unset any custom mouse pointer/cursor decoration set to be
3468 * shown, when the mouse pointer is over the given toolbar widget
3469 * item, thus making it show the @b default cursor again.
3471 * @param it a toolbar item
3473 * Use this call to undo any custom settings on this item's cursor
3474 * decoration, bringing it back to defaults (no custom style set).
3476 * @see elm_object_cursor_unset()
3477 * @see elm_toolbar_item_cursor_set()
3479 * @deprecated Use elm_object_item_cursor_unset() instead
3482 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3485 * Set a different @b style for a given custom cursor set for a
3488 * @param it toolbar item with custom cursor set
3489 * @param style the <b>theme style</b> to use (e.g. @c "default",
3490 * @c "transparent", etc)
3492 * This function only makes sense when one is using custom mouse
3493 * cursor decorations <b>defined in a theme file</b>, which can have,
3494 * given a cursor name/type, <b>alternate styles</b> on it. It
3495 * works analogously as elm_object_cursor_style_set(), but here
3496 * applies only to toolbar item objects.
3498 * @warning Before you set a cursor style you should have defined a
3499 * custom cursor previously on the item, with
3500 * elm_toolbar_item_cursor_set()
3502 * @see elm_toolbar_item_cursor_engine_only_set()
3503 * @see elm_toolbar_item_cursor_style_get()
3505 * @deprecated Use elm_object_item_cursor_style_set() instead
3508 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3511 * Get the current @b style set for a given toolbar item's custom
3514 * @param it toolbar item with custom cursor set.
3515 * @return style the cursor style in use. If the object does not
3516 * have a cursor set, then @c NULL is returned.
3518 * @see elm_toolbar_item_cursor_style_set() for more details
3520 * @deprecated Use elm_object_item_cursor_style_get() instead
3523 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3526 * Set if the (custom)cursor for a given toolbar item should be
3527 * searched in its theme, also, or should only rely on the
3530 * @param it item with custom (custom) cursor already set on
3531 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3532 * only on those provided by the rendering engine, @c EINA_FALSE to
3533 * have them searched on the widget's theme, as well.
3535 * @note This call is of use only if you've set a custom cursor
3536 * for toolbar items, with elm_toolbar_item_cursor_set().
3538 * @note By default, cursors will only be looked for between those
3539 * provided by the rendering engine.
3541 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3544 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3547 * Get if the (custom) cursor for a given toolbar item is being
3548 * searched in its theme, also, or is only relying on the rendering
3551 * @param it a toolbar item
3552 * @return @c EINA_TRUE, if cursors are being looked for only on
3553 * those provided by the rendering engine, @c EINA_FALSE if they
3554 * are being searched on the widget's theme, as well.
3556 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3558 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3561 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3564 * @brief Link a Elm_Payer with an Elm_Video object.
3566 * @param player the Elm_Player object.
3567 * @param video The Elm_Video object.
3569 * This mean that action on the player widget will affect the
3570 * video object and the state of the video will be reflected in
3571 * the player itself.
3573 * @see elm_player_add()
3574 * @see elm_video_add()
3575 * @deprecated use elm_object_part_content_set() instead
3578 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3581 * Set the label of item.
3583 * @param it The item of segment control.
3584 * @param label The label of item.
3586 * The label to be displayed by the item.
3587 * Label will be at right of the icon (if set).
3589 * If a label was passed as argument on item creation, with function
3590 * elm_control_segment_item_add(), it will be already
3591 * displayed by the item.
3593 * @see elm_segment_control_item_label_get()
3594 * @see elm_segment_control_item_add()
3595 * @deprecated Use elm_object_item_text_set() instead
3598 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3602 * Set the icon associated to the item.
3604 * @param it The segment control item.
3605 * @param icon The icon object to associate with @p it.
3607 * The icon object to use at left side of the item. An
3608 * icon can be any Evas object, but usually it is an icon created
3609 * with elm_icon_add().
3611 * Once the icon object is set, a previously set one will be deleted.
3612 * @warning Setting the same icon for two items will cause the icon to
3613 * disappear from the first item.
3615 * If an icon was passed as argument on item creation, with function
3616 * elm_segment_control_item_add(), it will be already
3617 * associated to the item.
3619 * @see elm_segment_control_item_add()
3620 * @see elm_segment_control_item_icon_get()
3621 * @deprecated Use elm_object_item_part_content_set() instead
3624 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3627 * Remove a segment control item from its parent, deleting it.
3629 * @param it The item to be removed.
3631 * Items can be added with elm_segment_control_item_add() or
3632 * elm_segment_control_item_insert_at().
3634 * @deprecated Use elm_object_item_del() instead
3636 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3641 * @param obj The multibuttonentry object
3642 * @return The label, or NULL if none
3644 * @deprecated Use elm_object_text_get() instead
3647 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3652 * @param obj The multibuttonentry object
3653 * @param label The text label string
3655 * @deprecated Use elm_object_text_set() instead
3658 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3661 * Get the label of a given item
3663 * @param it The item
3664 * @return The label of a given item, or NULL if none
3666 * @deprecated Use elm_object_item_text_get() instead
3669 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3672 * Set the label of a given item
3674 * @param it The item
3675 * @param str The text label string
3677 * @deprecated Use elm_object_item_text_set() instead
3679 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3682 * Delete a given item
3684 * @param it The item
3686 * @deprecated Use elm_object_item_del() instead
3689 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3692 * @brief Delete the given item instantly.
3694 * @param it The naviframe item
3696 * This just deletes the given item from the naviframe item list instantly.
3697 * So this would not emit any signals for view transitions but just change
3698 * the current view if the given item is a top one.
3700 * @deprecated Use elm_object_item_del() instead
3702 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3707 * Sets the disabled/enabled state of a list item.
3709 * @param it The item.
3710 * @param disabled The disabled state.
3712 * A disabled item cannot be selected or unselected. It will also
3713 * change its appearance (generally greyed out). This sets the
3714 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3717 * @deprecated Use elm_object_item_disabled_set() instead
3720 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3723 * Get a value whether list item is disabled or not.
3725 * @param it The item.
3726 * @return The disabled state.
3728 * @see elm_list_item_disabled_set() for more details.
3730 * @deprecated Use elm_object_item_disabled_get() instead
3733 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3736 * Set the function called when a list item is freed.
3738 * @param it The item to set the callback on
3739 * @param func The function called
3741 * If there is a @p func, then it will be called prior item's memory release.
3742 * That will be called with the following arguments:
3744 * @li item's Evas object;
3747 * This way, a data associated to a list item could be properly freed.
3749 * @deprecated Please use elm_object_item_del_cb_set() instead.
3752 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3755 * Get the data associated to the item.
3757 * @param it The list item
3758 * @return The data associated to @p item
3760 * The return value is a pointer to data associated to @p item when it was
3761 * created, with function elm_list_item_append() or similar. If no data
3762 * was passed as argument, it will return @c NULL.
3764 * @see elm_list_item_append()
3766 * @deprecated Please use elm_object_item_data_get() instead.
3769 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
3772 * Get the left side icon associated to the item.
3774 * @param it The list item
3775 * @return The left side icon associated to @p item
3777 * The return value is a pointer to the icon associated to @p item when
3779 * created, with function elm_list_item_append() or similar, or later
3780 * with function elm_list_item_icon_set(). If no icon
3781 * was passed as argument, it will return @c NULL.
3783 * @see elm_list_item_append()
3784 * @see elm_list_item_icon_set()
3786 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3788 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
3791 * Set the left side icon associated to the item.
3793 * @param it The list item
3794 * @param icon The left side icon object to associate with @p item
3796 * The icon object to use at left side of the item. An
3797 * icon can be any Evas object, but usually it is an icon created
3798 * with elm_icon_add().
3800 * Once the icon object is set, a previously set one will be deleted.
3801 * @warning Setting the same icon for two items will cause the icon to
3802 * disappear from the first item.
3804 * If an icon was passed as argument on item creation, with function
3805 * elm_list_item_append() or similar, it will be already
3806 * associated to the item.
3808 * @see elm_list_item_append()
3809 * @see elm_list_item_icon_get()
3811 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3813 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3816 * Get the right side icon associated to the item.
3818 * @param it The list item
3819 * @return The right side icon associated to @p item
3821 * The return value is a pointer to the icon associated to @p item when
3823 * created, with function elm_list_item_append() or similar, or later
3824 * with function elm_list_item_icon_set(). If no icon
3825 * was passed as argument, it will return @c NULL.
3827 * @see elm_list_item_append()
3828 * @see elm_list_item_icon_set()
3830 * @deprecated Please use elm_object_item_part_content_get(item, "end");
3832 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
3835 * Set the right side icon associated to the item.
3837 * @param it The list item
3838 * @param end The right side icon object to associate with @p item
3840 * The icon object to use at right side of the item. An
3841 * icon can be any Evas object, but usually it is an icon created
3842 * with elm_icon_add().
3844 * Once the icon object is set, a previously set one will be deleted.
3845 * @warning Setting the same icon for two items will cause the icon to
3846 * disappear from the first item.
3848 * If an icon was passed as argument on item creation, with function
3849 * elm_list_item_append() or similar, it will be already
3850 * associated to the item.
3852 * @see elm_list_item_append()
3853 * @see elm_list_item_end_get()
3855 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3857 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3860 * Get the label of item.
3862 * @param it The item of list.
3863 * @return The label of item.
3865 * The return value is a pointer to the label associated to @p item when
3866 * it was created, with function elm_list_item_append(), or later
3867 * with function elm_list_item_label_set. If no label
3868 * was passed as argument, it will return @c NULL.
3870 * @see elm_list_item_label_set() for more details.
3871 * @see elm_list_item_append()
3873 * @deprecated Please use elm_object_item_text_get(item);
3875 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
3878 * Set the label of item.
3880 * @param it The item of list.
3881 * @param text The label of item.
3883 * The label to be displayed by the item.
3884 * Label will be placed between left and right side icons (if set).
3886 * If a label was passed as argument on item creation, with function
3887 * elm_list_item_append() or similar, it will be already
3888 * displayed by the item.
3890 * @see elm_list_item_label_get()
3891 * @see elm_list_item_append()
3893 * @deprecated Please use elm_object_item_text_set(item, text);
3895 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3898 * Set the text to be shown in a given list item's tooltips.
3900 * @param it Target item.
3901 * @param text The text to set in the content.
3903 * Setup the text as tooltip to object. The item can have only one tooltip,
3904 * so any previous tooltip data - set with this function or
3905 * elm_list_item_tooltip_content_cb_set() - is removed.
3907 * @deprecated Use elm_object_item_tooltip_text_set() instead
3908 * @see elm_object_tooltip_text_set() for more details.
3911 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3914 * @brief Disable size restrictions on an object's tooltip
3915 * @param it The tooltip's anchor object
3916 * @param disable If EINA_TRUE, size restrictions are disabled
3917 * @return EINA_FALSE on failure, EINA_TRUE on success
3919 * This function allows a tooltip to expand beyond its parent window's canvas.
3920 * It will instead be limited only by the size of the display.
3922 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3925 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3928 * @brief Retrieve size restriction state of an object's tooltip
3929 * @param obj The tooltip's anchor object
3930 * @return If EINA_TRUE, size restrictions are disabled
3932 * This function returns whether a tooltip is allowed to expand beyond
3933 * its parent window's canvas.
3934 * It will instead be limited only by the size of the display.
3936 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3939 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3942 * Set the content to be shown in the tooltip item.
3944 * Setup the tooltip to item. The item can have only one tooltip,
3945 * so any previous tooltip data is removed. @p func(with @p data) will
3946 * be called every time that need show the tooltip and it should
3947 * return a valid Evas_Object. This object is then managed fully by
3948 * tooltip system and is deleted when the tooltip is gone.
3950 * @param it the list item being attached a tooltip.
3951 * @param func the function used to create the tooltip contents.
3952 * @param data what to provide to @a func as callback data/context.
3953 * @param del_cb called when data is not needed anymore, either when
3954 * another callback replaces @a func, the tooltip is unset with
3955 * elm_list_item_tooltip_unset() or the owner @a item
3956 * dies. This callback receives as the first parameter the
3957 * given @a data, and @c event_info is the item.
3959 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3961 * @see elm_object_tooltip_content_cb_set() for more details.
3964 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);
3967 * Unset tooltip from item.
3969 * @param it list item to remove previously set tooltip.
3971 * Remove tooltip from item. The callback provided as del_cb to
3972 * elm_list_item_tooltip_content_cb_set() will be called to notify
3973 * it is not used anymore.
3975 * @deprecated Use elm_object_item_tooltip_unset() instead
3976 * @see elm_object_tooltip_unset() for more details.
3977 * @see elm_list_item_tooltip_content_cb_set()
3980 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
3983 * Sets a different style for this item tooltip.
3985 * @note before you set a style you should define a tooltip with
3986 * elm_list_item_tooltip_content_cb_set() or
3987 * elm_list_item_tooltip_text_set()
3989 * @param it list item with tooltip already set.
3990 * @param style the theme style to use (default, transparent, ...)
3993 * @deprecated Use elm_object_item_tooltip_style_set() instead
3994 * @see elm_object_tooltip_style_set() for more details.
3997 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
4000 * Get the style for this item tooltip.
4002 * @param it list item with tooltip already set.
4003 * @return style the theme style in use, defaults to "default". If the
4004 * object does not have a tooltip set, then NULL is returned.
4006 * @deprecated Use elm_object_item_tooltip_style_get() instead
4008 * @see elm_object_tooltip_style_get() for more details.
4009 * @see elm_list_item_tooltip_style_set()
4012 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
4015 * Set the type of mouse pointer/cursor decoration to be shown,
4016 * when the mouse pointer is over the given list widget item
4018 * @param it list item to customize cursor on
4019 * @param cursor the cursor type's name
4021 * This function works analogously as elm_object_cursor_set(), but
4022 * here the cursor's changing area is restricted to the item's
4023 * area, and not the whole widget's. Note that that item cursors
4024 * have precedence over widget cursors, so that a mouse over an
4025 * item with custom cursor set will always show @b that cursor.
4027 * If this function is called twice for an object, a previously set
4028 * cursor will be unset on the second call.
4030 * @see elm_object_cursor_set()
4031 * @see elm_list_item_cursor_get()
4032 * @see elm_list_item_cursor_unset()
4034 * @deprecated Please use elm_object_item_cursor_set() instead
4036 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
4039 * Get the type of mouse pointer/cursor decoration set to be shown,
4040 * when the mouse pointer is over the given list widget item
4042 * @param it list item with custom cursor set
4043 * @return the cursor type's name or @c NULL, if no custom cursors
4044 * were set to @p item (and on errors)
4046 * @see elm_object_cursor_get()
4047 * @see elm_list_item_cursor_set()
4048 * @see elm_list_item_cursor_unset()
4050 * @deprecated Please use elm_object_item_cursor_get() instead
4052 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
4055 * Unset any custom mouse pointer/cursor decoration set to be
4056 * shown, when the mouse pointer is over the given list widget
4057 * item, thus making it show the @b default cursor again.
4059 * @param it a list item
4061 * Use this call to undo any custom settings on this item's cursor
4062 * decoration, bringing it back to defaults (no custom style set).
4064 * @see elm_object_cursor_unset()
4065 * @see elm_list_item_cursor_set()
4067 * @deprecated Please use elm_list_item_cursor_unset() instead
4069 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
4072 * Set a different @b style for a given custom cursor set for a
4075 * @param it list item with custom cursor set
4076 * @param style the <b>theme style</b> to use (e.g. @c "default",
4077 * @c "transparent", etc)
4079 * This function only makes sense when one is using custom mouse
4080 * cursor decorations <b>defined in a theme file</b>, which can have,
4081 * given a cursor name/type, <b>alternate styles</b> on it. It
4082 * works analogously as elm_object_cursor_style_set(), but here
4083 * applies only to list item objects.
4085 * @warning Before you set a cursor style you should have defined a
4086 * custom cursor previously on the item, with
4087 * elm_list_item_cursor_set()
4089 * @see elm_list_item_cursor_engine_only_set()
4090 * @see elm_list_item_cursor_style_get()
4092 * @deprecated Please use elm_list_item_cursor_style_set() instead
4094 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
4097 * Get the current @b style set for a given list item's custom
4100 * @param it list item with custom cursor set.
4101 * @return style the cursor style in use. If the object does not
4102 * have a cursor set, then @c NULL is returned.
4104 * @see elm_list_item_cursor_style_set() for more details
4106 * @deprecated Please use elm_list_item_cursor_style_get() instead
4108 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
4111 * Set if the (custom)cursor for a given list item should be
4112 * searched in its theme, also, or should only rely on the
4115 * @param it item with custom (custom) cursor already set on
4116 * @param engine_only Use @c EINA_TRUE to have cursors looked for
4117 * only on those provided by the rendering engine, @c EINA_FALSE to
4118 * have them searched on the widget's theme, as well.
4120 * @note This call is of use only if you've set a custom cursor
4121 * for list items, with elm_list_item_cursor_set().
4123 * @note By default, cursors will only be looked for between those
4124 * provided by the rendering engine.
4126 * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
4128 EINA_DEPRECATED EAPI void elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
4131 * Get if the (custom) cursor for a given list item is being
4132 * searched in its theme, also, or is only relying on the rendering
4135 * @param it a list item
4136 * @return @c EINA_TRUE, if cursors are being looked for only on
4137 * those provided by the rendering engine, @c EINA_FALSE if they
4138 * are being searched on the widget's theme, as well.
4140 * @see elm_list_item_cursor_engine_only_set(), for more details
4142 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
4144 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
4147 * Delete the item from the list.
4149 * @param it The item of list to be deleted.
4151 * If deleting all list items is required, elm_list_clear()
4152 * should be used instead of getting items list and deleting each one.
4154 * @see elm_list_clear()
4155 * @see elm_list_item_append()
4156 * @see elm_widget_item_del_cb_set()
4157 * @deprecated Use elm_object_item_del() instead
4160 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
4163 * Set the shrink state of toolbar @p obj.
4165 * @param obj The toolbar object.
4166 * @param shrink_mode Toolbar's items display behavior.
4168 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
4169 * but will enforce a minimum size so all the items will fit, won't scroll
4170 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
4171 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
4172 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
4174 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
4176 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
4179 * Get the shrink mode of toolbar @p obj.
4181 * @param obj The toolbar object.
4182 * @return Toolbar's items display behavior.
4184 * @see elm_toolbar_shrink_mode_set() for details.
4186 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
4188 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
4191 * This sets a widget to be displayed to the left of a scrolled entry.
4193 * @param obj The scrolled entry object
4194 * @param icon The widget to display on the left side of the scrolled
4197 * @note A previously set widget will be destroyed.
4198 * @note If the object being set does not have minimum size hints set,
4199 * it won't get properly displayed.
4201 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4202 * @see elm_entry_end_set()
4204 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4207 * Gets the leftmost widget of the scrolled entry. This object is
4208 * owned by the scrolled entry and should not be modified.
4210 * @param obj The scrolled entry object
4211 * @return the left widget inside the scroller
4213 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4215 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
4218 * Unset the leftmost widget of the scrolled entry, unparenting and
4221 * @param obj The scrolled entry object
4222 * @return the previously set icon sub-object of this entry, on
4225 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4226 * @see elm_entry_icon_set()
4228 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
4231 * This sets a widget to be displayed to the end of a scrolled entry.
4233 * @param obj The scrolled entry object
4234 * @param end The widget to display on the right side of the scrolled
4237 * @note A previously set widget will be destroyed.
4238 * @note If the object being set does not have minimum size hints set,
4239 * it won't get properly displayed.
4241 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4242 * @see elm_entry_icon_set
4244 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4247 * Gets the endmost widget of the scrolled entry. This object is owned
4248 * by the scrolled entry and should not be modified.
4250 * @param obj The scrolled entry object
4251 * @return the right widget inside the scroller
4253 * @deprecated Use elm_object_part_content_get(entry, "end") instead
4255 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
4258 * Unset the endmost widget of the scrolled entry, unparenting and
4261 * @param obj The scrolled entry object
4262 * @return the previously set icon sub-object of this entry, on
4265 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4266 * @see elm_entry_icon_set()
4268 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
4271 * Set route service to be used. By default used source is
4272 * #ELM_MAP_ROUTE_SOURCE_YOURS.
4274 * @see elm_map_route_source_set()
4275 * @see elm_map_route_source_get()
4280 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
4281 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. */
4282 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
4283 ELM_MAP_ROUTE_SOURCE_LAST
4284 } Elm_Map_Route_Sources;
4287 * Convert a pixel coordinate into a rotated pixel coordinate.
4289 * @param obj The map object.
4290 * @param x horizontal coordinate of the point to rotate.
4291 * @param y vertical coordinate of the point to rotate.
4292 * @param cx rotation's center horizontal position.
4293 * @param cy rotation's center vertical position.
4294 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4295 * @param xx Pointer where to store rotated x.
4296 * @param yy Pointer where to store rotated y.
4298 * @deprecated Use elm_map_canvas_to_geo_convert() instead
4300 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);
4303 * Convert a pixel coordinate (x,y) into a geographic coordinate
4304 * (longitude, latitude).
4306 * @param obj The map object.
4307 * @param x the coordinate.
4308 * @param y the coordinate.
4309 * @param size the size in pixels of the map.
4310 * The map is a square and generally his size is : pow(2.0, zoom)*256.
4311 * @param lon Pointer to store the longitude that correspond to x.
4312 * @param lat Pointer to store the latitude that correspond to y.
4314 * @note Origin pixel point is the top left corner of the viewport.
4315 * Map zoom and size are taken on account.
4317 * @see elm_map_utils_convert_geo_into_coord() if you need the inverse.
4319 * @deprecated Use elm_map_canvas_to_geo_convert() instead
4321 EINA_DEPRECATED EAPI void elm_map_utils_convert_coord_into_geo(const Evas_Object *obj, int x, int y, int size, double *lon, double *lat);
4324 * Convert a geographic coordinate (longitude, latitude) into a pixel
4325 * coordinate (x, y).
4327 * @param obj The map object.
4328 * @param lon the longitude.
4329 * @param lat the latitude.
4330 * @param size the size in pixels of the map. The map is a square
4331 * and generally his size is : pow(2.0, zoom)*256.
4332 * @param x Pointer to store the horizontal pixel coordinate that
4333 * correspond to the longitude.
4334 * @param y Pointer to store the vertical pixel coordinate that
4335 * correspond to the latitude.
4337 * @note Origin pixel point is the top left corner of the viewport.
4338 * Map zoom and size are taken on account.
4340 * @see elm_map_utils_convert_coord_into_geo() if you need the inverse.
4342 * @deprecatedUse Use elm_map_canvas_to_geo_convert() instead
4344 EINA_DEPRECATED EAPI void elm_map_utils_convert_geo_into_coord(const Evas_Object *obj, double lon, double lat, int size, int *x, int *y);
4347 * Get the information of downloading status.
4349 * @param obj The map object.
4350 * @param try_num Pointer to store number of tiles being downloaded.
4351 * @param finish_num Pointer to store number of tiles successfully
4354 * This gets the current downloading status for the map object, the number
4355 * of tiles being downloaded and the number of tiles already downloaded.
4357 * @deprecatedUse Use elm_map_tile_load_status_get() instead
4359 EINA_DEPRECATED EAPI void elm_map_utils_downloading_status_get(const Evas_Object *obj, int *try_num, int *finish_num);
4362 * Convert a geographic coordinate (longitude, latitude) into a name
4365 * @param obj The map object.
4366 * @param lon the longitude.
4367 * @param lat the latitude.
4368 * @return name A #Elm_Map_Name handle for this coordinate.
4370 * To get the string for this address, elm_map_name_address_get()
4373 * @see elm_map_utils_convert_name_into_coord() if you need the inverse.
4374 * @deprecatedUse Use elm_map_name_add() instead
4377 EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_coord_into_name(const Evas_Object *obj, double lon, double lat);
4380 * Convert a name (address) into a geographic coordinate
4381 * (longitude, latitude).
4383 * @param obj The map object.
4384 * @param address The address.
4385 * @return name A #Elm_Map_Name handle for this address.
4387 * To get the longitude and latitude, elm_map_name_region_get()
4390 * @see elm_map_utils_convert_coord_into_name() if you need the inverse.
4391 * @deprecatedUse Use elm_map_name_geo_request() instead
4394 EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_name_into_coord(const Evas_Object *obj, char *address);
4397 * Convert canvas coordinates into a geographic coordinate
4398 * (longitude, latitude).
4400 * @param obj The map object.
4401 * @param x horizontal coordinate of the point to convert.
4402 * @param y vertical coordinate of the point to convert.
4403 * @param lon A pointer to the longitude.
4404 * @param lat A pointer to the latitude.
4406 * This gets longitude and latitude from canvas x, y coordinates. The canvas
4407 * coordinates mean x, y coordinate from current viewport.
4409 * see elm_map_rotate_get()
4410 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
4413 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);
4416 * Get the current geographic coordinates of the map.
4418 * @param obj The map object.
4419 * @param lon Pointer to store longitude.
4420 * @param lat Pointer to store latitude.
4422 * This gets the current center coordinates of the map object. It can be
4423 * set by elm_map_region_bring_in() and elm_map_region_show().
4425 * @see elm_map_region_bring_in()
4426 * @see elm_map_region_show()
4428 * @deprecated Use elm_map_region_get() instead
4430 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
4433 * Animatedly bring in given coordinates to the center of the map.
4435 * @param obj The map object.
4436 * @param lon Longitude to center at.
4437 * @param lat Latitude to center at.
4439 * This causes map to jump to the given @p lat and @p lon coordinates
4440 * and show it (by scrolling) in the center of the viewport, if it is not
4441 * already centered. This will use animation to do so and take a period
4442 * of time to complete.
4444 * @see elm_map_region_show() for a function to avoid animation.
4445 * @see elm_map_region_get()
4447 * @deprecated Use elm_map_region_bring_in() instead
4449 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
4452 * Show the given coordinates at the center of the map, @b immediately.
4454 * @param obj The map object.
4455 * @param lon Longitude to center at.
4456 * @param lat Latitude to center at.
4458 * This causes map to @b redraw its viewport's contents to the
4459 * region containing the given @p lat and @p lon, that will be moved to the
4460 * center of the map.
4462 * @see elm_map_region_bring_in() for a function to move with animation.
4463 * @see elm_map_region_get()
4465 * @deprecated Use elm_map_region_show() instead
4467 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
4470 * Set the minimum zoom of the source.
4472 * @param obj The map object.
4473 * @param zoom New minimum zoom value to be used.
4475 * By default, it's 0.
4477 * @deprecated Use elm_map_zoom_min_set() instead
4479 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4482 * Get the minimum zoom of the source.
4484 * @param obj The map object.
4485 * @return Returns the minimum zoom of the source.
4487 * @see elm_map_zoom_min_set() for details.
4489 * @deprecated Use elm_map_zoom_min_get() instead
4491 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
4494 * Set the maximum zoom of the source.
4496 * @param obj The map object.
4497 * @param zoom New maximum zoom value to be used.
4499 * By default, it's 18.
4501 * @deprecated Use elm_map_zoom_max_set() instead
4503 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4506 * Get the maximum zoom of the source.
4508 * @param obj The map object.
4509 * @return Returns the maximum zoom of the source.
4511 * @see elm_map_zoom_min_set() for details.
4513 * @deprecated Use elm_map_zoom_max_get() instead
4515 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
4519 * Get the list of available sources.
4521 * @param obj The map object.
4522 * @return The source names list.
4524 * It will provide a list with all available sources, that can be set as
4525 * current source with elm_map_source_name_set(), or get with
4526 * elm_map_source_name_get().
4528 * Available sources:
4534 * @see elm_map_source_name_set() for more details.
4535 * @see elm_map_source_name_get()
4536 * @deprecated Use elm_map_sources_get() instead
4539 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
4542 * Set the source of the map.
4544 * @param obj The map object.
4545 * @param source_name The source to be used.
4547 * Map widget retrieves images that composes the map from a web service.
4548 * This web service can be set with this method.
4550 * A different service can return a different maps with different
4551 * information and it can use different zoom values.
4553 * The @p source_name need to match one of the names provided by
4554 * elm_map_source_names_get().
4556 * The current source can be get using elm_map_source_name_get().
4558 * @see elm_map_source_names_get()
4559 * @see elm_map_source_name_get()
4560 * @deprecated Use elm_map_source_set() instead
4563 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
4566 * Get the name of currently used source.
4568 * @param obj The map object.
4569 * @return Returns the name of the source in use.
4571 * @see elm_map_source_name_set() for more details.
4572 * @deprecated Use elm_map_source_get() instead
4575 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
4578 * Set the source of the route service to be used by the map.
4580 * @param obj The map object.
4581 * @param source The route service to be used, being it one of
4582 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4583 * and #ELM_MAP_ROUTE_SOURCE_ORS.
4585 * Each one has its own algorithm, so the route retrieved may
4586 * differ depending on the source route. Now, only the default is working.
4588 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4589 * http://www.yournavigation.org/.
4591 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4592 * assumptions. Its routing core is based on Contraction Hierarchies.
4594 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4596 * @see elm_map_route_source_get().
4597 * @deprecated Use elm_map_source_set() instead
4600 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);