2 * DO NOT INCLUDE THIS HEADER INSIDE ANY SOURCE.
3 * THIS IS ONLY FOR ELEMENTARY API DEPRECATION HISTORY AND WILL BE REMOVED LATER.
4 * THIS WILL BE MAINLY MANAGED BY JIYOUN PARK (jypark).
6 * (deprecation process)
7 * 1. mark EINA_DEPRECATED and move declarations to elm_deprecated.h.
8 * 2. remove it from elm_deprecated.h and apply it to all trunk.
9 * 3. move it to elm_removed.h.
12 #error "do not include this"
15 * @brief Get Elementary's rendering engine in use.
17 * @return The rendering engine's name
18 * @note there's no need to free the returned string, here.
20 * This gets the global rendering engine that is applied to all Elementary
23 * @see elm_engine_set()
24 * @deprecated Use elm_engine_get() instead.
26 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
29 * Set the configured finger size for all applications on the display
31 * This sets the globally configured finger size in pixels for all
32 * applications on the display
34 * @param size The finger size
36 * @deprecated Use elm_finger_size_set() and elm_config_all_flush()
38 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size);
41 * Set the global scaling factor for all applications on the display
43 * This sets the globally configured scaling factor that is applied to all
44 * objects for all applications.
45 * @param scale The scaling factor to set
47 * @deprecated use elm_scale_set() and elm_config_all_flush()
49 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale);
52 * Apply the changes made with elm_font_overlay_set() and
53 * elm_font_overlay_unset() on all Elementary application windows.
57 * This applies all font overlays set to all objects in the UI.
58 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
60 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void);
63 * Set the configured cache flush interval time for all applications on the
66 * This sets the globally configured cache flush interval time -- in ticks
67 * -- for all applications on the display.
69 * @param size The cache flush interval time
70 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
73 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size);
76 * Set the configured cache flush enabled state for all applications on the
79 * This sets the globally configured cache flush enabled state for all
80 * applications on the display.
82 * @param enabled The cache flush enabled state
83 * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
86 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled);
89 * Set the configured font cache size for all applications on the
92 * This sets the globally configured font cache size -- in bytes
93 * -- for all applications on the display.
95 * @param size The font cache size
96 * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
99 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size);
102 * Set the configured image cache size for all applications on the
105 * This sets the globally configured image cache size -- in bytes
106 * -- for all applications on the display.
108 * @param size The image cache size
109 * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
112 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size);
115 * Set the configured edje file cache size for all applications on the
118 * This sets the globally configured edje file cache size -- in number
119 * of files -- for all applications on the display.
121 * @param size The edje file cache size
122 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
125 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size);
128 * Set the configured edje collections (groups) cache size for all
129 * applications on the display
131 * This sets the globally configured edje collections cache size -- in
132 * number of collections -- for all applications on the display.
134 * @param size The edje collections cache size
135 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
138 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size);
141 * Set Elementary's profile.
143 * This sets the global profile that is applied to all Elementary
144 * applications. All running Elementary windows will be affected.
146 * @param profile The profile's name
147 * @deprecated Use elm_profile_set() and elm_config_all_flush()
151 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile);
154 * Set whether scrollers should bounce when they reach their
155 * viewport's edge during a scroll, for all Elementary application
158 * @param enabled the thumb scroll bouncing state
160 * @see elm_thumbscroll_bounce_enabled_get()
161 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
164 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
167 * Set the amount of inertia a scroller will impose at bounce
168 * animations, for all Elementary application windows.
170 * @param friction the thumb scroll bounce friction
172 * @see elm_thumbscroll_bounce_friction_get()
173 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
176 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction);
179 * Set the amount of inertia a <b>paged</b> scroller will impose at
180 * page fitting animations, for all Elementary application windows.
182 * @param friction the page scroll friction
184 * @see elm_thumbscroll_page_scroll_friction_get()
185 * @deprecated Use elm_scroll_page_scroll_friction_set() and
186 * elm_config_all_flush()
189 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
192 * Set the amount of inertia a scroller will impose at region bring
193 * animations, for all Elementary application windows.
195 * @param friction the bring in scroll friction
197 * @see elm_thumbscroll_bring_in_scroll_friction_get()
198 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
199 * elm_config_all_flush()
202 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
205 * Set the amount of inertia scrollers will impose at animations
206 * triggered by Elementary widgets' zooming API, for all Elementary
207 * application windows.
209 * @param friction the zoom friction
211 * @see elm_thumbscroll_zoom_friction_get()
212 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
215 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction);
218 * Set whether scrollers should be draggable from any point in their
219 * views, for all Elementary application windows.
221 * @param enabled the thumb scroll state
223 * @see elm_thumbscroll_enabled_get()
224 * @deprecated Use elm_scroll_thumbscroll_enabled_set()
225 * and elm_config_all_flush()
229 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
233 * Set the number of pixels one should travel while dragging a
234 * scroller's view to actually trigger scrolling, for all Elementary
235 * application windows.
237 * @param threshold the thumb scroll threshold
239 * @see elm_thumbscroll_threshold_get()
240 * @deprecated Use elm_scroll_thumbscroll_threshold_set()
241 * and elm_config_all_flush()
245 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
248 * Set the minimum speed of mouse cursor movement which will trigger
249 * list self scrolling animation after a mouse up event
250 * (pixels/second), for all Elementary application windows.
252 * @param threshold the thumb scroll momentum threshold
254 * @see elm_thumbscroll_momentum_threshold_get()
255 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
256 * and elm_config_all_flush()
260 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
263 * Set the amount of inertia a scroller will impose at self scrolling
264 * animations, for all Elementary application windows.
266 * @param friction the thumb scroll friction
268 * @see elm_thumbscroll_friction_get()
269 * @deprecated Use elm_scroll_thumbscroll_friction_set()
270 * and elm_config_all_flush()
274 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
277 * Set the amount of lag between your actual mouse cursor dragging
278 * movement and a scroller's view movement itself, while pushing it
279 * into bounce state manually, for all Elementary application windows.
281 * @param friction the thumb scroll border friction. @c 0.0 for
282 * perfect synchrony between two movements, @c 1.0 for maximum
285 * @see elm_thumbscroll_border_friction_get()
286 * @note parameter value will get bound to 0.0 - 1.0 interval, always
287 * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
288 * and elm_config_all_flush()
292 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
295 * Set the sensitivity amount which is be multiplied by the length of
296 * mouse dragging, for all Elementary application windows.
298 * @param friction the thumb scroll sensitivity friction. @c 0.1 for
299 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
302 * @see elm_thumbscroll_sensitivity_friction_get()
303 * @note parameter value will get bound to 0.1 - 1.0 interval, always
304 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
305 * and elm_config_all_flush()
309 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
311 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
312 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
313 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
314 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
315 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
316 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
317 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
318 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
319 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
320 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
321 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
323 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
324 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
325 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
326 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
327 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
328 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
329 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
330 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
331 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
332 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
335 * Get the widget object's handle which contains a given item
337 * @param it The Elementary object item
338 * @return The widget object
340 * @note This returns the widget object itself that an item belongs to.
341 * @note Every elm_object_item supports this API
342 * @deprecated Use elm_object_item_widget_get() instead
345 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it);
348 * Set the text to show in the anchorblock
350 * Sets the text of the anchorblock to @p text. This text can include markup
351 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
352 * of text that will be specially styled and react to click events, ended
353 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
354 * "anchor,clicked" signal that you can attach a callback to with
355 * evas_object_smart_callback_add(). The name of the anchor given in the
356 * event info struct will be the one set in the href attribute, in this
359 * Other markup can be used to style the text in different ways, but it's
360 * up to the style defined in the theme which tags do what.
361 * @deprecated use elm_object_text_set() instead.
363 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
366 * Get the markup text set for the anchorblock
368 * Retrieves the text set on the anchorblock, with markup tags included.
370 * @param obj The anchorblock object
371 * @return The markup text set or @c NULL if nothing was set or an error
373 * @deprecated use elm_object_text_set() instead.
375 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
378 * Set the text to show in the anchorview
380 * Sets the text of the anchorview to @p text. This text can include markup
381 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
382 * text that will be specially styled and react to click events, ended with
383 * either of \</a\> or \</\>. When clicked, the anchor will emit an
384 * "anchor,clicked" signal that you can attach a callback to with
385 * evas_object_smart_callback_add(). The name of the anchor given in the
386 * event info struct will be the one set in the href attribute, in this
389 * Other markup can be used to style the text in different ways, but it's
390 * up to the style defined in the theme which tags do what.
391 * @deprecated use elm_object_text_set() instead.
393 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
396 * Get the markup text set for the anchorview
398 * Retrieves the text set on the anchorview, with markup tags included.
400 * @param obj The anchorview object
401 * @return The markup text set or @c NULL if nothing was set or an error
403 * @deprecated use elm_object_text_set() instead.
405 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
408 * @brief Get the ctxpopup item's disabled/enabled state.
410 * @param it Ctxpopup item to be enabled/disabled
411 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
413 * @see elm_ctxpopup_item_disabled_set()
414 * @deprecated use elm_object_item_disabled_get() instead
418 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
421 * @brief Set the ctxpopup item's state as disabled or enabled.
423 * @param it Ctxpopup item to be enabled/disabled
424 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
426 * When disabled the item is greyed out to indicate it's state.
427 * @deprecated use elm_object_item_disabled_set() instead
431 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
434 * @brief Get the icon object for the given ctxpopup item.
436 * @param it Ctxpopup item
437 * @return icon object or @c NULL, if the item does not have icon or an error
440 * @see elm_ctxpopup_item_append()
441 * @see elm_ctxpopup_item_icon_set()
443 * @deprecated use elm_object_item_part_content_get() instead
447 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
450 * @brief Sets the side icon associated with the ctxpopup item
452 * @param it Ctxpopup item
453 * @param icon Icon object to be set
455 * Once the icon object is set, a previously set one will be deleted.
456 * @warning Setting the same icon for two items will cause the icon to
457 * disappear from the first item.
459 * @see elm_ctxpopup_item_append()
461 * @deprecated use elm_object_item_part_content_set() instead
465 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
468 * @brief Get the label for the given ctxpopup item.
470 * @param it Ctxpopup item
471 * @return label string or @c NULL, if the item does not have label or an
474 * @see elm_ctxpopup_item_append()
475 * @see elm_ctxpopup_item_label_set()
477 * @deprecated use elm_object_item_text_get() instead
481 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
484 * @brief (Re)set the label on the given ctxpopup item.
486 * @param it Ctxpopup item
487 * @param label String to set as label
489 * @deprecated use elm_object_item_text_set() instead
493 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
496 * @brief Set an elm widget as the content of the ctxpopup.
498 * @param obj Ctxpopup object
499 * @param content Content to be swallowed
501 * If the content object is already set, a previous one will be deleted. If
502 * you want to keep that old content object, use the
503 * elm_ctxpopup_content_unset() function.
505 * @warning Ctxpopup can't hold both a item list and a content at the same
506 * time. When a content is set, any previous items will be removed.
508 * @deprecated use elm_object_content_set() instead
512 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
515 * @brief Unset the ctxpopup content
517 * @param obj Ctxpopup object
518 * @return The content that was being used
520 * Unparent and return the content object which was set for this widget.
522 * @deprecated use elm_object_content_unset()
524 * @see elm_ctxpopup_content_set()
526 * @deprecated use elm_object_content_unset() instead
530 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
533 * @brief Delete the given item in a ctxpopup object.
535 * @param it Ctxpopup item to be deleted
537 * @deprecated Use elm_object_item_del() instead
538 * @see elm_ctxpopup_item_append()
542 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
545 * Set the label for a given file selector button widget
547 * @param obj The file selector button widget
548 * @param label The text label to be displayed on @p obj
550 * @deprecated use elm_object_text_set() instead.
552 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
555 * Get the label set for a given file selector button widget
557 * @param obj The file selector button widget
558 * @return The button label
560 * @deprecated use elm_object_text_set() instead.
562 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
565 * Set the icon on a given file selector button widget
567 * @param obj The file selector button widget
568 * @param icon The icon object for the button
570 * Once the icon object is set, a previously set one will be
571 * deleted. If you want to keep the latter, use the
572 * elm_fileselector_button_icon_unset() function.
574 * @deprecated Use elm_object_part_content_set() instead
575 * @see elm_fileselector_button_icon_get()
577 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
580 * Get the icon set for a given file selector button widget
582 * @param obj The file selector button widget
583 * @return The icon object currently set on @p obj or @c NULL, if
586 * @deprecated Use elm_object_part_content_get() instead
587 * @see elm_fileselector_button_icon_set()
589 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
592 * Unset the icon used in a given file selector button widget
594 * @param obj The file selector button widget
595 * @return The icon object that was being used on @p obj or @c
598 * Unparent and return the icon object which was set for this
601 * @deprecated Use elm_object_part_content_unset() instead
602 * @see elm_fileselector_button_icon_set()
604 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
607 * Set the label for a given file selector entry widget's button
609 * @param obj The file selector entry widget
610 * @param label The text label to be displayed on @p obj widget's
613 * @deprecated use elm_object_text_set() instead.
615 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
618 * Get the label set for a given file selector entry widget's button
620 * @param obj The file selector entry widget
621 * @return The widget button's label
623 * @deprecated use elm_object_text_set() instead.
625 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
628 * Set the icon on a given file selector entry widget's button
630 * @param obj The file selector entry widget
631 * @param icon The icon object for the entry's button
633 * Once the icon object is set, a previously set one will be
634 * deleted. If you want to keep the latter, use the
635 * elm_fileselector_entry_button_icon_unset() function.
637 * @deprecated Use elm_object_part_content_set() instead
638 * @see elm_fileselector_entry_button_icon_get()
640 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
643 * Get the icon set for a given file selector entry widget's button
645 * @param obj The file selector entry widget
646 * @return The icon object currently set on @p obj widget's button
647 * or @c NULL, if none is
649 * @deprecated Use elm_object_part_content_get() instead
650 * @see elm_fileselector_entry_button_icon_set()
652 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
655 * Unset the icon used in a given file selector entry widget's
658 * @param obj The file selector entry widget
659 * @return The icon object that was being used on @p obj widget's
660 * button or @c NULL, on errors
662 * Unparent and return the icon object which was set for this
665 * @deprecated Use elm_object_part_content_unset() instead
666 * @see elm_fileselector_entry_button_icon_set()
668 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
671 * @brief Sets the content of the hover object and the direction in which it
674 * @param obj The hover object
675 * @param swallow The direction that the object will be displayed
676 * at. Accepted values are "left", "top-left", "top", "top-right",
677 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
679 * @param content The content to place at @p swallow
681 * Once the content object is set for a given direction, a previously
682 * set one (on the same direction) will be deleted. If you want to
683 * keep that old content object, use the elm_object_part_content_unset()
686 * All directions may have contents at the same time, except for
687 * "smart". This is a special placement hint and its use case
688 * depends of the calculations coming from
689 * elm_hover_best_content_location_get(). Its use is for cases when
690 * one desires only one hover content, but with a dynamic special
691 * placement within the hover area. The content's geometry, whenever
692 * it changes, will be used to decide on a best location, not
693 * extrapolating the hover's parent object view to show it in (still
694 * being the hover's target determinant of its medium part -- move and
695 * resize it to simulate finger sizes, for example). If one of the
696 * directions other than "smart" are used, a previously content set
697 * using it will be deleted, and vice-versa.
699 * @deprecated Use elm_object_part_content_set() instead
701 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
704 * @brief Get the content of the hover object, in a given direction.
706 * Return the content object which was set for this widget in the
707 * @p swallow direction.
709 * @param obj The hover object
710 * @param swallow The direction that the object was display at.
711 * @return The content that was being used
713 * @deprecated Use elm_object_part_content_get() instead
714 * @see elm_object_part_content_set()
716 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
719 * @brief Unset the content of the hover object, in a given direction.
721 * Unparent and return the content object set at @p swallow direction.
723 * @param obj The hover object
724 * @param swallow The direction that the object was display at.
725 * @return The content that was being used.
727 * @deprecated Use elm_object_part_content_unset() instead
728 * @see elm_object_part_content_set()
730 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
733 * @brief Set the hoversel button label
735 * @param obj The hoversel object
736 * @param label The label text.
738 * This sets the label of the button that is always visible (before it is
739 * clicked and expanded).
741 * @deprecated elm_object_text_set()
743 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
746 * @brief Get the hoversel button label
748 * @param obj The hoversel object
749 * @return The label text.
751 * @deprecated elm_object_text_get()
753 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
756 * @brief Set the icon of the hoversel button
758 * @param obj The hoversel object
759 * @param icon The icon object
761 * Sets the icon of the button that is always visible (before it is clicked
762 * and expanded). Once the icon object is set, a previously set one will be
763 * deleted, if you want to keep that old content object, use the
764 * elm_hoversel_icon_unset() function.
766 * @see elm_object_content_set() for the button widget
767 * @deprecated Use elm_object_item_part_content_set() instead
769 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
772 * @brief Get the icon of the hoversel button
774 * @param obj The hoversel object
775 * @return The icon object
777 * Get the icon of the button that is always visible (before it is clicked
778 * and expanded). Also see elm_object_content_get() for the button widget.
780 * @see elm_hoversel_icon_set()
781 * @deprecated Use elm_object_item_part_content_get() instead
783 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
786 * @brief Get and unparent the icon of the hoversel button
788 * @param obj The hoversel object
789 * @return The icon object that was being used
791 * Unparent and return the icon of the button that is always visible
792 * (before it is clicked and expanded).
794 * @see elm_hoversel_icon_set()
795 * @see elm_object_content_unset() for the button widget
796 * @deprecated Use elm_object_item_part_content_unset() instead
798 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
801 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
802 * that will be passed to associated function callbacks.
804 * @param it The item to get the data from
805 * @return The data pointer set with elm_hoversel_item_add()
807 * @see elm_hoversel_item_add()
808 * @deprecated Use elm_object_item_data_get() instead
810 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
813 * @brief This returns the label text of the given hoversel item.
815 * @param it The item to get the label
816 * @return The label text of the hoversel item
818 * @see elm_hoversel_item_add()
819 * @deprecated Use elm_object_item_text_get() instead
821 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
824 * @brief Set the function to be called when an item from the hoversel is
827 * @param it The item to set the callback on
828 * @param func The function called
830 * That function will receive these parameters:
831 * @li void * item data
832 * @li Evas_Object * hoversel object
833 * @li Elm_Object_Item * hoversel item
835 * @see elm_hoversel_item_add()
836 * @deprecated Use elm_object_item_del_cb_set() instead
838 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
841 * @brief Delete an item from the hoversel
843 * @param it The item to delete
845 * This deletes the item from the hoversel (should not be called while the
846 * hoversel is active; use elm_hoversel_expanded_get() to check first).
848 * @deprecated Use elm_object_item_del() instead
849 * @see elm_hoversel_item_add()
851 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
854 * Set actionslider labels.
856 * @param obj The actionslider object
857 * @param left_label The label to be set on the left.
858 * @param center_label The label to be set on the center.
859 * @param right_label The label to be set on the right.
860 * @deprecated use elm_object_text_set() instead.
862 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
865 * Get actionslider labels.
867 * @param obj The actionslider object
868 * @param left_label A char** to place the left_label of @p obj into.
869 * @param center_label A char** to place the center_label of @p obj into.
870 * @param right_label A char** to place the right_label of @p obj into.
871 * @deprecated use elm_object_text_set() instead.
873 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
876 * Set the label used on the indicator.
878 * @param obj The actionslider object
879 * @param label The label to be set on the indicator.
880 * @deprecated use elm_object_text_set() instead.
882 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
885 * Get the label used on the indicator object.
887 * @param obj The actionslider object
888 * @return The indicator label
889 * @deprecated use elm_object_text_get() instead.
891 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
894 * Set the overlay object used for the background object.
896 * @param obj The bg object
897 * @param overlay The overlay object
899 * This provides a way for elm_bg to have an 'overlay' that will be on top
900 * of the bg. Once the over object is set, a previously set one will be
901 * deleted, even if you set the new one to NULL. If you want to keep that
902 * old content object, use the elm_bg_overlay_unset() function.
904 * @deprecated use elm_object_part_content_set() instead
909 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
912 * Get the overlay object used for the background object.
914 * @param obj The bg object
915 * @return The content that is being used
917 * Return the content object which is set for this widget
919 * @deprecated use elm_object_part_content_get() instead
923 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
926 * Get the overlay object used for the background object.
928 * @param obj The bg object
929 * @return The content that was being used
931 * Unparent and return the overlay object which was set for this widget
933 * @deprecated use elm_object_part_content_unset() instead
937 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
941 * Set the label of the bubble
943 * @param obj The bubble object
944 * @param label The string to set in the label
946 * This function sets the title of the bubble. Where this appears depends on
947 * the selected corner.
948 * @deprecated use elm_object_text_set() instead.
950 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
953 * Get the label of the bubble
955 * @param obj The bubble object
956 * @return The string of set in the label
958 * This function gets the title of the bubble.
959 * @deprecated use elm_object_text_get() instead.
961 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
964 * Set the info of the bubble
966 * @param obj The bubble object
967 * @param info The given info about the bubble
969 * This function sets the info of the bubble. Where this appears depends on
970 * the selected corner.
971 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
973 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
976 * Get the info of the bubble
978 * @param obj The bubble object
980 * @return The "info" string of the bubble
982 * This function gets the info text.
983 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
985 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
988 * Set the content to be shown in the bubble
990 * Once the content object is set, a previously set one will be deleted.
991 * If you want to keep the old content object, use the
992 * elm_bubble_content_unset() function.
994 * @param obj The bubble object
995 * @param content The given content of the bubble
997 * This function sets the content shown on the middle of the bubble.
999 * @deprecated use elm_object_content_set() instead
1002 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1005 * Get the content shown in the bubble
1007 * Return the content object which is set for this widget.
1009 * @param obj The bubble object
1010 * @return The content that is being used
1012 * @deprecated use elm_object_content_get() instead
1015 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1018 * Unset the content shown in the bubble
1020 * Unparent and return the content object which was set for this widget.
1022 * @param obj The bubble object
1023 * @return The content that was being used
1025 * @deprecated use elm_object_content_unset() instead
1028 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1031 * Set the icon of the bubble
1033 * Once the icon object is set, a previously set one will be deleted.
1034 * If you want to keep the old content object, use the
1035 * elm_icon_content_unset() function.
1037 * @param obj The bubble object
1038 * @param icon The given icon for the bubble
1040 * @deprecated use elm_object_part_content_set() instead
1043 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1046 * Get the icon of the bubble
1048 * @param obj The bubble object
1049 * @return The icon for the bubble
1051 * This function gets the icon shown on the top left of bubble.
1053 * @deprecated use elm_object_part_content_get() instead
1056 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1059 * Unset the icon of the bubble
1061 * Unparent and return the icon object which was set for this widget.
1063 * @param obj The bubble object
1064 * @return The icon that was being used
1066 * @deprecated use elm_object_part_content_unset() instead
1069 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1073 * Set the label used in the button
1075 * The passed @p label can be NULL to clean any existing text in it and
1076 * leave the button as an icon only object.
1078 * @param obj The button object
1079 * @param label The text will be written on the button
1080 * @deprecated use elm_object_text_set() instead.
1082 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1085 * Get the label set for the button
1087 * The string returned is an internal pointer and should not be freed or
1088 * altered. It will also become invalid when the button is destroyed.
1089 * The string returned, if not NULL, is a stringshare, so if you need to
1090 * keep it around even after the button is destroyed, you can use
1091 * eina_stringshare_ref().
1093 * @param obj The button object
1094 * @return The text set to the label, or NULL if nothing is set
1095 * @deprecated use elm_object_text_set() instead.
1097 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1100 * Set the icon used for the button
1102 * Setting a new icon will delete any other that was previously set, making
1103 * any reference to them invalid. If you need to maintain the previous
1104 * object alive, unset it first with elm_button_icon_unset().
1106 * @param obj The button object
1107 * @param icon The icon object for the button
1108 * @deprecated use elm_object_part_content_set() instead.
1110 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1113 * Get the icon used for the button
1115 * Return the icon object which is set for this widget. If the button is
1116 * destroyed or another icon is set, the returned object will be deleted
1117 * and any reference to it will be invalid.
1119 * @param obj The button object
1120 * @return The icon object that is being used
1122 * @deprecated use elm_object_part_content_get() instead
1124 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1127 * Remove the icon set without deleting it and return the object
1129 * This function drops the reference the button holds of the icon object
1130 * and returns this last object. It is used in case you want to remove any
1131 * icon, or set another one, without deleting the actual object. The button
1132 * will be left without an icon set.
1134 * @param obj The button object
1135 * @return The icon object that was being used
1136 * @deprecated use elm_object_part_content_unset() instead.
1138 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1141 * Set a day text color to the same that represents Saturdays.
1143 * @param obj The calendar object.
1144 * @param pos The text position. Position is the cell counter, from left
1145 * to right, up to down. It starts on 0 and ends on 41.
1147 * @deprecated use elm_calendar_mark_add() instead like:
1150 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1151 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1154 * @see elm_calendar_mark_add()
1158 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1161 * Set a day text color to the same that represents Sundays.
1163 * @param obj The calendar object.
1164 * @param pos The text position. Position is the cell counter, from left
1165 * to right, up to down. It starts on 0 and ends on 41.
1167 * @deprecated use elm_calendar_mark_add() instead like:
1170 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1171 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1174 * @see elm_calendar_mark_add()
1178 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1181 * Set a day text color to the same that represents Weekdays.
1183 * @param obj The calendar object
1184 * @param pos The text position. Position is the cell counter, from left
1185 * to right, up to down. It starts on 0 and ends on 41.
1187 * @deprecated use elm_calendar_mark_add() instead like:
1190 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1192 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1193 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1194 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1195 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1196 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1197 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1198 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1199 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1200 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1203 * @see elm_calendar_mark_add()
1207 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1211 * @brief Set the text label of the check object
1213 * @param obj The check object
1214 * @param label The text label string in UTF-8
1216 * @deprecated use elm_object_text_set() instead.
1218 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1221 * @brief Get the text label of the check object
1223 * @param obj The check object
1224 * @return The text label string in UTF-8
1226 * @deprecated use elm_object_text_get() instead.
1228 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1231 * @brief Set the icon object of the check object
1233 * @param obj The check object
1234 * @param icon The icon object
1236 * Once the icon object is set, a previously set one will be deleted.
1237 * If you want to keep that old content object, use the
1238 * elm_object_content_unset() function.
1240 * @deprecated use elm_object_part_content_set() instead.
1243 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1246 * @brief Get the icon object of the check object
1248 * @param obj The check object
1249 * @return The icon object
1251 * @deprecated use elm_object_part_content_get() instead.
1254 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1257 * @brief Unset the icon used for the check object
1259 * @param obj The check object
1260 * @return The icon object that was being used
1262 * Unparent and return the icon object which was set for this widget.
1264 * @deprecated use elm_object_part_content_unset() instead.
1267 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1270 * @brief Set the text label of the check object
1272 * @param obj The check object
1273 * @param label The text label string in UTF-8
1275 * @deprecated use elm_object_text_set() instead.
1277 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1280 * @brief Get the text label of the check object
1282 * @param obj The check object
1283 * @return The text label string in UTF-8
1285 * @deprecated use elm_object_text_get() instead.
1287 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1290 * @brief Set the icon object of the check object
1292 * @param obj The check object
1293 * @param icon The icon object
1295 * Once the icon object is set, a previously set one will be deleted.
1296 * If you want to keep that old content object, use the
1297 * elm_object_content_unset() function.
1299 * @deprecated use elm_object_part_content_set() instead.
1302 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1305 * @brief Get the icon object of the check object
1307 * @param obj The check object
1308 * @return The icon object
1310 * @deprecated use elm_object_part_content_get() instead.
1313 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1316 * @brief Unset the icon used for the check object
1318 * @param obj The check object
1319 * @return The icon object that was being used
1321 * Unparent and return the icon object which was set for this widget.
1323 * @deprecated use elm_object_part_content_unset() instead.
1326 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1328 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1329 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1333 * Set the content of the conformant widget.
1335 * @param obj The conformant object.
1336 * @param content The content to be displayed by the conformant.
1338 * Content will be sized and positioned considering the space required
1339 * to display a virtual keyboard. So it won't fill all the conformant
1340 * size. This way is possible to be sure that content won't resize
1341 * or be re-positioned after the keyboard is displayed.
1343 * Once the content object is set, a previously set one will be deleted.
1344 * If you want to keep that old content object, use the
1345 * elm_object_content_unset() function.
1347 * @see elm_object_content_unset()
1348 * @see elm_object_content_get()
1350 * @deprecated use elm_object_content_set() instead
1352 * @ingroup Conformant
1354 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1357 * Get the content of the conformant widget.
1359 * @param obj The conformant object.
1360 * @return The content that is being used.
1362 * Return the content object which is set for this widget.
1363 * It won't be unparent from conformant. For that, use
1364 * elm_object_content_unset().
1366 * @see elm_object_content_set().
1367 * @see elm_object_content_unset()
1369 * @deprecated use elm_object_content_get() instead
1371 * @ingroup Conformant
1373 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1376 * Unset the content of the conformant widget.
1378 * @param obj The conformant object.
1379 * @return The content that was being used.
1381 * Unparent and return the content object which was set for this widget.
1383 * @see elm_object_content_set().
1385 * @deprecated use elm_object_content_unset() instead
1387 * @ingroup Conformant
1389 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1392 * Get the side labels max length.
1394 * @deprecated use elm_diskselector_side_label_length_get() instead:
1396 * @param obj The diskselector object.
1397 * @return The max length defined for side labels, or 0 if not a valid
1400 * @ingroup Diskselector
1402 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1405 * Set the side labels max length.
1407 * @deprecated use elm_diskselector_side_label_length_set() instead:
1409 * @param obj The diskselector object.
1410 * @param len The max length defined for side labels.
1412 * @ingroup Diskselector
1414 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1417 * Get the data associated to the item.
1419 * @param it The diskselector item
1420 * @return The data associated to @p it
1422 * The return value is a pointer to data associated to @p item when it was
1423 * created, with function elm_diskselector_item_append(). If no data
1424 * was passed as argument, it will return @c NULL.
1426 * @see elm_diskselector_item_append()
1427 * @deprecated Use elm_object_item_data_get()
1429 * @ingroup Diskselector
1431 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1434 * Set the icon associated to the item.
1436 * @param it The diskselector item
1437 * @param icon The icon object to associate with @p it
1439 * The icon object to use at left side of the item. An
1440 * icon can be any Evas object, but usually it is an icon created
1441 * with elm_icon_add().
1443 * Once the icon object is set, a previously set one will be deleted.
1444 * @warning Setting the same icon for two items will cause the icon to
1445 * disappear from the first item.
1447 * If an icon was passed as argument on item creation, with function
1448 * elm_diskselector_item_append(), it will be already
1449 * associated to the item.
1451 * @see elm_diskselector_item_append()
1452 * @see elm_diskselector_item_icon_get()
1454 * @deprecated Use elm_object_item_part_content_set() instead
1455 * @ingroup Diskselector
1457 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1460 * Get the icon associated to the item.
1462 * @param it The diskselector item
1463 * @return The icon associated to @p it
1465 * The return value is a pointer to the icon associated to @p item when it was
1466 * created, with function elm_diskselector_item_append(), or later
1467 * with function elm_diskselector_item_icon_set. If no icon
1468 * was passed as argument, it will return @c NULL.
1470 * @see elm_diskselector_item_append()
1471 * @see elm_diskselector_item_icon_set()
1473 * @deprecated Use elm_object_item_part_content_set() instead
1474 * @ingroup Diskselector
1476 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1479 * Set the label of item.
1481 * @param it The item of diskselector.
1482 * @param label The label of item.
1484 * The label to be displayed by the item.
1486 * If no icon is set, label will be centered on item position, otherwise
1487 * the icon will be placed at left of the label, that will be shifted
1490 * An item with label "January" would be displayed on side position as
1491 * "Jan" if max length is set to 3 with function
1492 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1495 * When this @p item is selected, the entire label will be displayed,
1496 * except for width restrictions.
1497 * In this case label will be cropped and "..." will be concatenated,
1498 * but only for display purposes. It will keep the entire string, so
1499 * if diskselector is resized the remaining characters will be displayed.
1501 * If a label was passed as argument on item creation, with function
1502 * elm_diskselector_item_append(), it will be already
1503 * displayed by the item.
1505 * @see elm_diskselector_side_label_length_set()
1506 * @see elm_diskselector_item_label_get()
1507 * @see elm_diskselector_item_append()
1509 * @deprecated Use elm_object_item_text_set() instead
1510 * @ingroup Diskselector
1512 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1515 * Get the label of item.
1517 * @param it The item of diskselector.
1518 * @return The label of item.
1520 * The return value is a pointer to the label associated to @p item when it was
1521 * created, with function elm_diskselector_item_append(), or later
1522 * with function elm_diskselector_item_label_set. If no label
1523 * was passed as argument, it will return @c NULL.
1525 * @see elm_diskselector_item_label_set() for more details.
1526 * @see elm_diskselector_item_append()
1527 * @deprecated Use elm_object_item_text_get() instead
1529 * @ingroup Diskselector
1531 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1534 * Set the function called when a diskselector item is freed.
1536 * @param it The item to set the callback on
1537 * @param func The function called
1539 * If there is a @p func, then it will be called prior item's memory release.
1540 * That will be called with the following arguments:
1542 * @li item's Evas object;
1545 * This way, a data associated to a diskselector item could be properly
1547 * @deprecated Use elm_object_item_del_cb_set() instead
1549 * @ingroup Diskselector
1551 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1554 * Delete them item from the diskselector.
1556 * @param it The item of diskselector to be deleted.
1558 * If deleting all diskselector items is required, elm_diskselector_clear()
1559 * should be used instead of getting items list and deleting each one.
1561 * @deprecated Use elm_object_item_del() instead
1562 * @see elm_diskselector_clear()
1563 * @see elm_diskselector_item_append()
1565 * @ingroup Diskselector
1567 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1570 * Set the text to be shown in the diskselector item.
1572 * @param it Target item
1573 * @param text The text to set in the content
1575 * Setup the text as tooltip to object. The item can have only one tooltip,
1576 * so any previous tooltip data is removed.
1578 * @deprecated Use elm_object_item_tooltip_text_set() instead
1579 * @see elm_object_tooltip_text_set() for more details.
1581 * @ingroup Diskselector
1583 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1586 * Set the content to be shown in the tooltip item.
1588 * Setup the tooltip to item. The item can have only one tooltip,
1589 * so any previous tooltip data is removed. @p func(with @p data) will
1590 * be called every time that need show the tooltip and it should
1591 * return a valid Evas_Object. This object is then managed fully by
1592 * tooltip system and is deleted when the tooltip is gone.
1594 * @param it the diskselector item being attached a tooltip.
1595 * @param func the function used to create the tooltip contents.
1596 * @param data what to provide to @a func as callback data/context.
1597 * @param del_cb called when data is not needed anymore, either when
1598 * another callback replaces @p func, the tooltip is unset with
1599 * elm_diskselector_item_tooltip_unset() or the owner @a item
1600 * dies. This callback receives as the first parameter the
1601 * given @a data, and @c event_info is the item.
1603 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1604 * @see elm_object_tooltip_content_cb_set() for more details.
1606 * @ingroup Diskselector
1608 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
1611 * Unset tooltip from item.
1613 * @param it diskselector item to remove previously set tooltip.
1615 * Remove tooltip from item. The callback provided as del_cb to
1616 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1617 * it is not used anymore.
1619 * @deprecated Use elm_object_item_tooltip_unset() instead
1620 * @see elm_object_tooltip_unset() for more details.
1621 * @see elm_diskselector_item_tooltip_content_cb_set()
1623 * @ingroup Diskselector
1625 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1628 * Sets a different style for this item tooltip.
1630 * @note before you set a style you should define a tooltip with
1631 * elm_diskselector_item_tooltip_content_cb_set() or
1632 * elm_diskselector_item_tooltip_text_set()
1634 * @param it diskselector item with tooltip already set.
1635 * @param style the theme style to use (default, transparent, ...)
1637 * @deprecated Use elm_object_item_tooltip_style_set() instead
1638 * @see elm_object_tooltip_style_set() for more details.
1640 * @ingroup Diskselector
1642 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1645 * Get the style for this item tooltip.
1647 * @param it diskselector item with tooltip already set.
1648 * @return style the theme style in use, defaults to "default". If the
1649 * object does not have a tooltip set, then NULL is returned.
1651 * @deprecated Use elm_object_item_tooltip_style_get() instead
1652 * @see elm_object_tooltip_style_get() for more details.
1653 * @see elm_diskselector_item_tooltip_style_set()
1655 * @ingroup Diskselector
1657 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1660 * Set the cursor to be shown when mouse is over the diskselector item
1662 * @param it Target item
1663 * @param cursor the cursor name to be used.
1665 * @see elm_object_cursor_set() for more details.
1666 * @deprecated Use elm_object_item_cursor_set() instead
1668 * @ingroup Diskselector
1670 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1673 * Get the cursor to be shown when mouse is over the diskselector item
1675 * @param it diskselector item with cursor already set.
1676 * @return the cursor name.
1678 * @see elm_object_cursor_get() for more details.
1679 * @see elm_diskselector_item_cursor_set()
1680 * @deprecated Use elm_object_item_cursor_get() instead
1682 * @ingroup Diskselector
1684 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1687 * Unset the cursor to be shown when mouse is over the diskselector item
1689 * @param it Target item
1691 * @see elm_object_cursor_unset() for more details.
1692 * @see elm_diskselector_item_cursor_set()
1693 * @deprecated use elm_object_item_cursor_unset() instead
1695 * @ingroup Diskselector
1697 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1700 * Sets a different style for this item cursor.
1702 * @note before you set a style you should define a cursor with
1703 * elm_diskselector_item_cursor_set()
1705 * @param it diskselector item with cursor already set.
1706 * @param style the theme style to use (default, transparent, ...)
1708 * @see elm_object_cursor_style_set() for more details.
1709 * @deprecated Use elm_object_item_cursor_style_set() instead
1711 * @ingroup Diskselector
1713 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1716 * Get the style for this item cursor.
1718 * @param it diskselector item with cursor already set.
1719 * @return style the theme style in use, defaults to "default". If the
1720 * object does not have a cursor set, then @c NULL is returned.
1722 * @see elm_object_cursor_style_get() for more details.
1723 * @see elm_diskselector_item_cursor_style_set()
1724 * @deprecated Use elm_object_item_cursor_style_get() instead
1726 * @ingroup Diskselector
1728 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1731 * Set if the cursor set should be searched on the theme or should use
1732 * the provided by the engine, only.
1734 * @note before you set if should look on theme you should define a cursor
1735 * with elm_diskselector_item_cursor_set().
1736 * By default it will only look for cursors provided by the engine.
1738 * @param it widget item with cursor already set.
1739 * @param engine_only boolean to define if cursors set with
1740 * elm_diskselector_item_cursor_set() should be searched only
1741 * between cursors provided by the engine or searched on widget's
1744 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1746 * @ingroup Diskselector
1748 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1751 * Get the cursor engine only usage for this item cursor.
1753 * @param it widget item with cursor already set.
1754 * @return engine_only boolean to define it cursors should be looked only
1755 * between the provided by the engine or searched on widget's theme as well.
1756 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1758 * @see elm_diskselector_item_cursor_engine_only_set()
1759 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1761 * @ingroup Diskselector
1763 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1765 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1766 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1769 * Get the label of a given flip selector widget's item.
1771 * @param it The item to get label from
1772 * @return The text label of @p item or @c NULL, on errors
1774 * @see elm_object_item_text_set()
1776 * @deprecated see elm_object_item_text_get() instead
1777 * @ingroup Flipselector
1779 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1782 * Set the label of a given flip selector widget's item.
1784 * @param it The item to set label on
1785 * @param label The text label string, in UTF-8 encoding
1787 * @see elm_object_item_text_get()
1789 * @deprecated see elm_object_item_text_set() instead
1790 * @ingroup Flipselector
1792 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1795 * Delete a given item from a flip selector widget.
1797 * @param it The item to delete
1799 * @deprecated Use elm_object_item_del() instead
1800 * @ingroup Flipselector
1802 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1805 * Set the interval on time updates for a user mouse button hold
1806 * on a flip selector widget.
1808 * @param obj The flip selector object
1809 * @param interval The (first) interval value in seconds
1811 * This interval value is @b decreased while the user holds the
1812 * mouse pointer either flipping up or flipping down a given flip
1815 * This helps the user to get to a given item distant from the
1816 * current one easier/faster, as it will start to flip quicker and
1817 * quicker on mouse button holds.
1819 * The calculation for the next flip interval value, starting from
1820 * the one set with this call, is the previous interval divided by
1821 * 1.05, so it decreases a little bit.
1823 * The default starting interval value for automatic flips is
1826 * @see elm_flipselector_interval_get()
1827 * @deprecated Use elm_flipselector_first_interval_set()
1829 * @ingroup Flipselector
1831 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
1834 * Get the interval on time updates for an user mouse button hold
1835 * on a flip selector widget.
1837 * @param obj The flip selector object
1838 * @return The (first) interval value, in seconds, set on it
1840 * @see elm_flipselector_interval_set() for more details
1841 * @deprecated Use elm_flipselector_first_interval_get()
1843 * @ingroup Flipselector
1845 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
1848 * Make a given Elementary object the focused one.
1850 * @param obj The Elementary object to make focused.
1852 * @note This object, if it can handle focus, will take the focus
1853 * away from the one who had it previously and will, for now on, be
1854 * the one receiving input events.
1856 * @see elm_object_focus_get()
1857 * @deprecated use elm_object_focus_set() instead.
1861 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1864 * Remove the focus from an Elementary object
1866 * @param obj The Elementary to take focus from
1868 * This removes the focus from @p obj, passing it back to the
1869 * previous element in the focus chain list.
1871 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1872 * @deprecated use elm_object_focus_set() instead.
1876 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1879 * Give focus to near object in one direction.
1881 * Give focus to near object in direction of one object.
1882 * If none focusable object in given direction, the focus will not change.
1884 * @param obj The reference object
1885 * @param x Horizontal component of direction to focus
1886 * @param y Vertical component of direction to focus
1888 * @deprecated Support it later.
1891 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1894 * @brief Set the frame label
1896 * @param obj The frame object
1897 * @param label The label of this frame object
1899 * @deprecated use elm_object_text_set() instead.
1901 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1904 * @brief Get the frame label
1906 * @param obj The frame object
1908 * @return The label of this frame object or NULL if unable to get frame
1910 * @deprecated use elm_object_text_get() instead.
1912 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1915 * @brief Set the content of the frame widget
1917 * Once the content object is set, a previously set one will be deleted.
1918 * If you want to keep that old content object, use the
1919 * elm_frame_content_unset() function.
1921 * @param obj The frame object
1922 * @param content The content will be filled in this frame object
1924 * @deprecated use elm_object_content_set() instead.
1926 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1929 * @brief Get the content of the frame widget
1931 * Return the content object which is set for this widget
1933 * @param obj The frame object
1934 * @return The content that is being used
1936 * @deprecated use elm_object_content_get() instead.
1938 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1941 * @brief Unset the content of the frame widget
1943 * Unparent and return the content object which was set for this widget
1945 * @param obj The frame object
1946 * @return The content that was being used
1948 * @deprecated use elm_object_content_unset() instead.
1950 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1952 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1953 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1954 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1956 * This sets the horizontal stretching mode.
1958 * @param obj The genlist object
1959 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1961 * This sets the mode used for sizing items horizontally. Valid modes
1962 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1963 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1964 * the scroller will scroll horizontally. Otherwise items are expanded
1965 * to fill the width of the viewport of the scroller. If it is
1966 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1967 * limited to that size.
1969 * @see elm_genlist_horizontal_get()
1971 * @deprecated use elm_genlist_mode_set()
1974 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1977 * Gets the horizontal stretching mode.
1979 * @param obj The genlist object
1980 * @return The mode to use
1981 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1983 * @see elm_genlist_horizontal_set()
1985 * @deprecated use elm_genlist_mode_get()
1988 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
1991 * Return the data associated to a given genlist item
1993 * @param it The genlist item.
1994 * @return the data associated to this item.
1996 * This returns the @c data value passed on the
1997 * elm_genlist_item_append() and related item addition calls.
1999 * @see elm_genlist_item_append()
2000 * @see elm_genlist_item_data_set()
2002 * @deprecated Use elm_object_item_data_get() instead
2005 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2008 * Set the data associated to a given genlist item
2010 * @param it The genlist item
2011 * @param data The new data pointer to set on it
2013 * This @b overrides the @c data value passed on the
2014 * elm_genlist_item_append() and related item addition calls. This
2015 * function @b won't call elm_genlist_item_update() automatically,
2016 * so you'd issue it afterwards if you want to hove the item
2017 * updated to reflect the that new data.
2019 * @see elm_genlist_item_data_get()
2021 * @deprecated Use elm_object_item_data_set() instead
2024 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2027 * Set whether a given genlist item is disabled or not.
2029 * @param it The item
2030 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2031 * to enable it back.
2033 * A disabled item cannot be selected or unselected. It will also
2034 * change its appearance, to signal the user it's disabled.
2036 * @see elm_genlist_item_disabled_get()
2037 * @deprecated Use elm_object_item_disabled_set() instead
2041 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2044 * Get whether a given genlist item is disabled or not.
2046 * @param it The item
2047 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2050 * @see elm_genlist_item_disabled_set() for more details
2051 * @deprecated Use elm_object_item_disabled_get() instead
2055 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2058 * Remove a genlist item from the its parent, deleting it.
2060 * @param it The item to be removed.
2061 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2063 * @see elm_genlist_clear(), to remove all items in a genlist at
2066 * @deprecated Use elm_object_item_del() instead
2069 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2072 * Get the genlist object's handle which contains a given genlist
2075 * @param it The item to fetch the container from
2076 * @return The genlist (parent) object
2078 * This returns the genlist object itself that an item belongs to.
2079 * @deprecated Use elm_object_item_widget_get() instead
2083 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2086 * Get the mode item style of items in the genlist
2087 * @param obj The genlist object
2088 * @return The mode item style string, or NULL if none is specified
2090 * This is a constant string and simply defines the name of the
2091 * style that will be used for mode animations. It can be
2092 * @c NULL if you don't plan to use Genlist mode. See
2093 * elm_genlist_item_mode_set() for more info.
2097 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2100 * Set the mode item style of items in the genlist
2101 * @param obj The genlist object
2102 * @param style The mode item style string, or NULL if none is desired
2104 * This is a constant string and simply defines the name of the
2105 * style that will be used for mode animations. It can be
2106 * @c NULL if you don't plan to use Genlist mode. See
2107 * elm_genlist_item_mode_set() for more info.
2111 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2114 * Get the real Evas object created to implement the view of a
2115 * given genlist item
2117 * @param it The genlist item.
2118 * @return the Evas object implementing this item's view.
2120 * This returns the actual Evas object used to implement the
2121 * specified genlist item's view. This may be @c NULL, as it may
2122 * not have been created or may have been deleted, at any time, by
2123 * the genlist. <b>Do not modify this object</b> (move, resize,
2124 * show, hide, etc.), as the genlist is controlling it. This
2125 * function is for querying, emitting custom signals or hooking
2126 * lower level callbacks for events on that object. Do not delete
2127 * this object under any circumstances.
2129 * @see elm_object_item_data_get()
2130 * @deprecated No more support
2134 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
2137 * Get the Item's Flags
2139 * @param it The genlist item
2140 * @return The item type.
2142 * This function returns the item's type. Normally the item's type.
2143 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2145 * @deprecated Use elm_genlist_item_type_get() instead
2148 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2151 * Tells genlist to "orphan" contents fetched by the item class
2153 * @param it The item
2155 * This instructs genlist to release references to contents in the item,
2156 * meaning that they will no longer be managed by genlist and are
2157 * floating "orphans" that can be re-used elsewhere if the user wants
2160 * @deprecated Use elm_genlist_item_all_contents_unset() instead