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"
16 * @brief A toggle is a slider which can be used to toggle between
17 * two values. It has two states: on and off.
19 * This widget is deprecated. Please use elm_check_add() instead using the
23 * obj = elm_check_add(parent);
24 * elm_object_style_set(obj, "toggle");
25 * elm_object_part_text_set(obj, "on", "ON");
26 * elm_object_part_text_set(obj, "off", "OFF");
29 * Signals that you can add callbacks for are:
30 * @li "changed" - Whenever the toggle value has been changed. Is not called
31 * until the toggle is released by the cursor (assuming it
32 * has been triggered by the cursor in the first place).
34 * Default content parts of the toggle widget that you can use for are:
35 * @li "icon" - An icon of the toggle
37 * Default text parts of the toggle widget that you can use for are:
38 * @li "elm.text" - Label of the toggle
46 * @brief Add a toggle to @p parent.
48 * @param parent The parent object
50 * @return The toggle object
52 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
57 * @brief Sets the label to be displayed with the toggle.
59 * @param obj The toggle object
60 * @param label The label to be displayed
62 * @deprecated use elm_object_text_set() instead.
64 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
69 * @brief Get the label of the toggle
71 * @param obj toggle object
72 * @return The label of the toggle
74 * @deprecated use elm_object_text_get() instead.
76 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
81 * @brief Set the icon used for the toggle
83 * @param obj The toggle object
84 * @param icon The icon object for the button
86 * Once the icon object is set, a previously set one will be deleted
87 * If you want to keep that old content object, use the
88 * elm_toggle_icon_unset() function.
90 * @deprecated use elm_object_part_content_set() instead.
92 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
97 * @brief Get the icon used for the toggle
99 * @param obj The toggle object
100 * @return The icon object that is being used
102 * Return the icon object which is set for this widget.
104 * @deprecated use elm_object_part_content_get() instead.
106 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
111 * @brief Unset the icon used for the toggle
113 * @param obj The toggle object
114 * @return The icon object that was being used
116 * Unparent and return the icon object which was set for this widget.
118 * @deprecated use elm_object_part_content_unset() instead.
120 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
125 * @brief Sets the labels to be associated with the on and off states of the toggle.
127 * @param obj The toggle object
128 * @param onlabel The label displayed when the toggle is in the "on" state
129 * @param offlabel The label displayed when the toggle is in the "off" state
131 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
134 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
139 * @brief Get the labels associated with the on and off states of the
142 * @param obj The toggle object
143 * @param onlabel A char** to place the onlabel of @p obj into
144 * @param offlabel A char** to place the offlabel of @p obj into
146 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
149 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
154 * @brief Sets the state of the toggle to @p state.
156 * @param obj The toggle object
157 * @param state The state of @p obj
159 * @deprecated use elm_check_state_set() instead.
161 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
166 * @brief Get the state of the toggle to @p state.
168 * @param obj The toggle object
169 * @return The state of @p obj
171 * @deprecated use elm_check_state_get() instead.
173 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
178 * @brief Sets the state pointer of the toggle to @p statep.
180 * @param obj The toggle object
181 * @param statep The state pointer of @p obj
183 * @deprecated use elm_check_state_pointer_set() instead.
185 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
190 * @brief Get Elementary's rendering engine in use.
192 * @return The rendering engine's name
193 * @note there's no need to free the returned string, here.
195 * This gets the global rendering engine that is applied to all Elementary
198 * @see elm_engine_set()
199 * @deprecated Use elm_engine_get() instead.
201 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
206 * Set the configured finger size for all applications on the display
208 * This sets the globally configured finger size in pixels for all
209 * applications on the display
211 * @param size The finger size
213 * @deprecated Use elm_config_finger_size_set() and elm_config_all_flush()
215 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size);
220 * Set the global scaling factor for all applications on the display
222 * This sets the globally configured scaling factor that is applied to all
223 * objects for all applications.
224 * @param scale The scaling factor to set
226 * @deprecated use elm_scale_set() and elm_config_all_flush()
228 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale);
233 * Apply the changes made with elm_font_overlay_set() and
234 * elm_font_overlay_unset() on all Elementary application windows.
238 * This applies all font overlays set to all objects in the UI.
239 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
241 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void);
246 * Set the configured cache flush interval time for all applications on the
249 * This sets the globally configured cache flush interval time -- in ticks
250 * -- for all applications on the display.
252 * @param size The cache flush interval time
253 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
256 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size);
261 * Set the configured cache flush enabled state for all applications on the
264 * This sets the globally configured cache flush enabled state for all
265 * applications on the display.
267 * @param enabled The cache flush enabled state
268 * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
271 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled);
276 * Set the configured font cache size for all applications on the
279 * This sets the globally configured font cache size -- in bytes
280 * -- for all applications on the display.
282 * @param size The font cache size
283 * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
286 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size);
291 * Set the configured image cache size for all applications on the
294 * This sets the globally configured image cache size -- in bytes
295 * -- for all applications on the display.
297 * @param size The image cache size
298 * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
301 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size);
306 * Set the configured edje file cache size for all applications on the
309 * This sets the globally configured edje file cache size -- in number
310 * of files -- for all applications on the display.
312 * @param size The edje file cache size
313 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
316 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size);
321 * Set the configured edje collections (groups) cache size for all
322 * applications on the display
324 * This sets the globally configured edje collections cache size -- in
325 * number of collections -- for all applications on the display.
327 * @param size The edje collections cache size
328 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
331 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size);
336 * Set Elementary's profile.
338 * This sets the global profile that is applied to all Elementary
339 * applications. All running Elementary windows will be affected.
341 * @param profile The profile's name
342 * @deprecated Use elm_profile_set() and elm_config_all_flush()
346 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile);
351 * Set whether scrollers should bounce when they reach their
352 * viewport's edge during a scroll, for all Elementary application
355 * @param enabled the thumb scroll bouncing state
357 * @see elm_thumbscroll_bounce_enabled_get()
358 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
361 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
366 * Set the amount of inertia a scroller will impose at bounce
367 * animations, for all Elementary application windows.
369 * @param friction the thumb scroll bounce friction
371 * @see elm_thumbscroll_bounce_friction_get()
372 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
375 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction);
380 * Set the amount of inertia a <b>paged</b> scroller will impose at
381 * page fitting animations, for all Elementary application windows.
383 * @param friction the page scroll friction
385 * @see elm_thumbscroll_page_scroll_friction_get()
386 * @deprecated Use elm_scroll_page_scroll_friction_set() and
387 * elm_config_all_flush()
390 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
395 * Set the amount of inertia a scroller will impose at region bring
396 * animations, for all Elementary application windows.
398 * @param friction the bring in scroll friction
400 * @see elm_thumbscroll_bring_in_scroll_friction_get()
401 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
402 * elm_config_all_flush()
405 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
410 * Set the amount of inertia scrollers will impose at animations
411 * triggered by Elementary widgets' zooming API, for all Elementary
412 * application windows.
414 * @param friction the zoom friction
416 * @see elm_thumbscroll_zoom_friction_get()
417 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
420 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction);
425 * Set whether scrollers should be draggable from any point in their
426 * views, for all Elementary application windows.
428 * @param enabled the thumb scroll state
430 * @see elm_thumbscroll_enabled_get()
431 * @deprecated Use elm_scroll_thumbscroll_enabled_set()
432 * and elm_config_all_flush()
436 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
442 * Set the number of pixels one should travel while dragging a
443 * scroller's view to actually trigger scrolling, for all Elementary
444 * application windows.
446 * @param threshold the thumb scroll threshold
448 * @see elm_thumbscroll_threshold_get()
449 * @deprecated Use elm_scroll_thumbscroll_threshold_set()
450 * and elm_config_all_flush()
454 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
459 * Set the minimum speed of mouse cursor movement which will trigger
460 * list self scrolling animation after a mouse up event
461 * (pixels/second), for all Elementary application windows.
463 * @param threshold the thumb scroll momentum threshold
465 * @see elm_thumbscroll_momentum_threshold_get()
466 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
467 * and elm_config_all_flush()
471 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
476 * Set the amount of inertia a scroller will impose at self scrolling
477 * animations, for all Elementary application windows.
479 * @param friction the thumb scroll friction
481 * @see elm_thumbscroll_friction_get()
482 * @deprecated Use elm_scroll_thumbscroll_friction_set()
483 * and elm_config_all_flush()
487 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
492 * Set the amount of lag between your actual mouse cursor dragging
493 * movement and a scroller's view movement itself, while pushing it
494 * into bounce state manually, for all Elementary application windows.
496 * @param friction the thumb scroll border friction. @c 0.0 for
497 * perfect synchrony between two movements, @c 1.0 for maximum
500 * @see elm_thumbscroll_border_friction_get()
501 * @note parameter value will get bound to 0.0 - 1.0 interval, always
502 * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
503 * and elm_config_all_flush()
507 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
512 * Set the sensitivity amount which is be multiplied by the length of
513 * mouse dragging, for all Elementary application windows.
515 * @param friction the thumb scroll sensitivity friction. @c 0.1 for
516 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
519 * @see elm_thumbscroll_sensitivity_friction_get()
520 * @note parameter value will get bound to 0.1 - 1.0 interval, always
521 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
522 * and elm_config_all_flush()
526 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
528 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
529 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
530 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
531 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
532 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
533 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
534 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
535 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
536 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
537 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
538 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
540 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
541 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
542 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
543 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
544 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
545 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
546 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
547 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
548 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
549 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
554 * Set the text to show in the anchorblock
556 * Sets the text of the anchorblock to @p text. This text can include markup
557 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
558 * of text that will be specially styled and react to click events, ended
559 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
560 * "anchor,clicked" signal that you can attach a callback to with
561 * evas_object_smart_callback_add(). The name of the anchor given in the
562 * event info struct will be the one set in the href attribute, in this
565 * Other markup can be used to style the text in different ways, but it's
566 * up to the style defined in the theme which tags do what.
567 * @deprecated use elm_object_text_set() instead.
569 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
574 * Get the markup text set for the anchorblock
576 * Gets the text set on the anchorblock, with markup tags included.
578 * @param obj The anchorblock object
579 * @return The markup text set or @c NULL if nothing was set or an error
581 * @deprecated use elm_object_text_set() instead.
583 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
588 * Set the text to show in the anchorview
590 * Sets the text of the anchorview to @p text. This text can include markup
591 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
592 * text that will be specially styled and react to click events, ended with
593 * either of \</a\> or \</\>. When clicked, the anchor will emit an
594 * "anchor,clicked" signal that you can attach a callback to with
595 * evas_object_smart_callback_add(). The name of the anchor given in the
596 * event info struct will be the one set in the href attribute, in this
599 * Other markup can be used to style the text in different ways, but it's
600 * up to the style defined in the theme which tags do what.
601 * @deprecated use elm_object_text_set() instead.
603 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
608 * Get the markup text set for the anchorview
610 * Gets the text set on the anchorview, with markup tags included.
612 * @param obj The anchorview object
613 * @return The markup text set or @c NULL if nothing was set or an error
615 * @deprecated use elm_object_text_set() instead.
617 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
622 * @brief Get the ctxpopup item's disabled/enabled state.
624 * @param it Ctxpopup item to be enabled/disabled
625 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
627 * @see elm_ctxpopup_item_disabled_set()
628 * @deprecated use elm_object_item_disabled_get() instead
632 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
637 * @brief Set the ctxpopup item's state as disabled or enabled.
639 * @param it Ctxpopup item to be enabled/disabled
640 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
642 * When disabled the item is greyed out to indicate it's state.
643 * @deprecated use elm_object_item_disabled_set() instead
647 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
652 * @brief Get the icon object for the given ctxpopup item.
654 * @param it Ctxpopup item
655 * @return icon object or @c NULL, if the item does not have icon or an error
658 * @see elm_ctxpopup_item_append()
659 * @see elm_ctxpopup_item_icon_set()
661 * @deprecated use elm_object_item_part_content_get() instead
665 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
670 * @brief Sets the side icon associated with the ctxpopup item
672 * @param it Ctxpopup item
673 * @param icon Icon object to be set
675 * Once the icon object is set, a previously set one will be deleted.
676 * @warning Setting the same icon for two items will cause the icon to
677 * disappear from the first item.
679 * @see elm_ctxpopup_item_append()
681 * @deprecated use elm_object_item_part_content_set() instead
685 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
690 * @brief Get the label for the given ctxpopup item.
692 * @param it Ctxpopup item
693 * @return label string or @c NULL, if the item does not have label or an
696 * @see elm_ctxpopup_item_append()
697 * @see elm_ctxpopup_item_label_set()
699 * @deprecated use elm_object_item_text_get() instead
703 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
708 * @brief (Re)set the label on the given ctxpopup item.
710 * @param it Ctxpopup item
711 * @param label String to set as label
713 * @deprecated use elm_object_item_text_set() instead
717 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
722 * @brief Set an elm widget as the content of the ctxpopup.
724 * @param obj Ctxpopup object
725 * @param content Content to be swallowed
727 * If the content object is already set, a previous one will be deleted. If
728 * you want to keep that old content object, use the
729 * elm_ctxpopup_content_unset() function.
731 * @warning Ctxpopup can't hold both a item list and a content at the same
732 * time. When a content is set, any previous items will be removed.
734 * @deprecated use elm_object_content_set() instead
738 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
743 * @brief Unset the ctxpopup content
745 * @param obj Ctxpopup object
746 * @return The content that was being used
748 * Unparent and return the content object which was set for this widget.
750 * @deprecated use elm_object_content_unset()
752 * @see elm_ctxpopup_content_set()
754 * @deprecated use elm_object_content_unset() instead
758 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
763 * @brief Delete the given item in a ctxpopup object.
765 * @param it Ctxpopup item to be deleted
767 * @deprecated Use elm_object_item_del() instead
768 * @see elm_ctxpopup_item_append()
772 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
777 * Set the label for a given file selector button widget
779 * @param obj The file selector button widget
780 * @param label The text label to be displayed on @p obj
782 * @deprecated use elm_object_text_set() instead.
784 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
789 * Get the label set for a given file selector button widget
791 * @param obj The file selector button widget
792 * @return The button label
794 * @deprecated use elm_object_text_set() instead.
796 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
801 * Set the icon on a given file selector button widget
803 * @param obj The file selector button widget
804 * @param icon The icon object for the button
806 * Once the icon object is set, a previously set one will be
807 * deleted. If you want to keep the latter, use the
808 * elm_fileselector_button_icon_unset() function.
810 * @deprecated Use elm_object_part_content_set() instead
811 * @see elm_fileselector_button_icon_get()
813 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
818 * Get the icon set for a given file selector button widget
820 * @param obj The file selector button widget
821 * @return The icon object currently set on @p obj or @c NULL, if
824 * @deprecated Use elm_object_part_content_get() instead
825 * @see elm_fileselector_button_icon_set()
827 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
832 * Unset the icon used in a given file selector button widget
834 * @param obj The file selector button widget
835 * @return The icon object that was being used on @p obj or @c
838 * Unparent and return the icon object which was set for this
841 * @deprecated Use elm_object_part_content_unset() instead
842 * @see elm_fileselector_button_icon_set()
844 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
849 * Set the label for a given file selector entry widget's button
851 * @param obj The file selector entry widget
852 * @param label The text label to be displayed on @p obj widget's
855 * @deprecated use elm_object_text_set() instead.
857 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
862 * Get the label set for a given file selector entry widget's button
864 * @param obj The file selector entry widget
865 * @return The widget button's label
867 * @deprecated use elm_object_text_set() instead.
869 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
874 * Set the icon on a given file selector entry widget's button
876 * @param obj The file selector entry widget
877 * @param icon The icon object for the entry's button
879 * Once the icon object is set, a previously set one will be
880 * deleted. If you want to keep the latter, use the
881 * elm_fileselector_entry_button_icon_unset() function.
883 * @deprecated Use elm_object_part_content_set() instead
884 * @see elm_fileselector_entry_button_icon_get()
886 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
891 * Get the icon set for a given file selector entry widget's button
893 * @param obj The file selector entry widget
894 * @return The icon object currently set on @p obj widget's button
895 * or @c NULL, if none is
897 * @deprecated Use elm_object_part_content_get() instead
898 * @see elm_fileselector_entry_button_icon_set()
900 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
905 * Unset the icon used in a given file selector entry widget's
908 * @param obj The file selector entry widget
909 * @return The icon object that was being used on @p obj widget's
910 * button or @c NULL, on errors
912 * Unparent and return the icon object which was set for this
915 * @deprecated Use elm_object_part_content_unset() instead
916 * @see elm_fileselector_entry_button_icon_set()
918 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
923 * @brief Sets the content of the hover object and the direction in which it
926 * @param obj The hover object
927 * @param swallow The direction that the object will be displayed
928 * at. Accepted values are "left", "top-left", "top", "top-right",
929 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
931 * @param content The content to place at @p swallow
933 * Once the content object is set for a given direction, a previously
934 * set one (on the same direction) will be deleted. If you want to
935 * keep that old content object, use the elm_object_part_content_unset()
938 * All directions may have contents at the same time, except for
939 * "smart". This is a special placement hint and its use case
940 * depends of the calculations coming from
941 * elm_hover_best_content_location_get(). Its use is for cases when
942 * one desires only one hover content, but with a dynamic special
943 * placement within the hover area. The content's geometry, whenever
944 * it changes, will be used to decide on a best location, not
945 * extrapolating the hover's parent object view to show it in (still
946 * being the hover's target determinant of its medium part -- move and
947 * resize it to simulate finger sizes, for example). If one of the
948 * directions other than "smart" are used, a previously content set
949 * using it will be deleted, and vice-versa.
951 * @deprecated Use elm_object_part_content_set() instead
953 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
958 * @brief Get the content of the hover object, in a given direction.
960 * Return the content object which was set for this widget in the
961 * @p swallow direction.
963 * @param obj The hover object
964 * @param swallow The direction that the object was display at.
965 * @return The content that was being used
967 * @deprecated Use elm_object_part_content_get() instead
968 * @see elm_object_part_content_set()
970 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
975 * @brief Unset the content of the hover object, in a given direction.
977 * Unparent and return the content object set at @p swallow direction.
979 * @param obj The hover object
980 * @param swallow The direction that the object was display at.
981 * @return The content that was being used.
983 * @deprecated Use elm_object_part_content_unset() instead
984 * @see elm_object_part_content_set()
986 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
991 * @brief Set the hoversel button label
993 * @param obj The hoversel object
994 * @param label The label text.
996 * This sets the label of the button that is always visible (before it is
997 * clicked and expanded).
999 * @deprecated elm_object_text_set()
1001 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
1006 * @brief Get the hoversel button label
1008 * @param obj The hoversel object
1009 * @return The label text.
1011 * @deprecated elm_object_text_get()
1013 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
1018 * @brief Set the icon of the hoversel button
1020 * @param obj The hoversel object
1021 * @param icon The icon object
1023 * Sets the icon of the button that is always visible (before it is clicked
1024 * and expanded). Once the icon object is set, a previously set one will be
1025 * deleted, if you want to keep that old content object, use the
1026 * elm_hoversel_icon_unset() function.
1028 * @see elm_object_content_set() for the button widget
1029 * @deprecated Use elm_object_item_part_content_set() instead
1031 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
1036 * @brief Get the icon of the hoversel button
1038 * @param obj The hoversel object
1039 * @return The icon object
1041 * Get the icon of the button that is always visible (before it is clicked
1042 * and expanded). Also see elm_object_content_get() for the button widget.
1044 * @see elm_hoversel_icon_set()
1045 * @deprecated Use elm_object_item_part_content_get() instead
1047 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
1052 * @brief Get and unparent the icon of the hoversel button
1054 * @param obj The hoversel object
1055 * @return The icon object that was being used
1057 * Unparent and return the icon of the button that is always visible
1058 * (before it is clicked and expanded).
1060 * @see elm_hoversel_icon_set()
1061 * @see elm_object_content_unset() for the button widget
1062 * @deprecated Use elm_object_item_part_content_unset() instead
1064 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
1069 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
1070 * that will be passed to associated function callbacks.
1072 * @param it The item to get the data from
1073 * @return The data pointer set with elm_hoversel_item_add()
1075 * @see elm_hoversel_item_add()
1076 * @deprecated Use elm_object_item_data_get() instead
1078 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
1083 * @brief This returns the label text of the given hoversel item.
1085 * @param it The item to get the label
1086 * @return The label text of the hoversel item
1088 * @see elm_hoversel_item_add()
1089 * @deprecated Use elm_object_item_text_get() instead
1091 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
1096 * @brief Set the function to be called when an item from the hoversel is
1099 * @param it The item to set the callback on
1100 * @param func The function called
1102 * That function will receive these parameters:
1103 * @li void * item data
1104 * @li Evas_Object * hoversel object
1105 * @li Elm_Object_Item * hoversel item
1107 * @see elm_hoversel_item_add()
1108 * @deprecated Use elm_object_item_del_cb_set() instead
1110 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1115 * @brief Delete an item from the hoversel
1117 * @param it The item to delete
1119 * This deletes the item from the hoversel (should not be called while the
1120 * hoversel is active; use elm_hoversel_expanded_get() to check first).
1122 * @deprecated Use elm_object_item_del() instead
1123 * @see elm_hoversel_item_add()
1125 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
1130 * Set actionslider labels.
1132 * @param obj The actionslider object
1133 * @param left_label The label to be set on the left.
1134 * @param center_label The label to be set on the center.
1135 * @param right_label The label to be set on the right.
1136 * @deprecated use elm_object_text_set() instead.
1138 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
1143 * Get actionslider labels.
1145 * @param obj The actionslider object
1146 * @param left_label A char** to place the left_label of @p obj into.
1147 * @param center_label A char** to place the center_label of @p obj into.
1148 * @param right_label A char** to place the right_label of @p obj into.
1149 * @deprecated use elm_object_text_set() instead.
1151 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
1156 * Set the label used on the indicator.
1158 * @param obj The actionslider object
1159 * @param label The label to be set on the indicator.
1160 * @deprecated use elm_object_text_set() instead.
1162 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
1167 * Get the label used on the indicator object.
1169 * @param obj The actionslider object
1170 * @return The indicator label
1171 * @deprecated use elm_object_text_get() instead.
1173 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
1178 * Set the overlay object used for the background object.
1180 * @param obj The bg object
1181 * @param overlay The overlay object
1183 * This provides a way for elm_bg to have an 'overlay' that will be on top
1184 * of the bg. Once the over object is set, a previously set one will be
1185 * deleted, even if you set the new one to NULL. If you want to keep that
1186 * old content object, use the elm_bg_overlay_unset() function.
1188 * @deprecated use elm_object_part_content_set() instead
1193 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
1198 * Get the overlay object used for the background object.
1200 * @param obj The bg object
1201 * @return The content that is being used
1203 * Return the content object which is set for this widget
1205 * @deprecated use elm_object_part_content_get() instead
1209 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
1214 * Get the overlay object used for the background object.
1216 * @param obj The bg object
1217 * @return The content that was being used
1219 * Unparent and return the overlay object which was set for this widget
1221 * @deprecated use elm_object_part_content_unset() instead
1225 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
1231 * Set the label of the bubble
1233 * @param obj The bubble object
1234 * @param label The string to set in the label
1236 * This function sets the title of the bubble. Where this appears depends on
1237 * the selected corner.
1238 * @deprecated use elm_object_text_set() instead.
1240 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
1245 * Get the label of the bubble
1247 * @param obj The bubble object
1248 * @return The string of set in the label
1250 * This function gets the title of the bubble.
1251 * @deprecated use elm_object_text_get() instead.
1253 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
1258 * Set the info of the bubble
1260 * @param obj The bubble object
1261 * @param info The given info about the bubble
1263 * This function sets the info of the bubble. Where this appears depends on
1264 * the selected corner.
1265 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
1267 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
1272 * Get the info of the bubble
1274 * @param obj The bubble object
1276 * @return The "info" string of the bubble
1278 * This function gets the info text.
1279 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
1281 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
1286 * Set the content to be shown in the bubble
1288 * Once the content object is set, a previously set one will be deleted.
1289 * If you want to keep the old content object, use the
1290 * elm_bubble_content_unset() function.
1292 * @param obj The bubble object
1293 * @param content The given content of the bubble
1295 * This function sets the content shown on the middle of the bubble.
1297 * @deprecated use elm_object_content_set() instead
1300 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1305 * Get the content shown in the bubble
1307 * Return the content object which is set for this widget.
1309 * @param obj The bubble object
1310 * @return The content that is being used
1312 * @deprecated use elm_object_content_get() instead
1315 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1320 * Unset the content shown in the bubble
1322 * Unparent and return the content object which was set for this widget.
1324 * @param obj The bubble object
1325 * @return The content that was being used
1327 * @deprecated use elm_object_content_unset() instead
1330 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1335 * Set the icon of the bubble
1337 * Once the icon object is set, a previously set one will be deleted.
1338 * If you want to keep the old content object, use the
1339 * elm_icon_content_unset() function.
1341 * @param obj The bubble object
1342 * @param icon The given icon for the bubble
1344 * @deprecated use elm_object_part_content_set() instead
1347 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1352 * Get the icon of the bubble
1354 * @param obj The bubble object
1355 * @return The icon for the bubble
1357 * This function gets the icon shown on the top left of bubble.
1359 * @deprecated use elm_object_part_content_get() instead
1362 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1367 * Unset the icon of the bubble
1369 * Unparent and return the icon object which was set for this widget.
1371 * @param obj The bubble object
1372 * @return The icon that was being used
1374 * @deprecated use elm_object_part_content_unset() instead
1377 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1383 * Set the label used in the button
1385 * The passed @p label can be NULL to clean any existing text in it and
1386 * leave the button as an icon only object.
1388 * @param obj The button object
1389 * @param label The text will be written on the button
1390 * @deprecated use elm_object_text_set() instead.
1392 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1397 * Get the label set for the button
1399 * The string returned is an internal pointer and should not be freed or
1400 * altered. It will also become invalid when the button is destroyed.
1401 * The string returned, if not NULL, is a stringshare, so if you need to
1402 * keep it around even after the button is destroyed, you can use
1403 * eina_stringshare_ref().
1405 * @param obj The button object
1406 * @return The text set to the label, or NULL if nothing is set
1407 * @deprecated use elm_object_text_set() instead.
1409 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1414 * Set the icon used for the button
1416 * Setting a new icon will delete any other that was previously set, making
1417 * any reference to them invalid. If you need to maintain the previous
1418 * object alive, unset it first with elm_button_icon_unset().
1420 * @param obj The button object
1421 * @param icon The icon object for the button
1422 * @deprecated use elm_object_part_content_set() instead.
1424 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1429 * Get the icon used for the button
1431 * Return the icon object which is set for this widget. If the button is
1432 * destroyed or another icon is set, the returned object will be deleted
1433 * and any reference to it will be invalid.
1435 * @param obj The button object
1436 * @return The icon object that is being used
1438 * @deprecated use elm_object_part_content_get() instead
1440 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1445 * Remove the icon set without deleting it and return the object
1447 * This function drops the reference the button holds of the icon object
1448 * and returns this last object. It is used in case you want to remove any
1449 * icon, or set another one, without deleting the actual object. The button
1450 * will be left without an icon set.
1452 * @param obj The button object
1453 * @return The icon object that was being used
1454 * @deprecated use elm_object_part_content_unset() instead.
1456 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1461 * Set a day text color to the same that represents Saturdays.
1463 * @param obj The calendar object.
1464 * @param pos The text position. Position is the cell counter, from left
1465 * to right, up to down. It starts on 0 and ends on 41.
1467 * @deprecated use elm_calendar_mark_add() instead like:
1470 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1471 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1474 * @see elm_calendar_mark_add()
1478 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1483 * Set a day text color to the same that represents Sundays.
1485 * @param obj The calendar object.
1486 * @param pos The text position. Position is the cell counter, from left
1487 * to right, up to down. It starts on 0 and ends on 41.
1489 * @deprecated use elm_calendar_mark_add() instead like:
1492 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1493 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1496 * @see elm_calendar_mark_add()
1500 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1505 * Set a day text color to the same that represents Weekdays.
1507 * @param obj The calendar object
1508 * @param pos The text position. Position is the cell counter, from left
1509 * to right, up to down. It starts on 0 and ends on 41.
1511 * @deprecated use elm_calendar_mark_add() instead like:
1514 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1516 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1517 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1518 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1519 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1520 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1521 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1522 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1523 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1524 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1527 * @see elm_calendar_mark_add()
1531 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1537 * @brief Set the text label of the check object
1539 * @param obj The check object
1540 * @param label The text label string in UTF-8
1542 * @deprecated use elm_object_text_set() instead.
1544 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1549 * @brief Get the text label of the check object
1551 * @param obj The check object
1552 * @return The text label string in UTF-8
1554 * @deprecated use elm_object_text_get() instead.
1556 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1561 * @brief Set the icon object of the check object
1563 * @param obj The check object
1564 * @param icon The icon object
1566 * Once the icon object is set, a previously set one will be deleted.
1567 * If you want to keep that old content object, use the
1568 * elm_object_content_unset() function.
1570 * @deprecated use elm_object_part_content_set() instead.
1573 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1578 * @brief Get the icon object of the check object
1580 * @param obj The check object
1581 * @return The icon object
1583 * @deprecated use elm_object_part_content_get() instead.
1586 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1591 * @brief Unset the icon used for the check object
1593 * @param obj The check object
1594 * @return The icon object that was being used
1596 * Unparent and return the icon object which was set for this widget.
1598 * @deprecated use elm_object_part_content_unset() instead.
1601 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1606 * @brief Set the text label of the check object
1608 * @param obj The check object
1609 * @param label The text label string in UTF-8
1611 * @deprecated use elm_object_text_set() instead.
1613 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1618 * @brief Get the text label of the check object
1620 * @param obj The check object
1621 * @return The text label string in UTF-8
1623 * @deprecated use elm_object_text_get() instead.
1625 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1630 * @brief Set the icon object of the check object
1632 * @param obj The check object
1633 * @param icon The icon object
1635 * Once the icon object is set, a previously set one will be deleted.
1636 * If you want to keep that old content object, use the
1637 * elm_object_content_unset() function.
1639 * @deprecated use elm_object_part_content_set() instead.
1642 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1647 * @brief Get the icon object of the check object
1649 * @param obj The check object
1650 * @return The icon object
1652 * @deprecated use elm_object_part_content_get() instead.
1655 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1660 * @brief Unset the icon used for the check object
1662 * @param obj The check object
1663 * @return The icon object that was being used
1665 * Unparent and return the icon object which was set for this widget.
1667 * @deprecated use elm_object_part_content_unset() instead.
1670 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1672 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1673 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1679 * Set the content of the conformant widget.
1681 * @param obj The conformant object.
1682 * @param content The content to be displayed by the conformant.
1684 * Content will be sized and positioned considering the space required
1685 * to display a virtual keyboard. So it won't fill all the conformant
1686 * size. This way is possible to be sure that content won't resize
1687 * or be re-positioned after the keyboard is displayed.
1689 * Once the content object is set, a previously set one will be deleted.
1690 * If you want to keep that old content object, use the
1691 * elm_object_content_unset() function.
1693 * @see elm_object_content_unset()
1694 * @see elm_object_content_get()
1696 * @deprecated use elm_object_content_set() instead
1698 * @ingroup Conformant
1700 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1705 * Get the content of the conformant widget.
1707 * @param obj The conformant object.
1708 * @return The content that is being used.
1710 * Return the content object which is set for this widget.
1711 * It won't be unparent from conformant. For that, use
1712 * elm_object_content_unset().
1714 * @see elm_object_content_set().
1715 * @see elm_object_content_unset()
1717 * @deprecated use elm_object_content_get() instead
1719 * @ingroup Conformant
1721 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1726 * Unset the content of the conformant widget.
1728 * @param obj The conformant object.
1729 * @return The content that was being used.
1731 * Unparent and return the content object which was set for this widget.
1733 * @see elm_object_content_set().
1735 * @deprecated use elm_object_content_unset() instead
1737 * @ingroup Conformant
1739 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1744 * Get the side labels max length.
1746 * @deprecated use elm_diskselector_side_label_length_get() instead:
1748 * @param obj The diskselector object.
1749 * @return The max length defined for side labels, or 0 if not a valid
1752 * @ingroup Diskselector
1754 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1759 * Set the side labels max length.
1761 * @deprecated use elm_diskselector_side_label_length_set() instead:
1763 * @param obj The diskselector object.
1764 * @param len The max length defined for side labels.
1766 * @ingroup Diskselector
1768 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1773 * Get the data associated to the item.
1775 * @param it The diskselector item
1776 * @return The data associated to @p it
1778 * The return value is a pointer to data associated to @p item when it was
1779 * created, with function elm_diskselector_item_append(). If no data
1780 * was passed as argument, it will return @c NULL.
1782 * @see elm_diskselector_item_append()
1783 * @deprecated Use elm_object_item_data_get()
1785 * @ingroup Diskselector
1787 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1792 * Set the icon associated to the item.
1794 * @param it The diskselector item
1795 * @param icon The icon object to associate with @p it
1797 * The icon object to use at left side of the item. An
1798 * icon can be any Evas object, but usually it is an icon created
1799 * with elm_icon_add().
1801 * Once the icon object is set, a previously set one will be deleted.
1802 * @warning Setting the same icon for two items will cause the icon to
1803 * disappear from the first item.
1805 * If an icon was passed as argument on item creation, with function
1806 * elm_diskselector_item_append(), it will be already
1807 * associated to the item.
1809 * @see elm_diskselector_item_append()
1810 * @see elm_diskselector_item_icon_get()
1812 * @deprecated Use elm_object_item_part_content_set() instead
1813 * @ingroup Diskselector
1815 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1820 * Get the icon associated to the item.
1822 * @param it The diskselector item
1823 * @return The icon associated to @p it
1825 * The return value is a pointer to the icon associated to @p item when it was
1826 * created, with function elm_diskselector_item_append(), or later
1827 * with function elm_diskselector_item_icon_set. If no icon
1828 * was passed as argument, it will return @c NULL.
1830 * @see elm_diskselector_item_append()
1831 * @see elm_diskselector_item_icon_set()
1833 * @deprecated Use elm_object_item_part_content_set() instead
1834 * @ingroup Diskselector
1836 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1841 * Set the label of item.
1843 * @param it The item of diskselector.
1844 * @param label The label of item.
1846 * The label to be displayed by the item.
1848 * If no icon is set, label will be centered on item position, otherwise
1849 * the icon will be placed at left of the label, that will be shifted
1852 * An item with label "January" would be displayed on side position as
1853 * "Jan" if max length is set to 3 with function
1854 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1857 * When this @p item is selected, the entire label will be displayed,
1858 * except for width restrictions.
1859 * In this case label will be cropped and "..." will be concatenated,
1860 * but only for display purposes. It will keep the entire string, so
1861 * if diskselector is resized the remaining characters will be displayed.
1863 * If a label was passed as argument on item creation, with function
1864 * elm_diskselector_item_append(), it will be already
1865 * displayed by the item.
1867 * @see elm_diskselector_side_label_length_set()
1868 * @see elm_diskselector_item_label_get()
1869 * @see elm_diskselector_item_append()
1871 * @deprecated Use elm_object_item_text_set() instead
1872 * @ingroup Diskselector
1874 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1879 * Get the label of item.
1881 * @param it The item of diskselector.
1882 * @return The label of item.
1884 * The return value is a pointer to the label associated to @p item when it was
1885 * created, with function elm_diskselector_item_append(), or later
1886 * with function elm_diskselector_item_label_set. If no label
1887 * was passed as argument, it will return @c NULL.
1889 * @see elm_diskselector_item_label_set() for more details.
1890 * @see elm_diskselector_item_append()
1891 * @deprecated Use elm_object_item_text_get() instead
1893 * @ingroup Diskselector
1895 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1900 * Set the function called when a diskselector item is freed.
1902 * @param it The item to set the callback on
1903 * @param func The function called
1905 * If there is a @p func, then it will be called prior item's memory release.
1906 * That will be called with the following arguments:
1908 * @li item's Evas object;
1911 * This way, a data associated to a diskselector item could be properly
1913 * @deprecated Use elm_object_item_del_cb_set() instead
1915 * @ingroup Diskselector
1917 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1922 * Delete them item from the diskselector.
1924 * @param it The item of diskselector to be deleted.
1926 * If deleting all diskselector items is required, elm_diskselector_clear()
1927 * should be used instead of getting items list and deleting each one.
1929 * @deprecated Use elm_object_item_del() instead
1930 * @see elm_diskselector_clear()
1931 * @see elm_diskselector_item_append()
1933 * @ingroup Diskselector
1935 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1940 * Set the text to be shown in the diskselector item.
1942 * @param it Target item
1943 * @param text The text to set in the content
1945 * Setup the text as tooltip to object. The item can have only one tooltip,
1946 * so any previous tooltip data is removed.
1948 * @deprecated Use elm_object_item_tooltip_text_set() instead
1949 * @see elm_object_tooltip_text_set() for more details.
1951 * @ingroup Diskselector
1953 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1958 * Set the content to be shown in the tooltip item.
1960 * Setup the tooltip to item. The item can have only one tooltip,
1961 * so any previous tooltip data is removed. @p func(with @p data) will
1962 * be called every time that need show the tooltip and it should
1963 * return a valid Evas_Object. This object is then managed fully by
1964 * tooltip system and is deleted when the tooltip is gone.
1966 * @param it the diskselector item being attached a tooltip.
1967 * @param func the function used to create the tooltip contents.
1968 * @param data what to provide to @a func as callback data/context.
1969 * @param del_cb called when data is not needed anymore, either when
1970 * another callback replaces @p func, the tooltip is unset with
1971 * elm_diskselector_item_tooltip_unset() or the owner @a item
1972 * dies. This callback receives as the first parameter the
1973 * given @a data, and @p event_info is the item.
1975 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1976 * @see elm_object_tooltip_content_cb_set() for more details.
1978 * @ingroup Diskselector
1980 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);
1985 * Unset tooltip from item.
1987 * @param it diskselector item to remove previously set tooltip.
1989 * Remove tooltip from item. The callback provided as del_cb to
1990 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1991 * it is not used anymore.
1993 * @deprecated Use elm_object_item_tooltip_unset() instead
1994 * @see elm_object_tooltip_unset() for more details.
1995 * @see elm_diskselector_item_tooltip_content_cb_set()
1997 * @ingroup Diskselector
1999 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
2004 * Sets a different style for this item tooltip.
2006 * @note before you set a style you should define a tooltip with
2007 * elm_diskselector_item_tooltip_content_cb_set() or
2008 * elm_diskselector_item_tooltip_text_set()
2010 * @param it diskselector item with tooltip already set.
2011 * @param style the theme style to use (default, transparent, ...)
2013 * @deprecated Use elm_object_item_tooltip_style_set() instead
2014 * @see elm_object_tooltip_style_set() for more details.
2016 * @ingroup Diskselector
2018 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
2023 * Get the style for this item tooltip.
2025 * @param it diskselector item with tooltip already set.
2026 * @return style the theme style in use, defaults to "default". If the
2027 * object does not have a tooltip set, then NULL is returned.
2029 * @deprecated Use elm_object_item_tooltip_style_get() instead
2030 * @see elm_object_tooltip_style_get() for more details.
2031 * @see elm_diskselector_item_tooltip_style_set()
2033 * @ingroup Diskselector
2035 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
2040 * Set the cursor to be shown when mouse is over the diskselector item
2042 * @param it Target item
2043 * @param cursor the cursor name to be used.
2045 * @see elm_object_cursor_set() for more details.
2046 * @deprecated Use elm_object_item_cursor_set() instead
2048 * @ingroup Diskselector
2050 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
2055 * Get the cursor to be shown when mouse is over the diskselector item
2057 * @param it diskselector item with cursor already set.
2058 * @return the cursor name.
2060 * @see elm_object_cursor_get() for more details.
2061 * @see elm_diskselector_item_cursor_set()
2062 * @deprecated Use elm_object_item_cursor_get() instead
2064 * @ingroup Diskselector
2066 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
2071 * Unset the cursor to be shown when mouse is over the diskselector item
2073 * @param it Target item
2075 * @see elm_object_cursor_unset() for more details.
2076 * @see elm_diskselector_item_cursor_set()
2077 * @deprecated use elm_object_item_cursor_unset() instead
2079 * @ingroup Diskselector
2081 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
2086 * Sets a different style for this item cursor.
2088 * @note before you set a style you should define a cursor with
2089 * elm_diskselector_item_cursor_set()
2091 * @param it diskselector item with cursor already set.
2092 * @param style the theme style to use (default, transparent, ...)
2094 * @see elm_object_cursor_style_set() for more details.
2095 * @deprecated Use elm_object_item_cursor_style_set() instead
2097 * @ingroup Diskselector
2099 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
2104 * Get the style for this item cursor.
2106 * @param it diskselector item with cursor already set.
2107 * @return style the theme style in use, defaults to "default". If the
2108 * object does not have a cursor set, then @c NULL is returned.
2110 * @see elm_object_cursor_style_get() for more details.
2111 * @see elm_diskselector_item_cursor_style_set()
2112 * @deprecated Use elm_object_item_cursor_style_get() instead
2114 * @ingroup Diskselector
2116 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
2121 * Set if the cursor set should be searched on the theme or should use
2122 * the provided by the engine, only.
2124 * @note before you set if should look on theme you should define a cursor
2125 * with elm_diskselector_item_cursor_set().
2126 * By default it will only look for cursors provided by the engine.
2128 * @param it widget item with cursor already set.
2129 * @param engine_only boolean to define if cursors set with
2130 * elm_diskselector_item_cursor_set() should be searched only
2131 * between cursors provided by the engine or searched on widget's
2134 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
2136 * @ingroup Diskselector
2138 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
2143 * Get the cursor engine only usage for this item cursor.
2145 * @param it widget item with cursor already set.
2146 * @return engine_only boolean to define it cursors should be looked only
2147 * between the provided by the engine or searched on widget's theme as well.
2148 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
2150 * @see elm_diskselector_item_cursor_engine_only_set()
2151 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
2153 * @ingroup Diskselector
2155 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
2157 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
2158 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
2163 * Get the label of a given flip selector widget's item.
2165 * @param it The item to get label from
2166 * @return The text label of @p item or @c NULL, on errors
2168 * @see elm_object_item_text_set()
2170 * @deprecated see elm_object_item_text_get() instead
2171 * @ingroup Flipselector
2173 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
2178 * Set the label of a given flip selector widget's item.
2180 * @param it The item to set label on
2181 * @param label The text label string, in UTF-8 encoding
2183 * @see elm_object_item_text_get()
2185 * @deprecated see elm_object_item_text_set() instead
2186 * @ingroup Flipselector
2188 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
2193 * Delete a given item from a flip selector widget.
2195 * @param it The item to delete
2197 * @deprecated Use elm_object_item_del() instead
2198 * @ingroup Flipselector
2200 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
2205 * Set the interval on time updates for a user mouse button hold
2206 * on a flip selector widget.
2208 * @param obj The flip selector object
2209 * @param interval The (first) interval value in seconds
2211 * This interval value is @b decreased while the user holds the
2212 * mouse pointer either flipping up or flipping down a given flip
2215 * This helps the user to get to a given item distant from the
2216 * current one easier/faster, as it will start to flip quicker and
2217 * quicker on mouse button holds.
2219 * The calculation for the next flip interval value, starting from
2220 * the one set with this call, is the previous interval divided by
2221 * 1.05, so it decreases a little bit.
2223 * The default starting interval value for automatic flips is
2226 * @see elm_flipselector_interval_get()
2227 * @deprecated Use elm_flipselector_first_interval_set()
2229 * @ingroup Flipselector
2231 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
2236 * Get the interval on time updates for an user mouse button hold
2237 * on a flip selector widget.
2239 * @param obj The flip selector object
2240 * @return The (first) interval value, in seconds, set on it
2242 * @see elm_flipselector_interval_set() for more details
2243 * @deprecated Use elm_flipselector_first_interval_get()
2245 * @ingroup Flipselector
2247 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
2252 * Make a given Elementary object the focused one.
2254 * @param obj The Elementary object to make focused.
2256 * @note This object, if it can handle focus, will take the focus
2257 * away from the one who had it previously and will, for now on, be
2258 * the one receiving input events.
2260 * @see elm_object_focus_get()
2261 * @deprecated use elm_object_focus_set() instead.
2265 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
2270 * Give focus to next object in object tree.
2272 * Give focus to next object in focus chain of one object sub-tree.
2273 * If the last object of chain already have focus, the focus will go to the
2274 * first object of chain.
2276 * @param obj The object root of sub-tree
2277 * @param dir Direction to cycle the focus
2279 * @deprecated Use elm_object_focus_next() instead
2283 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
2288 * Remove the focus from an Elementary object
2290 * @param obj The Elementary to take focus from
2292 * This removes the focus from @p obj, passing it back to the
2293 * previous element in the focus chain list.
2295 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
2296 * @deprecated use elm_object_focus_set() instead.
2300 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
2305 * Give focus to near object in one direction.
2307 * Give focus to near object in direction of one object.
2308 * If none focusable object in given direction, the focus will not change.
2310 * @param obj The reference object
2311 * @param x Horizontal component of direction to focus
2312 * @param y Vertical component of direction to focus
2314 * @deprecated Support it later.
2317 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
2322 * @brief Set the frame label
2324 * @param obj The frame object
2325 * @param label The label of this frame object
2327 * @deprecated use elm_object_text_set() instead.
2329 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
2334 * @brief Get the frame label
2336 * @param obj The frame object
2338 * @return The label of this frame object or NULL if unable to get frame
2340 * @deprecated use elm_object_text_get() instead.
2342 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
2347 * @brief Set the content of the frame widget
2349 * Once the content object is set, a previously set one will be deleted.
2350 * If you want to keep that old content object, use the
2351 * elm_frame_content_unset() function.
2353 * @param obj The frame object
2354 * @param content The content will be filled in this frame object
2356 * @deprecated use elm_object_content_set() instead.
2358 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
2363 * @brief Get the content of the frame widget
2365 * Return the content object which is set for this widget
2367 * @param obj The frame object
2368 * @return The content that is being used
2370 * @deprecated use elm_object_content_get() instead.
2372 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
2377 * @brief Unset the content of the frame widget
2379 * Unparent and return the content object which was set for this widget
2381 * @param obj The frame object
2382 * @return The content that was being used
2384 * @deprecated use elm_object_content_unset() instead.
2386 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
2388 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
2389 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
2390 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
2394 * This sets the horizontal stretching mode.
2396 * @param obj The genlist object
2397 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
2399 * This sets the mode used for sizing items horizontally. Valid modes
2400 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
2401 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
2402 * the scroller will scroll horizontally. Otherwise items are expanded
2403 * to fill the width of the viewport of the scroller. If it is
2404 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
2405 * limited to that size.
2407 * @see elm_genlist_horizontal_get()
2409 * @deprecated use elm_genlist_mode_set()
2412 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
2417 * Get the horizontal stretching mode.
2419 * @param obj The genlist object
2420 * @return The mode to use
2421 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
2423 * @see elm_genlist_horizontal_set()
2425 * @deprecated use elm_genlist_mode_get()
2428 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
2433 * Return the data associated to a given genlist item
2435 * @param it The genlist item.
2436 * @return the data associated to this item.
2438 * This returns the @c data value passed on the
2439 * elm_genlist_item_append() and related item addition calls.
2441 * @see elm_genlist_item_append()
2442 * @see elm_genlist_item_data_set()
2444 * @deprecated Use elm_object_item_data_get() instead
2447 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2452 * Set the data associated to a given genlist item
2454 * @param it The genlist item
2455 * @param data The new data pointer to set on it
2457 * This @b overrides the @c data value passed on the
2458 * elm_genlist_item_append() and related item addition calls. This
2459 * function @b won't call elm_genlist_item_update() automatically,
2460 * so you'd issue it afterwards if you want to hove the item
2461 * updated to reflect the that new data.
2463 * @see elm_genlist_item_data_get()
2465 * @deprecated Use elm_object_item_data_set() instead
2468 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2473 * Set whether a given genlist item is disabled or not.
2475 * @param it The item
2476 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2477 * to enable it back.
2479 * A disabled item cannot be selected or unselected. It will also
2480 * change its appearance, to signal the user it's disabled.
2482 * @see elm_genlist_item_disabled_get()
2483 * @deprecated Use elm_object_item_disabled_set() instead
2487 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2492 * Get whether a given genlist item is disabled or not.
2494 * @param it The item
2495 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2498 * @see elm_genlist_item_disabled_set() for more details
2499 * @deprecated Use elm_object_item_disabled_get() instead
2503 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2508 * Remove a genlist item from the its parent, deleting it.
2510 * @param it The item to be removed.
2511 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2513 * @see elm_genlist_clear(), to remove all items in a genlist at
2516 * @deprecated Use elm_object_item_del() instead
2519 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2524 * Get the genlist object's handle which contains a given genlist
2527 * @param it The item to fetch the container from
2528 * @return The genlist (parent) object
2530 * This returns the genlist object itself that an item belongs to.
2531 * @deprecated Use elm_object_item_widget_get() instead
2535 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2540 * Get the mode item style of items in the genlist
2541 * @param obj The genlist object
2542 * @return The mode item style string, or NULL if none is specified
2544 * This is a constant string and simply defines the name of the
2545 * style that will be used for mode animations. It can be
2546 * @c NULL if you don't plan to use Genlist mode. See
2547 * elm_genlist_item_mode_set() for more info.
2551 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2556 * Set the mode item style of items in the genlist
2557 * @param obj The genlist object
2558 * @param style The mode item style string, or NULL if none is desired
2560 * This is a constant string and simply defines the name of the
2561 * style that will be used for mode animations. It can be
2562 * @c NULL if you don't plan to use Genlist mode. See
2563 * elm_genlist_item_mode_set() for more info.
2567 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2572 * Get the Item's Flags
2574 * @param it The genlist item
2575 * @return The item type.
2577 * This function returns the item's type. Normally the item's type.
2578 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2580 * @deprecated Use elm_genlist_item_type_get() instead
2583 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2588 * Tells genlist to "orphan" contents fetched by the item class
2590 * @param it The item
2592 * This instructs genlist to release references to contents in the item,
2593 * meaning that they will no longer be managed by genlist and are
2594 * floating "orphans" that can be re-used elsewhere if the user wants
2597 * @deprecated Use elm_genlist_item_all_contents_unset() instead
2599 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it);
2601 #define ELM_IMAGE_ROTATE_90_CW 1
2602 #define ELM_IMAGE_ROTATE_180_CW 2
2603 #define ELM_IMAGE_ROTATE_90_CCW 3
2608 * Return the data associated with a given index widget item
2610 * @param item The index widget item handle
2611 * @return The data associated with @p it
2612 * @deprecated Use elm_object_item_data_get() instead
2614 * @see elm_index_item_data_set()
2617 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2622 * Set the data associated with a given index widget item
2624 * @param it The index widget item handle
2625 * @param data The new data pointer to set to @p it
2627 * This sets new item data on @p it.
2629 * @warning The old data pointer won't be touched by this function, so
2630 * the user had better to free that old data himself/herself.
2632 * @deprecated Use elm_object_item_data_set() instead
2634 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2639 * Set the function to be called when a given index widget item is freed.
2641 * @param it The item to set the callback on
2642 * @param func The function to call on the item's deletion
2644 * When called, @p func will have both @c data and @p event_info
2645 * arguments with the @p it item's data value and, naturally, the
2646 * @c obj argument with a handle to the parent index widget.
2648 * @deprecated Use elm_object_item_del_cb_set() instead
2650 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2655 * Remove an item from a given index widget, <b>to be referenced by
2656 * it's data value</b>.
2658 * @param obj The index object
2659 * @param item The item to be removed from @p obj
2661 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2662 * that callback function will be called by this one.
2664 * @deprecated Use elm_object_item_del() instead
2666 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2671 * @brief Set the label on the label object
2673 * @param obj The label object
2674 * @param label The label will be used on the label object
2675 * @deprecated See elm_object_text_set()
2677 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2682 * @brief Get the label used on the label object
2684 * @param obj The label object
2685 * @return The string inside the label
2686 * @deprecated See elm_object_text_get()
2688 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2693 * @def elm_layout_label_set
2694 * Convenience macro to set the label in a layout that follows the
2695 * Elementary naming convention for its parts.
2697 * @deprecated use elm_object_text_set() instead.
2699 #define elm_layout_label_set(_ly, _txt) \
2700 elm_layout_text_set((_ly), "elm.text", (_txt))
2705 * @def elm_layout_label_get
2706 * Convenience macro to get the label in a layout that follows the
2707 * Elementary naming convention for its parts.
2709 * @deprecated use elm_object_text_set() instead.
2711 #define elm_layout_label_get(_ly) \
2712 elm_layout_text_get((_ly), "elm.text")
2714 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2720 * Set the content of the mapbuf.
2722 * @param obj The mapbuf object.
2723 * @param content The content that will be filled in this mapbuf object.
2725 * Once the content object is set, a previously set one will be deleted.
2726 * If you want to keep that old content object, use the
2727 * elm_mapbuf_content_unset() function.
2729 * To enable map, elm_mapbuf_enabled_set() should be used.
2731 * @deprecated use elm_object_content_set() instead
2734 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2739 * Get the content of the mapbuf.
2741 * @param obj The mapbuf object.
2742 * @return The content that is being used.
2744 * Return the content object which is set for this widget.
2746 * @see elm_mapbuf_content_set() for details.
2748 * @deprecated use elm_object_content_get() instead
2751 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2756 * Unset the content of the mapbuf.
2758 * @param obj The mapbuf object.
2759 * @return The content that was being used.
2761 * Unparent and return the content object which was set for this widget.
2763 * @see elm_mapbuf_content_set() for details.
2765 * @deprecated use elm_object_content_unset() instead
2768 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2773 * @brief Set the label of a menu item
2775 * @param it The menu item object.
2776 * @param label The label to set for @p item
2778 * @warning Don't use this function on items created with
2779 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2781 * @deprecated Use elm_object_item_text_set() instead
2783 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2788 * @brief Get the label of a menu item
2790 * @param it The menu item object.
2791 * @return The label of @p item
2792 * @deprecated Use elm_object_item_text_get() instead
2794 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2799 * @brief Set the content object of a menu item
2801 * @param it The menu item object
2802 * @param The content object or NULL
2803 * @return EINA_TRUE on success, else EINA_FALSE
2805 * Use this function to change the object swallowed by a menu item, deleting
2806 * any previously swallowed object.
2808 * @deprecated Use elm_object_item_content_set() instead
2810 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2815 * @brief Get the content object of a menu item
2817 * @param it The menu item object
2818 * @return The content object or NULL
2819 * @note If @p item was added with elm_menu_item_add_object, this
2820 * function will return the object passed, else it will return the
2823 * @see elm_menu_item_object_content_set()
2825 * @deprecated Use elm_object_item_content_get() instead
2827 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2832 * @brief Set the disabled state of @p item.
2834 * @param it The menu item object.
2835 * @param disabled The enabled/disabled state of the item
2836 * @deprecated Use elm_object_item_disabled_set() instead
2838 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2843 * @brief Get the disabled state of @p item.
2845 * @param it The menu item object.
2846 * @return The enabled/disabled state of the item
2848 * @see elm_menu_item_disabled_set()
2849 * @deprecated Use elm_object_item_disabled_get() instead
2851 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2856 * @brief Returns the data associated with menu item @p item.
2858 * @param it The item
2859 * @return The data associated with @p item or NULL if none was set.
2861 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2863 * @deprecated Use elm_object_item_data_get() instead
2865 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2870 * @brief Set the function called when a menu item is deleted.
2872 * @param it The item to set the callback on
2873 * @param func The function called
2875 * @see elm_menu_item_add()
2876 * @see elm_menu_item_del()
2877 * @deprecated Use elm_object_item_del_cb_set() instead
2879 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2884 * @brief Sets the data to be associated with menu item @p item.
2886 * @param it The item
2887 * @param data The data to be associated with @p item
2889 * @deprecated Use elm_object_item_data_set() instead
2891 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2896 * @brief Deletes an item from the menu.
2898 * @param it The item to delete.
2900 * @deprecated Use elm_object_item_del() instead
2901 * @see elm_menu_item_add()
2903 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2908 * @brief @brief Return a menu item's owner menu
2910 * @param it The menu item
2911 * @return The menu object owning @p item, or NULL on failure
2913 * Use this function to get the menu object owning an item.
2914 * @deprecated Use elm_object_item_widget_get() instead
2916 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2921 * @brief Set the icon of a menu item to the standard icon with name @p icon
2923 * @param it The menu item object.
2924 * @param icon The icon object to set for the content of @p item
2926 * @deprecated elm_menu_item_icon_name_set() instead
2927 * Once this icon is set, any previously set icon will be deleted.
2929 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2934 * @brief Get the string representation from the icon of a menu item
2936 * @param it The menu item object.
2937 * @return The string representation of @p item's icon or NULL
2939 * @deprecated elm_menu_item_icon_name_get() instead
2940 * @see elm_menu_item_icon_name_set()
2942 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2947 * @brief Set the content of the notify widget
2949 * @param obj The notify object
2950 * @param content The content will be filled in this notify object
2952 * Once the content object is set, a previously set one will be deleted. If
2953 * you want to keep that old content object, use the
2954 * elm_notify_content_unset() function.
2956 * @deprecated use elm_object_content_set() instead
2959 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2964 * @brief Unset the content of the notify widget
2966 * @param obj The notify object
2967 * @return The content that was being used
2969 * Unparent and return the content object which was set for this widget
2971 * @see elm_notify_content_set()
2972 * @deprecated use elm_object_content_unset() instead
2975 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2980 * @brief Return the content of the notify widget
2982 * @param obj The notify object
2983 * @return The content that is being used
2985 * @see elm_notify_content_set()
2986 * @deprecated use elm_object_content_get() instead
2989 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2994 * Set a label of an object
2996 * @param obj The Elementary object
2997 * @param part The text part name to set (NULL for the default label)
2998 * @param label The new text of the label
3000 * @note Elementary objects may have many labels (e.g. Action Slider)
3001 * @deprecated Use elm_object_part_text_set() instead.
3003 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
3008 * Get a label of an object
3010 * @param obj The Elementary object
3011 * @param part The text part name to get (NULL for the default label)
3012 * @return text of the label or NULL for any error
3014 * @note Elementary objects may have many labels (e.g. Action Slider)
3015 * @deprecated Use elm_object_part_text_get() instead.
3017 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
3022 * Set a content of an object
3024 * @param obj The Elementary object
3025 * @param part The content part name to set (NULL for the default content)
3026 * @param content The new content of the object
3028 * @note Elementary objects may have many contents
3029 * @deprecated Use elm_object_part_content_set instead.
3031 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
3036 * Get a content of an object
3038 * @param obj The Elementary object
3039 * @param part The content part name to get (NULL for the default content)
3040 * @return content of the object or NULL for any error
3042 * @note Elementary objects may have many contents
3043 * @deprecated Use elm_object_part_content_get instead.
3045 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
3050 * Unset a content of an object
3052 * @param obj The Elementary object
3053 * @param part The content part name to unset (NULL for the default content)
3055 * @note Elementary objects may have many contents
3056 * @deprecated Use elm_object_part_content_unset instead.
3058 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
3063 * Set a content of an object item
3065 * @param it The Elementary object item
3066 * @param part The content part name to set (NULL for the default content)
3067 * @param content The new content of the object item
3069 * @note Elementary object items may have many contents
3070 * @deprecated Use elm_object_item_part_content_set instead.
3072 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
3077 * Get a content of an object item
3079 * @param it The Elementary object item
3080 * @param part The content part name to unset (NULL for the default content)
3081 * @return content of the object item or NULL for any error
3083 * @note Elementary object items may have many contents
3084 * @deprecated Use elm_object_item_part_content_get instead.
3086 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
3091 * Unset a content of an object item
3093 * @param it The Elementary object item
3094 * @param part The content part name to unset (NULL for the default content)
3096 * @note Elementary object items may have many contents
3097 * @deprecated Use elm_object_item_part_content_unset instead.
3099 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
3104 * Get a label of an object item
3106 * @param it The Elementary object item
3107 * @param part The text part name to get (NULL for the default label)
3108 * @return text of the label or NULL for any error
3110 * @note Elementary object items may have many labels
3111 * @deprecated Use elm_object_item_part_text_get instead.
3113 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
3118 * Set a label of an object item
3120 * @param it The Elementary object item
3121 * @param part The text part name to set (NULL for the default label)
3122 * @param label The new text of the label
3124 * @note Elementary object items may have many labels
3125 * @deprecated Use elm_object_item_part_text_set instead.
3127 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
3132 * @brief Set the content of the panel.
3134 * @param obj The panel object
3135 * @param content The panel content
3137 * Once the content object is set, a previously set one will be deleted.
3138 * If you want to keep that old content object, use the
3139 * elm_panel_content_unset() function.
3141 * @deprecated use elm_object_content_set() instead
3144 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
3149 * @brief Get the content of the panel.
3151 * @param obj The panel object
3152 * @return The content that is being used
3154 * Return the content object which is set for this widget.
3156 * @see elm_panel_content_set()
3158 * @deprecated use elm_object_content_get() instead
3161 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
3166 * @brief Unset the content of the panel.
3168 * @param obj The panel object
3169 * @return The content that was being used
3171 * Unparent and return the content object which was set for this widget.
3173 * @see elm_panel_content_set()
3175 * @deprecated use elm_object_content_unset() instead
3178 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
3183 * Set the left content of the panes widget.
3185 * @param obj The panes object.
3186 * @param content The new left content object.
3188 * Once the content object is set, a previously set one will be deleted.
3189 * If you want to keep that old content object, use the
3190 * elm_panes_content_left_unset() function.
3192 * If panes is displayed vertically, left content will be displayed at
3195 * @see elm_panes_content_left_get()
3196 * @see elm_panes_content_right_set() to set content on the other side.
3198 * @deprecated use elm_object_part_content_set() instead
3201 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
3206 * Set the right content of the panes widget.
3208 * @param obj The panes object.
3209 * @param content The new right content object.
3211 * Once the content object is set, a previously set one will be deleted.
3212 * If you want to keep that old content object, use the
3213 * elm_panes_content_right_unset() function.
3215 * If panes is displayed vertically, left content will be displayed at
3218 * @see elm_panes_content_right_get()
3219 * @see elm_panes_content_left_set() to set content on the other side.
3221 * @deprecated use elm_object_part_content_set() instead
3224 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
3229 * Get the left content of the panes.
3231 * @param obj The panes object.
3232 * @return The left content object that is being used.
3234 * Return the left content object which is set for this widget.
3236 * @see elm_panes_content_left_set() for details.
3238 * @deprecated use elm_object_part_content_get() instead
3241 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
3246 * Get the right content of the panes.
3248 * @param obj The panes object
3249 * @return The right content object that is being used
3251 * Return the right content object which is set for this widget.
3253 * @see elm_panes_content_right_set() for details.
3255 * @deprecated use elm_object_part_content_get() instead
3258 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
3263 * Unset the left content used for the panes.
3265 * @param obj The panes object.
3266 * @return The left content object that was being used.
3268 * Unparent and return the left content object which was set for this widget.
3270 * @see elm_panes_content_left_set() for details.
3271 * @see elm_panes_content_left_get().
3273 * @deprecated use elm_object_part_content_unset() instead
3276 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
3281 * Unset the right content used for the panes.
3283 * @param obj The panes object.
3284 * @return The right content object that was being used.
3286 * Unparent and return the right content object which was set for this
3289 * @see elm_panes_content_right_set() for details.
3290 * @see elm_panes_content_right_get().
3292 * @deprecated use elm_object_part_content_unset() instead
3295 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
3299 * Set the label of a given progress bar widget
3301 * @param obj The progress bar object
3302 * @param label The text label string, in UTF-8
3304 * @deprecated use elm_object_text_set() instead.
3306 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
3311 * Get the label of a given progress bar widget
3313 * @param obj The progressbar object
3314 * @return The text label string, in UTF-8
3316 * @deprecated use elm_object_text_set() instead.
3318 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
3323 * Set the icon object of a given progress bar widget
3325 * @param obj The progress bar object
3326 * @param icon The icon object
3328 * Use this call to decorate @p obj with an icon next to it.
3330 * @note Once the icon object is set, a previously set one will be
3331 * deleted. If you want to keep that old content object, use the
3332 * elm_progressbar_icon_unset() function.
3334 * @see elm_progressbar_icon_get()
3335 * @deprecated use elm_object_part_content_set() instead.
3338 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
3343 * Get the icon object set for a given progress bar widget
3345 * @param obj The progress bar object
3346 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3347 * otherwise (and on errors)
3349 * @see elm_progressbar_icon_set() for more details
3350 * @deprecated use elm_object_part_content_get() instead.
3353 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
3358 * Unset an icon set on a given progress bar widget
3360 * @param obj The progress bar object
3361 * @return The icon object that was being used, if any was set, or
3362 * @c NULL, otherwise (and on errors)
3364 * This call will unparent and return the icon object which was set
3365 * for this widget, previously, on success.
3367 * @see elm_progressbar_icon_set() for more details
3368 * @deprecated use elm_object_part_content_unset() instead.
3371 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
3376 * @brief Set the text label of the radio object
3378 * @param obj The radio object
3379 * @param label The text label string in UTF-8
3381 * @deprecated use elm_object_text_set() instead.
3383 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
3388 * @brief Get the text label of the radio object
3390 * @param obj The radio object
3391 * @return The text label string in UTF-8
3393 * @deprecated use elm_object_text_set() instead.
3395 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
3400 * @brief Set the icon object of the radio object
3402 * @param obj The radio object
3403 * @param icon The icon object
3405 * Once the icon object is set, a previously set one will be deleted. If you
3406 * want to keep that old content object, use the elm_radio_icon_unset()
3409 * @deprecated use elm_object_part_content_set() instead.
3412 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
3417 * @brief Get the icon object of the radio object
3419 * @param obj The radio object
3420 * @return The icon object
3422 * @see elm_radio_icon_set()
3424 * @deprecated use elm_object_part_content_get() instead.
3427 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
3432 * @brief Unset the icon used for the radio object
3434 * @param obj The radio object
3435 * @return The icon object that was being used
3437 * Unparent and return the icon object which was set for this widget.
3439 * @see elm_radio_icon_set()
3440 * @deprecated use elm_object_part_content_unset() instead.
3443 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
3448 * Set the label of a given slider widget
3450 * @param obj The progress bar object
3451 * @param label The text label string, in UTF-8
3453 * @deprecated use elm_object_text_set() instead.
3455 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
3460 * Get the label of a given slider widget
3462 * @param obj The progressbar object
3463 * @return The text label string, in UTF-8
3465 * @deprecated use elm_object_text_get() instead.
3467 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
3472 * Set the icon object of the slider object.
3474 * @param obj The slider object.
3475 * @param icon The icon object.
3477 * On horizontal mode, icon is placed at left, and on vertical mode,
3480 * @note Once the icon object is set, a previously set one will be deleted.
3481 * If you want to keep that old content object, use the
3482 * elm_slider_icon_unset() function.
3484 * @warning If the object being set does not have minimum size hints set,
3485 * it won't get properly displayed.
3487 * @deprecated use elm_object_part_content_set() instead.
3489 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3494 * Unset an icon set on a given slider widget.
3496 * @param obj The slider object.
3497 * @return The icon object that was being used, if any was set, or
3498 * @c NULL, otherwise (and on errors).
3500 * On horizontal mode, icon is placed at left, and on vertical mode,
3503 * This call will unparent and return the icon object which was set
3504 * for this widget, previously, on success.
3506 * @see elm_slider_icon_set() for more details
3507 * @see elm_slider_icon_get()
3508 * @deprecated use elm_object_part_content_unset() instead.
3511 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3516 * Get the icon object set for a given slider widget.
3518 * @param obj The slider object.
3519 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3520 * otherwise (and on errors).
3522 * On horizontal mode, icon is placed at left, and on vertical mode,
3525 * @see elm_slider_icon_set() for more details
3526 * @see elm_slider_icon_unset()
3528 * @deprecated use elm_object_part_content_get() instead.
3531 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3536 * Set the end object of the slider object.
3538 * @param obj The slider object.
3539 * @param end The end object.
3541 * On horizontal mode, end is placed at left, and on vertical mode,
3544 * @note Once the icon object is set, a previously set one will be deleted.
3545 * If you want to keep that old content object, use the
3546 * elm_slider_end_unset() function.
3548 * @warning If the object being set does not have minimum size hints set,
3549 * it won't get properly displayed.
3551 * @deprecated use elm_object_part_content_set() instead.
3554 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3559 * Unset an end object set on a given slider widget.
3561 * @param obj The slider object.
3562 * @return The end object that was being used, if any was set, or
3563 * @c NULL, otherwise (and on errors).
3565 * On horizontal mode, end is placed at left, and on vertical mode,
3568 * This call will unparent and return the icon object which was set
3569 * for this widget, previously, on success.
3571 * @see elm_slider_end_set() for more details.
3572 * @see elm_slider_end_get()
3574 * @deprecated use elm_object_part_content_unset() instead
3578 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3583 * Get the end object set for a given slider widget.
3585 * @param obj The slider object.
3586 * @return The end object's handle, if @p obj had one set, or @c NULL,
3587 * otherwise (and on errors).
3589 * On horizontal mode, icon is placed at right, and on vertical mode,
3592 * @see elm_slider_end_set() for more details.
3593 * @see elm_slider_end_unset()
3596 * @deprecated use elm_object_part_content_get() instead
3600 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3605 * Return the data associated with a given slideshow item
3607 * @param it The slideshow item
3608 * @return Returns the data associated to this item
3610 * @deprecated use elm_object_item_data_get() instead
3612 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3617 * Delete a given item from a slideshow widget.
3619 * @param it The slideshow item
3621 * @deprecated Use elm_object_item_de() instead
3623 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
3628 * Display a given slideshow widget's item, programmatically.
3630 * @param it The item to display on @p obj's viewport
3632 * The change between the current item and @p item will use the
3633 * transition @p obj is set to use (@see
3634 * elm_slideshow_transition_set()).
3636 * @deprecated use elm_slideshow_item_show() instead
3638 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
3643 * Get the toolbar object from an item.
3645 * @param it The item.
3646 * @return The toolbar object.
3648 * This returns the toolbar object itself that an item belongs to.
3650 * @deprecated use elm_object_item_widget_get() instead.
3652 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3657 * Get the label of item.
3659 * @param it The item of toolbar.
3660 * @return The label of item.
3662 * The return value is a pointer to the label associated to @p item when
3663 * it was created, with function elm_toolbar_item_append() or similar,
3665 * with function elm_toolbar_item_label_set. If no label
3666 * was passed as argument, it will return @c NULL.
3668 * @see elm_toolbar_item_label_set() for more details.
3669 * @see elm_toolbar_item_append()
3671 * @deprecated use elm_object_item_text_get() instead.
3673 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3678 * Set the label of item.
3680 * @param it The item of toolbar.
3681 * @param label The label of item.
3683 * The label to be displayed by the item.
3684 * Label will be placed at icons bottom (if set).
3686 * If a label was passed as argument on item creation, with function
3687 * elm_toolbar_item_append() or similar, it will be already
3688 * displayed by the item.
3690 * @see elm_toolbar_item_label_get()
3691 * @see elm_toolbar_item_append()
3693 * @deprecated use elm_object_item_text_set() instead
3695 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3700 * Return the data associated with a given toolbar widget item.
3702 * @param it The toolbar widget item handle.
3703 * @return The data associated with @p item.
3705 * @see elm_toolbar_item_data_set()
3707 * @deprecated use elm_object_item_data_get() instead.
3709 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3714 * Set the data associated with a given toolbar widget item.
3716 * @param it The toolbar widget item handle
3717 * @param data The new data pointer to set to @p item.
3719 * This sets new item data on @p item.
3721 * @warning The old data pointer won't be touched by this function, so
3722 * the user had better to free that old data himself/herself.
3724 * @deprecated use elm_object_item_data_set() instead.
3726 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3731 * Get a value whether toolbar item is disabled or not.
3733 * @param it The item.
3734 * @return The disabled state.
3736 * @see elm_toolbar_item_disabled_set() for more details.
3738 * @deprecated use elm_object_item_disabled_get() instead.
3740 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3745 * Sets the disabled/enabled state of a toolbar item.
3747 * @param it The item.
3748 * @param disabled The disabled state.
3750 * A disabled item cannot be selected or unselected. It will also
3751 * change its appearance (generally greyed out). This sets the
3752 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3755 * @deprecated use elm_object_item_disabled_set() instead.
3757 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3762 * Change a toolbar's orientation
3763 * @param obj The toolbar object
3764 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3765 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3766 * @deprecated use elm_toolbar_horizontal_set() instead.
3768 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3773 * Get a toolbar's orientation
3774 * @param obj The toolbar object
3775 * @return If @c EINA_TRUE, the toolbar is vertical
3776 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3777 * @deprecated use elm_toolbar_horizontal_get() instead.
3779 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3784 * Set the function called when a toolbar item is freed.
3786 * @param it The item to set the callback on.
3787 * @param func The function called.
3789 * If there is a @p func, then it will be called prior item's memory release.
3790 * That will be called with the following arguments:
3792 * @li item's Evas object;
3795 * This way, a data associated to a toolbar item could be properly freed.
3797 * @deprecated Use elm_object_item_del_cb_set() instead
3799 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3804 * Delete them item from the toolbar.
3806 * @param it The item of toolbar to be deleted.
3808 * @deprecated Use elm_object_item_del() instead
3809 * @see elm_toolbar_item_append()
3812 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3817 * Set the content to be shown in the tooltip item.
3819 * Setup the tooltip to item. The item can have only one tooltip,
3820 * so any previous tooltip data is removed. @p func(with @p data) will
3821 * be called every time that need show the tooltip and it should
3822 * return a valid Evas_Object. This object is then managed fully by
3823 * tooltip system and is deleted when the tooltip is gone.
3825 * @param it the toolbar item being attached a tooltip.
3826 * @param func the function used to create the tooltip contents.
3827 * @param data what to provide to @a func as callback data/context.
3828 * @param del_cb called when data is not needed anymore, either when
3829 * another callback replaces @a func, the tooltip is unset with
3830 * elm_toolbar_item_tooltip_unset() or the owner @a item
3831 * dies. This callback receives as the first parameter the
3832 * given @a data, and @p event_info is the item.
3834 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3835 * @see elm_object_tooltip_content_cb_set() for more details.
3838 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);
3843 * Unset tooltip from item.
3845 * @param it toolbar item to remove previously set tooltip.
3847 * Remove tooltip from item. The callback provided as del_cb to
3848 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3849 * it is not used anymore.
3851 * @deprecated Use elm_object_item_tooltip_unset() instead
3852 * @see elm_object_tooltip_unset() for more details.
3853 * @see elm_toolbar_item_tooltip_content_cb_set()
3856 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3861 * Sets a different style for this item tooltip.
3863 * @note before you set a style you should define a tooltip with
3864 * elm_toolbar_item_tooltip_content_cb_set() or
3865 * elm_toolbar_item_tooltip_text_set()
3867 * @param it toolbar item with tooltip already set.
3868 * @param style the theme style to use (default, transparent, ...)
3870 * @deprecated Use elm_object_item_tooltip_style_set() instead
3871 * @see elm_object_tooltip_style_set() for more details.
3874 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3879 * Get the style for this item tooltip.
3881 * @param it toolbar item with tooltip already set.
3882 * @return style the theme style in use, defaults to "default". If the
3883 * object does not have a tooltip set, then NULL is returned.
3885 * @deprecated Use elm_object_item_style_get() instead
3886 * @see elm_object_tooltip_style_get() for more details.
3887 * @see elm_toolbar_item_tooltip_style_set()
3890 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3895 * Set the type of mouse pointer/cursor decoration to be shown,
3896 * when the mouse pointer is over the given toolbar widget item
3898 * @param it toolbar item to customize cursor on
3899 * @param cursor the cursor type's name
3901 * This function works analogously as elm_object_cursor_set(), but
3902 * here the cursor's changing area is restricted to the item's
3903 * area, and not the whole widget's. Note that that item cursors
3904 * have precedence over widget cursors, so that a mouse over an
3905 * item with custom cursor set will always show @b that cursor.
3907 * If this function is called twice for an object, a previously set
3908 * cursor will be unset on the second call.
3910 * @see elm_object_cursor_set()
3911 * @see elm_toolbar_item_cursor_get()
3912 * @see elm_toolbar_item_cursor_unset()
3914 * @deprecated use elm_object_item_cursor_set() instead
3917 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3922 * Get the type of mouse pointer/cursor decoration set to be shown,
3923 * when the mouse pointer is over the given toolbar widget item
3925 * @param it toolbar item with custom cursor set
3926 * @return the cursor type's name or @c NULL, if no custom cursors
3927 * were set to @p item (and on errors)
3929 * @see elm_object_cursor_get()
3930 * @see elm_toolbar_item_cursor_set()
3931 * @see elm_toolbar_item_cursor_unset()
3933 * @deprecated Use elm_object_item_cursor_get() instead
3936 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3941 * Unset any custom mouse pointer/cursor decoration set to be
3942 * shown, when the mouse pointer is over the given toolbar widget
3943 * item, thus making it show the @b default cursor again.
3945 * @param it a toolbar item
3947 * Use this call to undo any custom settings on this item's cursor
3948 * decoration, bringing it back to defaults (no custom style set).
3950 * @see elm_object_cursor_unset()
3951 * @see elm_toolbar_item_cursor_set()
3953 * @deprecated Use elm_object_item_cursor_unset() instead
3956 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3961 * Set a different @b style for a given custom cursor set for a
3964 * @param it toolbar item with custom cursor set
3965 * @param style the <b>theme style</b> to use (e.g. @c "default",
3966 * @c "transparent", etc)
3968 * This function only makes sense when one is using custom mouse
3969 * cursor decorations <b>defined in a theme file</b>, which can have,
3970 * given a cursor name/type, <b>alternate styles</b> on it. It
3971 * works analogously as elm_object_cursor_style_set(), but here
3972 * applies only to toolbar item objects.
3974 * @warning Before you set a cursor style you should have defined a
3975 * custom cursor previously on the item, with
3976 * elm_toolbar_item_cursor_set()
3978 * @see elm_toolbar_item_cursor_engine_only_set()
3979 * @see elm_toolbar_item_cursor_style_get()
3981 * @deprecated Use elm_object_item_cursor_style_set() instead
3984 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3989 * Get the current @b style set for a given toolbar item's custom
3992 * @param it toolbar item with custom cursor set.
3993 * @return style the cursor style in use. If the object does not
3994 * have a cursor set, then @c NULL is returned.
3996 * @see elm_toolbar_item_cursor_style_set() for more details
3998 * @deprecated Use elm_object_item_cursor_style_get() instead
4001 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
4006 * Set if the (custom)cursor for a given toolbar item should be
4007 * searched in its theme, also, or should only rely on the
4010 * @param it item with custom (custom) cursor already set on
4011 * @param engine_only Use @c EINA_TRUE to have cursors looked for
4012 * only on those provided by the rendering engine, @c EINA_FALSE to
4013 * have them searched on the widget's theme, as well.
4015 * @note This call is of use only if you've set a custom cursor
4016 * for toolbar items, with elm_toolbar_item_cursor_set().
4018 * @note By default, cursors will only be looked for between those
4019 * provided by the rendering engine.
4021 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
4024 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
4029 * Get if the (custom) cursor for a given toolbar item is being
4030 * searched in its theme, also, or is only relying on the rendering
4033 * @param it a toolbar item
4034 * @return @c EINA_TRUE, if cursors are being looked for only on
4035 * those provided by the rendering engine, @c EINA_FALSE if they
4036 * are being searched on the widget's theme, as well.
4038 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
4040 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
4043 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
4048 * @brief Link a Elm_Payer with an Elm_Video object.
4050 * @param player the Elm_Player object.
4051 * @param video The Elm_Video object.
4053 * This mean that action on the player widget will affect the
4054 * video object and the state of the video will be reflected in
4055 * the player itself.
4057 * @see elm_player_add()
4058 * @see elm_video_add()
4059 * @deprecated use elm_object_part_content_set() instead
4062 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
4067 * Set the label of item.
4069 * @param it The item of segment control.
4070 * @param label The label of item.
4072 * The label to be displayed by the item.
4073 * Label will be at right of the icon (if set).
4075 * If a label was passed as argument on item creation, with function
4076 * elm_control_segment_item_add(), it will be already
4077 * displayed by the item.
4079 * @see elm_segment_control_item_label_get()
4080 * @see elm_segment_control_item_add()
4081 * @deprecated Use elm_object_item_text_set() instead
4084 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
4090 * Set the icon associated to the item.
4092 * @param it The segment control item.
4093 * @param icon The icon object to associate with @p it.
4095 * The icon object to use at left side of the item. An
4096 * icon can be any Evas object, but usually it is an icon created
4097 * with elm_icon_add().
4099 * Once the icon object is set, a previously set one will be deleted.
4100 * @warning Setting the same icon for two items will cause the icon to
4101 * disappear from the first item.
4103 * If an icon was passed as argument on item creation, with function
4104 * elm_segment_control_item_add(), it will be already
4105 * associated to the item.
4107 * @see elm_segment_control_item_add()
4108 * @see elm_segment_control_item_icon_get()
4109 * @deprecated Use elm_object_item_part_content_set() instead
4112 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
4117 * Remove a segment control item from its parent, deleting it.
4119 * @param it The item to be removed.
4121 * Items can be added with elm_segment_control_item_add() or
4122 * elm_segment_control_item_insert_at().
4124 * @deprecated Use elm_object_item_del() instead
4126 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
4133 * @param obj The multibuttonentry object
4134 * @return The label, or NULL if none
4136 * @deprecated Use elm_object_text_get() instead
4139 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
4146 * @param obj The multibuttonentry object
4147 * @param label The text label string
4149 * @deprecated Use elm_object_text_set() instead
4152 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
4157 * Get the label of a given item
4159 * @param it The item
4160 * @return The label of a given item, or NULL if none
4162 * @deprecated Use elm_object_item_text_get() instead
4165 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
4170 * Set the label of a given item
4172 * @param it The item
4173 * @param str The text label string
4175 * @deprecated Use elm_object_item_text_set() instead
4177 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
4182 * Delete a given item
4184 * @param it The item
4186 * @deprecated Use elm_object_item_del() instead
4189 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
4194 * @brief Delete the given item instantly.
4196 * @param it The naviframe item
4198 * This just deletes the given item from the naviframe item list instantly.
4199 * So this would not emit any signals for view transitions but just change
4200 * the current view if the given item is a top one.
4202 * @deprecated Use elm_object_item_del() instead
4204 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
4211 * Sets the disabled/enabled state of a list item.
4213 * @param it The item.
4214 * @param disabled The disabled state.
4216 * A disabled item cannot be selected or unselected. It will also
4217 * change its appearance (generally greyed out). This sets the
4218 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
4221 * @deprecated Use elm_object_item_disabled_set() instead
4224 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4229 * Get a value whether list item is disabled or not.
4231 * @param it The item.
4232 * @return The disabled state.
4234 * @see elm_list_item_disabled_set() for more details.
4236 * @deprecated Use elm_object_item_disabled_get() instead
4239 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
4244 * @brief Disable size restrictions on an object's tooltip
4245 * @param it The tooltip's anchor object
4246 * @param disable If EINA_TRUE, size restrictions are disabled
4247 * @return EINA_FALSE on failure, EINA_TRUE on success
4249 * This function allows a tooltip to expand beyond its parent window's canvas.
4250 * It will instead be limited only by the size of the display.
4252 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
4255 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
4260 * @brief Get size restriction state of an object's tooltip
4261 * @param obj The tooltip's anchor object
4262 * @return If EINA_TRUE, size restrictions are disabled
4264 * This function returns whether a tooltip is allowed to expand beyond
4265 * its parent window's canvas.
4266 * It will instead be limited only by the size of the display.
4268 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
4271 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
4276 * Set the function called when a list item is freed.
4278 * @param it The item to set the callback on
4279 * @param func The function called
4281 * If there is a @p func, then it will be called prior item's memory release.
4282 * That will be called with the following arguments:
4284 * @li item's Evas object;
4287 * This way, a data associated to a list item could be properly freed.
4289 * @deprecated Please use elm_object_item_del_cb_set() instead.
4292 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
4297 * Get the data associated to the item.
4299 * @param it The list item
4300 * @return The data associated to @p item
4302 * The return value is a pointer to data associated to @p item when it was
4303 * created, with function elm_list_item_append() or similar. If no data
4304 * was passed as argument, it will return @c NULL.
4306 * @see elm_list_item_append()
4308 * @deprecated Please use elm_object_item_data_get() instead.
4311 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
4316 * Get the left side icon associated to the item.
4318 * @param it The list item
4319 * @return The left side icon associated to @p item
4321 * The return value is a pointer to the icon associated to @p item when
4323 * created, with function elm_list_item_append() or similar, or later
4324 * with function elm_list_item_icon_set(). If no icon
4325 * was passed as argument, it will return @c NULL.
4327 * @see elm_list_item_append()
4328 * @see elm_list_item_icon_set()
4330 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
4332 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
4337 * Set the left side icon associated to the item.
4339 * @param it The list item
4340 * @param icon The left side icon object to associate with @p item
4342 * The icon object to use at left side of the item. An
4343 * icon can be any Evas object, but usually it is an icon created
4344 * with elm_icon_add().
4346 * Once the icon object is set, a previously set one will be deleted.
4347 * @warning Setting the same icon for two items will cause the icon to
4348 * disappear from the first item.
4350 * If an icon was passed as argument on item creation, with function
4351 * elm_list_item_append() or similar, it will be already
4352 * associated to the item.
4354 * @see elm_list_item_append()
4355 * @see elm_list_item_icon_get()
4357 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
4359 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
4364 * Get the right side icon associated to the item.
4366 * @param it The list item
4367 * @return The right side icon associated to @p item
4369 * The return value is a pointer to the icon associated to @p item when
4371 * created, with function elm_list_item_append() or similar, or later
4372 * with function elm_list_item_icon_set(). If no icon
4373 * was passed as argument, it will return @c NULL.
4375 * @see elm_list_item_append()
4376 * @see elm_list_item_icon_set()
4378 * @deprecated Please use elm_object_item_part_content_get(item, "end");
4380 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
4385 * Set the right side icon associated to the item.
4387 * @param it The list item
4388 * @param end The right side icon object to associate with @p item
4390 * The icon object to use at right side of the item. An
4391 * icon can be any Evas object, but usually it is an icon created
4392 * with elm_icon_add().
4394 * Once the icon object is set, a previously set one will be deleted.
4395 * @warning Setting the same icon for two items will cause the icon to
4396 * disappear from the first item.
4398 * If an icon was passed as argument on item creation, with function
4399 * elm_list_item_append() or similar, it will be already
4400 * associated to the item.
4402 * @see elm_list_item_append()
4403 * @see elm_list_item_end_get()
4405 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
4407 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
4412 * Get the label of item.
4414 * @param it The item of list.
4415 * @return The label of item.
4417 * The return value is a pointer to the label associated to @p item when
4418 * it was created, with function elm_list_item_append(), or later
4419 * with function elm_list_item_label_set. If no label
4420 * was passed as argument, it will return @c NULL.
4422 * @see elm_list_item_label_set() for more details.
4423 * @see elm_list_item_append()
4425 * @deprecated Please use elm_object_item_text_get(item);
4427 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
4432 * Set the label of item.
4434 * @param it The item of list.
4435 * @param text The label of item.
4437 * The label to be displayed by the item.
4438 * Label will be placed between left and right side icons (if set).
4440 * If a label was passed as argument on item creation, with function
4441 * elm_list_item_append() or similar, it will be already
4442 * displayed by the item.
4444 * @see elm_list_item_label_get()
4445 * @see elm_list_item_append()
4447 * @deprecated Please use elm_object_item_text_set(item, text);
4449 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
4454 * Set the text to be shown in a given list item's tooltips.
4456 * @param it Target item.
4457 * @param text The text to set in the content.
4459 * Setup the text as tooltip to object. The item can have only one tooltip,
4460 * so any previous tooltip data - set with this function or
4461 * elm_list_item_tooltip_content_cb_set() - is removed.
4463 * @deprecated Use elm_object_item_tooltip_text_set() instead
4464 * @see elm_object_tooltip_text_set() for more details.
4467 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
4472 * Set the content to be shown in the tooltip item.
4474 * Setup the tooltip to item. The item can have only one tooltip,
4475 * so any previous tooltip data is removed. @p func(with @p data) will
4476 * be called every time that need show the tooltip and it should
4477 * return a valid Evas_Object. This object is then managed fully by
4478 * tooltip system and is deleted when the tooltip is gone.
4480 * @param it the list item being attached a tooltip.
4481 * @param func the function used to create the tooltip contents.
4482 * @param data what to provide to @a func as callback data/context.
4483 * @param del_cb called when data is not needed anymore, either when
4484 * another callback replaces @a func, the tooltip is unset with
4485 * elm_list_item_tooltip_unset() or the owner @a item
4486 * dies. This callback receives as the first parameter the
4487 * given @a data, and @p event_info is the item.
4489 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
4491 * @see elm_object_tooltip_content_cb_set() for more details.
4494 EINA_DEPRECATED EAPI void elm_list_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
4499 * Unset tooltip from item.
4501 * @param it list item to remove previously set tooltip.
4503 * Remove tooltip from item. The callback provided as del_cb to
4504 * elm_list_item_tooltip_content_cb_set() will be called to notify
4505 * it is not used anymore.
4507 * @deprecated Use elm_object_item_tooltip_unset() instead
4508 * @see elm_object_tooltip_unset() for more details.
4509 * @see elm_list_item_tooltip_content_cb_set()
4512 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
4517 * Sets a different style for this item tooltip.
4519 * @note before you set a style you should define a tooltip with
4520 * elm_list_item_tooltip_content_cb_set() or
4521 * elm_list_item_tooltip_text_set()
4523 * @param it list item with tooltip already set.
4524 * @param style the theme style to use (default, transparent, ...)
4527 * @deprecated Use elm_object_item_tooltip_style_set() instead
4528 * @see elm_object_tooltip_style_set() for more details.
4531 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
4536 * Get the style for this item tooltip.
4538 * @param it list item with tooltip already set.
4539 * @return style the theme style in use, defaults to "default". If the
4540 * object does not have a tooltip set, then NULL is returned.
4542 * @deprecated Use elm_object_item_tooltip_style_get() instead
4544 * @see elm_object_tooltip_style_get() for more details.
4545 * @see elm_list_item_tooltip_style_set()
4548 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
4553 * Set the type of mouse pointer/cursor decoration to be shown,
4554 * when the mouse pointer is over the given list widget item
4556 * @param it list item to customize cursor on
4557 * @param cursor the cursor type's name
4559 * This function works analogously as elm_object_cursor_set(), but
4560 * here the cursor's changing area is restricted to the item's
4561 * area, and not the whole widget's. Note that that item cursors
4562 * have precedence over widget cursors, so that a mouse over an
4563 * item with custom cursor set will always show @b that cursor.
4565 * If this function is called twice for an object, a previously set
4566 * cursor will be unset on the second call.
4568 * @see elm_object_cursor_set()
4569 * @see elm_list_item_cursor_get()
4570 * @see elm_list_item_cursor_unset()
4572 * @deprecated Please use elm_object_item_cursor_set() instead
4574 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
4579 * Get the type of mouse pointer/cursor decoration set to be shown,
4580 * when the mouse pointer is over the given list widget item
4582 * @param it list item with custom cursor set
4583 * @return the cursor type's name or @c NULL, if no custom cursors
4584 * were set to @p item (and on errors)
4586 * @see elm_object_cursor_get()
4587 * @see elm_list_item_cursor_set()
4588 * @see elm_list_item_cursor_unset()
4590 * @deprecated Please use elm_object_item_cursor_get() instead
4592 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
4597 * Unset any custom mouse pointer/cursor decoration set to be
4598 * shown, when the mouse pointer is over the given list widget
4599 * item, thus making it show the @b default cursor again.
4601 * @param it a list item
4603 * Use this call to undo any custom settings on this item's cursor
4604 * decoration, bringing it back to defaults (no custom style set).
4606 * @see elm_object_cursor_unset()
4607 * @see elm_list_item_cursor_set()
4609 * @deprecated Please use elm_list_item_cursor_unset() instead
4611 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
4616 * Set a different @b style for a given custom cursor set for a
4619 * @param it list item with custom cursor set
4620 * @param style the <b>theme style</b> to use (e.g. @c "default",
4621 * @c "transparent", etc)
4623 * This function only makes sense when one is using custom mouse
4624 * cursor decorations <b>defined in a theme file</b>, which can have,
4625 * given a cursor name/type, <b>alternate styles</b> on it. It
4626 * works analogously as elm_object_cursor_style_set(), but here
4627 * applies only to list item objects.
4629 * @warning Before you set a cursor style you should have defined a
4630 * custom cursor previously on the item, with
4631 * elm_list_item_cursor_set()
4633 * @see elm_list_item_cursor_engine_only_set()
4634 * @see elm_list_item_cursor_style_get()
4636 * @deprecated Please use elm_list_item_cursor_style_set() instead
4638 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
4643 * Get the current @b style set for a given list item's custom
4646 * @param it list item with custom cursor set.
4647 * @return style the cursor style in use. If the object does not
4648 * have a cursor set, then @c NULL is returned.
4650 * @see elm_list_item_cursor_style_set() for more details
4652 * @deprecated Please use elm_list_item_cursor_style_get() instead
4654 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
4659 * Get if the (custom) cursor for a given list item is being
4660 * searched in its theme, also, or is only relying on the rendering
4663 * @param it a list item
4664 * @return @c EINA_TRUE, if cursors are being looked for only on
4665 * those provided by the rendering engine, @c EINA_FALSE if they
4666 * are being searched on the widget's theme, as well.
4668 * @see elm_list_item_cursor_engine_only_set(), for more details
4670 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
4672 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
4677 * Delete the item from the list.
4679 * @param it The item of list to be deleted.
4681 * If deleting all list items is required, elm_list_clear()
4682 * should be used instead of getting items list and deleting each one.
4684 * @see elm_list_clear()
4685 * @see elm_list_item_append()
4686 * @see elm_widget_item_del_cb_set()
4687 * @deprecated Use elm_object_item_del() instead
4690 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
4696 * This sets a widget to be displayed to the left of a scrolled entry.
4698 * @param obj The scrolled entry object
4699 * @param icon The widget to display on the left side of the scrolled
4702 * @note A previously set widget will be destroyed.
4703 * @note If the object being set does not have minimum size hints set,
4704 * it won't get properly displayed.
4706 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4707 * @see elm_entry_end_set()
4709 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4714 * Get the leftmost widget of the scrolled entry. This object is
4715 * owned by the scrolled entry and should not be modified.
4717 * @param obj The scrolled entry object
4718 * @return the left widget inside the scroller
4720 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4722 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
4727 * Unset the leftmost widget of the scrolled entry, unparenting and
4730 * @param obj The scrolled entry object
4731 * @return the previously set icon sub-object of this entry, on
4734 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4735 * @see elm_entry_icon_set()
4737 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
4742 * This sets a widget to be displayed to the end of a scrolled entry.
4744 * @param obj The scrolled entry object
4745 * @param end The widget to display on the right side of the scrolled
4748 * @note A previously set widget will be destroyed.
4749 * @note If the object being set does not have minimum size hints set,
4750 * it won't get properly displayed.
4752 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4753 * @see elm_entry_icon_set
4755 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4760 * Get the endmost widget of the scrolled entry. This object is owned
4761 * by the scrolled entry and should not be modified.
4763 * @param obj The scrolled entry object
4764 * @return the right widget inside the scroller
4766 * @deprecated Use elm_object_part_content_get(entry, "end") instead
4768 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
4773 * Unset the endmost widget of the scrolled entry, unparenting and
4776 * @param obj The scrolled entry object
4777 * @return the previously set icon sub-object of this entry, on
4780 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4781 * @see elm_entry_icon_set()
4783 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
4788 * Set route service to be used. By default used source is
4789 * #ELM_MAP_ROUTE_SOURCE_YOURS.
4791 * @see elm_map_route_source_set()
4792 * @see elm_map_route_source_get()
4797 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
4798 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. */
4799 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
4800 ELM_MAP_ROUTE_SOURCE_LAST
4801 } Elm_Map_Route_Sources;
4806 * Convert a pixel coordinate into a rotated pixel coordinate.
4808 * @param obj The map object.
4809 * @param x horizontal coordinate of the point to rotate.
4810 * @param y vertical coordinate of the point to rotate.
4811 * @param cx rotation's center horizontal position.
4812 * @param cy rotation's center vertical position.
4813 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4814 * @param xx Pointer where to store rotated x.
4815 * @param yy Pointer where to store rotated y.
4817 * @deprecated Use elm_map_canvas_to_geo_convert() instead
4819 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);
4824 * Convert canvas coordinates into a geographic coordinate
4825 * (longitude, latitude).
4827 * @param obj The map object.
4828 * @param x horizontal coordinate of the point to convert.
4829 * @param y vertical coordinate of the point to convert.
4830 * @param lon A pointer to the longitude.
4831 * @param lat A pointer to the latitude.
4833 * This gets longitude and latitude from canvas x, y coordinates. The canvas
4834 * coordinates mean x, y coordinate from current viewport.
4836 * see elm_map_rotate_get()
4837 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
4840 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);
4845 * Get the current geographic coordinates of the map.
4847 * @param obj The map object.
4848 * @param lon Pointer to store longitude.
4849 * @param lat Pointer to store latitude.
4851 * This gets the current center coordinates of the map object. It can be
4852 * set by elm_map_region_bring_in() and elm_map_region_show().
4854 * @see elm_map_region_bring_in()
4855 * @see elm_map_region_show()
4857 * @deprecated Use elm_map_region_get() instead
4859 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
4864 * Animatedly bring in given coordinates to the center of the map.
4866 * @param obj The map object.
4867 * @param lon Longitude to center at.
4868 * @param lat Latitude to center at.
4870 * This causes map to jump to the given @p lat and @p lon coordinates
4871 * and show it (by scrolling) in the center of the viewport, if it is not
4872 * already centered. This will use animation to do so and take a period
4873 * of time to complete.
4875 * @see elm_map_region_show() for a function to avoid animation.
4876 * @see elm_map_region_get()
4878 * @deprecated Use elm_map_region_bring_in() instead
4880 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
4885 * Show the given coordinates at the center of the map, @b immediately.
4887 * @param obj The map object.
4888 * @param lon Longitude to center at.
4889 * @param lat Latitude to center at.
4891 * This causes map to @b redraw its viewport's contents to the
4892 * region containing the given @p lat and @p lon, that will be moved to the
4893 * center of the map.
4895 * @see elm_map_region_bring_in() for a function to move with animation.
4896 * @see elm_map_region_get()
4898 * @deprecated Use elm_map_region_show() instead
4900 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
4905 * Set the minimum zoom of the source.
4907 * @param obj The map object.
4908 * @param zoom New minimum zoom value to be used.
4910 * By default, it's 0.
4912 * @deprecated Use elm_map_zoom_min_set() instead
4914 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4919 * Get the minimum zoom of the source.
4921 * @param obj The map object.
4922 * @return Returns the minimum zoom of the source.
4924 * @see elm_map_zoom_min_set() for details.
4926 * @deprecated Use elm_map_zoom_min_get() instead
4928 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
4933 * Set the maximum zoom of the source.
4935 * @param obj The map object.
4936 * @param zoom New maximum zoom value to be used.
4938 * By default, it's 18.
4940 * @deprecated Use elm_map_zoom_max_set() instead
4942 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4947 * Get the maximum zoom of the source.
4949 * @param obj The map object.
4950 * @return Returns the maximum zoom of the source.
4952 * @see elm_map_zoom_min_set() for details.
4954 * @deprecated Use elm_map_zoom_max_get() instead
4956 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
4962 * Get the list of available sources.
4964 * @param obj The map object.
4965 * @return The source names list.
4967 * It will provide a list with all available sources, that can be set as
4968 * current source with elm_map_source_name_set(), or get with
4969 * elm_map_source_name_get().
4971 * Available sources:
4977 * @see elm_map_source_name_set() for more details.
4978 * @see elm_map_source_name_get()
4979 * @deprecated Use elm_map_sources_get() instead
4982 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
4987 * Set the source of the map.
4989 * @param obj The map object.
4990 * @param source_name The source to be used.
4992 * Map widget retrieves images that composes the map from a web service.
4993 * This web service can be set with this method.
4995 * A different service can return a different maps with different
4996 * information and it can use different zoom values.
4998 * The @p source_name need to match one of the names provided by
4999 * elm_map_source_names_get().
5001 * The current source can be get using elm_map_source_name_get().
5003 * @see elm_map_source_names_get()
5004 * @see elm_map_source_name_get()
5005 * @deprecated Use elm_map_source_set() instead
5008 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
5013 * Get the name of currently used source.
5015 * @param obj The map object.
5016 * @return Returns the name of the source in use.
5018 * @see elm_map_source_name_set() for more details.
5019 * @deprecated Use elm_map_source_get() instead
5022 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
5027 * Set the source of the route service to be used by the map.
5029 * @param obj The map object.
5030 * @param source The route service to be used, being it one of
5031 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
5032 * and #ELM_MAP_ROUTE_SOURCE_ORS.
5034 * Each one has its own algorithm, so the route retrieved may
5035 * differ depending on the source route. Now, only the default is working.
5037 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
5038 * http://www.yournavigation.org/.
5040 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
5041 * assumptions. Its routing core is based on Contraction Hierarchies.
5043 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
5045 * @see elm_map_route_source_get().
5046 * @deprecated Use elm_map_source_set() instead
5049 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
5054 * Get the current route source.
5056 * @param obj The map object.
5057 * @return The source of the route service used by the map.
5059 * @see elm_map_route_source_set() for details.
5060 * @deprecated Use elm_map_source_get() instead
5063 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
5068 * Set the maximum numbers of markers' content to be displayed in a group.
5070 * @param obj The map object.
5071 * @param max The maximum numbers of items displayed in a bubble.
5073 * A bubble will be displayed when the user clicks over the group,
5074 * and will place the content of markers that belong to this group
5077 * A group can have a long list of markers, consequently the creation
5078 * of the content of the bubble can be very slow.
5080 * In order to avoid this, a maximum number of items is displayed
5083 * By default this number is 30.
5085 * Marker with the same group class are grouped if they are close.
5087 * @see elm_map_marker_add()
5089 * @deprecated Use Elm_Map_Overlay instead
5091 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
5096 * Set to show markers during zoom level changes or not.
5098 * @param obj The map object.
5099 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
5102 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
5105 * The default is off.
5107 * This will stop zooming using animation, changing zoom levels will
5108 * change instantly. This will stop any existing animations that are running.
5110 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
5113 * The default is off.
5115 * Enabling it will force the map to stop displaying the markers during
5116 * zoom level changes. Set to on if you have a large number of markers.
5118 * @see elm_map_paused_markers_get()
5120 * @deprecated Use Elm_Map_Overlay instead
5122 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
5127 * Get a value whether markers will be displayed on zoom level changes or not
5129 * @param obj The map object.
5130 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
5131 * indicates it will.
5133 * This gets the current markers paused state for the map object.
5135 * @see elm_map_paused_markers_set() for details.
5137 * @deprecated Use Elm_Map_Overlay instead
5139 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj);
5144 * Close all the bubbles opened by the user.
5146 * @param obj The map object.
5148 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
5149 * when the user clicks on a marker.
5151 * This functions is set for the marker class with
5152 * elm_map_marker_class_get_cb_set().
5154 * @deprecated Use Elm_Map_Overlay instead
5156 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj);
5161 * Set the marker's style of a group class.
5163 * @param clas The group class.
5164 * @param style The style to be used by markers.
5166 * Each marker must be associated to a group class, and will use the style
5167 * defined by such class when grouped to other markers.
5169 * The following styles are provided by default theme:
5170 * @li @c radio - blue circle
5171 * @li @c radio2 - green circle
5174 * @see elm_map_group_class_new() for more details.
5175 * @see elm_map_marker_add()
5177 * @deprecated Use Elm_Map_Overlay instead
5179 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
5184 * Set the icon callback function of a group class.
5186 * @param clas The group class.
5187 * @param icon_get The callback function that will return the icon.
5189 * Each marker must be associated to a group class, and it can display a
5190 * custom icon. The function @p icon_get must return this icon.
5192 * @see elm_map_group_class_new() for more details.
5193 * @see elm_map_marker_add()
5195 * @deprecated Use Elm_Map_Overlay instead
5197 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
5202 * Set the data associated to the group class.
5204 * @param clas The group class.
5205 * @param data The new user data.
5207 * This data will be passed for callback functions, like icon get callback,
5208 * that can be set with elm_map_group_class_icon_cb_set().
5210 * If a data was previously set, the object will lose the pointer for it,
5211 * so if needs to be freed, you must do it yourself.
5213 * @see elm_map_group_class_new() for more details.
5214 * @see elm_map_group_class_icon_cb_set()
5215 * @see elm_map_marker_add()
5217 * @deprecated Use Elm_Map_Overlay instead
5219 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
5224 * Set the minimum zoom from where the markers are displayed.
5226 * @param clas The group class.
5227 * @param zoom The minimum zoom.
5229 * Markers only will be displayed when the map is displayed at @p zoom
5232 * @see elm_map_group_class_new() for more details.
5233 * @see elm_map_marker_add()
5235 * @deprecated Use Elm_Map_Overlay instead
5237 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
5242 * Set the zoom from where the markers are no more grouped.
5244 * @param clas The group class.
5245 * @param zoom The maximum zoom.
5247 * Markers only will be grouped when the map is displayed at
5248 * less than @p zoom.
5250 * @see elm_map_group_class_new() for more details.
5251 * @see elm_map_marker_add()
5253 * @deprecated Use Elm_Map_Overlay instead
5255 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
5260 * Set if the markers associated to the group class @p clas are hidden or not.
5262 * @param clas The group class.
5263 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
5266 * @param obj The map object.
5267 * If @p hide is @c EINA_TRUE the markers will be hidden, but default
5270 * @deprecated Use Elm_Map_Overlay instead
5272 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
5277 * Set the marker's style of a marker class.
5279 * @param clas The marker class.
5280 * @param style The style to be used by markers.
5282 * Each marker must be associated to a marker class, and will use the style
5283 * defined by such class when alone, i.e., @b not grouped to other markers.
5285 * The following styles are provided by default theme:
5290 * @see elm_map_marker_class_new() for more details.
5291 * @see elm_map_marker_add()
5293 * @deprecated Use Elm_Map_Overlay instead
5295 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
5300 * Set the icon callback function of a marker class.
5302 * @param clas The marker class.
5303 * @param icon_get The callback function that will return the icon.
5305 * Each marker must be associated to a marker class, and it can display a
5306 * custom icon. The function @p icon_get must return this icon.
5308 * @see elm_map_marker_class_new() for more details.
5309 * @see elm_map_marker_add()
5311 * @deprecated Use Elm_Map_Overlay instead
5313 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
5318 * Set the bubble content callback function of a marker class.
5320 * @param clas The marker class.
5321 * @param get The callback function that will return the content.
5323 * Each marker must be associated to a marker class, and it can display a
5324 * a content on a bubble that opens when the user click over the marker.
5325 * The function @p get must return this content object.
5327 * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
5330 * @see elm_map_marker_class_new() for more details.
5331 * @see elm_map_marker_class_del_cb_set()
5332 * @see elm_map_marker_add()
5334 * @deprecated Use Elm_Map_Overlay instead
5336 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
5341 * Set the callback function used to delete bubble content of a marker class.
5343 * @param clas The marker class.
5344 * @param del The callback function that will delete the content.
5346 * Each marker must be associated to a marker class, and it can display a
5347 * a content on a bubble that opens when the user click over the marker.
5348 * The function to return such content can be set with
5349 * elm_map_marker_class_get_cb_set().
5351 * If this content must be freed, a callback function need to be
5352 * set for that task with this function.
5354 * If this callback is defined it will have to delete (or not) the
5355 * object inside, but if the callback is not defined the object will be
5356 * destroyed with evas_object_del().
5358 * @see elm_map_marker_class_new() for more details.
5359 * @see elm_map_marker_class_get_cb_set()
5360 * @see elm_map_marker_add()
5362 * @deprecated Use Elm_Map_Overlay instead
5364 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
5369 * Set the route color.
5371 * @param route The route object.
5372 * @param r Red channel value, from 0 to 255.
5373 * @param g Green channel value, from 0 to 255.
5374 * @param b Blue channel value, from 0 to 255.
5375 * @param a Alpha channel value, from 0 to 255.
5377 * It uses an additive color model, so each color channel represents
5378 * how much of each primary colors must to be used. 0 represents
5379 * absence of this color, so if all of the three are set to 0,
5380 * the color will be black.
5382 * These component values should be integers in the range 0 to 255,
5383 * (single 8-bit byte).
5385 * This sets the color used for the route. By default, it is set to
5386 * solid red (r = 255, g = 0, b = 0, a = 255).
5388 * For alpha channel, 0 represents completely transparent, and 255, opaque.
5390 * @see elm_map_route_color_get()
5391 * @deprecated Use elm_map_overlay_color_set() instead
5394 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
5399 * Get the route color.
5401 * @param route The route object.
5402 * @param r Pointer to store the red channel value.
5403 * @param g Pointer to store the green channel value.
5404 * @param b Pointer to store the blue channel value.
5405 * @param a Pointer to store the alpha channel value.
5407 * @see elm_map_route_color_set() for details.
5408 * @deprecated Use elm_map_overlay_color_get() instead
5411 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
5416 * Remove a name from the map.
5418 * @param name The name to remove.
5420 * Basically the struct handled by @p name will be freed, so conversions
5421 * between address and coordinates will be lost.
5423 * @see elm_map_utils_convert_name_into_coord()
5424 * @see elm_map_utils_convert_coord_into_name()
5425 * @deprecated Use elm_map_name_del() instead
5428 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name);
5433 * Get the gengrid object's handle which contains a given gengrid item
5435 * @param it The item to fetch the container from
5436 * @return The gengrid (parent) object
5438 * This returns the gengrid object itself that an item belongs to.
5440 * @deprecated Use elm_object_item_widget_get() instead
5442 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
5447 * Return the data associated to a given gengrid item
5449 * @param it The gengrid item.
5450 * @return the data associated with this item.
5452 * This returns the @c data value passed on the
5453 * elm_gengrid_item_append() and related item addition calls.
5455 * @see elm_gengrid_item_append()
5456 * @see elm_gengrid_item_data_set()
5457 * @deprecated Use elm_object_item_data_get() instead
5459 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
5464 * Set the data associated with a given gengrid item
5466 * @param it The gengrid item
5467 * @param data The data pointer to set on it
5469 * This @b overrides the @c data value passed on the
5470 * elm_gengrid_item_append() and related item addition calls. This
5471 * function @b won't call elm_gengrid_item_update() automatically,
5472 * so you'd issue it afterwards if you want to have the item
5473 * updated to reflect the new data.
5475 * @see elm_gengrid_item_data_get()
5476 * @see elm_gengrid_item_update()
5477 * @deprecated Use elm_object_item_data_set() instead
5480 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
5485 * Set whether a given gengrid item is disabled or not.
5487 * @param it The gengrid item
5488 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
5489 * to enable it back.
5491 * A disabled item cannot be selected or unselected. It will also
5492 * change its appearance, to signal the user it's disabled.
5494 * @see elm_gengrid_item_disabled_get()
5495 * @deprecated Use elm_object_item_disabled_set() instead
5498 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
5503 * Get whether a given gengrid item is disabled or not.
5505 * @param it The gengrid item
5506 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
5509 * @see elm_gengrid_item_disabled_set() for more details
5510 * @deprecated Use elm_object_item_disabled_get() instead
5513 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
5518 * Remove a gengrid item from its parent, deleting it.
5520 * @param it The item to be removed.
5521 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
5523 * @see elm_gengrid_clear(), to remove all items in a gengrid at
5525 * @deprecated use elm_object_item_de() instead
5528 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
5533 * Update the item class of a gengrid item.
5535 * This sets another class of the item, changing the way that it is
5536 * displayed. After changing the item class, elm_gengrid_item_update() is
5537 * called on the item @p it.
5539 * @param it The gengrid item
5540 * @param gic The gengrid item class describing the function pointers and the item style.
5542 * @deprecated Use elm_gengrid_item_item_class_update instead
5544 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
5549 * Insert an item in a gengrid widget using a user-defined sort function.
5551 * @param obj The gengrid object.
5552 * @param gic The item class for the item.
5553 * @param data The item data.
5554 * @param comp User defined comparison function that defines the sort order
5555 * based on Elm_Gen_Item.
5556 * @param func Convenience function called when the item is selected.
5557 * @param func_data Data to be passed to @p func.
5558 * @return A handle to the item added or @c NULL, on errors.
5560 * This inserts an item in the gengrid based on user defined comparison function.
5562 * @see elm_gengrid_item_append()
5563 * @see elm_gengrid_item_prepend()
5564 * @see elm_gengrid_item_insert_after()
5565 * @see elm_object_item_del()
5566 * @see elm_gengrid_item_sorted_insert()
5568 * @deprecated Use elm_gengrid_item_sorted_insert() instead
5570 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);
5575 * Append a filter function for text inserted in the entry
5577 * Append the given callback to the list. This functions will be called
5578 * whenever any text is inserted into the entry, with the text to be inserted
5579 * as a parameter. The callback function is free to alter the text in any way
5580 * it wants, but it must remember to free the given pointer and update it.
5581 * If the new text is to be discarded, the function can free it and set its
5582 * text parameter to NULL. This will also prevent any following filters from
5585 * @param obj The entry object
5586 * @param func The function to use as text filter
5587 * @param data User data to pass to @p func
5588 * @deprecated use elm_entry_markup_filter_append() instead
5590 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5595 * Prepend a filter function for text inserted in the entry
5597 * Prepend the given callback to the list. See elm_entry_text_filter_append()
5598 * for more information
5600 * @param obj The entry object
5601 * @param func The function to use as text filter
5602 * @param data User data to pass to @p func
5603 * @deprecated use elm_entry_markup_filter_prepend() instead
5605 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5610 * Remove a filter from the list
5612 * Removes the given callback from the filter list. See
5613 * elm_entry_text_filter_append() for more information.
5615 * @param obj The entry object
5616 * @param func The filter function to remove
5617 * @param data The user data passed when adding the function
5618 * @deprecated use elm_entry_markup_filter_remove() instead
5620 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5625 * @brief Set the front content of the flip widget.
5627 * @param obj The flip object
5628 * @param content The new front content object
5630 * Once the content object is set, a previously set one will be deleted.
5631 * If you want to keep that old content object, use the
5632 * elm_flip_content_front_unset() function.
5634 * @deprecated Use elm_object_part_content_set(flip, "front") instead
5636 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
5641 * @brief Set the back content of the flip widget.
5643 * @param obj The flip object
5644 * @param content The new back content object
5646 * Once the content object is set, a previously set one will be deleted.
5647 * If you want to keep that old content object, use the
5648 * elm_flip_content_back_unset() function.
5650 * @deprecated Use elm_object_part_content_set(flip, "back") instead
5652 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
5657 * @brief Get the front content used for the flip
5659 * @param obj The flip object
5660 * @return The front content object that is being used
5662 * Return the front content object which is set for this widget.
5664 * @deprecated Use elm_object_part_content_get(flip, "front") instead
5666 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj);
5671 * @brief Get the back content used for the flip
5673 * @param obj The flip object
5674 * @return The back content object that is being used
5676 * Return the back content object which is set for this widget.
5678 * @deprecated Use elm_object_part_content_get(flip, "back") instead
5680 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj);
5685 * @brief Unset the front content used for the flip
5687 * @param obj The flip object
5688 * @return The front content object that was being used
5690 * Unparent and return the front content object which was set for this widget.
5692 * @deprecated Use elm_object_part_content_unset(flip, "front") instead
5694 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj);
5699 * @brief Unset the back content used for the flip
5701 * @param obj The flip object
5702 * @return The back content object that was being used
5704 * Unparent and return the back content object which was set for this widget.
5706 * @deprecated Use elm_object_part_content_unset(flip, "back") instead
5708 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj);
5713 * @brief Get flip front visibility state
5715 * @param obj The flip object
5716 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
5719 * @deprecated Use elm_flip_front_visible_get() instead
5721 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj);
5726 * @brief Set the font size on the label object.
5728 * @param obj The label object
5729 * @param size font size
5731 * @warning NEVER use this. It is for hyper-special cases only. use styles
5732 * instead. e.g. "default", "marker", "slide_long" etc.
5733 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
5735 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize);
5740 * @brief Set the text color on the label object
5742 * @param obj The label object
5743 * @param r Red property background color of The label object
5744 * @param g Green property background color of The label object
5745 * @param b Blue property background color of The label object
5746 * @param a Alpha property background color of The label object
5748 * @warning NEVER use this. It is for hyper-special cases only. use styles
5749 * instead. e.g. "default", "marker", "slide_long" etc.
5750 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
5752 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5757 * @brief Set the text align on the label object
5759 * @param obj The label object
5760 * @param align align mode ("left", "center", "right")
5762 * @warning NEVER use this. It is for hyper-special cases only. use styles
5763 * instead. e.g. "default", "marker", "slide_long" etc.
5764 * @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%.
5766 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
5771 * @brief Set background color of the label
5773 * @param obj The label object
5774 * @param r Red property background color of The label object
5775 * @param g Green property background color of The label object
5776 * @param b Blue property background color of The label object
5777 * @param a Alpha property background alpha of The label object
5779 * @warning NEVER use this. It is for hyper-special cases only. use styles
5780 * instead. e.g. "default", "marker", "slide_long" etc.
5781 * @deprecated Just make colored background by yourself.
5783 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5788 * @brief Set wrap height of the label
5790 * @param obj The label object
5791 * @param h The wrap height in pixels at a minimum where words need to wrap
5793 * This function sets the maximum height size hint of the label.
5795 * @warning This is only relevant if the label is inside a container.
5796 * @deprecated This function should not be used because of wrong concept.
5798 EINA_DEPRECATED EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
5803 * @brief get wrap width of the label
5805 * @param obj The label object
5806 * @return The wrap height in pixels at a minimum where words need to wrap
5807 * @deprecated This function should not be used because of wrong concept.
5809 EINA_DEPRECATED EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj);
5814 * @brief Flush all caches.
5816 * Frees all data that was in cache and is not currently being used to reduce
5817 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
5818 * to calling all of the following functions:
5819 * @li edje_file_cache_flush()
5820 * @li edje_collection_cache_flush()
5821 * @li eet_clearcache()
5822 * @li evas_image_cache_flush()
5823 * @li evas_font_cache_flush()
5824 * @li evas_render_dump()
5825 * @note Evas caches are flushed for every canvas associated with a window.
5826 * @deprecated Use elm_cache_all_flush() instead.
5828 EINA_DEPRECATED EAPI void elm_all_flush(void);
5834 * @brief Define the uri that will be the video source.
5836 * @param video The video object to define the file for.
5837 * @param uri The uri to target.
5839 * This function will define an uri as a source for the video of the
5840 * Elm_Video object. URI could be remote source of video, like http:// or local
5841 * like for example WebCam who are most of the time v4l2:// (but that depend an
5842 * you should use Emotion API to request and list the available Webcam on your
5844 * @deprecated Use elm_video_file_set() instead.
5847 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri);
5852 * @brief Get the region of the image that is currently shown
5855 * @param x A pointer to the X-coordinate of region
5856 * @param y A pointer to the Y-coordinate of region
5857 * @param w A pointer to the width
5858 * @param h A pointer to the height
5860 * @deprecated Use elm_photocam_image_region_get() instead.
5862 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
5867 * @brief Set the gesture state for photocam.
5869 * @param obj The photocam object
5870 * @param gesture The gesture state to set
5872 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
5873 * photocam. The default is off. This will start multi touch zooming.
5875 * @deprecated Use elm_photocam_gesture_enabled_set() instead.
5877 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
5882 * @brief Get the gesture state for photocam.
5884 * @param obj The photocam object
5885 * @return The current gesture state
5887 * This gets the current gesture state for the photocam object.
5889 * @deprecated Use elm_photocam_gesture_enabled_get() instead.
5891 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj);
5892 /* No documentation for these API before.
5894 * @deprecated Use elm_route_latitude_min_max_get()
5895 * elm_route_longitude_min_max_get()
5898 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj);
5899 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj);
5900 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj);
5901 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj);
5907 * Get the duration after which tooltip will be shown.
5909 * @return Duration after which tooltip will be shown.
5910 * @deprecated Use elm_config_tooltip_delay_get(void);
5912 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void);
5917 * Set the duration after which tooltip will be shown.
5919 * @return EINA_TRUE if value is set.
5920 * @deprecated Use elm_config_tooltip_delay_set(double delay);
5922 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay);
5927 * Set the corner of the bubble
5929 * @param obj The bubble object.
5930 * @param corner The given corner for the bubble.
5932 * @deprecated Use elm_bubble_pos_set()
5935 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
5940 * Get the corner of the bubble
5942 * @param obj The bubble object.
5943 * @return The given corner for the bubble.
5945 * @deprecated Use elm_bubble_pos_get()
5947 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
5952 * Enable or disable day selection
5954 * @param obj The calendar object.
5955 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
5958 * @deprecated Use elm_calendar_day_selection_disabled_set()
5960 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
5965 * Get a value whether day selection is enabled or not.
5967 * @param obj The calendar object.
5968 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
5969 * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
5971 * @deprecated elm_calendar_day_selection_disabled_get()
5973 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
5978 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
5980 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
5985 * Get the configured font cache size
5987 * This gets the globally configured font cache size, in bytes.
5989 * @return The font cache size
5990 * @deprecated elm_cache_font_cache_size_get(void);
5992 EINA_DEPRECATED EAPI int elm_font_cache_get(void);
5997 * Set the configured font cache size
5999 * This sets the globally configured font cache size, in bytes
6001 * @param size The font cache size
6002 * @deprecated elm_cache_font_cache_size_set(int size);
6004 EINA_DEPRECATED EAPI void elm_font_cache_set(int size);
6009 * Get the configured image cache size
6011 * This gets the globally configured image cache size, in bytes
6013 * @return The image cache size
6015 EINA_DEPRECATED EAPI int elm_image_cache_get(void);
6016 EINA_DEPRECATED EAPI int elm_cache_image_cache_size_get(void);
6021 * Set the configured image cache size
6023 * This sets the globally configured image cache size, in bytes
6025 * @param size The image cache size
6026 * @deprecated Use elm_cache_image_cache_size_set(int size);
6028 EINA_DEPRECATED EAPI void elm_image_cache_set(int size);
6034 * Get the configured edje file cache size.
6036 * This gets the globally configured edje file cache size, in number
6039 * @return The edje file cache size
6040 * @deprecated Use elm_cache_edje_file_cache_size_get(void);
6042 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void);
6047 * Set the configured edje file cache size
6049 * This sets the globally configured edje file cache size, in number
6052 * @param size The edje file cache size
6053 * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
6055 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size);
6060 * Get the configured edje collections (groups) cache size.
6062 * This gets the globally configured edje collections cache size, in
6063 * number of collections.
6065 * @return The edje collections cache size
6066 * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
6068 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void);
6073 * Set the configured edje collections (groups) cache size
6075 * This sets the globally configured edje collections cache size, in
6076 * number of collections.
6078 * @param size The edje collections cache size
6079 * @deprecated elm_cache_edje_collection_cache_size_set(int size);
6081 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size);
6086 * Get whether browsing history is enabled for the given object
6088 * @param obj The web object
6090 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
6092 * @deprecated Use elm_web_history_enabled_get()
6094 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj);
6099 * Enables or disables the browsing history
6101 * @param obj The web object
6102 * @param enable Whether to enable or disable the browsing history
6104 * @deprecated Use elm_web_history_enabled_set()
6107 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
6112 * @brief Add an object swallowed in an item at the end of the given menu
6115 * @param obj The menu object.
6116 * @param parent The parent menu item (optional)
6117 * @param subobj The object to swallow
6118 * @param func Function called when the user select the item.
6119 * @param data Data sent by the callback.
6120 * @return Returns the new item.
6122 * Add an evas object as an item to the menu.
6123 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
6125 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);
6130 * @brief Sets whether events should be passed to by a click outside
6133 * @param obj The notify object
6134 * @param repeat EINA_TRUE Events are repeats, else no
6136 * When true if the user clicks outside the window the events will be caught
6137 * by the others widgets, else the events are blocked.
6139 * @note The default value is EINA_TRUE.
6140 * @deprecated Please use elm_notify_allow_events_set() instead
6142 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
6147 * @brief Return true if events are repeat below the notify object
6148 * @param obj the notify object
6150 * @see elm_notify_repeat_events_set()
6151 * @deprecated Please use elm_notify_allow_events_get() instead
6153 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj);
6158 * Set if the cursor set should be searched on the theme or should use
6159 * the provided by the engine, only.
6161 * @param obj an object with cursor already set.
6162 * @param engine_only boolean to define if cursors should be looked only
6163 * between the provided by the engine or searched on widget's theme as well.
6165 * @deprecated Use elm_object_cursor_theme_search_enabled_set()
6167 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
6172 * Get the cursor engine only usage for this object cursor.
6174 * @param obj an object with cursor already set.
6175 * @return engine_only boolean to define it cursors should be
6176 * looked only between the provided by the engine or searched on
6177 * widget's theme as well. If the object does not have a cursor
6178 * set, then EINA_FALSE is returned.
6180 * @deprecated Use elm_object_cursor_theme_search_enabled_get();
6182 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj);
6187 * Go to a given items level on a index widget
6189 * @param obj The index object
6190 * @param level The index level (one of @c 0 or @c 1)
6192 * @deprecated please use "elm_index_level_go" instead.
6194 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level);
6199 * Enable or disable auto hiding feature for a given index widget.
6201 * @param obj The index object
6202 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
6204 * @see elm_index_active_get()
6206 * @deprecated please use "elm_index_autohide_disabled_set" instead.
6208 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
6213 * Get whether auto hiding feature is enabled or not for a given index widget.
6215 * @param obj The index object
6216 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
6218 * @see elm_index_active_set() for more details
6220 * @deprecated please use "elm_index_autohide_disabled_get" instead.
6222 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
6227 * Append a new item, on a given index widget, <b>after the item
6228 * having @p relative as data</b>.
6230 * @param obj The index object.
6231 * @param letter Letter under which the item should be indexed
6232 * @param item The item data to set for the index's item
6233 * @param relative The index item to be the predecessor of this new one
6234 * @return A handle to the item added or @c NULL, on errors
6236 * Despite the most common usage of the @p letter argument is for
6237 * single char strings, one could use arbitrary strings as index
6240 * @c item will be the pointer returned back on @c "changed", @c
6241 * "delay,changed" and @c "selected" smart events.
6243 * @note If @p relative is @c NULL this function will behave as
6244 * elm_index_item_append().
6246 * @deprecated please use "elm_index_item_insert_after" instead.
6248 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);
6253 * Prepend a new item, on a given index widget, <b>after the item
6254 * having @p relative as data</b>.
6256 * @param obj The index object.
6257 * @param letter Letter under which the item should be indexed
6258 * @param item The item data to set for the index's item
6259 * @param relative The index item to be the successor of this new one
6260 * @return A handle to the item added or @c NULL, on errors
6262 * Despite the most common usage of the @p letter argument is for
6263 * single char strings, one could use arbitrary strings as index
6266 * @c item will be the pointer returned back on @c "changed", @c
6267 * "delay,changed" and @c "selected" smart events.
6269 * @note If @p relative is @c NULL this function will behave as
6270 * elm_index_item_prepend().
6272 * @deprecated please use "elm_index_item_insert_before" instead.
6274 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);
6279 * Set the transparency state of a window.
6281 * Use elm_win_alpha_set() instead.
6283 * @param obj The window object
6284 * @param transparent If true, the window is transparent
6286 * @see elm_win_alpha_set()
6287 * @deprecated Please use elm_win_alpha_set()
6289 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
6294 * Get the transparency state of a window.
6296 * @param obj The window object
6297 * @return If true, the window is transparent
6299 * @see elm_win_transparent_set()
6300 * @deprecated Please use elm_win_alpha_get()
6302 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj);
6307 * Set the theme for all elementary using applications on the current display
6309 * @param theme The name of the theme to use. Format same as the ELM_THEME
6310 * environment variable.
6311 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
6313 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme);
6318 * Returns the Evas_Object that represents the content area.
6320 * @param obj The conformant object.
6321 * @return The content area of the widget.
6324 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
6329 * Set if the object is (up/down) resizable.
6331 * @param obj The image object
6332 * @param scale_up A bool to set if the object is resizable up. Default is
6334 * @param scale_down A bool to set if the object is resizable down. Default
6337 * This function limits the image resize ability. If @p scale_up is set to
6338 * @c EINA_FALSE, the object can't have its height or width resized to a value
6339 * higher than the original image size. Same is valid for @p scale_down.
6341 * @see elm_image_scale_get()
6342 * @deprecated Please use elm_image_resizable_set()
6345 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
6350 * Get if the object is (up/down) resizable.
6352 * @param obj The image object
6353 * @param scale_up A bool to set if the object is resizable up
6354 * @param scale_down A bool to set if the object is resizable down
6356 * @see elm_image_scale_set()
6357 * @deprecated Please use elm_image_resizable_get()
6360 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
6365 * Set if the object is (up/down) resizable.
6367 * @param obj The icon object
6368 * @param scale_up A bool to set if the object is resizable up. Default is
6370 * @param scale_down A bool to set if the object is resizable down. Default
6373 * This function limits the icon object resize ability. If @p scale_up is set to
6374 * @c EINA_FALSE, the object can't have its height or width resized to a value
6375 * higher than the original icon size. Same is valid for @p scale_down.
6377 * @see elm_icon_scale_get()
6378 * @deprecated Please use elm_icon_resizable_set()
6381 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
6386 * Get if the object is (up/down) resizable.
6388 * @param obj The icon object
6389 * @param scale_up A bool to set if the object is resizable up
6390 * @param scale_down A bool to set if the object is resizable down
6392 * @see elm_icon_scale_set()
6393 * @deprecated Please use elm_icon_resizable_get()
6396 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
6401 * Enable or disable preloading of the icon
6403 * @param obj The icon object
6404 * @param disable If EINA_TRUE, preloading will be disabled
6405 * @deprecated Use elm_icon_preload_disabled_set() instead
6407 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
6412 * Returns the last selected item, for a given index widget.
6414 * @param obj The index object.
6415 * @return The last item @b selected on @p obj (or @c NULL, on errors).
6416 * @deprecated Please use elm_index_selected_item_get() instead.
6420 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
6425 * Get the value of shrink_mode state.
6427 * @deprecated elm_multibuttonentry_expanded_get()
6429 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
6434 * Set/Unset the multibuttonentry to shrink mode state of single line
6436 * @deprecated elm_multibuttonentry_expanded_set()
6438 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
6443 * Get the guide text
6445 * @param obj The multibuttonentry object
6446 * @return The guide text, or NULL if none
6448 * @deprecated Please use elm_object_part_text_get(obj, "guide");
6450 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
6455 * Set the guide text
6457 * @param obj The multibuttonentry object
6458 * @param guidetext The guide text string
6460 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
6462 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
6467 * Make the elementary object and its children to be unfocusable
6470 * @param obj The Elementary object to operate on
6471 * @param tree_unfocusable @c EINA_TRUE for unfocusable,
6472 * @c EINA_FALSE for focusable.
6474 * This sets whether the object @p obj and its children objects
6475 * are able to take focus or not. If the tree is set as unfocusable,
6476 * newest focused object which is not in this tree will get focus.
6477 * This API can be helpful for an object to be deleted.
6478 * When an object will be deleted soon, it and its children may not
6479 * want to get focus (by focus reverting or by other focus controls).
6480 * Then, just use this API before deleting.
6482 * @see elm_object_tree_unfocusable_get()
6484 * @deprecated Please use elm_object_tree_unfocusable_set()
6486 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
6491 * Get whether an Elementary object and its children are unfocusable or not.
6493 * @param obj The Elementary object to get the information from
6494 * @return @c EINA_TRUE, if the tree is unfocussable,
6495 * @c EINA_FALSE if not (and on errors).
6497 * @see elm_object_tree_unfocusable_set()
6499 * @deprecated Please use elm_object_tree_unfocusable_get()
6501 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj);
6506 * Animatedly bring in, to the visible are of a genlist, a given
6509 * @deprecated elm_genlist_item_bring_in()
6511 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
6516 * Animatedly bring in, to the visible are of a genlist, a given
6519 * @deprecated elm_genlist_item_bring_in()
6521 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
6526 * Show the portion of a genlist's internal list containing a given
6527 * item, immediately.
6529 * @param it The item to display
6531 * @deprecated elm_genlist_item_show()
6534 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it);
6539 * Show the portion of a genlist's internal list containing a given
6540 * item, immediately.
6542 * @param it The item to display
6544 * @deprecated elm_genlist_item_show()
6547 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it);
6552 * Enable or disable round mode.
6554 * @param obj The diskselector object.
6555 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
6558 * Disabled by default. If round mode is enabled the items list will
6559 * work like a circle list, so when the user reaches the last item,
6560 * the first one will popup.
6562 * @see elm_diskselector_round_enabled_get()
6564 * @deprecated elm_diskselector_round_enabled_set()
6566 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
6571 * Set whether items on a given gengrid widget are to get their
6572 * selection callbacks issued for @b every subsequent selection
6573 * click on them or just for the first click.
6575 * @param obj The gengrid object
6576 * @param always_select @c EINA_TRUE to make items "always
6577 * selected", @c EINA_FALSE, otherwise
6579 * By default, grid items will only call their selection callback
6580 * function when firstly getting selected, any subsequent further
6581 * clicks will do nothing. With this call, you make those
6582 * subsequent clicks also to issue the selection callbacks.
6584 * @note <b>Double clicks</b> will @b always be reported on items.
6586 * @see elm_gengrid_always_select_mode_get()
6589 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6594 * Get whether items on a given gengrid widget have their selection
6595 * callbacks issued for @b every subsequent selection click on them
6596 * or just for the first click.
6598 * @param obj The gengrid object.
6599 * @return @c EINA_TRUE if the gengrid items are "always selected",
6600 * @c EINA_FALSE, otherwise
6602 * @see elm_gengrid_always_select_mode_set() for more details
6605 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj);
6610 * Set whether items on a given gengrid widget can be selected or not.
6612 * @param obj The gengrid object
6613 * @param no_select @c EINA_TRUE to make items selectable,
6614 * @c EINA_FALSE otherwise
6616 * This will make items in @p obj selectable or not. In the latter
6617 * case, any user interaction on the gengrid items will neither make
6618 * them appear selected nor them call their selection callback
6621 * @see elm_gengrid_no_select_mode_get()
6624 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6629 * Get whether items on a given gengrid widget can be selected or
6632 * @param obj The gengrid object
6633 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
6636 * @see elm_gengrid_no_select_mode_set() for more details
6639 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj);
6644 * Get the side labels max length.
6646 * @see elm_diskselector_side_text_max_length_set() for details.
6648 * @param obj The diskselector object.
6649 * @return The max length defined for side labels, or 0 if not a valid
6652 * @deprecated elm_diskselector_side_text_max_length_get()
6654 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj);
6659 * Set the side labels max length.
6661 * @param obj The diskselector object.
6662 * @param len The max length defined for side labels.
6664 * Length is the number of characters of items' label that will be
6665 * visible when it's set on side positions. It will just crop
6666 * the string after defined size. E.g.:
6668 * An item with label "January" would be displayed on side position as
6669 * "Jan" if max length is set to 3, or "Janu", if this property
6672 * When it's selected, the entire label will be displayed, except for
6673 * width restrictions. In this case label will be cropped and "..."
6674 * will be concatenated.
6676 * Default side label max length is 3.
6678 * This property will be applied over all items, included before or
6679 * later this function call.
6681 * @deprecated elm_diskselector_side_text_max_length_set()
6683 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
6688 * Set whether the toolbar should always have an item selected.
6690 * @param obj The toolbar object.
6691 * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to
6694 * This will cause the toolbar to always have an item selected, and clicking
6695 * the selected item will not cause a selected event to be emitted. Enabling this mode
6696 * will immediately select the first toolbar item.
6698 * Always-selected is disabled by default.
6700 * @see elm_toolbar_always_select_mode_get().
6704 EINA_DEPRECATED EAPI void elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6709 * Get whether the toolbar should always have an item selected.
6711 * @param obj The toolbar object.
6712 * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates
6713 * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned.
6715 * @see elm_toolbar_always_select_mode_set() for details.
6719 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_always_select_mode_get(const Evas_Object *obj);
6724 * Set whether the toolbar items' should be selected by the user or not.
6726 * @param obj The toolbar object.
6727 * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to
6730 * This will turn off the ability to select items entirely and they will
6731 * neither appear selected nor emit selected signals. The clicked
6732 * callback function will still be called.
6734 * Selection is enabled by default.
6736 * @see elm_toolbar_no_select_mode_get().
6740 EINA_DEPRECATED EAPI void elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6745 * Set whether the toolbar items' should be selected by the user or not.
6747 * @param obj The toolbar object.
6748 * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates
6749 * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned.
6751 * @see elm_toolbar_no_select_mode_set() for details.
6755 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_no_select_mode_get(const Evas_Object *obj);
6760 * Set the interval on time updates for a user mouse button hold
6761 * on clock widgets' time edition.
6763 * @param obj The clock object
6764 * @param interval The (first) interval value in seconds
6766 * This interval value is @b decreased while the user holds the
6767 * mouse pointer either incrementing or decrementing a given the
6768 * clock digit's value.
6770 * This helps the user to get to a given time distant from the
6771 * current one easier/faster, as it will start to flip quicker and
6772 * quicker on mouse button holds.
6774 * The calculation for the next flip interval value, starting from
6775 * the one set with this call, is the previous interval divided by
6776 * 1.05, so it decreases a little bit.
6778 * The default starting interval value for automatic flips is
6781 * @deprecated elm_clock_first_interval_set()
6784 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval);
6789 * Get the interval on time updates for a user mouse button hold
6790 * on clock widgets' time edition.
6792 * @param obj The clock object
6793 * @return The (first) interval value, in seconds, set on it
6795 * @elm_clock_first_interval_get()
6797 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj);
6802 * Set what digits of the given clock widget should be editable
6803 * when in edition mode.
6805 * @param obj The clock object
6806 * @param digedit Bit mask indicating the digits to be editable
6807 * (values in #Elm_Clock_Edit_Mode).
6809 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
6810 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
6813 * @deprecated elm_clock_edit_mode_set()
6815 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
6820 * Get what digits of the given clock widget should be
6821 * editable when in edition mode.
6823 * @param obj The clock object
6824 * @return Bit mask indicating the digits to be editable
6825 * (values in #Elm_Clock_Edit_Mode).
6827 * @deprecated elm_clock_edit_mode_get()
6829 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
6834 * Queries whether it's possible to go back in history
6836 * @param obj The web object
6838 * @return EINA_TRUE if it's possible to back in history, EINA_FALSE
6840 * @deprecated elm_web_back_possible_get();
6842 EINA_DEPRECATED EAPI Eina_Bool elm_web_backward_possible(Evas_Object *obj);
6847 * Queries whether it's possible to go forward in history
6849 * @param obj The web object
6851 * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE
6854 * @deprecated elm_web_forward_possible_get();
6856 EINA_DEPRECATED EAPI Eina_Bool elm_web_forward_possible(Evas_Object *obj);
6861 * Queries whether it's possible to jump the given number of steps
6863 * @deprecated elm_web_navigate_possible_get();
6866 EINA_DEPRECATED EAPI Eina_Bool elm_web_navigate_possible(Evas_Object *obj, int steps);
6871 * @brief Set the content of the scroller widget (the object to be scrolled around).
6873 * @param obj The scroller object
6874 * @param content The new content object
6876 * Once the content object is set, a previously set one will be deleted.
6877 * If you want to keep that old content object, use the
6878 * elm_scroller_content_unset() function.
6879 * @deprecated use elm_object_content_set() instead
6881 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
6886 * @brief Get the content of the scroller widget
6888 * @param obj The slider object
6889 * @return The content that is being used
6891 * Return the content object which is set for this widget
6893 * @see elm_scroller_content_set()
6894 * @deprecated use elm_object_content_get() instead.
6896 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
6901 * @brief Unset the content of the scroller widget
6903 * @param obj The slider object
6904 * @return The content that was being used
6906 * Unparent and return the content object which was set for this widget
6908 * @see elm_scroller_content_set()
6909 * @deprecated use elm_object_content_unset() instead.
6911 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
6916 * Set the shrink state of toolbar @p obj.
6918 * @param obj The toolbar object.
6919 * @param shrink_mode Toolbar's items display behavior.
6921 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
6922 * but will enforce a minimum size so all the items will fit, won't scroll
6923 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
6924 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
6925 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
6927 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
6929 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
6934 * Get the shrink mode of toolbar @p obj.
6936 * @param obj The toolbar object.
6937 * @return Toolbar's items display behavior.
6939 * @see elm_toolbar_shrink_mode_set() for details.
6941 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
6943 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
6948 * Set the text to be shown in a given toolbar item's tooltips.
6950 * @param it toolbar item.
6951 * @param text The text to set in the content.
6953 * Setup the text as tooltip to object. The item can have only one tooltip,
6954 * so any previous tooltip data - set with this function or
6955 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
6957 * @deprecated Use elm_object_item_tooltip_text_set() instead
6958 * @see elm_object_tooltip_text_set() for more details.
6961 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
6966 * Enable or disable always select mode on the list object.
6968 * @param obj The list object
6969 * @param always_select @c EINA_TRUE to enable always select mode or
6970 * @c EINA_FALSE to disable it.
6972 * @note Always select mode is disabled by default.
6974 * Default behavior of list items is to only call its callback function
6975 * the first time it's pressed, i.e., when it is selected. If a selected
6976 * item is pressed again, and multi-select is disabled, it won't call
6977 * this function (if multi-select is enabled it will unselect the item).
6979 * If always select is enabled, it will call the callback function
6980 * every time a item is pressed, so it will call when the item is selected,
6981 * and again when a selected item is pressed.
6983 * @deprecated elm_list_always_select_mode_set()
6985 EINA_DEPRECATED EAPI void elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6990 * Get a value whether always select mode is enabled or not, meaning that
6991 * an item will always call its callback function, even if already selected.
6993 * @param obj The list object
6994 * @return @c EINA_TRUE means horizontal mode selection is enabled.
6995 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
6996 * @c EINA_FALSE is returned.
6998 * @see elm_list_always_select_mode_set() for details.
7000 * @deprecated elm_list_always_select_mode_get()
7002 EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj);
7007 * Get the real Evas object created to implement the view of a
7008 * given genlist item
7010 * @param it The genlist item.
7011 * @return the Evas object implementing this item's view.
7013 * This returns the actual Evas object used to implement the
7014 * specified genlist item's view. This may be @c NULL, as it may
7015 * not have been created or may have been deleted, at any time, by
7016 * the genlist. <b>Do not modify this object</b> (move, resize,
7017 * show, hide, etc.), as the genlist is controlling it. This
7018 * function is for querying, emitting custom signals or hooking
7019 * lower level callbacks for events on that object. Do not delete
7020 * this object under any circumstances.
7022 * @see elm_object_item_data_get()
7023 * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit().
7026 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
7031 * Set the always select mode.
7033 * @param obj The genlist object
7034 * @param always_select The always select mode (@c EINA_TRUE = on, @c
7035 * EINA_FALSE = off). Default is @c EINA_FALSE.
7037 * Items will only call their selection func and callback when first
7038 * becoming selected. Any further clicks will do nothing, unless you
7039 * enable always select with elm_genlist_always_select_mode_set().
7040 * This means that, even if selected, every click will make the selected
7041 * callbacks be called.
7043 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_ALWAYS); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode.
7046 EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
7052 * Get the always select mode.
7054 * @param obj The genlist object
7055 * @return The always select mode
7056 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
7058 * @deprecated use elm_genlist_select_mode_get instead.
7061 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj);
7066 * Enable/disable the no select mode.
7068 * @param obj The genlist object
7069 * @param no_select The no select mode
7070 * (EINA_TRUE = on, EINA_FALSE = off)
7072 * This will turn off the ability to select items entirely and they
7073 * will neither appear selected nor call selected callback functions.
7075 * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_NONE); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode.
7078 EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
7083 * Get whether the no select mode is enabled.
7085 * @param obj The genlist object
7086 * @return The no select mode
7087 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
7089 * @deprecated use elm_genlist_select_mode_get instead.
7092 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj);
7097 * Enable/disable compress mode.
7099 * @param obj The genlist object
7100 * @param compress The compress mode
7101 * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE.
7103 * This will enable the compress mode where items are "compressed"
7104 * horizontally to fit the genlist scrollable viewport width. This is
7105 * special for genlist. Do not rely on
7106 * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to
7107 * work as genlist needs to handle it specially.
7109 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
7111 EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress);
7116 * Sets the display only state of an item.
7118 * @param it The item
7119 * @param display_only @c EINA_TRUE if the item is display only, @c
7120 * EINA_FALSE otherwise.
7122 * A display only item cannot be selected or unselected. It is for
7123 * display only and not selecting or otherwise clicking, dragging
7124 * etc. by the user, thus finger size rules will not be applied to
7127 * It's good to set group index items to display only state.
7129 * @see elm_genlist_item_display_only_get()
7131 * @deprecated elm_genlist_item_display_only_set()
7133 EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only);
7138 * Get the display only state of an item
7140 * @param it The item
7141 * @return @c EINA_TRUE if the item is display only, @c
7142 * EINA_FALSE otherwise.
7144 * @see elm_genlist_item_display_only_set()
7146 * @deprecated elm_genlist_item_display_only_get()
7148 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it);
7153 * Get whether the compress mode is enabled.
7155 * @param obj The genlist object
7156 * @return The compress mode
7157 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
7159 * @deprecated elm_genlsit_mode_get()
7161 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj);
7166 * Enable/disable height-for-width mode.
7168 * @param obj The genlist object
7169 * @param height_for_width The height-for-width mode (@c EINA_TRUE = on,
7170 * @c EINA_FALSE = off). Default is @c EINA_FALSE.
7172 * With height-for-width mode the item width will be fixed (restricted
7173 * to a minimum of) to the list width when calculating its size in
7174 * order to allow the height to be calculated based on it. This allows,
7175 * for instance, text block to wrap lines if the Edje part is
7176 * configured with "text.min: 0 1".
7178 * @note This mode will make list resize slower as it will have to
7179 * recalculate every item height again whenever the list width
7182 * @note When height-for-width mode is enabled, it also enables
7183 * compress mode (see elm_genlist_compress_mode_set()) and
7184 * disables homogeneous (see elm_genlist_homogeneous_set()).
7186 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
7188 EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width);
7193 * Get whether the height-for-width mode is enabled.
7195 * @param obj The genlist object
7196 * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE =
7199 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
7201 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj);
7206 * Activate a genlist mode on an item
7208 * @param it The genlist item
7209 * @param mode_type Mode name
7210 * @param mode_set Boolean to define set or unset mode.
7212 * A genlist mode is a different way of selecting an item. Once a mode is
7213 * activated on an item, any other selected item is immediately unselected.
7214 * This feature provides an easy way of implementing a new kind of animation
7215 * for selecting an item, without having to entirely rewrite the item style
7216 * theme. However, the elm_genlist_selected_* API can't be used to get what
7217 * item is activate for a mode.
7219 * The current item style will still be used, but applying a genlist mode to
7220 * an item will select it using a different kind of animation.
7222 * The current active item for a mode can be found by
7223 * elm_genlist_decorated_item_get().
7225 * The characteristics of genlist mode are:
7226 * - Only one mode can be active at any time, and for only one item.
7227 * - Genlist handles deactivating other items when one item is activated.
7228 * - A mode is defined in the genlist theme (edc), and more modes can easily
7230 * - A mode style and the genlist item style are different things. They
7231 * can be combined to provide a default style to the item, with some kind
7232 * of animation for that item when the mode is activated.
7234 * When a mode is activated on an item, a new view for that item is created.
7235 * The theme of this mode defines the animation that will be used to transit
7236 * the item from the old view to the new view. This second (new) view will be
7237 * active for that item while the mode is active on the item, and will be
7238 * destroyed after the mode is totally deactivated from that item.
7240 * @deprecated elm_genlist_item_decorate_mode_set()
7242 EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set);
7247 * Get the last (or current) genlist mode used.
7249 * @param obj The genlist object
7251 * This function just returns the name of the last used genlist mode. It will
7252 * be the current mode if it's still active.
7254 * @deprecated elm_genlist_item_decorate_mode_get()
7256 EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj);
7261 * Get active genlist mode item
7263 * @param obj The genlist object
7264 * @return The active item for that current mode. Or @c NULL if no item is
7265 * activated with any mode.
7267 * This function returns the item that was activated with a mode, by the
7268 * function elm_genlist_item_decorate_mode_set().
7270 * @deprecated elm_genlist_decorated_item_get()
7272 EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj);
7277 * Set Genlist edit mode
7279 * This sets Genlist edit mode.
7281 * @param obj The Genlist object
7282 * @param The edit mode status
7283 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
7285 * @deprecated elm_genlist_decorate_mode_set
7287 EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode);
7292 * Get Genlist edit mode
7294 * @param obj The genlist object
7295 * @return The edit mode status
7296 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
7298 * @deprecated elm_genlist_decorate_mode_get()
7300 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj);