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 * Give focus to next object in object tree.
1866 * Give focus to next object in focus chain of one object sub-tree.
1867 * If the last object of chain already have focus, the focus will go to the
1868 * first object of chain.
1870 * @param obj The object root of sub-tree
1871 * @param dir Direction to cycle the focus
1873 * @deprecated Use elm_object_focus_next() instead
1877 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
1880 * Remove the focus from an Elementary object
1882 * @param obj The Elementary to take focus from
1884 * This removes the focus from @p obj, passing it back to the
1885 * previous element in the focus chain list.
1887 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1888 * @deprecated use elm_object_focus_set() instead.
1892 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1895 * Give focus to near object in one direction.
1897 * Give focus to near object in direction of one object.
1898 * If none focusable object in given direction, the focus will not change.
1900 * @param obj The reference object
1901 * @param x Horizontal component of direction to focus
1902 * @param y Vertical component of direction to focus
1904 * @deprecated Support it later.
1907 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1910 * @brief Set the frame label
1912 * @param obj The frame object
1913 * @param label The label of this frame object
1915 * @deprecated use elm_object_text_set() instead.
1917 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1920 * @brief Get the frame label
1922 * @param obj The frame object
1924 * @return The label of this frame object or NULL if unable to get frame
1926 * @deprecated use elm_object_text_get() instead.
1928 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1931 * @brief Set the content of the frame widget
1933 * Once the content object is set, a previously set one will be deleted.
1934 * If you want to keep that old content object, use the
1935 * elm_frame_content_unset() function.
1937 * @param obj The frame object
1938 * @param content The content will be filled in this frame object
1940 * @deprecated use elm_object_content_set() instead.
1942 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1945 * @brief Get the content of the frame widget
1947 * Return the content object which is set for this widget
1949 * @param obj The frame object
1950 * @return The content that is being used
1952 * @deprecated use elm_object_content_get() instead.
1954 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1957 * @brief Unset the content of the frame widget
1959 * Unparent and return the content object which was set for this widget
1961 * @param obj The frame object
1962 * @return The content that was being used
1964 * @deprecated use elm_object_content_unset() instead.
1966 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1968 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1969 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1970 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1972 * This sets the horizontal stretching mode.
1974 * @param obj The genlist object
1975 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1977 * This sets the mode used for sizing items horizontally. Valid modes
1978 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1979 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1980 * the scroller will scroll horizontally. Otherwise items are expanded
1981 * to fill the width of the viewport of the scroller. If it is
1982 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1983 * limited to that size.
1985 * @see elm_genlist_horizontal_get()
1987 * @deprecated use elm_genlist_mode_set()
1990 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1993 * Gets the horizontal stretching mode.
1995 * @param obj The genlist object
1996 * @return The mode to use
1997 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1999 * @see elm_genlist_horizontal_set()
2001 * @deprecated use elm_genlist_mode_get()
2004 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
2007 * Return the data associated to a given genlist item
2009 * @param it The genlist item.
2010 * @return the data associated to this item.
2012 * This returns the @c data value passed on the
2013 * elm_genlist_item_append() and related item addition calls.
2015 * @see elm_genlist_item_append()
2016 * @see elm_genlist_item_data_set()
2018 * @deprecated Use elm_object_item_data_get() instead
2021 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2024 * Set the data associated to a given genlist item
2026 * @param it The genlist item
2027 * @param data The new data pointer to set on it
2029 * This @b overrides the @c data value passed on the
2030 * elm_genlist_item_append() and related item addition calls. This
2031 * function @b won't call elm_genlist_item_update() automatically,
2032 * so you'd issue it afterwards if you want to hove the item
2033 * updated to reflect the that new data.
2035 * @see elm_genlist_item_data_get()
2037 * @deprecated Use elm_object_item_data_set() instead
2040 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2043 * Set whether a given genlist item is disabled or not.
2045 * @param it The item
2046 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2047 * to enable it back.
2049 * A disabled item cannot be selected or unselected. It will also
2050 * change its appearance, to signal the user it's disabled.
2052 * @see elm_genlist_item_disabled_get()
2053 * @deprecated Use elm_object_item_disabled_set() instead
2057 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2060 * Get whether a given genlist item is disabled or not.
2062 * @param it The item
2063 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2066 * @see elm_genlist_item_disabled_set() for more details
2067 * @deprecated Use elm_object_item_disabled_get() instead
2071 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2074 * Remove a genlist item from the its parent, deleting it.
2076 * @param it The item to be removed.
2077 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2079 * @see elm_genlist_clear(), to remove all items in a genlist at
2082 * @deprecated Use elm_object_item_del() instead
2085 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2088 * Get the genlist object's handle which contains a given genlist
2091 * @param it The item to fetch the container from
2092 * @return The genlist (parent) object
2094 * This returns the genlist object itself that an item belongs to.
2095 * @deprecated Use elm_object_item_widget_get() instead
2099 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2102 * Get the mode item style of items in the genlist
2103 * @param obj The genlist object
2104 * @return The mode item style string, or NULL if none is specified
2106 * This is a constant string and simply defines the name of the
2107 * style that will be used for mode animations. It can be
2108 * @c NULL if you don't plan to use Genlist mode. See
2109 * elm_genlist_item_mode_set() for more info.
2113 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2116 * Set the mode item style of items in the genlist
2117 * @param obj The genlist object
2118 * @param style The mode item style string, or NULL if none is desired
2120 * This is a constant string and simply defines the name of the
2121 * style that will be used for mode animations. It can be
2122 * @c NULL if you don't plan to use Genlist mode. See
2123 * elm_genlist_item_mode_set() for more info.
2127 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2130 * Get the Item's Flags
2132 * @param it The genlist item
2133 * @return The item type.
2135 * This function returns the item's type. Normally the item's type.
2136 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2138 * @deprecated Use elm_genlist_item_type_get() instead
2141 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2144 * Tells genlist to "orphan" contents fetched by the item class
2146 * @param it The item
2148 * This instructs genlist to release references to contents in the item,
2149 * meaning that they will no longer be managed by genlist and are
2150 * floating "orphans" that can be re-used elsewhere if the user wants
2153 * @deprecated Use elm_genlist_item_all_contents_unset() instead
2155 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it);
2157 #define ELM_IMAGE_ROTATE_90_CW 1
2158 #define ELM_IMAGE_ROTATE_180_CW 2
2159 #define ELM_IMAGE_ROTATE_90_CCW 3
2162 * Return the data associated with a given index widget item
2164 * @param item The index widget item handle
2165 * @return The data associated with @p it
2166 * @deprecated Use elm_object_item_data_get() instead
2168 * @see elm_index_item_data_set()
2171 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2174 * Set the data associated with a given index widget item
2176 * @param it The index widget item handle
2177 * @param data The new data pointer to set to @p it
2179 * This sets new item data on @p it.
2181 * @warning The old data pointer won't be touched by this function, so
2182 * the user had better to free that old data himself/herself.
2184 * @deprecated Use elm_object_item_data_set() instead
2186 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2189 * Set the function to be called when a given index widget item is freed.
2191 * @param it The item to set the callback on
2192 * @param func The function to call on the item's deletion
2194 * When called, @p func will have both @c data and @c event_info
2195 * arguments with the @p it item's data value and, naturally, the
2196 * @c obj argument with a handle to the parent index widget.
2198 * @deprecated Use elm_object_item_del_cb_set() instead
2200 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2203 * Remove an item from a given index widget, <b>to be referenced by
2204 * it's data value</b>.
2206 * @param obj The index object
2207 * @param item The item to be removed from @p obj
2209 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2210 * that callback function will be called by this one.
2212 * @deprecated Use elm_object_item_del() instead
2214 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2217 * @brief Set the label on the label object
2219 * @param obj The label object
2220 * @param label The label will be used on the label object
2221 * @deprecated See elm_object_text_set()
2223 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2226 * @brief Get the label used on the label object
2228 * @param obj The label object
2229 * @return The string inside the label
2230 * @deprecated See elm_object_text_get()
2232 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2236 * Set the layout content.
2238 * @param obj The layout object
2239 * @param swallow The swallow part name in the edje file
2240 * @param content The child that will be added in this layout object
2241 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2243 * Once the content object is set, a previously set one will be deleted.
2244 * If you want to keep that old content object, use the
2245 * elm_object_part_content_unset() function.
2247 * @note In an Edje theme, the part used as a content container is called @c
2248 * SWALLOW. This is why the parameter name is called @p swallow, but it is
2249 * expected to be a part name just like the second parameter of
2250 * elm_layout_box_append().
2252 * @see elm_layout_box_append()
2253 * @see elm_object_part_content_get()
2254 * @see elm_object_part_content_unset()
2256 * @deprecated use elm_object_part_content_set() instead
2259 EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2262 * Get the child object in the given content part.
2264 * @param obj The layout object
2265 * @param swallow The SWALLOW part to get its content
2267 * @return The swallowed object or NULL if none or an error occurred
2269 * @deprecated use elm_object_part_content_get() instead
2272 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2275 * Unset the layout content.
2277 * @param obj The layout object
2278 * @param swallow The swallow part name in the edje file
2279 * @return The content that was being used
2281 * Unparent and return the content object which was set for this part.
2283 * @deprecated use elm_object_part_content_unset() instead
2286 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2289 * Set the text of the given part
2291 * @param obj The layout object
2292 * @param part The TEXT part where to set the text
2293 * @param text The text to set
2294 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2296 * @deprecated use elm_object_part_text_set() instead.
2298 EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2301 * Get the text set in the given part
2303 * @param obj The layout object
2304 * @param part The TEXT part to retrieve the text off
2306 * @return The text set in @p part
2308 * @deprecated use elm_object_part_text_get() instead.
2310 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
2313 * @def elm_layout_label_set
2314 * Convenience macro to set the label in a layout that follows the
2315 * Elementary naming convention for its parts.
2317 * @deprecated use elm_object_text_set() instead.
2319 #define elm_layout_label_set(_ly, _txt) \
2320 elm_layout_text_set((_ly), "elm.text", (_txt))
2323 * @def elm_layout_label_get
2324 * Convenience macro to get the label in a layout that follows the
2325 * Elementary naming convention for its parts.
2327 * @deprecated use elm_object_text_set() instead.
2329 #define elm_layout_label_get(_ly) \
2330 elm_layout_text_get((_ly), "elm.text")
2332 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2336 * Set the content of the mapbuf.
2338 * @param obj The mapbuf object.
2339 * @param content The content that will be filled in this mapbuf object.
2341 * Once the content object is set, a previously set one will be deleted.
2342 * If you want to keep that old content object, use the
2343 * elm_mapbuf_content_unset() function.
2345 * To enable map, elm_mapbuf_enabled_set() should be used.
2347 * @deprecated use elm_object_content_set() instead
2350 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2353 * Get the content of the mapbuf.
2355 * @param obj The mapbuf object.
2356 * @return The content that is being used.
2358 * Return the content object which is set for this widget.
2360 * @see elm_mapbuf_content_set() for details.
2362 * @deprecated use elm_object_content_get() instead
2365 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2368 * Unset the content of the mapbuf.
2370 * @param obj The mapbuf object.
2371 * @return The content that was being used.
2373 * Unparent and return the content object which was set for this widget.
2375 * @see elm_mapbuf_content_set() for details.
2377 * @deprecated use elm_object_content_unset() instead
2380 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2383 * @brief Set the label of a menu item
2385 * @param it The menu item object.
2386 * @param label The label to set for @p item
2388 * @warning Don't use this function on items created with
2389 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2391 * @deprecated Use elm_object_item_text_set() instead
2393 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2396 * @brief Get the label of a menu item
2398 * @param it The menu item object.
2399 * @return The label of @p item
2400 * @deprecated Use elm_object_item_text_get() instead
2402 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2405 * @brief Set the content object of a menu item
2407 * @param it The menu item object
2408 * @param The content object or NULL
2409 * @return EINA_TRUE on success, else EINA_FALSE
2411 * Use this function to change the object swallowed by a menu item, deleting
2412 * any previously swallowed object.
2414 * @deprecated Use elm_object_item_content_set() instead
2416 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2419 * @brief Get the content object of a menu item
2421 * @param it The menu item object
2422 * @return The content object or NULL
2423 * @note If @p item was added with elm_menu_item_add_object, this
2424 * function will return the object passed, else it will return the
2427 * @see elm_menu_item_object_content_set()
2429 * @deprecated Use elm_object_item_content_get() instead
2431 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2434 * @brief Set the disabled state of @p item.
2436 * @param it The menu item object.
2437 * @param disabled The enabled/disabled state of the item
2438 * @deprecated Use elm_object_item_disabled_set() instead
2440 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2443 * @brief Get the disabled state of @p item.
2445 * @param it The menu item object.
2446 * @return The enabled/disabled state of the item
2448 * @see elm_menu_item_disabled_set()
2449 * @deprecated Use elm_object_item_disabled_get() instead
2451 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2454 * @brief Returns the data associated with menu item @p item.
2456 * @param it The item
2457 * @return The data associated with @p item or NULL if none was set.
2459 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2461 * @deprecated Use elm_object_item_data_get() instead
2463 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2466 * @brief Set the function called when a menu item is deleted.
2468 * @param it The item to set the callback on
2469 * @param func The function called
2471 * @see elm_menu_item_add()
2472 * @see elm_menu_item_del()
2473 * @deprecated Use elm_object_item_del_cb_set() instead
2475 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2478 * @brief Sets the data to be associated with menu item @p item.
2480 * @param it The item
2481 * @param data The data to be associated with @p item
2483 * @deprecated Use elm_object_item_data_set() instead
2485 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2488 * @brief Deletes an item from the menu.
2490 * @param it The item to delete.
2492 * @deprecated Use elm_object_item_del() instead
2493 * @see elm_menu_item_add()
2495 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2498 * @brief @brief Return a menu item's owner menu
2500 * @param it The menu item
2501 * @return The menu object owning @p item, or NULL on failure
2503 * Use this function to get the menu object owning an item.
2504 * @deprecated Use elm_object_item_widget_get() instead
2506 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2509 * @brief Set the icon of a menu item to the standard icon with name @p icon
2511 * @param it The menu item object.
2512 * @param icon The icon object to set for the content of @p item
2514 * @deprecated elm_menu_item_icon_name_set() instead
2515 * Once this icon is set, any previously set icon will be deleted.
2517 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2520 * @brief Get the string representation from the icon of a menu item
2522 * @param it The menu item object.
2523 * @return The string representation of @p item's icon or NULL
2525 * @deprecated elm_menu_item_icon_name_get() instead
2526 * @see elm_menu_item_icon_name_set()
2528 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2531 * @brief Set the content of the notify widget
2533 * @param obj The notify object
2534 * @param content The content will be filled in this notify object
2536 * Once the content object is set, a previously set one will be deleted. If
2537 * you want to keep that old content object, use the
2538 * elm_notify_content_unset() function.
2540 * @deprecated use elm_object_content_set() instead
2543 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2546 * @brief Unset the content of the notify widget
2548 * @param obj The notify object
2549 * @return The content that was being used
2551 * Unparent and return the content object which was set for this widget
2553 * @see elm_notify_content_set()
2554 * @deprecated use elm_object_content_unset() instead
2557 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2560 * @brief Return the content of the notify widget
2562 * @param obj The notify object
2563 * @return The content that is being used
2565 * @see elm_notify_content_set()
2566 * @deprecated use elm_object_content_get() instead
2569 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2572 * Set a label of an object
2574 * @param obj The Elementary object
2575 * @param part The text part name to set (NULL for the default label)
2576 * @param label The new text of the label
2578 * @note Elementary objects may have many labels (e.g. Action Slider)
2579 * @deprecated Use elm_object_part_text_set() instead.
2581 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2584 * Get a label of an object
2586 * @param obj The Elementary object
2587 * @param part The text part name to get (NULL for the default label)
2588 * @return text of the label or NULL for any error
2590 * @note Elementary objects may have many labels (e.g. Action Slider)
2591 * @deprecated Use elm_object_part_text_get() instead.
2593 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2596 * Set a content of an object
2598 * @param obj The Elementary object
2599 * @param part The content part name to set (NULL for the default content)
2600 * @param content The new content of the object
2602 * @note Elementary objects may have many contents
2603 * @deprecated Use elm_object_part_content_set instead.
2605 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2608 * Get a content of an object
2610 * @param obj The Elementary object
2611 * @param part The content part name to get (NULL for the default content)
2612 * @return content of the object or NULL for any error
2614 * @note Elementary objects may have many contents
2615 * @deprecated Use elm_object_part_content_get instead.
2617 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2620 * Unset a content of an object
2622 * @param obj The Elementary object
2623 * @param part The content part name to unset (NULL for the default content)
2625 * @note Elementary objects may have many contents
2626 * @deprecated Use elm_object_part_content_unset instead.
2628 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2631 * Set a content of an object item
2633 * @param it The Elementary object item
2634 * @param part The content part name to set (NULL for the default content)
2635 * @param content The new content of the object item
2637 * @note Elementary object items may have many contents
2638 * @deprecated Use elm_object_item_part_content_set instead.
2640 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2643 * Get a content of an object item
2645 * @param it The Elementary object item
2646 * @param part The content part name to unset (NULL for the default content)
2647 * @return content of the object item or NULL for any error
2649 * @note Elementary object items may have many contents
2650 * @deprecated Use elm_object_item_part_content_get instead.
2652 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2655 * Unset a content of an object item
2657 * @param it The Elementary object item
2658 * @param part The content part name to unset (NULL for the default content)
2660 * @note Elementary object items may have many contents
2661 * @deprecated Use elm_object_item_part_content_unset instead.
2663 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2666 * Get a label of an object item
2668 * @param it The Elementary object item
2669 * @param part The text part name to get (NULL for the default label)
2670 * @return text of the label or NULL for any error
2672 * @note Elementary object items may have many labels
2673 * @deprecated Use elm_object_item_part_text_get instead.
2675 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2678 * Set a label of an object item
2680 * @param it The Elementary object item
2681 * @param part The text part name to set (NULL for the default label)
2682 * @param label The new text of the label
2684 * @note Elementary object items may have many labels
2685 * @deprecated Use elm_object_item_part_text_set instead.
2687 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2690 * @brief Set the content of the panel.
2692 * @param obj The panel object
2693 * @param content The panel content
2695 * Once the content object is set, a previously set one will be deleted.
2696 * If you want to keep that old content object, use the
2697 * elm_panel_content_unset() function.
2699 * @deprecated use elm_object_content_set() instead
2702 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2705 * @brief Get the content of the panel.
2707 * @param obj The panel object
2708 * @return The content that is being used
2710 * Return the content object which is set for this widget.
2712 * @see elm_panel_content_set()
2714 * @deprecated use elm_object_content_get() instead
2717 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2720 * @brief Unset the content of the panel.
2722 * @param obj The panel object
2723 * @return The content that was being used
2725 * Unparent and return the content object which was set for this widget.
2727 * @see elm_panel_content_set()
2729 * @deprecated use elm_object_content_unset() instead
2732 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2735 * Set the left content of the panes widget.
2737 * @param obj The panes object.
2738 * @param content The new left content object.
2740 * Once the content object is set, a previously set one will be deleted.
2741 * If you want to keep that old content object, use the
2742 * elm_panes_content_left_unset() function.
2744 * If panes is displayed vertically, left content will be displayed at
2747 * @see elm_panes_content_left_get()
2748 * @see elm_panes_content_right_set() to set content on the other side.
2750 * @deprecated use elm_object_part_content_set() instead
2753 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2756 * Set the right content of the panes widget.
2758 * @param obj The panes object.
2759 * @param content The new right content object.
2761 * Once the content object is set, a previously set one will be deleted.
2762 * If you want to keep that old content object, use the
2763 * elm_panes_content_right_unset() function.
2765 * If panes is displayed vertically, left content will be displayed at
2768 * @see elm_panes_content_right_get()
2769 * @see elm_panes_content_left_set() to set content on the other side.
2771 * @deprecated use elm_object_part_content_set() instead
2774 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2777 * Get the left content of the panes.
2779 * @param obj The panes object.
2780 * @return The left content object that is being used.
2782 * Return the left content object which is set for this widget.
2784 * @see elm_panes_content_left_set() for details.
2786 * @deprecated use elm_object_part_content_get() instead
2789 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2792 * Get the right content of the panes.
2794 * @param obj The panes object
2795 * @return The right content object that is being used
2797 * Return the right content object which is set for this widget.
2799 * @see elm_panes_content_right_set() for details.
2801 * @deprecated use elm_object_part_content_get() instead
2804 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2807 * Unset the left content used for the panes.
2809 * @param obj The panes object.
2810 * @return The left content object that was being used.
2812 * Unparent and return the left content object which was set for this widget.
2814 * @see elm_panes_content_left_set() for details.
2815 * @see elm_panes_content_left_get().
2817 * @deprecated use elm_object_part_content_unset() instead
2820 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2823 * Unset the right content used for the panes.
2825 * @param obj The panes object.
2826 * @return The right content object that was being used.
2828 * Unparent and return the right content object which was set for this
2831 * @see elm_panes_content_right_set() for details.
2832 * @see elm_panes_content_right_get().
2834 * @deprecated use elm_object_part_content_unset() instead
2837 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2839 * Set the label of a given progress bar widget
2841 * @param obj The progress bar object
2842 * @param label The text label string, in UTF-8
2844 * @deprecated use elm_object_text_set() instead.
2846 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2849 * Get the label of a given progress bar widget
2851 * @param obj The progressbar object
2852 * @return The text label string, in UTF-8
2854 * @deprecated use elm_object_text_set() instead.
2856 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2859 * Set the icon object of a given progress bar widget
2861 * @param obj The progress bar object
2862 * @param icon The icon object
2864 * Use this call to decorate @p obj with an icon next to it.
2866 * @note Once the icon object is set, a previously set one will be
2867 * deleted. If you want to keep that old content object, use the
2868 * elm_progressbar_icon_unset() function.
2870 * @see elm_progressbar_icon_get()
2871 * @deprecated use elm_object_part_content_set() instead.
2874 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2877 * Retrieve the icon object set for a given progress bar widget
2879 * @param obj The progress bar object
2880 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2881 * otherwise (and on errors)
2883 * @see elm_progressbar_icon_set() for more details
2884 * @deprecated use elm_object_part_content_get() instead.
2887 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2890 * Unset an icon set on a given progress bar widget
2892 * @param obj The progress bar object
2893 * @return The icon object that was being used, if any was set, or
2894 * @c NULL, otherwise (and on errors)
2896 * This call will unparent and return the icon object which was set
2897 * for this widget, previously, on success.
2899 * @see elm_progressbar_icon_set() for more details
2900 * @deprecated use elm_object_part_content_unset() instead.
2903 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2906 * @brief Set the text label of the radio object
2908 * @param obj The radio object
2909 * @param label The text label string in UTF-8
2911 * @deprecated use elm_object_text_set() instead.
2913 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
2916 * @brief Get the text label of the radio object
2918 * @param obj The radio object
2919 * @return The text label string in UTF-8
2921 * @deprecated use elm_object_text_set() instead.
2923 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
2926 * @brief Set the icon object of the radio object
2928 * @param obj The radio object
2929 * @param icon The icon object
2931 * Once the icon object is set, a previously set one will be deleted. If you
2932 * want to keep that old content object, use the elm_radio_icon_unset()
2935 * @deprecated use elm_object_part_content_set() instead.
2938 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2941 * @brief Get the icon object of the radio object
2943 * @param obj The radio object
2944 * @return The icon object
2946 * @see elm_radio_icon_set()
2948 * @deprecated use elm_object_part_content_get() instead.
2951 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2954 * @brief Unset the icon used for the radio object
2956 * @param obj The radio object
2957 * @return The icon object that was being used
2959 * Unparent and return the icon object which was set for this widget.
2961 * @see elm_radio_icon_set()
2962 * @deprecated use elm_object_part_content_unset() instead.
2965 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2968 * Set the label of a given slider widget
2970 * @param obj The progress bar object
2971 * @param label The text label string, in UTF-8
2973 * @deprecated use elm_object_text_set() instead.
2975 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
2978 * Get the label of a given slider widget
2980 * @param obj The progressbar object
2981 * @return The text label string, in UTF-8
2983 * @deprecated use elm_object_text_get() instead.
2985 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
2988 * Set the icon object of the slider object.
2990 * @param obj The slider object.
2991 * @param icon The icon object.
2993 * On horizontal mode, icon is placed at left, and on vertical mode,
2996 * @note Once the icon object is set, a previously set one will be deleted.
2997 * If you want to keep that old content object, use the
2998 * elm_slider_icon_unset() function.
3000 * @warning If the object being set does not have minimum size hints set,
3001 * it won't get properly displayed.
3003 * @deprecated use elm_object_part_content_set() instead.
3005 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3008 * Unset an icon set on a given slider widget.
3010 * @param obj The slider object.
3011 * @return The icon object that was being used, if any was set, or
3012 * @c NULL, otherwise (and on errors).
3014 * On horizontal mode, icon is placed at left, and on vertical mode,
3017 * This call will unparent and return the icon object which was set
3018 * for this widget, previously, on success.
3020 * @see elm_slider_icon_set() for more details
3021 * @see elm_slider_icon_get()
3022 * @deprecated use elm_object_part_content_unset() instead.
3025 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3028 * Retrieve the icon object set for a given slider widget.
3030 * @param obj The slider object.
3031 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3032 * otherwise (and on errors).
3034 * On horizontal mode, icon is placed at left, and on vertical mode,
3037 * @see elm_slider_icon_set() for more details
3038 * @see elm_slider_icon_unset()
3040 * @deprecated use elm_object_part_content_get() instead.
3043 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3046 * Set the end object of the slider object.
3048 * @param obj The slider object.
3049 * @param end The end object.
3051 * On horizontal mode, end is placed at left, and on vertical mode,
3054 * @note Once the icon object is set, a previously set one will be deleted.
3055 * If you want to keep that old content object, use the
3056 * elm_slider_end_unset() function.
3058 * @warning If the object being set does not have minimum size hints set,
3059 * it won't get properly displayed.
3061 * @deprecated use elm_object_part_content_set() instead.
3064 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3067 * Unset an end object set on a given slider widget.
3069 * @param obj The slider object.
3070 * @return The end object that was being used, if any was set, or
3071 * @c NULL, otherwise (and on errors).
3073 * On horizontal mode, end is placed at left, and on vertical mode,
3076 * This call will unparent and return the icon object which was set
3077 * for this widget, previously, on success.
3079 * @see elm_slider_end_set() for more details.
3080 * @see elm_slider_end_get()
3082 * @deprecated use elm_object_part_content_unset() instead
3086 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3089 * Retrieve the end object set for a given slider widget.
3091 * @param obj The slider object.
3092 * @return The end object's handle, if @p obj had one set, or @c NULL,
3093 * otherwise (and on errors).
3095 * On horizontal mode, icon is placed at right, and on vertical mode,
3098 * @see elm_slider_end_set() for more details.
3099 * @see elm_slider_end_unset()
3102 * @deprecated use elm_object_part_content_get() instead
3106 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3109 * Return the data associated with a given slideshow item
3111 * @param it The slideshow item
3112 * @return Returns the data associated to this item
3114 * @deprecated use elm_object_item_data_get() instead
3116 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3119 * Delete a given item from a slideshow widget.
3121 * @param it The slideshow item
3123 * @deprecated Use elm_object_item_de() instead
3125 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
3128 * Display a given slideshow widget's item, programmatically.
3130 * @param it The item to display on @p obj's viewport
3132 * The change between the current item and @p item will use the
3133 * transition @p obj is set to use (@see
3134 * elm_slideshow_transition_set()).
3136 * @deprecated use elm_slideshow_item_show() instead
3138 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
3141 * Get the toolbar object from an item.
3143 * @param it The item.
3144 * @return The toolbar object.
3146 * This returns the toolbar object itself that an item belongs to.
3148 * @deprecated use elm_object_item_object_get() instead.
3150 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3153 * Get the label of item.
3155 * @param it The item of toolbar.
3156 * @return The label of item.
3158 * The return value is a pointer to the label associated to @p item when
3159 * it was created, with function elm_toolbar_item_append() or similar,
3161 * with function elm_toolbar_item_label_set. If no label
3162 * was passed as argument, it will return @c NULL.
3164 * @see elm_toolbar_item_label_set() for more details.
3165 * @see elm_toolbar_item_append()
3167 * @deprecated use elm_object_item_text_get() instead.
3169 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3172 * Set the label of item.
3174 * @param it The item of toolbar.
3175 * @param label The label of item.
3177 * The label to be displayed by the item.
3178 * Label will be placed at icons bottom (if set).
3180 * If a label was passed as argument on item creation, with function
3181 * elm_toolbar_item_append() or similar, it will be already
3182 * displayed by the item.
3184 * @see elm_toolbar_item_label_get()
3185 * @see elm_toolbar_item_append()
3187 * @deprecated use elm_object_item_text_set() instead
3189 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3192 * Return the data associated with a given toolbar widget item.
3194 * @param it The toolbar widget item handle.
3195 * @return The data associated with @p item.
3197 * @see elm_toolbar_item_data_set()
3199 * @deprecated use elm_object_item_data_get() instead.
3201 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3204 * Set the data associated with a given toolbar widget item.
3206 * @param it The toolbar widget item handle
3207 * @param data The new data pointer to set to @p item.
3209 * This sets new item data on @p item.
3211 * @warning The old data pointer won't be touched by this function, so
3212 * the user had better to free that old data himself/herself.
3214 * @deprecated use elm_object_item_data_set() instead.
3216 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3219 * Get a value whether toolbar item is disabled or not.
3221 * @param it The item.
3222 * @return The disabled state.
3224 * @see elm_toolbar_item_disabled_set() for more details.
3226 * @deprecated use elm_object_item_disabled_get() instead.
3228 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3231 * Sets the disabled/enabled state of a toolbar item.
3233 * @param it The item.
3234 * @param disabled The disabled state.
3236 * A disabled item cannot be selected or unselected. It will also
3237 * change its appearance (generally greyed out). This sets the
3238 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3241 * @deprecated use elm_object_item_disabled_set() instead.
3243 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3246 * Change a toolbar's orientation
3247 * @param obj The toolbar object
3248 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3249 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3250 * @deprecated use elm_toolbar_horizontal_set() instead.
3252 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3255 * Get a toolbar's orientation
3256 * @param obj The toolbar object
3257 * @return If @c EINA_TRUE, the toolbar is vertical
3258 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3259 * @deprecated use elm_toolbar_horizontal_get() instead.
3261 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3264 * Set the function called when a toolbar item is freed.
3266 * @param it The item to set the callback on.
3267 * @param func The function called.
3269 * If there is a @p func, then it will be called prior item's memory release.
3270 * That will be called with the following arguments:
3272 * @li item's Evas object;
3275 * This way, a data associated to a toolbar item could be properly freed.
3277 * @deprecated Use elm_object_item_del_cb_set() instead
3279 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3282 * Delete them item from the toolbar.
3284 * @param it The item of toolbar to be deleted.
3286 * @deprecated Use elm_object_item_del() instead
3287 * @see elm_toolbar_item_append()
3290 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3293 * Set the content to be shown in the tooltip item.
3295 * Setup the tooltip to item. The item can have only one tooltip,
3296 * so any previous tooltip data is removed. @p func(with @p data) will
3297 * be called every time that need show the tooltip and it should
3298 * return a valid Evas_Object. This object is then managed fully by
3299 * tooltip system and is deleted when the tooltip is gone.
3301 * @param it the toolbar item being attached a tooltip.
3302 * @param func the function used to create the tooltip contents.
3303 * @param data what to provide to @a func as callback data/context.
3304 * @param del_cb called when data is not needed anymore, either when
3305 * another callback replaces @a func, the tooltip is unset with
3306 * elm_toolbar_item_tooltip_unset() or the owner @a item
3307 * dies. This callback receives as the first parameter the
3308 * given @a data, and @c event_info is the item.
3310 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3311 * @see elm_object_tooltip_content_cb_set() for more details.
3314 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);
3317 * Unset tooltip from item.
3319 * @param it toolbar item to remove previously set tooltip.
3321 * Remove tooltip from item. The callback provided as del_cb to
3322 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3323 * it is not used anymore.
3325 * @deprecated Use elm_object_item_tooltip_unset() instead
3326 * @see elm_object_tooltip_unset() for more details.
3327 * @see elm_toolbar_item_tooltip_content_cb_set()
3330 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3333 * Sets a different style for this item tooltip.
3335 * @note before you set a style you should define a tooltip with
3336 * elm_toolbar_item_tooltip_content_cb_set() or
3337 * elm_toolbar_item_tooltip_text_set()
3339 * @param it toolbar item with tooltip already set.
3340 * @param style the theme style to use (default, transparent, ...)
3342 * @deprecated Use elm_object_item_tooltip_style_set() instead
3343 * @see elm_object_tooltip_style_set() for more details.
3346 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3349 * Get the style for this item tooltip.
3351 * @param it toolbar item with tooltip already set.
3352 * @return style the theme style in use, defaults to "default". If the
3353 * object does not have a tooltip set, then NULL is returned.
3355 * @deprecated Use elm_object_item_style_get() instead
3356 * @see elm_object_tooltip_style_get() for more details.
3357 * @see elm_toolbar_item_tooltip_style_set()
3360 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3363 * Set the type of mouse pointer/cursor decoration to be shown,
3364 * when the mouse pointer is over the given toolbar widget item
3366 * @param it toolbar item to customize cursor on
3367 * @param cursor the cursor type's name
3369 * This function works analogously as elm_object_cursor_set(), but
3370 * here the cursor's changing area is restricted to the item's
3371 * area, and not the whole widget's. Note that that item cursors
3372 * have precedence over widget cursors, so that a mouse over an
3373 * item with custom cursor set will always show @b that cursor.
3375 * If this function is called twice for an object, a previously set
3376 * cursor will be unset on the second call.
3378 * @see elm_object_cursor_set()
3379 * @see elm_toolbar_item_cursor_get()
3380 * @see elm_toolbar_item_cursor_unset()
3382 * @deprecated use elm_object_item_cursor_set() instead
3385 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3388 * Get the type of mouse pointer/cursor decoration set to be shown,
3389 * when the mouse pointer is over the given toolbar widget item
3391 * @param it toolbar item with custom cursor set
3392 * @return the cursor type's name or @c NULL, if no custom cursors
3393 * were set to @p item (and on errors)
3395 * @see elm_object_cursor_get()
3396 * @see elm_toolbar_item_cursor_set()
3397 * @see elm_toolbar_item_cursor_unset()
3399 * @deprecated Use elm_object_item_cursor_get() instead
3402 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3405 * Unset any custom mouse pointer/cursor decoration set to be
3406 * shown, when the mouse pointer is over the given toolbar widget
3407 * item, thus making it show the @b default cursor again.
3409 * @param it a toolbar item
3411 * Use this call to undo any custom settings on this item's cursor
3412 * decoration, bringing it back to defaults (no custom style set).
3414 * @see elm_object_cursor_unset()
3415 * @see elm_toolbar_item_cursor_set()
3417 * @deprecated Use elm_object_item_cursor_unset() instead
3420 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3423 * Set a different @b style for a given custom cursor set for a
3426 * @param it toolbar item with custom cursor set
3427 * @param style the <b>theme style</b> to use (e.g. @c "default",
3428 * @c "transparent", etc)
3430 * This function only makes sense when one is using custom mouse
3431 * cursor decorations <b>defined in a theme file</b>, which can have,
3432 * given a cursor name/type, <b>alternate styles</b> on it. It
3433 * works analogously as elm_object_cursor_style_set(), but here
3434 * applies only to toolbar item objects.
3436 * @warning Before you set a cursor style you should have defined a
3437 * custom cursor previously on the item, with
3438 * elm_toolbar_item_cursor_set()
3440 * @see elm_toolbar_item_cursor_engine_only_set()
3441 * @see elm_toolbar_item_cursor_style_get()
3443 * @deprecated Use elm_object_item_cursor_style_set() instead
3446 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3449 * Get the current @b style set for a given toolbar item's custom
3452 * @param it toolbar item with custom cursor set.
3453 * @return style the cursor style in use. If the object does not
3454 * have a cursor set, then @c NULL is returned.
3456 * @see elm_toolbar_item_cursor_style_set() for more details
3458 * @deprecated Use elm_object_item_cursor_style_get() instead
3461 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3464 * Set if the (custom)cursor for a given toolbar item should be
3465 * searched in its theme, also, or should only rely on the
3468 * @param it item with custom (custom) cursor already set on
3469 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3470 * only on those provided by the rendering engine, @c EINA_FALSE to
3471 * have them searched on the widget's theme, as well.
3473 * @note This call is of use only if you've set a custom cursor
3474 * for toolbar items, with elm_toolbar_item_cursor_set().
3476 * @note By default, cursors will only be looked for between those
3477 * provided by the rendering engine.
3479 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3482 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3485 * Get if the (custom) cursor for a given toolbar item is being
3486 * searched in its theme, also, or is only relying on the rendering
3489 * @param it a toolbar item
3490 * @return @c EINA_TRUE, if cursors are being looked for only on
3491 * those provided by the rendering engine, @c EINA_FALSE if they
3492 * are being searched on the widget's theme, as well.
3494 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3496 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3499 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3502 * @brief Link a Elm_Payer with an Elm_Video object.
3504 * @param player the Elm_Player object.
3505 * @param video The Elm_Video object.
3507 * This mean that action on the player widget will affect the
3508 * video object and the state of the video will be reflected in
3509 * the player itself.
3511 * @see elm_player_add()
3512 * @see elm_video_add()
3513 * @deprecated use elm_object_part_content_set() instead
3516 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3519 * Set the label of item.
3521 * @param it The item of segment control.
3522 * @param label The label of item.
3524 * The label to be displayed by the item.
3525 * Label will be at right of the icon (if set).
3527 * If a label was passed as argument on item creation, with function
3528 * elm_control_segment_item_add(), it will be already
3529 * displayed by the item.
3531 * @see elm_segment_control_item_label_get()
3532 * @see elm_segment_control_item_add()
3533 * @deprecated Use elm_object_item_text_set() instead
3536 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3540 * Set the icon associated to the item.
3542 * @param it The segment control item.
3543 * @param icon The icon object to associate with @p it.
3545 * The icon object to use at left side of the item. An
3546 * icon can be any Evas object, but usually it is an icon created
3547 * with elm_icon_add().
3549 * Once the icon object is set, a previously set one will be deleted.
3550 * @warning Setting the same icon for two items will cause the icon to
3551 * disappear from the first item.
3553 * If an icon was passed as argument on item creation, with function
3554 * elm_segment_control_item_add(), it will be already
3555 * associated to the item.
3557 * @see elm_segment_control_item_add()
3558 * @see elm_segment_control_item_icon_get()
3559 * @deprecated Use elm_object_item_part_content_set() instead
3562 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3565 * Remove a segment control item from its parent, deleting it.
3567 * @param it The item to be removed.
3569 * Items can be added with elm_segment_control_item_add() or
3570 * elm_segment_control_item_insert_at().
3572 * @deprecated Use elm_object_item_del() instead
3574 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3579 * @param obj The multibuttonentry object
3580 * @return The label, or NULL if none
3582 * @deprecated Use elm_object_text_get() instead
3585 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3590 * @param obj The multibuttonentry object
3591 * @param label The text label string
3593 * @deprecated Use elm_object_text_set() instead
3596 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3599 * Get the label of a given item
3601 * @param it The item
3602 * @return The label of a given item, or NULL if none
3604 * @deprecated Use elm_object_item_text_get() instead
3607 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3610 * Set the label of a given item
3612 * @param it The item
3613 * @param str The text label string
3615 * @deprecated Use elm_object_item_text_set() instead
3617 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3620 * Delete a given item
3622 * @param it The item
3624 * @deprecated Use elm_object_item_del() instead
3627 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3630 * @brief Delete the given item instantly.
3632 * @param it The naviframe item
3634 * This just deletes the given item from the naviframe item list instantly.
3635 * So this would not emit any signals for view transitions but just change
3636 * the current view if the given item is a top one.
3638 * @deprecated Use elm_object_item_del() instead
3640 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3645 * Sets the disabled/enabled state of a list item.
3647 * @param it The item.
3648 * @param disabled The disabled state.
3650 * A disabled item cannot be selected or unselected. It will also
3651 * change its appearance (generally greyed out). This sets the
3652 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3655 * @deprecated Use elm_object_item_disabled_set() instead
3658 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3661 * Get a value whether list item is disabled or not.
3663 * @param it The item.
3664 * @return The disabled state.
3666 * @see elm_list_item_disabled_set() for more details.
3668 * @deprecated Use elm_object_item_disabled_get() instead
3671 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3674 * @brief Disable size restrictions on an object's tooltip
3675 * @param it The tooltip's anchor object
3676 * @param disable If EINA_TRUE, size restrictions are disabled
3677 * @return EINA_FALSE on failure, EINA_TRUE on success
3679 * This function allows a tooltip to expand beyond its parent window's canvas.
3680 * It will instead be limited only by the size of the display.
3682 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3685 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3688 * @brief Retrieve size restriction state of an object's tooltip
3689 * @param obj The tooltip's anchor object
3690 * @return If EINA_TRUE, size restrictions are disabled
3692 * This function returns whether a tooltip is allowed to expand beyond
3693 * its parent window's canvas.
3694 * It will instead be limited only by the size of the display.
3696 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3699 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3702 * This sets a widget to be displayed to the left of a scrolled entry.
3704 * @param obj The scrolled entry object
3705 * @param icon The widget to display on the left side of the scrolled
3708 * @note A previously set widget will be destroyed.
3709 * @note If the object being set does not have minimum size hints set,
3710 * it won't get properly displayed.
3712 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
3713 * @see elm_entry_end_set()
3715 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
3718 * Gets the leftmost widget of the scrolled entry. This object is
3719 * owned by the scrolled entry and should not be modified.
3721 * @param obj The scrolled entry object
3722 * @return the left widget inside the scroller
3724 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
3726 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
3729 * Unset the leftmost widget of the scrolled entry, unparenting and
3732 * @param obj The scrolled entry object
3733 * @return the previously set icon sub-object of this entry, on
3736 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
3737 * @see elm_entry_icon_set()
3739 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
3742 * This sets a widget to be displayed to the end of a scrolled entry.
3744 * @param obj The scrolled entry object
3745 * @param end The widget to display on the right side of the scrolled
3748 * @note A previously set widget will be destroyed.
3749 * @note If the object being set does not have minimum size hints set,
3750 * it won't get properly displayed.
3752 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
3753 * @see elm_entry_icon_set
3755 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
3758 * Gets the endmost widget of the scrolled entry. This object is owned
3759 * by the scrolled entry and should not be modified.
3761 * @param obj The scrolled entry object
3762 * @return the right widget inside the scroller
3764 * @deprecated Use elm_object_part_content_get(entry, "end") instead
3766 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
3769 * Unset the endmost widget of the scrolled entry, unparenting and
3772 * @param obj The scrolled entry object
3773 * @return the previously set icon sub-object of this entry, on
3776 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
3777 * @see elm_entry_icon_set()
3779 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
3782 * Set route service to be used. By default used source is
3783 * #ELM_MAP_ROUTE_SOURCE_YOURS.
3785 * @see elm_map_route_source_set()
3786 * @see elm_map_route_source_get()
3791 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
3792 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. */
3793 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
3794 ELM_MAP_ROUTE_SOURCE_LAST
3795 } Elm_Map_Route_Sources;
3798 * Convert a pixel coordinate into a rotated pixel coordinate.
3800 * @param obj The map object.
3801 * @param x horizontal coordinate of the point to rotate.
3802 * @param y vertical coordinate of the point to rotate.
3803 * @param cx rotation's center horizontal position.
3804 * @param cy rotation's center vertical position.
3805 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
3806 * @param xx Pointer where to store rotated x.
3807 * @param yy Pointer where to store rotated y.
3809 * @deprecated Use elm_map_canvas_to_geo_convert() instead
3811 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);
3814 * Convert canvas coordinates into a geographic coordinate
3815 * (longitude, latitude).
3817 * @param obj The map object.
3818 * @param x horizontal coordinate of the point to convert.
3819 * @param y vertical coordinate of the point to convert.
3820 * @param lon A pointer to the longitude.
3821 * @param lat A pointer to the latitude.
3823 * This gets longitude and latitude from canvas x, y coordinates. The canvas
3824 * coordinates mean x, y coordinate from current viewport.
3826 * see elm_map_rotate_get()
3827 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
3830 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);
3833 * Get the current geographic coordinates of the map.
3835 * @param obj The map object.
3836 * @param lon Pointer to store longitude.
3837 * @param lat Pointer to store latitude.
3839 * This gets the current center coordinates of the map object. It can be
3840 * set by elm_map_region_bring_in() and elm_map_region_show().
3842 * @see elm_map_region_bring_in()
3843 * @see elm_map_region_show()
3845 * @deprecated Use elm_map_region_get() instead
3847 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
3850 * Animatedly bring in given coordinates to the center of the map.
3852 * @param obj The map object.
3853 * @param lon Longitude to center at.
3854 * @param lat Latitude to center at.
3856 * This causes map to jump to the given @p lat and @p lon coordinates
3857 * and show it (by scrolling) in the center of the viewport, if it is not
3858 * already centered. This will use animation to do so and take a period
3859 * of time to complete.
3861 * @see elm_map_region_show() for a function to avoid animation.
3862 * @see elm_map_region_get()
3864 * @deprecated Use elm_map_region_bring_in() instead
3866 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
3869 * Show the given coordinates at the center of the map, @b immediately.
3871 * @param obj The map object.
3872 * @param lon Longitude to center at.
3873 * @param lat Latitude to center at.
3875 * This causes map to @b redraw its viewport's contents to the
3876 * region containing the given @p lat and @p lon, that will be moved to the
3877 * center of the map.
3879 * @see elm_map_region_bring_in() for a function to move with animation.
3880 * @see elm_map_region_get()
3882 * @deprecated Use elm_map_region_show() instead
3884 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
3887 * Set the minimum zoom of the source.
3889 * @param obj The map object.
3890 * @param zoom New minimum zoom value to be used.
3892 * By default, it's 0.
3894 * @deprecated Use elm_map_zoom_min_set() instead
3896 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
3899 * Get the minimum zoom of the source.
3901 * @param obj The map object.
3902 * @return Returns the minimum zoom of the source.
3904 * @see elm_map_zoom_min_set() for details.
3906 * @deprecated Use elm_map_zoom_min_get() instead
3908 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
3911 * Set the maximum zoom of the source.
3913 * @param obj The map object.
3914 * @param zoom New maximum zoom value to be used.
3916 * By default, it's 18.
3918 * @deprecated Use elm_map_zoom_max_set() instead
3920 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
3923 * Get the maximum zoom of the source.
3925 * @param obj The map object.
3926 * @return Returns the maximum zoom of the source.
3928 * @see elm_map_zoom_min_set() for details.
3930 * @deprecated Use elm_map_zoom_max_get() instead
3932 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
3936 * Get the list of available sources.
3938 * @param obj The map object.
3939 * @return The source names list.
3941 * It will provide a list with all available sources, that can be set as
3942 * current source with elm_map_source_name_set(), or get with
3943 * elm_map_source_name_get().
3945 * Available sources:
3951 * @see elm_map_source_name_set() for more details.
3952 * @see elm_map_source_name_get()
3953 * @deprecated Use elm_map_sources_get() instead
3956 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
3959 * Set the source of the map.
3961 * @param obj The map object.
3962 * @param source_name The source to be used.
3964 * Map widget retrieves images that composes the map from a web service.
3965 * This web service can be set with this method.
3967 * A different service can return a different maps with different
3968 * information and it can use different zoom values.
3970 * The @p source_name need to match one of the names provided by
3971 * elm_map_source_names_get().
3973 * The current source can be get using elm_map_source_name_get().
3975 * @see elm_map_source_names_get()
3976 * @see elm_map_source_name_get()
3977 * @deprecated Use elm_map_source_set() instead
3980 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
3983 * Get the name of currently used source.
3985 * @param obj The map object.
3986 * @return Returns the name of the source in use.
3988 * @see elm_map_source_name_set() for more details.
3989 * @deprecated Use elm_map_source_get() instead
3992 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
3995 * Set the source of the route service to be used by the map.
3997 * @param obj The map object.
3998 * @param source The route service to be used, being it one of
3999 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4000 * and #ELM_MAP_ROUTE_SOURCE_ORS.
4002 * Each one has its own algorithm, so the route retrieved may
4003 * differ depending on the source route. Now, only the default is working.
4005 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4006 * http://www.yournavigation.org/.
4008 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4009 * assumptions. Its routing core is based on Contraction Hierarchies.
4011 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4013 * @see elm_map_route_source_get().
4014 * @deprecated Use elm_map_source_set() instead
4017 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4020 * Get the current route source.
4022 * @param obj The map object.
4023 * @return The source of the route service used by the map.
4025 * @see elm_map_route_source_set() for details.
4026 * @deprecated Use elm_map_source_get() instead
4029 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4032 * Set the maximum numbers of markers' content to be displayed in a group.
4034 * @param obj The map object.
4035 * @param max The maximum numbers of items displayed in a bubble.
4037 * A bubble will be displayed when the user clicks over the group,
4038 * and will place the content of markers that belong to this group
4041 * A group can have a long list of markers, consequently the creation
4042 * of the content of the bubble can be very slow.
4044 * In order to avoid this, a maximum number of items is displayed
4047 * By default this number is 30.
4049 * Marker with the same group class are grouped if they are close.
4051 * @see elm_map_marker_add()
4053 * @deprecated Use Elm_Map_Overlay instead
4055 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4058 * Set to show markers during zoom level changes or not.
4060 * @param obj The map object.
4061 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4064 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4067 * The default is off.
4069 * This will stop zooming using animation, changing zoom levels will
4070 * change instantly. This will stop any existing animations that are running.
4072 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4075 * The default is off.
4077 * Enabling it will force the map to stop displaying the markers during
4078 * zoom level changes. Set to on if you have a large number of markers.
4080 * @see elm_map_paused_markers_get()
4082 * @deprecated Use Elm_Map_Overlay instead
4084 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4087 * Get a value whether markers will be displayed on zoom level changes or not
4089 * @param obj The map object.
4090 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4091 * indicates it will.
4093 * This gets the current markers paused state for the map object.
4095 * @see elm_map_paused_markers_set() for details.
4097 * @deprecated Use Elm_Map_Overlay instead
4099 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj);
4102 * Close all the bubbles opened by the user.
4104 * @param obj The map object.
4106 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4107 * when the user clicks on a marker.
4109 * This functions is set for the marker class with
4110 * elm_map_marker_class_get_cb_set().
4112 * @deprecated Use Elm_Map_Overlay instead
4114 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj);
4117 * Set the marker's style of a group class.
4119 * @param clas The group class.
4120 * @param style The style to be used by markers.
4122 * Each marker must be associated to a group class, and will use the style
4123 * defined by such class when grouped to other markers.
4125 * The following styles are provided by default theme:
4126 * @li @c radio - blue circle
4127 * @li @c radio2 - green circle
4130 * @see elm_map_group_class_new() for more details.
4131 * @see elm_map_marker_add()
4133 * @deprecated Use Elm_Map_Overlay instead
4135 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4138 * Set the icon callback function of a group class.
4140 * @param clas The group class.
4141 * @param icon_get The callback function that will return the icon.
4143 * Each marker must be associated to a group class, and it can display a
4144 * custom icon. The function @p icon_get must return this icon.
4146 * @see elm_map_group_class_new() for more details.
4147 * @see elm_map_marker_add()
4149 * @deprecated Use Elm_Map_Overlay instead
4151 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4154 * Set the data associated to the group class.
4156 * @param clas The group class.
4157 * @param data The new user data.
4159 * This data will be passed for callback functions, like icon get callback,
4160 * that can be set with elm_map_group_class_icon_cb_set().
4162 * If a data was previously set, the object will lose the pointer for it,
4163 * so if needs to be freed, you must do it yourself.
4165 * @see elm_map_group_class_new() for more details.
4166 * @see elm_map_group_class_icon_cb_set()
4167 * @see elm_map_marker_add()
4169 * @deprecated Use Elm_Map_Overlay instead
4171 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4174 * Set the minimum zoom from where the markers are displayed.
4176 * @param clas The group class.
4177 * @param zoom The minimum zoom.
4179 * Markers only will be displayed when the map is displayed at @p zoom
4182 * @see elm_map_group_class_new() for more details.
4183 * @see elm_map_marker_add()
4185 * @deprecated Use Elm_Map_Overlay instead
4187 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4190 * Set the zoom from where the markers are no more grouped.
4192 * @param clas The group class.
4193 * @param zoom The maximum zoom.
4195 * Markers only will be grouped when the map is displayed at
4196 * less than @p zoom.
4198 * @see elm_map_group_class_new() for more details.
4199 * @see elm_map_marker_add()
4201 * @deprecated Use Elm_Map_Overlay instead
4203 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4206 * Set if the markers associated to the group class @p clas are hidden or not.
4208 * @param clas The group class.
4209 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4212 * @param obj The map object.
4213 * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4216 * @deprecated Use Elm_Map_Overlay instead
4218 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4221 * Set the marker's style of a marker class.
4223 * @param clas The marker class.
4224 * @param style The style to be used by markers.
4226 * Each marker must be associated to a marker class, and will use the style
4227 * defined by such class when alone, i.e., @b not grouped to other markers.
4229 * The following styles are provided by default theme:
4234 * @see elm_map_marker_class_new() for more details.
4235 * @see elm_map_marker_add()
4237 * @deprecated Use Elm_Map_Overlay instead
4239 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4242 * Set the icon callback function of a marker class.
4244 * @param clas The marker class.
4245 * @param icon_get The callback function that will return the icon.
4247 * Each marker must be associated to a marker class, and it can display a
4248 * custom icon. The function @p icon_get must return this icon.
4250 * @see elm_map_marker_class_new() for more details.
4251 * @see elm_map_marker_add()
4253 * @deprecated Use Elm_Map_Overlay instead
4255 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4258 * Set the bubble content callback function of a marker class.
4260 * @param clas The marker class.
4261 * @param get The callback function that will return the content.
4263 * Each marker must be associated to a marker class, and it can display a
4264 * a content on a bubble that opens when the user click over the marker.
4265 * The function @p get must return this content object.
4267 * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4270 * @see elm_map_marker_class_new() for more details.
4271 * @see elm_map_marker_class_del_cb_set()
4272 * @see elm_map_marker_add()
4274 * @deprecated Use Elm_Map_Overlay instead
4276 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4279 * Set the callback function used to delete bubble content of a marker class.
4281 * @param clas The marker class.
4282 * @param del The callback function that will delete the content.
4284 * Each marker must be associated to a marker class, and it can display a
4285 * a content on a bubble that opens when the user click over the marker.
4286 * The function to return such content can be set with
4287 * elm_map_marker_class_get_cb_set().
4289 * If this content must be freed, a callback function need to be
4290 * set for that task with this function.
4292 * If this callback is defined it will have to delete (or not) the
4293 * object inside, but if the callback is not defined the object will be
4294 * destroyed with evas_object_del().
4296 * @see elm_map_marker_class_new() for more details.
4297 * @see elm_map_marker_class_get_cb_set()
4298 * @see elm_map_marker_add()
4300 * @deprecated Use Elm_Map_Overlay instead
4302 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4305 * Set the route color.
4307 * @param route The route object.
4308 * @param r Red channel value, from 0 to 255.
4309 * @param g Green channel value, from 0 to 255.
4310 * @param b Blue channel value, from 0 to 255.
4311 * @param a Alpha channel value, from 0 to 255.
4313 * It uses an additive color model, so each color channel represents
4314 * how much of each primary colors must to be used. 0 represents
4315 * absence of this color, so if all of the three are set to 0,
4316 * the color will be black.
4318 * These component values should be integers in the range 0 to 255,
4319 * (single 8-bit byte).
4321 * This sets the color used for the route. By default, it is set to
4322 * solid red (r = 255, g = 0, b = 0, a = 255).
4324 * For alpha channel, 0 represents completely transparent, and 255, opaque.
4326 * @see elm_map_route_color_get()
4327 * @deprecated Use elm_map_overlay_color_set() instead
4330 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4333 * Get the route color.
4335 * @param route The route object.
4336 * @param r Pointer to store the red channel value.
4337 * @param g Pointer to store the green channel value.
4338 * @param b Pointer to store the blue channel value.
4339 * @param a Pointer to store the alpha channel value.
4341 * @see elm_map_route_color_set() for details.
4342 * @deprecated Use elm_map_overlay_color_get() instead
4345 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4348 * Remove a name from the map.
4350 * @param name The name to remove.
4352 * Basically the struct handled by @p name will be freed, so conversions
4353 * between address and coordinates will be lost.
4355 * @see elm_map_utils_convert_name_into_coord()
4356 * @see elm_map_utils_convert_coord_into_name()
4357 * @deprecated Use elm_map_name_del() instead
4360 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name);
4363 * Get the gengrid object's handle which contains a given gengrid item
4365 * @param it The item to fetch the container from
4366 * @return The gengrid (parent) object
4368 * This returns the gengrid object itself that an item belongs to.
4370 * @deprecated Use elm_object_item_widget_get() instead
4372 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4375 * Return the data associated to a given gengrid item
4377 * @param it The gengrid item.
4378 * @return the data associated with this item.
4380 * This returns the @c data value passed on the
4381 * elm_gengrid_item_append() and related item addition calls.
4383 * @see elm_gengrid_item_append()
4384 * @see elm_gengrid_item_data_set()
4385 * @deprecated Use elm_object_item_data_get() instead
4387 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4390 * Set the data associated with a given gengrid item
4392 * @param it The gengrid item
4393 * @param data The data pointer to set on it
4395 * This @b overrides the @c data value passed on the
4396 * elm_gengrid_item_append() and related item addition calls. This
4397 * function @b won't call elm_gengrid_item_update() automatically,
4398 * so you'd issue it afterwards if you want to have the item
4399 * updated to reflect the new data.
4401 * @see elm_gengrid_item_data_get()
4402 * @see elm_gengrid_item_update()
4403 * @deprecated Use elm_object_item_data_set() instead
4406 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4409 * Set whether a given gengrid item is disabled or not.
4411 * @param it The gengrid item
4412 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4413 * to enable it back.
4415 * A disabled item cannot be selected or unselected. It will also
4416 * change its appearance, to signal the user it's disabled.
4418 * @see elm_gengrid_item_disabled_get()
4419 * @deprecated Use elm_object_item_disabled_set() instead
4422 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4425 * Get whether a given gengrid item is disabled or not.
4427 * @param it The gengrid item
4428 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4431 * @see elm_gengrid_item_disabled_set() for more details
4432 * @deprecated Use elm_object_item_disabled_get() instead
4435 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4438 * Remove a gengrid item from its parent, deleting it.
4440 * @param it The item to be removed.
4441 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4443 * @see elm_gengrid_clear(), to remove all items in a gengrid at
4445 * @deprecated use elm_object_item_de() instead
4448 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
4451 * Update the item class of a gengrid item.
4453 * This sets another class of the item, changing the way that it is
4454 * displayed. After changing the item class, elm_gengrid_item_update() is
4455 * called on the item @p it.
4457 * @param it The gengrid item
4458 * @param gic The gengrid item class describing the function pointers and the item style.
4460 * @deprecated Use elm_gengrid_item_item_class_update instead
4462 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
4465 * Insert an item in a gengrid widget using a user-defined sort function.
4467 * @param obj The gengrid object.
4468 * @param gic The item class for the item.
4469 * @param data The item data.
4470 * @param comp User defined comparison function that defines the sort order
4471 * based on Elm_Gen_Item.
4472 * @param func Convenience function called when the item is selected.
4473 * @param func_data Data to be passed to @p func.
4474 * @return A handle to the item added or @c NULL, on errors.
4476 * This inserts an item in the gengrid based on user defined comparison function.
4478 * @see elm_gengrid_item_append()
4479 * @see elm_gengrid_item_prepend()
4480 * @see elm_gengrid_item_insert_after()
4481 * @see elm_object_item_del()
4482 * @see elm_gengrid_item_sorted_insert()
4484 * @deprecated Use elm_gengrid_item_sorted_insert() instead
4486 EINA_DEPRECATED EAPI Elm_Object_Item *elm_gengrid_item_direct_sorted_insert(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Eina_Compare_Cb comp, Evas_Smart_Cb func, const void *func_data);
4489 * Append a filter function for text inserted in the entry
4491 * Append the given callback to the list. This functions will be called
4492 * whenever any text is inserted into the entry, with the text to be inserted
4493 * as a parameter. The callback function is free to alter the text in any way
4494 * it wants, but it must remember to free the given pointer and update it.
4495 * If the new text is to be discarded, the function can free it and set its
4496 * text parameter to NULL. This will also prevent any following filters from
4499 * @param obj The entry object
4500 * @param func The function to use as text filter
4501 * @param data User data to pass to @p func
4502 * @deprecated use elm_entry_markup_filter_append() instead
4504 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4507 * Prepend a filter function for text inserted in the entry
4509 * Prepend the given callback to the list. See elm_entry_text_filter_append()
4510 * for more information
4512 * @param obj The entry object
4513 * @param func The function to use as text filter
4514 * @param data User data to pass to @p func
4515 * @deprecated use elm_entry_markup_filter_prepend() instead
4517 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4520 * Remove a filter from the list
4522 * Removes the given callback from the filter list. See
4523 * elm_entry_text_filter_append() for more information.
4525 * @param obj The entry object
4526 * @param func The filter function to remove
4527 * @param data The user data passed when adding the function
4528 * @deprecated use elm_entry_markup_filter_remove() instead
4530 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4533 * @brief Set the front content of the flip widget.
4535 * @param obj The flip object
4536 * @param content The new front content object
4538 * Once the content object is set, a previously set one will be deleted.
4539 * If you want to keep that old content object, use the
4540 * elm_flip_content_front_unset() function.
4542 * @deprecated Use elm_object_part_content_set(flip, "front") instead
4544 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
4547 * @brief Set the back content of the flip widget.
4549 * @param obj The flip object
4550 * @param content The new back content object
4552 * Once the content object is set, a previously set one will be deleted.
4553 * If you want to keep that old content object, use the
4554 * elm_flip_content_back_unset() function.
4556 * @deprecated Use elm_object_part_content_set(flip, "back") instead
4558 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
4561 * @brief Get the front content used for the flip
4563 * @param obj The flip object
4564 * @return The front content object that is being used
4566 * Return the front content object which is set for this widget.
4568 * @deprecated Use elm_object_part_content_get(flip, "front") instead
4570 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj);
4573 * @brief Get the back content used for the flip
4575 * @param obj The flip object
4576 * @return The back content object that is being used
4578 * Return the back content object which is set for this widget.
4580 * @deprecated Use elm_object_part_content_get(flip, "back") instead
4582 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj);
4585 * @brief Unset the front content used for the flip
4587 * @param obj The flip object
4588 * @return The front content object that was being used
4590 * Unparent and return the front content object which was set for this widget.
4592 * @deprecated Use elm_object_part_content_unset(flip, "front") instead
4594 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj);
4597 * @brief Unset the back content used for the flip
4599 * @param obj The flip object
4600 * @return The back content object that was being used
4602 * Unparent and return the back content object which was set for this widget.
4604 * @deprecated Use elm_object_part_content_unset(flip, "back") instead
4606 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj);
4609 * @brief Get flip front visibility state
4611 * @param obj The flip object
4612 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
4615 * @deprecated Use elm_flip_front_visible_get() instead
4617 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj);
4620 * @brief Set the font size on the label object.
4622 * @param obj The label object
4623 * @param size font size
4625 * @warning NEVER use this. It is for hyper-special cases only. use styles
4626 * instead. e.g. "default", "marker", "slide_long" etc.
4627 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
4629 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize);
4632 * @brief Set the text color on the label object
4634 * @param obj The label object
4635 * @param r Red property background color of The label object
4636 * @param g Green property background color of The label object
4637 * @param b Blue property background color of The label object
4638 * @param a Alpha property background color of The label object
4640 * @warning NEVER use this. It is for hyper-special cases only. use styles
4641 * instead. e.g. "default", "marker", "slide_long" etc.
4642 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
4644 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4647 * @brief Set the text align on the label object
4649 * @param obj The label object
4650 * @param align align mode ("left", "center", "right")
4652 * @warning NEVER use this. It is for hyper-special cases only. use styles
4653 * instead. e.g. "default", "marker", "slide_long" etc.
4654 * @deprecated Use <align> tag instead. about <align> tag - Either "auto" (meaning according to text direction), "left", "right", "center", "middle", a value between 0.0 and 1.0, or a value between 0% to 100%.
4656 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
4659 * @brief Set background color of the label
4661 * @param obj The label object
4662 * @param r Red property background color of The label object
4663 * @param g Green property background color of The label object
4664 * @param b Blue property background color of The label object
4665 * @param a Alpha property background alpha of The label object
4667 * @warning NEVER use this. It is for hyper-special cases only. use styles
4668 * instead. e.g. "default", "marker", "slide_long" etc.
4669 * @deprecated Just make colored background by yourself.
4671 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4674 * @brief Set wrap height of the label
4676 * @param obj The label object
4677 * @param h The wrap height in pixels at a minimum where words need to wrap
4679 * This function sets the maximum height size hint of the label.
4681 * @warning This is only relevant if the label is inside a container.
4682 * @deprecated This function should not be used because of wrong concept.
4684 EINA_DEPRECATED EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
4687 * @brief get wrap width of the label
4689 * @param obj The label object
4690 * @return The wrap height in pixels at a minimum where words need to wrap
4691 * @deprecated This function should not be used because of wrong concept.
4693 EINA_DEPRECATED EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj);
4696 * @brief Flush all caches.
4698 * Frees all data that was in cache and is not currently being used to reduce
4699 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
4700 * to calling all of the following functions:
4701 * @li edje_file_cache_flush()
4702 * @li edje_collection_cache_flush()
4703 * @li eet_clearcache()
4704 * @li evas_image_cache_flush()
4705 * @li evas_font_cache_flush()
4706 * @li evas_render_dump()
4707 * @note Evas caches are flushed for every canvas associated with a window.
4708 * @deprecated Use elm_cache_all_flush() instead.
4710 EINA_DEPRECATED EAPI void elm_all_flush(void);
4714 * @brief Define the uri that will be the video source.
4716 * @param video The video object to define the file for.
4717 * @param uri The uri to target.
4719 * This function will define an uri as a source for the video of the
4720 * Elm_Video object. URI could be remote source of video, like http:// or local
4721 * like for example WebCam who are most of the time v4l2:// (but that depend an
4722 * you should use Emotion API to request and list the available Webcam on your
4724 * @deprecated Use elm_video_file_set() instead.
4727 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri);
4730 * @brief Get the region of the image that is currently shown
4733 * @param x A pointer to the X-coordinate of region
4734 * @param y A pointer to the Y-coordinate of region
4735 * @param w A pointer to the width
4736 * @param h A pointer to the height
4738 * @deprecated Use elm_photocam_image_region_get() instead.
4740 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
4743 * @brief Set the gesture state for photocam.
4745 * @param obj The photocam object
4746 * @param gesture The gesture state to set
4748 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
4749 * photocam. The default is off. This will start multi touch zooming.
4751 * @deprecated Use elm_photocam_gesture_enabled_set() instead.
4753 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
4756 * @brief Get the gesture state for photocam.
4758 * @param obj The photocam object
4759 * @return The current gesture state
4761 * This gets the current gesture state for the photocam object.
4763 * @deprecated Use elm_photocam_gesture_enabled_get() instead.
4765 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj);
4766 /* No documentation for these API before.
4768 * @deprecated Use elm_route_latitude_min_max_get()
4769 * elm_route_longitude_min_max_get()
4772 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj);
4773 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj);
4774 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj);
4775 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj);
4779 * Get the duration after which tooltip will be shown.
4781 * @return Duration after which tooltip will be shown.
4782 * @deprecated Use elm_config_tooltip_delay_get(void);
4784 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void);
4787 * Set the duration after which tooltip will be shown.
4789 * @return EINA_TRUE if value is set.
4790 * @deprecated Use elm_config_tooltip_delay_set(double delay);
4792 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay);
4795 * Set the corner of the bubble
4797 * @param obj The bubble object.
4798 * @param corner The given corner for the bubble.
4800 * @deprecated Use elm_bubble_pos_set()
4803 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
4806 * Get the corner of the bubble
4808 * @param obj The bubble object.
4809 * @return The given corner for the bubble.
4811 * @deprecated Use elm_bubble_pos_get()
4813 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
4816 * Enable or disable day selection
4818 * @param obj The calendar object.
4819 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
4822 * @deprecated Use elm_calendar_day_selection_disabled_set()
4824 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
4827 * Get a value whether day selection is enabled or not.
4829 * @param obj The calendar object.
4830 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
4831 * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
4833 * @deprecated elm_calendar_day_selection_disabled_get()
4835 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
4838 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
4840 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
4843 * Get the configured font cache size
4845 * This gets the globally configured font cache size, in bytes.
4847 * @return The font cache size
4848 * @deprecated elm_cache_font_cache_size_get(void);
4850 EINA_DEPRECATED EAPI int elm_font_cache_get(void);
4853 * Set the configured font cache size
4855 * This sets the globally configured font cache size, in bytes
4857 * @param size The font cache size
4858 * @deprecated elm_cache_font_cache_size_set(int size);
4860 EINA_DEPRECATED EAPI void elm_font_cache_set(int size);
4863 * Get the configured image cache size
4865 * This gets the globally configured image cache size, in bytes
4867 * @return The image cache size
4869 EINA_DEPRECATED EAPI int elm_image_cache_get(void);
4870 EINA_DEPRECATED EAPI int elm_cache_image_cache_size_get(void);
4873 * Set the configured image cache size
4875 * This sets the globally configured image cache size, in bytes
4877 * @param size The image cache size
4878 * @deprecated Use elm_cache_image_cache_size_set(int size);
4880 EINA_DEPRECATED EAPI void elm_image_cache_set(int size);
4884 * Get the configured edje file cache size.
4886 * This gets the globally configured edje file cache size, in number
4889 * @return The edje file cache size
4890 * @deprecated Use elm_cache_edje_file_cache_size_get(void);
4892 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void);
4895 * Set the configured edje file cache size
4897 * This sets the globally configured edje file cache size, in number
4900 * @param size The edje file cache size
4901 * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
4903 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size);
4906 * Get the configured edje collections (groups) cache size.
4908 * This gets the globally configured edje collections cache size, in
4909 * number of collections.
4911 * @return The edje collections cache size
4912 * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
4914 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void);
4917 * Set the configured edje collections (groups) cache size
4919 * This sets the globally configured edje collections cache size, in
4920 * number of collections.
4922 * @param size The edje collections cache size
4923 * @deprecated elm_cache_edje_collection_cache_size_set(int size);
4925 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size);
4928 * Gets whether browsing history is enabled for the given object
4930 * @param obj The web object
4932 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
4934 * @deprecated Use elm_web_history_enabled_get()
4936 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj);
4939 * Enables or disables the browsing history
4941 * @param obj The web object
4942 * @param enable Whether to enable or disable the browsing history
4944 * @deprecated Use elm_web_history_enabled_set()
4947 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
4950 * @brief Add an object swallowed in an item at the end of the given menu
4953 * @param obj The menu object.
4954 * @param parent The parent menu item (optional)
4955 * @param subobj The object to swallow
4956 * @param func Function called when the user select the item.
4957 * @param data Data sent by the callback.
4958 * @return Returns the new item.
4960 * Add an evas object as an item to the menu.
4961 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
4963 EINA_DEPRECATED EAPI Elm_Object_Item *elm_menu_item_add_object(Evas_Object *obj, Elm_Object_Item *parent, Evas_Object *subobj, Evas_Smart_Cb func, const void *data);
4966 * @brief Sets whether events should be passed to by a click outside
4969 * @param obj The notify object
4970 * @param repeat EINA_TRUE Events are repeats, else no
4972 * When true if the user clicks outside the window the events will be caught
4973 * by the others widgets, else the events are blocked.
4975 * @note The default value is EINA_TRUE.
4976 * @deprecated Please use elm_notify_allow_events_set() instead
4978 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
4981 * @brief Return true if events are repeat below the notify object
4982 * @param obj the notify object
4984 * @see elm_notify_repeat_events_set()
4985 * @deprecated Please use elm_notify_allow_events_get() instead
4987 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj);
4990 * Set if the cursor set should be searched on the theme or should use
4991 * the provided by the engine, only.
4993 * @param obj an object with cursor already set.
4994 * @param engine_only boolean to define if cursors should be looked only
4995 * between the provided by the engine or searched on widget's theme as well.
4997 * @deprecated Use elm_object_cursor_theme_search_enabled_set()
4999 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5002 * Get the cursor engine only usage for this object cursor.
5004 * @param obj an object with cursor already set.
5005 * @return engine_only boolean to define it cursors should be
5006 * looked only between the provided by the engine or searched on
5007 * widget's theme as well. If the object does not have a cursor
5008 * set, then EINA_FALSE is returned.
5010 * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5012 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj);
5015 * Go to a given items level on a index widget
5017 * @param obj The index object
5018 * @param level The index level (one of @c 0 or @c 1)
5020 * @deprecated please use "elm_index_level_go" instead.
5022 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level);
5025 * Enable or disable auto hiding feature for a given index widget.
5027 * @param obj The index object
5028 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5030 * @see elm_index_active_get()
5032 * @deprecated please use "elm_index_autohide_disabled_set" instead.
5034 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5037 * Get whether auto hiding feature is enabled or not for a given index widget.
5039 * @param obj The index object
5040 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5042 * @see elm_index_active_set() for more details
5044 * @deprecated please use "elm_index_autohide_disabled_get" instead.
5046 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
5049 * Append a new item, on a given index widget, <b>after the item
5050 * having @p relative as data</b>.
5052 * @param obj The index object.
5053 * @param letter Letter under which the item should be indexed
5054 * @param item The item data to set for the index's item
5055 * @param relative The index item to be the predecessor of this new one
5056 * @return A handle to the item added or @c NULL, on errors
5058 * Despite the most common usage of the @p letter argument is for
5059 * single char strings, one could use arbitrary strings as index
5062 * @c item will be the pointer returned back on @c "changed", @c
5063 * "delay,changed" and @c "selected" smart events.
5065 * @note If @p relative is @c NULL this function will behave as
5066 * elm_index_item_append().
5068 * @deprecated please use "elm_index_item_insert_after" instead.
5070 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5073 * Prepend a new item, on a given index widget, <b>after the item
5074 * having @p relative as data</b>.
5076 * @param obj The index object.
5077 * @param letter Letter under which the item should be indexed
5078 * @param item The item data to set for the index's item
5079 * @param relative The index item to be the successor of this new one
5080 * @return A handle to the item added or @c NULL, on errors
5082 * Despite the most common usage of the @p letter argument is for
5083 * single char strings, one could use arbitrary strings as index
5086 * @c item will be the pointer returned back on @c "changed", @c
5087 * "delay,changed" and @c "selected" smart events.
5089 * @note If @p relative is @c NULL this function will behave as
5090 * elm_index_item_prepend().
5092 * @deprecated please use "elm_index_item_insert_before" instead.
5094 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5097 * Set the transparency state of a window.
5099 * Use elm_win_alpha_set() instead.
5101 * @param obj The window object
5102 * @param transparent If true, the window is transparent
5104 * @see elm_win_alpha_set()
5105 * @deprecated Please use elm_win_alpha_set()
5107 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5110 * Get the transparency state of a window.
5112 * @param obj The window object
5113 * @return If true, the window is transparent
5115 * @see elm_win_transparent_set()
5116 * @deprecated Please use elm_win_alpha_get()
5118 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj);
5121 * Set the theme for all elementary using applications on the current display
5123 * @param theme The name of the theme to use. Format same as the ELM_THEME
5124 * environment variable.
5125 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5127 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme);
5130 * Returns the Evas_Object that represents the content area.
5132 * @param obj The conformant object.
5133 * @return The content area of the widget.
5136 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
5139 * Set if the object is (up/down) resizable.
5141 * @param obj The image object
5142 * @param scale_up A bool to set if the object is resizable up. Default is
5144 * @param scale_down A bool to set if the object is resizable down. Default
5147 * This function limits the image resize ability. If @p scale_up is set to
5148 * @c EINA_FALSE, the object can't have its height or width resized to a value
5149 * higher than the original image size. Same is valid for @p scale_down.
5151 * @see elm_image_scale_get()
5152 * @deprecated Please use elm_image_resizable_set()
5155 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5158 * Get if the object is (up/down) resizable.
5160 * @param obj The image object
5161 * @param scale_up A bool to set if the object is resizable up
5162 * @param scale_down A bool to set if the object is resizable down
5164 * @see elm_image_scale_set()
5165 * @deprecated Please use elm_image_resizable_get()
5168 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5171 * Set if the object is (up/down) resizable.
5173 * @param obj The icon object
5174 * @param scale_up A bool to set if the object is resizable up. Default is
5176 * @param scale_down A bool to set if the object is resizable down. Default
5179 * This function limits the icon object resize ability. If @p scale_up is set to
5180 * @c EINA_FALSE, the object can't have its height or width resized to a value
5181 * higher than the original icon size. Same is valid for @p scale_down.
5183 * @see elm_icon_scale_get()
5184 * @deprecated Please use elm_icon_resizable_set()
5187 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5190 * Get if the object is (up/down) resizable.
5192 * @param obj The icon object
5193 * @param scale_up A bool to set if the object is resizable up
5194 * @param scale_down A bool to set if the object is resizable down
5196 * @see elm_icon_scale_set()
5197 * @deprecated Please use elm_icon_resizable_get()
5200 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5203 * Enable or disable preloading of the icon
5205 * @param obj The icon object
5206 * @param disable If EINA_TRUE, preloading will be disabled
5207 * @deprecated Use elm_icon_preload_disabled_set() instead
5209 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5212 * Returns the last selected item, for a given index widget.
5214 * @param obj The index object.
5215 * @return The last item @b selected on @p obj (or @c NULL, on errors).
5216 * @deprecated Please use elm_index_selected_item_get() instead.
5220 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
5223 * Get the value of shrink_mode state.
5225 * @deprecated elm_multibuttonentry_expanded_get()
5227 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5230 * Set/Unset the multibuttonentry to shrink mode state of single line
5232 * @deprecated elm_multibuttonentry_expanded_set()
5234 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5237 * Get the guide text
5239 * @param obj The multibuttonentry object
5240 * @return The guide text, or NULL if none
5242 * @deprecated Please use elm_object_part_text_get(obj, "guide");
5244 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5247 * Set the guide text
5249 * @param obj The multibuttonentry object
5250 * @param guidetext The guide text string
5252 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5254 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5257 * Make the elementary object and its children to be unfocusable
5260 * @param obj The Elementary object to operate on
5261 * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5262 * @c EINA_FALSE for focusable.
5264 * This sets whether the object @p obj and its children objects
5265 * are able to take focus or not. If the tree is set as unfocusable,
5266 * newest focused object which is not in this tree will get focus.
5267 * This API can be helpful for an object to be deleted.
5268 * When an object will be deleted soon, it and its children may not
5269 * want to get focus (by focus reverting or by other focus controls).
5270 * Then, just use this API before deleting.
5272 * @see elm_object_tree_unfocusable_get()
5274 * @deprecated Please use elm_object_tree_unfocusable_set()
5276 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5279 * Get whether an Elementary object and its children are unfocusable or not.
5281 * @param obj The Elementary object to get the information from
5282 * @return @c EINA_TRUE, if the tree is unfocussable,
5283 * @c EINA_FALSE if not (and on errors).
5285 * @see elm_object_tree_unfocusable_set()
5287 * @deprecated Please use elm_object_tree_unfocusable_get()
5289 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj);
5292 * Animatedly bring in, to the visible are of a genlist, a given
5295 * @deprecated elm_genlist_item_bring_in()
5297 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5300 * Animatedly bring in, to the visible are of a genlist, a given
5303 * @deprecated elm_genlist_item_bring_in()
5305 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5308 * Show the portion of a genlist's internal list containing a given
5309 * item, immediately.
5311 * @param it The item to display
5313 * @deprecated elm_genlist_item_show()
5316 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it);
5319 * Show the portion of a genlist's internal list containing a given
5320 * item, immediately.
5322 * @param it The item to display
5324 * @deprecated elm_genlist_item_show()
5327 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it);
5330 * Enable or disable round mode.
5332 * @param obj The diskselector object.
5333 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
5336 * Disabled by default. If round mode is enabled the items list will
5337 * work like a circle list, so when the user reaches the last item,
5338 * the first one will popup.
5340 * @see elm_diskselector_round_enabled_get()
5342 * @deprecated elm_diskselector_round_enabled_set()
5344 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
5347 * Set whether items on a given gengrid widget are to get their
5348 * selection callbacks issued for @b every subsequent selection
5349 * click on them or just for the first click.
5351 * @param obj The gengrid object
5352 * @param always_select @c EINA_TRUE to make items "always
5353 * selected", @c EINA_FALSE, otherwise
5355 * By default, grid items will only call their selection callback
5356 * function when firstly getting selected, any subsequent further
5357 * clicks will do nothing. With this call, you make those
5358 * subsequent clicks also to issue the selection callbacks.
5360 * @note <b>Double clicks</b> will @b always be reported on items.
5362 * @see elm_gengrid_always_select_mode_get()
5365 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5368 * Get whether items on a given gengrid widget have their selection
5369 * callbacks issued for @b every subsequent selection click on them
5370 * or just for the first click.
5372 * @param obj The gengrid object.
5373 * @return @c EINA_TRUE if the gengrid items are "always selected",
5374 * @c EINA_FALSE, otherwise
5376 * @see elm_gengrid_always_select_mode_set() for more details
5379 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj);
5382 * Set whether items on a given gengrid widget can be selected or not.
5384 * @param obj The gengrid object
5385 * @param no_select @c EINA_TRUE to make items selectable,
5386 * @c EINA_FALSE otherwise
5388 * This will make items in @p obj selectable or not. In the latter
5389 * case, any user interaction on the gengrid items will neither make
5390 * them appear selected nor them call their selection callback
5393 * @see elm_gengrid_no_select_mode_get()
5396 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5399 * Get whether items on a given gengrid widget can be selected or
5402 * @param obj The gengrid object
5403 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
5406 * @see elm_gengrid_no_select_mode_set() for more details
5409 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj);
5412 * Get the side labels max length.
5414 * @see elm_diskselector_side_text_max_length_set() for details.
5416 * @param obj The diskselector object.
5417 * @return The max length defined for side labels, or 0 if not a valid
5420 * @deprecated elm_diskselector_side_text_max_length_get()
5422 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj);
5425 * Set the side labels max length.
5427 * @param obj The diskselector object.
5428 * @param len The max length defined for side labels.
5430 * Length is the number of characters of items' label that will be
5431 * visible when it's set on side positions. It will just crop
5432 * the string after defined size. E.g.:
5434 * An item with label "January" would be displayed on side position as
5435 * "Jan" if max length is set to 3, or "Janu", if this property
5438 * When it's selected, the entire label will be displayed, except for
5439 * width restrictions. In this case label will be cropped and "..."
5440 * will be concatenated.
5442 * Default side label max length is 3.
5444 * This property will be applied over all items, included before or
5445 * later this function call.
5447 * @deprecated elm_diskselector_side_text_max_length_set()
5449 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
5452 * Set whether the toolbar should always have an item selected.
5454 * @param obj The toolbar object.
5455 * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to
5458 * This will cause the toolbar to always have an item selected, and clicking
5459 * the selected item will not cause a selected event to be emitted. Enabling this mode
5460 * will immediately select the first toolbar item.
5462 * Always-selected is disabled by default.
5464 * @see elm_toolbar_always_select_mode_get().
5468 EINA_DEPRECATED EAPI void elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5471 * Get whether the toolbar should always have an item selected.
5473 * @param obj The toolbar object.
5474 * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates
5475 * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned.
5477 * @see elm_toolbar_always_select_mode_set() for details.
5481 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_always_select_mode_get(const Evas_Object *obj);
5484 * Set whether the toolbar items' should be selected by the user or not.
5486 * @param obj The toolbar object.
5487 * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to
5490 * This will turn off the ability to select items entirely and they will
5491 * neither appear selected nor emit selected signals. The clicked
5492 * callback function will still be called.
5494 * Selection is enabled by default.
5496 * @see elm_toolbar_no_select_mode_get().
5500 EINA_DEPRECATED EAPI void elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5503 * Set whether the toolbar items' should be selected by the user or not.
5505 * @param obj The toolbar object.
5506 * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates
5507 * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned.
5509 * @see elm_toolbar_no_select_mode_set() for details.
5513 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_no_select_mode_get(const Evas_Object *obj);
5516 * Set the interval on time updates for a user mouse button hold
5517 * on clock widgets' time edition.
5519 * @param obj The clock object
5520 * @param interval The (first) interval value in seconds
5522 * This interval value is @b decreased while the user holds the
5523 * mouse pointer either incrementing or decrementing a given the
5524 * clock digit's value.
5526 * This helps the user to get to a given time distant from the
5527 * current one easier/faster, as it will start to flip quicker and
5528 * quicker on mouse button holds.
5530 * The calculation for the next flip interval value, starting from
5531 * the one set with this call, is the previous interval divided by
5532 * 1.05, so it decreases a little bit.
5534 * The default starting interval value for automatic flips is
5537 * @deprecated elm_clock_first_interval_set()
5540 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval);
5543 * Get the interval on time updates for a user mouse button hold
5544 * on clock widgets' time edition.
5546 * @param obj The clock object
5547 * @return The (first) interval value, in seconds, set on it
5549 * @elm_clock_first_interval_get()
5551 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj);
5554 * Set what digits of the given clock widget should be editable
5555 * when in edition mode.
5557 * @param obj The clock object
5558 * @param digedit Bit mask indicating the digits to be editable
5559 * (values in #Elm_Clock_Edit_Mode).
5561 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
5562 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
5565 * @deprecated elm_clock_edit_mode_set()
5567 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
5570 * Retrieve what digits of the given clock widget should be
5571 * editable when in edition mode.
5573 * @param obj The clock object
5574 * @return Bit mask indicating the digits to be editable
5575 * (values in #Elm_Clock_Edit_Mode).
5577 * @deprecated elm_clock_edit_mode_get()
5579 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
5582 * Queries whether it's possible to go back in history
5584 * @param obj The web object
5586 * @return EINA_TRUE if it's possible to back in history, EINA_FALSE
5588 * @deprecated elm_web_back_possible_get();
5590 EINA_DEPRECATED EAPI Eina_Bool elm_web_backward_possible(Evas_Object *obj);
5593 * Queries whether it's possible to go forward in history
5595 * @param obj The web object
5597 * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE
5600 * @deprecated elm_web_forward_possible_get();
5602 EINA_DEPRECATED EAPI Eina_Bool elm_web_forward_possible(Evas_Object *obj);
5605 * Queries whether it's possible to jump the given number of steps
5607 * @deprecated elm_web_navigate_possible_get();
5610 EINA_DEPRECATED EAPI Eina_Bool elm_web_navigate_possible(Evas_Object *obj, int steps);
5613 * @brief Set the content of the scroller widget (the object to be scrolled around).
5615 * @param obj The scroller object
5616 * @param content The new content object
5618 * Once the content object is set, a previously set one will be deleted.
5619 * If you want to keep that old content object, use the
5620 * elm_scroller_content_unset() function.
5621 * @deprecated use elm_object_content_set() instead
5623 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
5626 * @brief Get the content of the scroller widget
5628 * @param obj The slider object
5629 * @return The content that is being used
5631 * Return the content object which is set for this widget
5633 * @see elm_scroller_content_set()
5634 * @deprecated use elm_object_content_get() instead.
5636 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
5639 * @brief Unset the content of the scroller widget
5641 * @param obj The slider object
5642 * @return The content that was being used
5644 * Unparent and return the content object which was set for this widget
5646 * @see elm_scroller_content_set()
5647 * @deprecated use elm_object_content_unset() instead.
5649 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
5652 * Set the shrink state of toolbar @p obj.
5654 * @param obj The toolbar object.
5655 * @param shrink_mode Toolbar's items display behavior.
5657 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
5658 * but will enforce a minimum size so all the items will fit, won't scroll
5659 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
5660 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
5661 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
5663 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
5665 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
5668 * Get the shrink mode of toolbar @p obj.
5670 * @param obj The toolbar object.
5671 * @return Toolbar's items display behavior.
5673 * @see elm_toolbar_shrink_mode_set() for details.
5675 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
5677 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
5680 * Set the text to be shown in a given toolbar item's tooltips.
5682 * @param it toolbar item.
5683 * @param text The text to set in the content.
5685 * Setup the text as tooltip to object. The item can have only one tooltip,
5686 * so any previous tooltip data - set with this function or
5687 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
5689 * @deprecated Use elm_object_item_tooltip_text_set() instead
5690 * @see elm_object_tooltip_text_set() for more details.
5693 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
5696 * Enable or disable always select mode on the list object.
5698 * @param obj The list object
5699 * @param always_select @c EINA_TRUE to enable always select mode or
5700 * @c EINA_FALSE to disable it.
5702 * @note Always select mode is disabled by default.
5704 * Default behavior of list items is to only call its callback function
5705 * the first time it's pressed, i.e., when it is selected. If a selected
5706 * item is pressed again, and multi-select is disabled, it won't call
5707 * this function (if multi-select is enabled it will unselect the item).
5709 * If always select is enabled, it will call the callback function
5710 * every time a item is pressed, so it will call when the item is selected,
5711 * and again when a selected item is pressed.
5713 * @deprecated elm_list_always_select_mode_set()
5715 EINA_DEPRECATED EAPI void elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5718 * Get a value whether always select mode is enabled or not, meaning that
5719 * an item will always call its callback function, even if already selected.
5721 * @param obj The list object
5722 * @return @c EINA_TRUE means horizontal mode selection is enabled.
5723 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
5724 * @c EINA_FALSE is returned.
5726 * @see elm_list_always_select_mode_set() for details.
5728 * @deprecated elm_list_always_select_mode_get()
5730 EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj);