2 * DO NOT INCLUDE THIS HEADER INSIDE ANY SOURCE.
3 * THIS IS ONLY FOR ELEMENTARY API DEPRECATION HISTORY AND WILL BE REMOVED LATER.
4 * THIS WILL BE MAINLY MANAGED BY JIYOUN PARK (jypark).
6 * (deprecation process)
7 * 1. mark EINA_DEPRECATED and move declarations to elm_deprecated.h.
8 * 2. remove it from elm_deprecated.h and apply it to all trunk.
9 * 3. move it to elm_removed.h.
12 #error "do not include this"
15 * @image html img/widget/toggle/preview-00.png
16 * @image latex img/widget/toggle/preview-00.eps
18 * @brief A toggle is a slider which can be used to toggle between
19 * two values. It has two states: on and off.
21 * This widget is deprecated. Please use elm_check_add() instead using the
25 * obj = elm_check_add(parent);
26 * elm_object_style_set(obj, "toggle");
27 * elm_object_part_text_set(obj, "on", "ON");
28 * elm_object_part_text_set(obj, "off", "OFF");
31 * Signals that you can add callbacks for are:
32 * @li "changed" - Whenever the toggle value has been changed. Is not called
33 * until the toggle is released by the cursor (assuming it
34 * has been triggered by the cursor in the first place).
36 * Default content parts of the toggle widget that you can use for are:
37 * @li "icon" - An icon of the toggle
39 * Default text parts of the toggle widget that you can use for are:
40 * @li "elm.text" - Label of the toggle
42 * @ref tutorial_toggle show how to use a toggle.
47 * @brief Add a toggle to @p parent.
49 * @param parent The parent object
51 * @return The toggle object
53 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
56 * @brief Sets the label to be displayed with the toggle.
58 * @param obj The toggle object
59 * @param label The label to be displayed
61 * @deprecated use elm_object_text_set() instead.
63 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
66 * @brief Gets the label of the toggle
68 * @param obj toggle object
69 * @return The label of the toggle
71 * @deprecated use elm_object_text_get() instead.
73 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
76 * @brief Set the icon used for the toggle
78 * @param obj The toggle object
79 * @param icon The icon object for the button
81 * Once the icon object is set, a previously set one will be deleted
82 * If you want to keep that old content object, use the
83 * elm_toggle_icon_unset() function.
85 * @deprecated use elm_object_part_content_set() instead.
87 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
90 * @brief Get the icon used for the toggle
92 * @param obj The toggle object
93 * @return The icon object that is being used
95 * Return the icon object which is set for this widget.
97 * @deprecated use elm_object_part_content_get() instead.
99 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
102 * @brief Unset the icon used for the toggle
104 * @param obj The toggle object
105 * @return The icon object that was being used
107 * Unparent and return the icon object which was set for this widget.
109 * @deprecated use elm_object_part_content_unset() instead.
111 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
114 * @brief Sets the labels to be associated with the on and off states of the toggle.
116 * @param obj The toggle object
117 * @param onlabel The label displayed when the toggle is in the "on" state
118 * @param offlabel The label displayed when the toggle is in the "off" state
120 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
123 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
126 * @brief Gets the labels associated with the on and off states of the
129 * @param obj The toggle object
130 * @param onlabel A char** to place the onlabel of @p obj into
131 * @param offlabel A char** to place the offlabel of @p obj into
133 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
136 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
139 * @brief Sets the state of the toggle to @p state.
141 * @param obj The toggle object
142 * @param state The state of @p obj
144 * @deprecated use elm_check_state_set() instead.
146 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
149 * @brief Gets the state of the toggle to @p state.
151 * @param obj The toggle object
152 * @return The state of @p obj
154 * @deprecated use elm_check_state_get() instead.
156 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
159 * @brief Sets the state pointer of the toggle to @p statep.
161 * @param obj The toggle object
162 * @param statep The state pointer of @p obj
164 * @deprecated use elm_check_state_pointer_set() instead.
166 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
173 * @brief Get Elementary's rendering engine in use.
175 * @return The rendering engine's name
176 * @note there's no need to free the returned string, here.
178 * This gets the global rendering engine that is applied to all Elementary
181 * @see elm_engine_set()
182 * @deprecated Use elm_engine_get() instead.
184 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
187 * Set the configured finger size for all applications on the display
189 * This sets the globally configured finger size in pixels for all
190 * applications on the display
192 * @param size The finger size
194 * @deprecated Use elm_finger_size_set() and elm_config_all_flush()
196 EINA_DEPRECATED EAPI void elm_finger_size_all_set(Evas_Coord size);
199 * Set the global scaling factor for all applications on the display
201 * This sets the globally configured scaling factor that is applied to all
202 * objects for all applications.
203 * @param scale The scaling factor to set
205 * @deprecated use elm_scale_set() and elm_config_all_flush()
207 EINA_DEPRECATED EAPI void elm_scale_all_set(double scale);
210 * Apply the changes made with elm_font_overlay_set() and
211 * elm_font_overlay_unset() on all Elementary application windows.
215 * This applies all font overlays set to all objects in the UI.
216 * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
218 EINA_DEPRECATED EAPI void elm_font_overlay_all_apply(void);
221 * Set the configured cache flush interval time for all applications on the
224 * This sets the globally configured cache flush interval time -- in ticks
225 * -- for all applications on the display.
227 * @param size The cache flush interval time
228 * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
231 EINA_DEPRECATED EAPI void elm_cache_flush_interval_all_set(int size);
234 * Set the configured cache flush enabled state for all applications on the
237 * This sets the globally configured cache flush enabled state for all
238 * applications on the display.
240 * @param enabled The cache flush enabled state
241 * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
244 EINA_DEPRECATED EAPI void elm_cache_flush_enabled_all_set(Eina_Bool enabled);
247 * Set the configured font cache size for all applications on the
250 * This sets the globally configured font cache size -- in bytes
251 * -- for all applications on the display.
253 * @param size The font cache size
254 * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
257 EINA_DEPRECATED EAPI void elm_font_cache_all_set(int size);
260 * Set the configured image cache size for all applications on the
263 * This sets the globally configured image cache size -- in bytes
264 * -- for all applications on the display.
266 * @param size The image cache size
267 * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
270 EINA_DEPRECATED EAPI void elm_image_cache_all_set(int size);
273 * Set the configured edje file cache size for all applications on the
276 * This sets the globally configured edje file cache size -- in number
277 * of files -- for all applications on the display.
279 * @param size The edje file cache size
280 * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
283 EINA_DEPRECATED EAPI void elm_edje_file_cache_all_set(int size);
286 * Set the configured edje collections (groups) cache size for all
287 * applications on the display
289 * This sets the globally configured edje collections cache size -- in
290 * number of collections -- for all applications on the display.
292 * @param size The edje collections cache size
293 * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
296 EINA_DEPRECATED EAPI void elm_edje_collection_cache_all_set(int size);
299 * Set Elementary's profile.
301 * This sets the global profile that is applied to all Elementary
302 * applications. All running Elementary windows will be affected.
304 * @param profile The profile's name
305 * @deprecated Use elm_profile_set() and elm_config_all_flush()
309 EINA_DEPRECATED EAPI void elm_profile_all_set(const char *profile);
312 * Set whether scrollers should bounce when they reach their
313 * viewport's edge during a scroll, for all Elementary application
316 * @param enabled the thumb scroll bouncing state
318 * @see elm_thumbscroll_bounce_enabled_get()
319 * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
322 EINA_DEPRECATED EAPI void elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
325 * Set the amount of inertia a scroller will impose at bounce
326 * animations, for all Elementary application windows.
328 * @param friction the thumb scroll bounce friction
330 * @see elm_thumbscroll_bounce_friction_get()
331 * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
334 EINA_DEPRECATED EAPI void elm_scroll_bounce_friction_all_set(double friction);
337 * Set the amount of inertia a <b>paged</b> scroller will impose at
338 * page fitting animations, for all Elementary application windows.
340 * @param friction the page scroll friction
342 * @see elm_thumbscroll_page_scroll_friction_get()
343 * @deprecated Use elm_scroll_page_scroll_friction_set() and
344 * elm_config_all_flush()
347 EINA_DEPRECATED EAPI void elm_scroll_page_scroll_friction_all_set(double friction);
350 * Set the amount of inertia a scroller will impose at region bring
351 * animations, for all Elementary application windows.
353 * @param friction the bring in scroll friction
355 * @see elm_thumbscroll_bring_in_scroll_friction_get()
356 * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
357 * elm_config_all_flush()
360 EINA_DEPRECATED EAPI void elm_scroll_bring_in_scroll_friction_all_set(double friction);
363 * Set the amount of inertia scrollers will impose at animations
364 * triggered by Elementary widgets' zooming API, for all Elementary
365 * application windows.
367 * @param friction the zoom friction
369 * @see elm_thumbscroll_zoom_friction_get()
370 * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
373 EINA_DEPRECATED EAPI void elm_scroll_zoom_friction_all_set(double friction);
376 * Set whether scrollers should be draggable from any point in their
377 * views, for all Elementary application windows.
379 * @param enabled the thumb scroll state
381 * @see elm_thumbscroll_enabled_get()
382 * @deprecated Use elm_scroll_thumbscroll_enabled_set()
383 * and elm_config_all_flush()
387 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
391 * Set the number of pixels one should travel while dragging a
392 * scroller's view to actually trigger scrolling, for all Elementary
393 * application windows.
395 * @param threshold the thumb scroll threshold
397 * @see elm_thumbscroll_threshold_get()
398 * @deprecated Use elm_scroll_thumbscroll_threshold_set()
399 * and elm_config_all_flush()
403 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
406 * Set the minimum speed of mouse cursor movement which will trigger
407 * list self scrolling animation after a mouse up event
408 * (pixels/second), for all Elementary application windows.
410 * @param threshold the thumb scroll momentum threshold
412 * @see elm_thumbscroll_momentum_threshold_get()
413 * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
414 * and elm_config_all_flush()
418 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
421 * Set the amount of inertia a scroller will impose at self scrolling
422 * animations, for all Elementary application windows.
424 * @param friction the thumb scroll friction
426 * @see elm_thumbscroll_friction_get()
427 * @deprecated Use elm_scroll_thumbscroll_friction_set()
428 * and elm_config_all_flush()
432 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_friction_all_set(double friction);
435 * Set the amount of lag between your actual mouse cursor dragging
436 * movement and a scroller's view movement itself, while pushing it
437 * into bounce state manually, for all Elementary application windows.
439 * @param friction the thumb scroll border friction. @c 0.0 for
440 * perfect synchrony between two movements, @c 1.0 for maximum
443 * @see elm_thumbscroll_border_friction_get()
444 * @note parameter value will get bound to 0.0 - 1.0 interval, always
445 * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
446 * and elm_config_all_flush()
450 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_border_friction_all_set(double friction);
453 * Set the sensitivity amount which is be multiplied by the length of
454 * mouse dragging, for all Elementary application windows.
456 * @param friction the thumb scroll sensitivity friction. @c 0.1 for
457 * minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
460 * @see elm_thumbscroll_sensitivity_friction_get()
461 * @note parameter value will get bound to 0.1 - 1.0 interval, always
462 * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
463 * and elm_config_all_flush()
467 EINA_DEPRECATED EAPI void elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
469 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
470 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
471 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
472 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
473 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
474 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
475 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
476 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
477 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
478 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
479 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
481 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
482 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
483 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
484 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
485 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
486 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
487 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
488 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
489 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
490 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
493 * Get the widget object's handle which contains a given item
495 * @param it The Elementary object item
496 * @return The widget object
498 * @note This returns the widget object itself that an item belongs to.
499 * @note Every elm_object_item supports this API
500 * @deprecated Use elm_object_item_widget_get() instead
503 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it);
506 * Set the text to show in the anchorblock
508 * Sets the text of the anchorblock to @p text. This text can include markup
509 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
510 * of text that will be specially styled and react to click events, ended
511 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
512 * "anchor,clicked" signal that you can attach a callback to with
513 * evas_object_smart_callback_add(). The name of the anchor given in the
514 * event info struct will be the one set in the href attribute, in this
517 * Other markup can be used to style the text in different ways, but it's
518 * up to the style defined in the theme which tags do what.
519 * @deprecated use elm_object_text_set() instead.
521 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
524 * Get the markup text set for the anchorblock
526 * Retrieves the text set on the anchorblock, with markup tags included.
528 * @param obj The anchorblock object
529 * @return The markup text set or @c NULL if nothing was set or an error
531 * @deprecated use elm_object_text_set() instead.
533 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
536 * Set the text to show in the anchorview
538 * Sets the text of the anchorview to @p text. This text can include markup
539 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
540 * text that will be specially styled and react to click events, ended with
541 * either of \</a\> or \</\>. When clicked, the anchor will emit an
542 * "anchor,clicked" signal that you can attach a callback to with
543 * evas_object_smart_callback_add(). The name of the anchor given in the
544 * event info struct will be the one set in the href attribute, in this
547 * Other markup can be used to style the text in different ways, but it's
548 * up to the style defined in the theme which tags do what.
549 * @deprecated use elm_object_text_set() instead.
551 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
554 * Get the markup text set for the anchorview
556 * Retrieves the text set on the anchorview, with markup tags included.
558 * @param obj The anchorview object
559 * @return The markup text set or @c NULL if nothing was set or an error
561 * @deprecated use elm_object_text_set() instead.
563 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
566 * @brief Get the ctxpopup item's disabled/enabled state.
568 * @param it Ctxpopup item to be enabled/disabled
569 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
571 * @see elm_ctxpopup_item_disabled_set()
572 * @deprecated use elm_object_item_disabled_get() instead
576 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
579 * @brief Set the ctxpopup item's state as disabled or enabled.
581 * @param it Ctxpopup item to be enabled/disabled
582 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
584 * When disabled the item is greyed out to indicate it's state.
585 * @deprecated use elm_object_item_disabled_set() instead
589 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
592 * @brief Get the icon object for the given ctxpopup item.
594 * @param it Ctxpopup item
595 * @return icon object or @c NULL, if the item does not have icon or an error
598 * @see elm_ctxpopup_item_append()
599 * @see elm_ctxpopup_item_icon_set()
601 * @deprecated use elm_object_item_part_content_get() instead
605 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
608 * @brief Sets the side icon associated with the ctxpopup item
610 * @param it Ctxpopup item
611 * @param icon Icon object to be set
613 * Once the icon object is set, a previously set one will be deleted.
614 * @warning Setting the same icon for two items will cause the icon to
615 * disappear from the first item.
617 * @see elm_ctxpopup_item_append()
619 * @deprecated use elm_object_item_part_content_set() instead
623 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
626 * @brief Get the label for the given ctxpopup item.
628 * @param it Ctxpopup item
629 * @return label string or @c NULL, if the item does not have label or an
632 * @see elm_ctxpopup_item_append()
633 * @see elm_ctxpopup_item_label_set()
635 * @deprecated use elm_object_item_text_get() instead
639 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
642 * @brief (Re)set the label on the given ctxpopup item.
644 * @param it Ctxpopup item
645 * @param label String to set as label
647 * @deprecated use elm_object_item_text_set() instead
651 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
654 * @brief Set an elm widget as the content of the ctxpopup.
656 * @param obj Ctxpopup object
657 * @param content Content to be swallowed
659 * If the content object is already set, a previous one will be deleted. If
660 * you want to keep that old content object, use the
661 * elm_ctxpopup_content_unset() function.
663 * @warning Ctxpopup can't hold both a item list and a content at the same
664 * time. When a content is set, any previous items will be removed.
666 * @deprecated use elm_object_content_set() instead
670 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
673 * @brief Unset the ctxpopup content
675 * @param obj Ctxpopup object
676 * @return The content that was being used
678 * Unparent and return the content object which was set for this widget.
680 * @deprecated use elm_object_content_unset()
682 * @see elm_ctxpopup_content_set()
684 * @deprecated use elm_object_content_unset() instead
688 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
691 * @brief Delete the given item in a ctxpopup object.
693 * @param it Ctxpopup item to be deleted
695 * @deprecated Use elm_object_item_del() instead
696 * @see elm_ctxpopup_item_append()
700 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
703 * Set the label for a given file selector button widget
705 * @param obj The file selector button widget
706 * @param label The text label to be displayed on @p obj
708 * @deprecated use elm_object_text_set() instead.
710 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
713 * Get the label set for a given file selector button widget
715 * @param obj The file selector button widget
716 * @return The button label
718 * @deprecated use elm_object_text_set() instead.
720 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
723 * Set the icon on a given file selector button widget
725 * @param obj The file selector button widget
726 * @param icon The icon object for the button
728 * Once the icon object is set, a previously set one will be
729 * deleted. If you want to keep the latter, use the
730 * elm_fileselector_button_icon_unset() function.
732 * @deprecated Use elm_object_part_content_set() instead
733 * @see elm_fileselector_button_icon_get()
735 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
738 * Get the icon set for a given file selector button widget
740 * @param obj The file selector button widget
741 * @return The icon object currently set on @p obj or @c NULL, if
744 * @deprecated Use elm_object_part_content_get() instead
745 * @see elm_fileselector_button_icon_set()
747 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
750 * Unset the icon used in a given file selector button widget
752 * @param obj The file selector button widget
753 * @return The icon object that was being used on @p obj or @c
756 * Unparent and return the icon object which was set for this
759 * @deprecated Use elm_object_part_content_unset() instead
760 * @see elm_fileselector_button_icon_set()
762 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
765 * Set the label for a given file selector entry widget's button
767 * @param obj The file selector entry widget
768 * @param label The text label to be displayed on @p obj widget's
771 * @deprecated use elm_object_text_set() instead.
773 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
776 * Get the label set for a given file selector entry widget's button
778 * @param obj The file selector entry widget
779 * @return The widget button's label
781 * @deprecated use elm_object_text_set() instead.
783 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
786 * Set the icon on a given file selector entry widget's button
788 * @param obj The file selector entry widget
789 * @param icon The icon object for the entry's button
791 * Once the icon object is set, a previously set one will be
792 * deleted. If you want to keep the latter, use the
793 * elm_fileselector_entry_button_icon_unset() function.
795 * @deprecated Use elm_object_part_content_set() instead
796 * @see elm_fileselector_entry_button_icon_get()
798 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
801 * Get the icon set for a given file selector entry widget's button
803 * @param obj The file selector entry widget
804 * @return The icon object currently set on @p obj widget's button
805 * or @c NULL, if none is
807 * @deprecated Use elm_object_part_content_get() instead
808 * @see elm_fileselector_entry_button_icon_set()
810 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
813 * Unset the icon used in a given file selector entry widget's
816 * @param obj The file selector entry widget
817 * @return The icon object that was being used on @p obj widget's
818 * button or @c NULL, on errors
820 * Unparent and return the icon object which was set for this
823 * @deprecated Use elm_object_part_content_unset() instead
824 * @see elm_fileselector_entry_button_icon_set()
826 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
829 * @brief Sets the content of the hover object and the direction in which it
832 * @param obj The hover object
833 * @param swallow The direction that the object will be displayed
834 * at. Accepted values are "left", "top-left", "top", "top-right",
835 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
837 * @param content The content to place at @p swallow
839 * Once the content object is set for a given direction, a previously
840 * set one (on the same direction) will be deleted. If you want to
841 * keep that old content object, use the elm_object_part_content_unset()
844 * All directions may have contents at the same time, except for
845 * "smart". This is a special placement hint and its use case
846 * depends of the calculations coming from
847 * elm_hover_best_content_location_get(). Its use is for cases when
848 * one desires only one hover content, but with a dynamic special
849 * placement within the hover area. The content's geometry, whenever
850 * it changes, will be used to decide on a best location, not
851 * extrapolating the hover's parent object view to show it in (still
852 * being the hover's target determinant of its medium part -- move and
853 * resize it to simulate finger sizes, for example). If one of the
854 * directions other than "smart" are used, a previously content set
855 * using it will be deleted, and vice-versa.
857 * @deprecated Use elm_object_part_content_set() instead
859 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
862 * @brief Get the content of the hover object, in a given direction.
864 * Return the content object which was set for this widget in the
865 * @p swallow direction.
867 * @param obj The hover object
868 * @param swallow The direction that the object was display at.
869 * @return The content that was being used
871 * @deprecated Use elm_object_part_content_get() instead
872 * @see elm_object_part_content_set()
874 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
877 * @brief Unset the content of the hover object, in a given direction.
879 * Unparent and return the content object set at @p swallow direction.
881 * @param obj The hover object
882 * @param swallow The direction that the object was display at.
883 * @return The content that was being used.
885 * @deprecated Use elm_object_part_content_unset() instead
886 * @see elm_object_part_content_set()
888 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
891 * @brief Set the hoversel button label
893 * @param obj The hoversel object
894 * @param label The label text.
896 * This sets the label of the button that is always visible (before it is
897 * clicked and expanded).
899 * @deprecated elm_object_text_set()
901 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
904 * @brief Get the hoversel button label
906 * @param obj The hoversel object
907 * @return The label text.
909 * @deprecated elm_object_text_get()
911 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
914 * @brief Set the icon of the hoversel button
916 * @param obj The hoversel object
917 * @param icon The icon object
919 * Sets the icon of the button that is always visible (before it is clicked
920 * and expanded). Once the icon object is set, a previously set one will be
921 * deleted, if you want to keep that old content object, use the
922 * elm_hoversel_icon_unset() function.
924 * @see elm_object_content_set() for the button widget
925 * @deprecated Use elm_object_item_part_content_set() instead
927 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
930 * @brief Get the icon of the hoversel button
932 * @param obj The hoversel object
933 * @return The icon object
935 * Get the icon of the button that is always visible (before it is clicked
936 * and expanded). Also see elm_object_content_get() for the button widget.
938 * @see elm_hoversel_icon_set()
939 * @deprecated Use elm_object_item_part_content_get() instead
941 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
944 * @brief Get and unparent the icon of the hoversel button
946 * @param obj The hoversel object
947 * @return The icon object that was being used
949 * Unparent and return the icon of the button that is always visible
950 * (before it is clicked and expanded).
952 * @see elm_hoversel_icon_set()
953 * @see elm_object_content_unset() for the button widget
954 * @deprecated Use elm_object_item_part_content_unset() instead
956 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
959 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
960 * that will be passed to associated function callbacks.
962 * @param it The item to get the data from
963 * @return The data pointer set with elm_hoversel_item_add()
965 * @see elm_hoversel_item_add()
966 * @deprecated Use elm_object_item_data_get() instead
968 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
971 * @brief This returns the label text of the given hoversel item.
973 * @param it The item to get the label
974 * @return The label text of the hoversel item
976 * @see elm_hoversel_item_add()
977 * @deprecated Use elm_object_item_text_get() instead
979 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
982 * @brief Set the function to be called when an item from the hoversel is
985 * @param it The item to set the callback on
986 * @param func The function called
988 * That function will receive these parameters:
989 * @li void * item data
990 * @li Evas_Object * hoversel object
991 * @li Elm_Object_Item * hoversel item
993 * @see elm_hoversel_item_add()
994 * @deprecated Use elm_object_item_del_cb_set() instead
996 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
999 * @brief Delete an item from the hoversel
1001 * @param it The item to delete
1003 * This deletes the item from the hoversel (should not be called while the
1004 * hoversel is active; use elm_hoversel_expanded_get() to check first).
1006 * @deprecated Use elm_object_item_del() instead
1007 * @see elm_hoversel_item_add()
1009 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
1012 * Set actionslider labels.
1014 * @param obj The actionslider object
1015 * @param left_label The label to be set on the left.
1016 * @param center_label The label to be set on the center.
1017 * @param right_label The label to be set on the right.
1018 * @deprecated use elm_object_text_set() instead.
1020 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
1023 * Get actionslider labels.
1025 * @param obj The actionslider object
1026 * @param left_label A char** to place the left_label of @p obj into.
1027 * @param center_label A char** to place the center_label of @p obj into.
1028 * @param right_label A char** to place the right_label of @p obj into.
1029 * @deprecated use elm_object_text_set() instead.
1031 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
1034 * Set the label used on the indicator.
1036 * @param obj The actionslider object
1037 * @param label The label to be set on the indicator.
1038 * @deprecated use elm_object_text_set() instead.
1040 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
1043 * Get the label used on the indicator object.
1045 * @param obj The actionslider object
1046 * @return The indicator label
1047 * @deprecated use elm_object_text_get() instead.
1049 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
1052 * Set the overlay object used for the background object.
1054 * @param obj The bg object
1055 * @param overlay The overlay object
1057 * This provides a way for elm_bg to have an 'overlay' that will be on top
1058 * of the bg. Once the over object is set, a previously set one will be
1059 * deleted, even if you set the new one to NULL. If you want to keep that
1060 * old content object, use the elm_bg_overlay_unset() function.
1062 * @deprecated use elm_object_part_content_set() instead
1067 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
1070 * Get the overlay object used for the background object.
1072 * @param obj The bg object
1073 * @return The content that is being used
1075 * Return the content object which is set for this widget
1077 * @deprecated use elm_object_part_content_get() instead
1081 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
1084 * Get the overlay object used for the background object.
1086 * @param obj The bg object
1087 * @return The content that was being used
1089 * Unparent and return the overlay object which was set for this widget
1091 * @deprecated use elm_object_part_content_unset() instead
1095 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
1099 * Set the label of the bubble
1101 * @param obj The bubble object
1102 * @param label The string to set in the label
1104 * This function sets the title of the bubble. Where this appears depends on
1105 * the selected corner.
1106 * @deprecated use elm_object_text_set() instead.
1108 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
1111 * Get the label of the bubble
1113 * @param obj The bubble object
1114 * @return The string of set in the label
1116 * This function gets the title of the bubble.
1117 * @deprecated use elm_object_text_get() instead.
1119 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
1122 * Set the info of the bubble
1124 * @param obj The bubble object
1125 * @param info The given info about the bubble
1127 * This function sets the info of the bubble. Where this appears depends on
1128 * the selected corner.
1129 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
1131 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
1134 * Get the info of the bubble
1136 * @param obj The bubble object
1138 * @return The "info" string of the bubble
1140 * This function gets the info text.
1141 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
1143 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
1146 * Set the content to be shown in the bubble
1148 * Once the content object is set, a previously set one will be deleted.
1149 * If you want to keep the old content object, use the
1150 * elm_bubble_content_unset() function.
1152 * @param obj The bubble object
1153 * @param content The given content of the bubble
1155 * This function sets the content shown on the middle of the bubble.
1157 * @deprecated use elm_object_content_set() instead
1160 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1163 * Get the content shown in the bubble
1165 * Return the content object which is set for this widget.
1167 * @param obj The bubble object
1168 * @return The content that is being used
1170 * @deprecated use elm_object_content_get() instead
1173 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1176 * Unset the content shown in the bubble
1178 * Unparent and return the content object which was set for this widget.
1180 * @param obj The bubble object
1181 * @return The content that was being used
1183 * @deprecated use elm_object_content_unset() instead
1186 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1189 * Set the icon of the bubble
1191 * Once the icon object is set, a previously set one will be deleted.
1192 * If you want to keep the old content object, use the
1193 * elm_icon_content_unset() function.
1195 * @param obj The bubble object
1196 * @param icon The given icon for the bubble
1198 * @deprecated use elm_object_part_content_set() instead
1201 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1204 * Get the icon of the bubble
1206 * @param obj The bubble object
1207 * @return The icon for the bubble
1209 * This function gets the icon shown on the top left of bubble.
1211 * @deprecated use elm_object_part_content_get() instead
1214 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1217 * Unset the icon of the bubble
1219 * Unparent and return the icon object which was set for this widget.
1221 * @param obj The bubble object
1222 * @return The icon that was being used
1224 * @deprecated use elm_object_part_content_unset() instead
1227 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1231 * Set the label used in the button
1233 * The passed @p label can be NULL to clean any existing text in it and
1234 * leave the button as an icon only object.
1236 * @param obj The button object
1237 * @param label The text will be written on the button
1238 * @deprecated use elm_object_text_set() instead.
1240 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1243 * Get the label set for the button
1245 * The string returned is an internal pointer and should not be freed or
1246 * altered. It will also become invalid when the button is destroyed.
1247 * The string returned, if not NULL, is a stringshare, so if you need to
1248 * keep it around even after the button is destroyed, you can use
1249 * eina_stringshare_ref().
1251 * @param obj The button object
1252 * @return The text set to the label, or NULL if nothing is set
1253 * @deprecated use elm_object_text_set() instead.
1255 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1258 * Set the icon used for the button
1260 * Setting a new icon will delete any other that was previously set, making
1261 * any reference to them invalid. If you need to maintain the previous
1262 * object alive, unset it first with elm_button_icon_unset().
1264 * @param obj The button object
1265 * @param icon The icon object for the button
1266 * @deprecated use elm_object_part_content_set() instead.
1268 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1271 * Get the icon used for the button
1273 * Return the icon object which is set for this widget. If the button is
1274 * destroyed or another icon is set, the returned object will be deleted
1275 * and any reference to it will be invalid.
1277 * @param obj The button object
1278 * @return The icon object that is being used
1280 * @deprecated use elm_object_part_content_get() instead
1282 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1285 * Remove the icon set without deleting it and return the object
1287 * This function drops the reference the button holds of the icon object
1288 * and returns this last object. It is used in case you want to remove any
1289 * icon, or set another one, without deleting the actual object. The button
1290 * will be left without an icon set.
1292 * @param obj The button object
1293 * @return The icon object that was being used
1294 * @deprecated use elm_object_part_content_unset() instead.
1296 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1299 * Set a day text color to the same that represents Saturdays.
1301 * @param obj The calendar object.
1302 * @param pos The text position. Position is the cell counter, from left
1303 * to right, up to down. It starts on 0 and ends on 41.
1305 * @deprecated use elm_calendar_mark_add() instead like:
1308 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1309 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1312 * @see elm_calendar_mark_add()
1316 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1319 * Set a day text color to the same that represents Sundays.
1321 * @param obj The calendar object.
1322 * @param pos The text position. Position is the cell counter, from left
1323 * to right, up to down. It starts on 0 and ends on 41.
1325 * @deprecated use elm_calendar_mark_add() instead like:
1328 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1329 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1332 * @see elm_calendar_mark_add()
1336 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1339 * Set a day text color to the same that represents Weekdays.
1341 * @param obj The calendar object
1342 * @param pos The text position. Position is the cell counter, from left
1343 * to right, up to down. It starts on 0 and ends on 41.
1345 * @deprecated use elm_calendar_mark_add() instead like:
1348 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1350 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1351 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1352 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1353 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1354 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1355 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1356 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1357 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1358 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1361 * @see elm_calendar_mark_add()
1365 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1369 * @brief Set the text label of the check object
1371 * @param obj The check object
1372 * @param label The text label string in UTF-8
1374 * @deprecated use elm_object_text_set() instead.
1376 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1379 * @brief Get the text label of the check object
1381 * @param obj The check object
1382 * @return The text label string in UTF-8
1384 * @deprecated use elm_object_text_get() instead.
1386 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1389 * @brief Set the icon object of the check object
1391 * @param obj The check object
1392 * @param icon The icon object
1394 * Once the icon object is set, a previously set one will be deleted.
1395 * If you want to keep that old content object, use the
1396 * elm_object_content_unset() function.
1398 * @deprecated use elm_object_part_content_set() instead.
1401 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1404 * @brief Get the icon object of the check object
1406 * @param obj The check object
1407 * @return The icon object
1409 * @deprecated use elm_object_part_content_get() instead.
1412 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1415 * @brief Unset the icon used for the check object
1417 * @param obj The check object
1418 * @return The icon object that was being used
1420 * Unparent and return the icon object which was set for this widget.
1422 * @deprecated use elm_object_part_content_unset() instead.
1425 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1428 * @brief Set the text label of the check object
1430 * @param obj The check object
1431 * @param label The text label string in UTF-8
1433 * @deprecated use elm_object_text_set() instead.
1435 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1438 * @brief Get the text label of the check object
1440 * @param obj The check object
1441 * @return The text label string in UTF-8
1443 * @deprecated use elm_object_text_get() instead.
1445 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1448 * @brief Set the icon object of the check object
1450 * @param obj The check object
1451 * @param icon The icon object
1453 * Once the icon object is set, a previously set one will be deleted.
1454 * If you want to keep that old content object, use the
1455 * elm_object_content_unset() function.
1457 * @deprecated use elm_object_part_content_set() instead.
1460 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1463 * @brief Get the icon object of the check object
1465 * @param obj The check object
1466 * @return The icon object
1468 * @deprecated use elm_object_part_content_get() instead.
1471 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1474 * @brief Unset the icon used for the check object
1476 * @param obj The check object
1477 * @return The icon object that was being used
1479 * Unparent and return the icon object which was set for this widget.
1481 * @deprecated use elm_object_part_content_unset() instead.
1484 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1486 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1487 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1491 * Set the content of the conformant widget.
1493 * @param obj The conformant object.
1494 * @param content The content to be displayed by the conformant.
1496 * Content will be sized and positioned considering the space required
1497 * to display a virtual keyboard. So it won't fill all the conformant
1498 * size. This way is possible to be sure that content won't resize
1499 * or be re-positioned after the keyboard is displayed.
1501 * Once the content object is set, a previously set one will be deleted.
1502 * If you want to keep that old content object, use the
1503 * elm_object_content_unset() function.
1505 * @see elm_object_content_unset()
1506 * @see elm_object_content_get()
1508 * @deprecated use elm_object_content_set() instead
1510 * @ingroup Conformant
1512 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1515 * Get the content of the conformant widget.
1517 * @param obj The conformant object.
1518 * @return The content that is being used.
1520 * Return the content object which is set for this widget.
1521 * It won't be unparent from conformant. For that, use
1522 * elm_object_content_unset().
1524 * @see elm_object_content_set().
1525 * @see elm_object_content_unset()
1527 * @deprecated use elm_object_content_get() instead
1529 * @ingroup Conformant
1531 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1534 * Unset the content of the conformant widget.
1536 * @param obj The conformant object.
1537 * @return The content that was being used.
1539 * Unparent and return the content object which was set for this widget.
1541 * @see elm_object_content_set().
1543 * @deprecated use elm_object_content_unset() instead
1545 * @ingroup Conformant
1547 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1550 * Get the side labels max length.
1552 * @deprecated use elm_diskselector_side_label_length_get() instead:
1554 * @param obj The diskselector object.
1555 * @return The max length defined for side labels, or 0 if not a valid
1558 * @ingroup Diskselector
1560 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1563 * Set the side labels max length.
1565 * @deprecated use elm_diskselector_side_label_length_set() instead:
1567 * @param obj The diskselector object.
1568 * @param len The max length defined for side labels.
1570 * @ingroup Diskselector
1572 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1575 * Get the data associated to the item.
1577 * @param it The diskselector item
1578 * @return The data associated to @p it
1580 * The return value is a pointer to data associated to @p item when it was
1581 * created, with function elm_diskselector_item_append(). If no data
1582 * was passed as argument, it will return @c NULL.
1584 * @see elm_diskselector_item_append()
1585 * @deprecated Use elm_object_item_data_get()
1587 * @ingroup Diskselector
1589 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1592 * Set the icon associated to the item.
1594 * @param it The diskselector item
1595 * @param icon The icon object to associate with @p it
1597 * The icon object to use at left side of the item. An
1598 * icon can be any Evas object, but usually it is an icon created
1599 * with elm_icon_add().
1601 * Once the icon object is set, a previously set one will be deleted.
1602 * @warning Setting the same icon for two items will cause the icon to
1603 * disappear from the first item.
1605 * If an icon was passed as argument on item creation, with function
1606 * elm_diskselector_item_append(), it will be already
1607 * associated to the item.
1609 * @see elm_diskselector_item_append()
1610 * @see elm_diskselector_item_icon_get()
1612 * @deprecated Use elm_object_item_part_content_set() instead
1613 * @ingroup Diskselector
1615 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1618 * Get the icon associated to the item.
1620 * @param it The diskselector item
1621 * @return The icon associated to @p it
1623 * The return value is a pointer to the icon associated to @p item when it was
1624 * created, with function elm_diskselector_item_append(), or later
1625 * with function elm_diskselector_item_icon_set. If no icon
1626 * was passed as argument, it will return @c NULL.
1628 * @see elm_diskselector_item_append()
1629 * @see elm_diskselector_item_icon_set()
1631 * @deprecated Use elm_object_item_part_content_set() instead
1632 * @ingroup Diskselector
1634 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1637 * Set the label of item.
1639 * @param it The item of diskselector.
1640 * @param label The label of item.
1642 * The label to be displayed by the item.
1644 * If no icon is set, label will be centered on item position, otherwise
1645 * the icon will be placed at left of the label, that will be shifted
1648 * An item with label "January" would be displayed on side position as
1649 * "Jan" if max length is set to 3 with function
1650 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1653 * When this @p item is selected, the entire label will be displayed,
1654 * except for width restrictions.
1655 * In this case label will be cropped and "..." will be concatenated,
1656 * but only for display purposes. It will keep the entire string, so
1657 * if diskselector is resized the remaining characters will be displayed.
1659 * If a label was passed as argument on item creation, with function
1660 * elm_diskselector_item_append(), it will be already
1661 * displayed by the item.
1663 * @see elm_diskselector_side_label_length_set()
1664 * @see elm_diskselector_item_label_get()
1665 * @see elm_diskselector_item_append()
1667 * @deprecated Use elm_object_item_text_set() instead
1668 * @ingroup Diskselector
1670 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1673 * Get the label of item.
1675 * @param it The item of diskselector.
1676 * @return The label of item.
1678 * The return value is a pointer to the label associated to @p item when it was
1679 * created, with function elm_diskselector_item_append(), or later
1680 * with function elm_diskselector_item_label_set. If no label
1681 * was passed as argument, it will return @c NULL.
1683 * @see elm_diskselector_item_label_set() for more details.
1684 * @see elm_diskselector_item_append()
1685 * @deprecated Use elm_object_item_text_get() instead
1687 * @ingroup Diskselector
1689 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1692 * Set the function called when a diskselector item is freed.
1694 * @param it The item to set the callback on
1695 * @param func The function called
1697 * If there is a @p func, then it will be called prior item's memory release.
1698 * That will be called with the following arguments:
1700 * @li item's Evas object;
1703 * This way, a data associated to a diskselector item could be properly
1705 * @deprecated Use elm_object_item_del_cb_set() instead
1707 * @ingroup Diskselector
1709 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1712 * Delete them item from the diskselector.
1714 * @param it The item of diskselector to be deleted.
1716 * If deleting all diskselector items is required, elm_diskselector_clear()
1717 * should be used instead of getting items list and deleting each one.
1719 * @deprecated Use elm_object_item_del() instead
1720 * @see elm_diskselector_clear()
1721 * @see elm_diskselector_item_append()
1723 * @ingroup Diskselector
1725 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1728 * Set the text to be shown in the diskselector item.
1730 * @param it Target item
1731 * @param text The text to set in the content
1733 * Setup the text as tooltip to object. The item can have only one tooltip,
1734 * so any previous tooltip data is removed.
1736 * @deprecated Use elm_object_item_tooltip_text_set() instead
1737 * @see elm_object_tooltip_text_set() for more details.
1739 * @ingroup Diskselector
1741 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1744 * Set the content to be shown in the tooltip item.
1746 * Setup the tooltip to item. The item can have only one tooltip,
1747 * so any previous tooltip data is removed. @p func(with @p data) will
1748 * be called every time that need show the tooltip and it should
1749 * return a valid Evas_Object. This object is then managed fully by
1750 * tooltip system and is deleted when the tooltip is gone.
1752 * @param it the diskselector item being attached a tooltip.
1753 * @param func the function used to create the tooltip contents.
1754 * @param data what to provide to @a func as callback data/context.
1755 * @param del_cb called when data is not needed anymore, either when
1756 * another callback replaces @p func, the tooltip is unset with
1757 * elm_diskselector_item_tooltip_unset() or the owner @a item
1758 * dies. This callback receives as the first parameter the
1759 * given @a data, and @c event_info is the item.
1761 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1762 * @see elm_object_tooltip_content_cb_set() for more details.
1764 * @ingroup Diskselector
1766 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);
1769 * Unset tooltip from item.
1771 * @param it diskselector item to remove previously set tooltip.
1773 * Remove tooltip from item. The callback provided as del_cb to
1774 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1775 * it is not used anymore.
1777 * @deprecated Use elm_object_item_tooltip_unset() instead
1778 * @see elm_object_tooltip_unset() for more details.
1779 * @see elm_diskselector_item_tooltip_content_cb_set()
1781 * @ingroup Diskselector
1783 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1786 * Sets a different style for this item tooltip.
1788 * @note before you set a style you should define a tooltip with
1789 * elm_diskselector_item_tooltip_content_cb_set() or
1790 * elm_diskselector_item_tooltip_text_set()
1792 * @param it diskselector item with tooltip already set.
1793 * @param style the theme style to use (default, transparent, ...)
1795 * @deprecated Use elm_object_item_tooltip_style_set() instead
1796 * @see elm_object_tooltip_style_set() for more details.
1798 * @ingroup Diskselector
1800 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1803 * Get the style for this item tooltip.
1805 * @param it diskselector item with tooltip already set.
1806 * @return style the theme style in use, defaults to "default". If the
1807 * object does not have a tooltip set, then NULL is returned.
1809 * @deprecated Use elm_object_item_tooltip_style_get() instead
1810 * @see elm_object_tooltip_style_get() for more details.
1811 * @see elm_diskselector_item_tooltip_style_set()
1813 * @ingroup Diskselector
1815 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1818 * Set the cursor to be shown when mouse is over the diskselector item
1820 * @param it Target item
1821 * @param cursor the cursor name to be used.
1823 * @see elm_object_cursor_set() for more details.
1824 * @deprecated Use elm_object_item_cursor_set() instead
1826 * @ingroup Diskselector
1828 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1831 * Get the cursor to be shown when mouse is over the diskselector item
1833 * @param it diskselector item with cursor already set.
1834 * @return the cursor name.
1836 * @see elm_object_cursor_get() for more details.
1837 * @see elm_diskselector_item_cursor_set()
1838 * @deprecated Use elm_object_item_cursor_get() instead
1840 * @ingroup Diskselector
1842 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1845 * Unset the cursor to be shown when mouse is over the diskselector item
1847 * @param it Target item
1849 * @see elm_object_cursor_unset() for more details.
1850 * @see elm_diskselector_item_cursor_set()
1851 * @deprecated use elm_object_item_cursor_unset() instead
1853 * @ingroup Diskselector
1855 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1858 * Sets a different style for this item cursor.
1860 * @note before you set a style you should define a cursor with
1861 * elm_diskselector_item_cursor_set()
1863 * @param it diskselector item with cursor already set.
1864 * @param style the theme style to use (default, transparent, ...)
1866 * @see elm_object_cursor_style_set() for more details.
1867 * @deprecated Use elm_object_item_cursor_style_set() instead
1869 * @ingroup Diskselector
1871 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1874 * Get the style for this item cursor.
1876 * @param it diskselector item with cursor already set.
1877 * @return style the theme style in use, defaults to "default". If the
1878 * object does not have a cursor set, then @c NULL is returned.
1880 * @see elm_object_cursor_style_get() for more details.
1881 * @see elm_diskselector_item_cursor_style_set()
1882 * @deprecated Use elm_object_item_cursor_style_get() instead
1884 * @ingroup Diskselector
1886 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1889 * Set if the cursor set should be searched on the theme or should use
1890 * the provided by the engine, only.
1892 * @note before you set if should look on theme you should define a cursor
1893 * with elm_diskselector_item_cursor_set().
1894 * By default it will only look for cursors provided by the engine.
1896 * @param it widget item with cursor already set.
1897 * @param engine_only boolean to define if cursors set with
1898 * elm_diskselector_item_cursor_set() should be searched only
1899 * between cursors provided by the engine or searched on widget's
1902 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1904 * @ingroup Diskselector
1906 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1909 * Get the cursor engine only usage for this item cursor.
1911 * @param it widget item with cursor already set.
1912 * @return engine_only boolean to define it cursors should be looked only
1913 * between the provided by the engine or searched on widget's theme as well.
1914 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1916 * @see elm_diskselector_item_cursor_engine_only_set()
1917 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1919 * @ingroup Diskselector
1921 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1923 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1924 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1927 * Get the label of a given flip selector widget's item.
1929 * @param it The item to get label from
1930 * @return The text label of @p item or @c NULL, on errors
1932 * @see elm_object_item_text_set()
1934 * @deprecated see elm_object_item_text_get() instead
1935 * @ingroup Flipselector
1937 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1940 * Set the label of a given flip selector widget's item.
1942 * @param it The item to set label on
1943 * @param label The text label string, in UTF-8 encoding
1945 * @see elm_object_item_text_get()
1947 * @deprecated see elm_object_item_text_set() instead
1948 * @ingroup Flipselector
1950 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1953 * Delete a given item from a flip selector widget.
1955 * @param it The item to delete
1957 * @deprecated Use elm_object_item_del() instead
1958 * @ingroup Flipselector
1960 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1963 * Set the interval on time updates for a user mouse button hold
1964 * on a flip selector widget.
1966 * @param obj The flip selector object
1967 * @param interval The (first) interval value in seconds
1969 * This interval value is @b decreased while the user holds the
1970 * mouse pointer either flipping up or flipping down a given flip
1973 * This helps the user to get to a given item distant from the
1974 * current one easier/faster, as it will start to flip quicker and
1975 * quicker on mouse button holds.
1977 * The calculation for the next flip interval value, starting from
1978 * the one set with this call, is the previous interval divided by
1979 * 1.05, so it decreases a little bit.
1981 * The default starting interval value for automatic flips is
1984 * @see elm_flipselector_interval_get()
1985 * @deprecated Use elm_flipselector_first_interval_set()
1987 * @ingroup Flipselector
1989 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
1992 * Get the interval on time updates for an user mouse button hold
1993 * on a flip selector widget.
1995 * @param obj The flip selector object
1996 * @return The (first) interval value, in seconds, set on it
1998 * @see elm_flipselector_interval_set() for more details
1999 * @deprecated Use elm_flipselector_first_interval_get()
2001 * @ingroup Flipselector
2003 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
2006 * Make a given Elementary object the focused one.
2008 * @param obj The Elementary object to make focused.
2010 * @note This object, if it can handle focus, will take the focus
2011 * away from the one who had it previously and will, for now on, be
2012 * the one receiving input events.
2014 * @see elm_object_focus_get()
2015 * @deprecated use elm_object_focus_set() instead.
2019 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
2022 * Give focus to next object in object tree.
2024 * Give focus to next object in focus chain of one object sub-tree.
2025 * If the last object of chain already have focus, the focus will go to the
2026 * first object of chain.
2028 * @param obj The object root of sub-tree
2029 * @param dir Direction to cycle the focus
2031 * @deprecated Use elm_object_focus_next() instead
2035 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
2038 * Remove the focus from an Elementary object
2040 * @param obj The Elementary to take focus from
2042 * This removes the focus from @p obj, passing it back to the
2043 * previous element in the focus chain list.
2045 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
2046 * @deprecated use elm_object_focus_set() instead.
2050 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
2053 * Give focus to near object in one direction.
2055 * Give focus to near object in direction of one object.
2056 * If none focusable object in given direction, the focus will not change.
2058 * @param obj The reference object
2059 * @param x Horizontal component of direction to focus
2060 * @param y Vertical component of direction to focus
2062 * @deprecated Support it later.
2065 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
2068 * @brief Set the frame label
2070 * @param obj The frame object
2071 * @param label The label of this frame object
2073 * @deprecated use elm_object_text_set() instead.
2075 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
2078 * @brief Get the frame label
2080 * @param obj The frame object
2082 * @return The label of this frame object or NULL if unable to get frame
2084 * @deprecated use elm_object_text_get() instead.
2086 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
2089 * @brief Set the content of the frame widget
2091 * Once the content object is set, a previously set one will be deleted.
2092 * If you want to keep that old content object, use the
2093 * elm_frame_content_unset() function.
2095 * @param obj The frame object
2096 * @param content The content will be filled in this frame object
2098 * @deprecated use elm_object_content_set() instead.
2100 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
2103 * @brief Get the content of the frame widget
2105 * Return the content object which is set for this widget
2107 * @param obj The frame object
2108 * @return The content that is being used
2110 * @deprecated use elm_object_content_get() instead.
2112 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
2115 * @brief Unset the content of the frame widget
2117 * Unparent and return the content object which was set for this widget
2119 * @param obj The frame object
2120 * @return The content that was being used
2122 * @deprecated use elm_object_content_unset() instead.
2124 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
2126 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
2127 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
2128 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
2130 * This sets the horizontal stretching mode.
2132 * @param obj The genlist object
2133 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
2135 * This sets the mode used for sizing items horizontally. Valid modes
2136 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
2137 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
2138 * the scroller will scroll horizontally. Otherwise items are expanded
2139 * to fill the width of the viewport of the scroller. If it is
2140 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
2141 * limited to that size.
2143 * @see elm_genlist_horizontal_get()
2145 * @deprecated use elm_genlist_mode_set()
2148 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
2151 * Gets the horizontal stretching mode.
2153 * @param obj The genlist object
2154 * @return The mode to use
2155 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
2157 * @see elm_genlist_horizontal_set()
2159 * @deprecated use elm_genlist_mode_get()
2162 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
2165 * Return the data associated to a given genlist item
2167 * @param it The genlist item.
2168 * @return the data associated to this item.
2170 * This returns the @c data value passed on the
2171 * elm_genlist_item_append() and related item addition calls.
2173 * @see elm_genlist_item_append()
2174 * @see elm_genlist_item_data_set()
2176 * @deprecated Use elm_object_item_data_get() instead
2179 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
2182 * Set the data associated to a given genlist item
2184 * @param it The genlist item
2185 * @param data The new data pointer to set on it
2187 * This @b overrides the @c data value passed on the
2188 * elm_genlist_item_append() and related item addition calls. This
2189 * function @b won't call elm_genlist_item_update() automatically,
2190 * so you'd issue it afterwards if you want to hove the item
2191 * updated to reflect the that new data.
2193 * @see elm_genlist_item_data_get()
2195 * @deprecated Use elm_object_item_data_set() instead
2198 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2201 * Set whether a given genlist item is disabled or not.
2203 * @param it The item
2204 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2205 * to enable it back.
2207 * A disabled item cannot be selected or unselected. It will also
2208 * change its appearance, to signal the user it's disabled.
2210 * @see elm_genlist_item_disabled_get()
2211 * @deprecated Use elm_object_item_disabled_set() instead
2215 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2218 * Get whether a given genlist item is disabled or not.
2220 * @param it The item
2221 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2224 * @see elm_genlist_item_disabled_set() for more details
2225 * @deprecated Use elm_object_item_disabled_get() instead
2229 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2232 * Remove a genlist item from the its parent, deleting it.
2234 * @param it The item to be removed.
2235 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2237 * @see elm_genlist_clear(), to remove all items in a genlist at
2240 * @deprecated Use elm_object_item_del() instead
2243 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
2246 * Get the genlist object's handle which contains a given genlist
2249 * @param it The item to fetch the container from
2250 * @return The genlist (parent) object
2252 * This returns the genlist object itself that an item belongs to.
2253 * @deprecated Use elm_object_item_widget_get() instead
2257 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2260 * Get the mode item style of items in the genlist
2261 * @param obj The genlist object
2262 * @return The mode item style string, or NULL if none is specified
2264 * This is a constant string and simply defines the name of the
2265 * style that will be used for mode animations. It can be
2266 * @c NULL if you don't plan to use Genlist mode. See
2267 * elm_genlist_item_mode_set() for more info.
2271 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2274 * Set the mode item style of items in the genlist
2275 * @param obj The genlist object
2276 * @param style The mode item style string, or NULL if none is desired
2278 * This is a constant string and simply defines the name of the
2279 * style that will be used for mode animations. It can be
2280 * @c NULL if you don't plan to use Genlist mode. See
2281 * elm_genlist_item_mode_set() for more info.
2285 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2288 * Get the Item's Flags
2290 * @param it The genlist item
2291 * @return The item type.
2293 * This function returns the item's type. Normally the item's type.
2294 * If it failed, return value is ELM_GENLIST_ITEM_MAX
2296 * @deprecated Use elm_genlist_item_type_get() instead
2299 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
2302 * Tells genlist to "orphan" contents fetched by the item class
2304 * @param it The item
2306 * This instructs genlist to release references to contents in the item,
2307 * meaning that they will no longer be managed by genlist and are
2308 * floating "orphans" that can be re-used elsewhere if the user wants
2311 * @deprecated Use elm_genlist_item_all_contents_unset() instead
2313 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it);
2315 #define ELM_IMAGE_ROTATE_90_CW 1
2316 #define ELM_IMAGE_ROTATE_180_CW 2
2317 #define ELM_IMAGE_ROTATE_90_CCW 3
2320 * Return the data associated with a given index widget item
2322 * @param item The index widget item handle
2323 * @return The data associated with @p it
2324 * @deprecated Use elm_object_item_data_get() instead
2326 * @see elm_index_item_data_set()
2329 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2332 * Set the data associated with a given index widget item
2334 * @param it The index widget item handle
2335 * @param data The new data pointer to set to @p it
2337 * This sets new item data on @p it.
2339 * @warning The old data pointer won't be touched by this function, so
2340 * the user had better to free that old data himself/herself.
2342 * @deprecated Use elm_object_item_data_set() instead
2344 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2347 * Set the function to be called when a given index widget item is freed.
2349 * @param it The item to set the callback on
2350 * @param func The function to call on the item's deletion
2352 * When called, @p func will have both @c data and @c event_info
2353 * arguments with the @p it item's data value and, naturally, the
2354 * @c obj argument with a handle to the parent index widget.
2356 * @deprecated Use elm_object_item_del_cb_set() instead
2358 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2361 * Remove an item from a given index widget, <b>to be referenced by
2362 * it's data value</b>.
2364 * @param obj The index object
2365 * @param item The item to be removed from @p obj
2367 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2368 * that callback function will be called by this one.
2370 * @deprecated Use elm_object_item_del() instead
2372 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2375 * @brief Set the label on the label object
2377 * @param obj The label object
2378 * @param label The label will be used on the label object
2379 * @deprecated See elm_object_text_set()
2381 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2384 * @brief Get the label used on the label object
2386 * @param obj The label object
2387 * @return The string inside the label
2388 * @deprecated See elm_object_text_get()
2390 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2394 * Set the layout content.
2396 * @param obj The layout object
2397 * @param swallow The swallow part name in the edje file
2398 * @param content The child that will be added in this layout object
2399 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2401 * Once the content object is set, a previously set one will be deleted.
2402 * If you want to keep that old content object, use the
2403 * elm_object_part_content_unset() function.
2405 * @note In an Edje theme, the part used as a content container is called @c
2406 * SWALLOW. This is why the parameter name is called @p swallow, but it is
2407 * expected to be a part name just like the second parameter of
2408 * elm_layout_box_append().
2410 * @see elm_layout_box_append()
2411 * @see elm_object_part_content_get()
2412 * @see elm_object_part_content_unset()
2414 * @deprecated use elm_object_part_content_set() instead
2417 EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2420 * Get the child object in the given content part.
2422 * @param obj The layout object
2423 * @param swallow The SWALLOW part to get its content
2425 * @return The swallowed object or NULL if none or an error occurred
2427 * @deprecated use elm_object_part_content_get() instead
2430 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2433 * Unset the layout content.
2435 * @param obj The layout object
2436 * @param swallow The swallow part name in the edje file
2437 * @return The content that was being used
2439 * Unparent and return the content object which was set for this part.
2441 * @deprecated use elm_object_part_content_unset() instead
2444 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2447 * Set the text of the given part
2449 * @param obj The layout object
2450 * @param part The TEXT part where to set the text
2451 * @param text The text to set
2452 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2454 * @deprecated use elm_object_part_text_set() instead.
2456 EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2459 * Get the text set in the given part
2461 * @param obj The layout object
2462 * @param part The TEXT part to retrieve the text off
2464 * @return The text set in @p part
2466 * @deprecated use elm_object_part_text_get() instead.
2468 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
2471 * @def elm_layout_label_set
2472 * Convenience macro to set the label in a layout that follows the
2473 * Elementary naming convention for its parts.
2475 * @deprecated use elm_object_text_set() instead.
2477 #define elm_layout_label_set(_ly, _txt) \
2478 elm_layout_text_set((_ly), "elm.text", (_txt))
2481 * @def elm_layout_label_get
2482 * Convenience macro to get the label in a layout that follows the
2483 * Elementary naming convention for its parts.
2485 * @deprecated use elm_object_text_set() instead.
2487 #define elm_layout_label_get(_ly) \
2488 elm_layout_text_get((_ly), "elm.text")
2490 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2494 * Set the content of the mapbuf.
2496 * @param obj The mapbuf object.
2497 * @param content The content that will be filled in this mapbuf object.
2499 * Once the content object is set, a previously set one will be deleted.
2500 * If you want to keep that old content object, use the
2501 * elm_mapbuf_content_unset() function.
2503 * To enable map, elm_mapbuf_enabled_set() should be used.
2505 * @deprecated use elm_object_content_set() instead
2508 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2511 * Get the content of the mapbuf.
2513 * @param obj The mapbuf object.
2514 * @return The content that is being used.
2516 * Return the content object which is set for this widget.
2518 * @see elm_mapbuf_content_set() for details.
2520 * @deprecated use elm_object_content_get() instead
2523 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2526 * Unset the content of the mapbuf.
2528 * @param obj The mapbuf object.
2529 * @return The content that was being used.
2531 * Unparent and return the content object which was set for this widget.
2533 * @see elm_mapbuf_content_set() for details.
2535 * @deprecated use elm_object_content_unset() instead
2538 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2541 * @brief Set the label of a menu item
2543 * @param it The menu item object.
2544 * @param label The label to set for @p item
2546 * @warning Don't use this function on items created with
2547 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2549 * @deprecated Use elm_object_item_text_set() instead
2551 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2554 * @brief Get the label of a menu item
2556 * @param it The menu item object.
2557 * @return The label of @p item
2558 * @deprecated Use elm_object_item_text_get() instead
2560 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2563 * @brief Set the content object of a menu item
2565 * @param it The menu item object
2566 * @param The content object or NULL
2567 * @return EINA_TRUE on success, else EINA_FALSE
2569 * Use this function to change the object swallowed by a menu item, deleting
2570 * any previously swallowed object.
2572 * @deprecated Use elm_object_item_content_set() instead
2574 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2577 * @brief Get the content object of a menu item
2579 * @param it The menu item object
2580 * @return The content object or NULL
2581 * @note If @p item was added with elm_menu_item_add_object, this
2582 * function will return the object passed, else it will return the
2585 * @see elm_menu_item_object_content_set()
2587 * @deprecated Use elm_object_item_content_get() instead
2589 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2592 * @brief Set the disabled state of @p item.
2594 * @param it The menu item object.
2595 * @param disabled The enabled/disabled state of the item
2596 * @deprecated Use elm_object_item_disabled_set() instead
2598 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2601 * @brief Get the disabled state of @p item.
2603 * @param it The menu item object.
2604 * @return The enabled/disabled state of the item
2606 * @see elm_menu_item_disabled_set()
2607 * @deprecated Use elm_object_item_disabled_get() instead
2609 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2612 * @brief Returns the data associated with menu item @p item.
2614 * @param it The item
2615 * @return The data associated with @p item or NULL if none was set.
2617 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2619 * @deprecated Use elm_object_item_data_get() instead
2621 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2624 * @brief Set the function called when a menu item is deleted.
2626 * @param it The item to set the callback on
2627 * @param func The function called
2629 * @see elm_menu_item_add()
2630 * @see elm_menu_item_del()
2631 * @deprecated Use elm_object_item_del_cb_set() instead
2633 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2636 * @brief Sets the data to be associated with menu item @p item.
2638 * @param it The item
2639 * @param data The data to be associated with @p item
2641 * @deprecated Use elm_object_item_data_set() instead
2643 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2646 * @brief Deletes an item from the menu.
2648 * @param it The item to delete.
2650 * @deprecated Use elm_object_item_del() instead
2651 * @see elm_menu_item_add()
2653 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2656 * @brief @brief Return a menu item's owner menu
2658 * @param it The menu item
2659 * @return The menu object owning @p item, or NULL on failure
2661 * Use this function to get the menu object owning an item.
2662 * @deprecated Use elm_object_item_widget_get() instead
2664 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2667 * @brief Set the icon of a menu item to the standard icon with name @p icon
2669 * @param it The menu item object.
2670 * @param icon The icon object to set for the content of @p item
2672 * @deprecated elm_menu_item_icon_name_set() instead
2673 * Once this icon is set, any previously set icon will be deleted.
2675 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2678 * @brief Get the string representation from the icon of a menu item
2680 * @param it The menu item object.
2681 * @return The string representation of @p item's icon or NULL
2683 * @deprecated elm_menu_item_icon_name_get() instead
2684 * @see elm_menu_item_icon_name_set()
2686 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2689 * @brief Set the content of the notify widget
2691 * @param obj The notify object
2692 * @param content The content will be filled in this notify object
2694 * Once the content object is set, a previously set one will be deleted. If
2695 * you want to keep that old content object, use the
2696 * elm_notify_content_unset() function.
2698 * @deprecated use elm_object_content_set() instead
2701 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2704 * @brief Unset the content of the notify widget
2706 * @param obj The notify object
2707 * @return The content that was being used
2709 * Unparent and return the content object which was set for this widget
2711 * @see elm_notify_content_set()
2712 * @deprecated use elm_object_content_unset() instead
2715 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2718 * @brief Return the content of the notify widget
2720 * @param obj The notify object
2721 * @return The content that is being used
2723 * @see elm_notify_content_set()
2724 * @deprecated use elm_object_content_get() instead
2727 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2730 * Set a label of an object
2732 * @param obj The Elementary object
2733 * @param part The text part name to set (NULL for the default label)
2734 * @param label The new text of the label
2736 * @note Elementary objects may have many labels (e.g. Action Slider)
2737 * @deprecated Use elm_object_part_text_set() instead.
2739 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2742 * Get a label of an object
2744 * @param obj The Elementary object
2745 * @param part The text part name to get (NULL for the default label)
2746 * @return text of the label or NULL for any error
2748 * @note Elementary objects may have many labels (e.g. Action Slider)
2749 * @deprecated Use elm_object_part_text_get() instead.
2751 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2754 * Set a content of an object
2756 * @param obj The Elementary object
2757 * @param part The content part name to set (NULL for the default content)
2758 * @param content The new content of the object
2760 * @note Elementary objects may have many contents
2761 * @deprecated Use elm_object_part_content_set instead.
2763 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2766 * Get a content of an object
2768 * @param obj The Elementary object
2769 * @param part The content part name to get (NULL for the default content)
2770 * @return content of the object or NULL for any error
2772 * @note Elementary objects may have many contents
2773 * @deprecated Use elm_object_part_content_get instead.
2775 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2778 * Unset a content of an object
2780 * @param obj The Elementary object
2781 * @param part The content part name to unset (NULL for the default content)
2783 * @note Elementary objects may have many contents
2784 * @deprecated Use elm_object_part_content_unset instead.
2786 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2789 * Set a content of an object item
2791 * @param it The Elementary object item
2792 * @param part The content part name to set (NULL for the default content)
2793 * @param content The new content of the object item
2795 * @note Elementary object items may have many contents
2796 * @deprecated Use elm_object_item_part_content_set instead.
2798 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2801 * Get a content of an object item
2803 * @param it The Elementary object item
2804 * @param part The content part name to unset (NULL for the default content)
2805 * @return content of the object item or NULL for any error
2807 * @note Elementary object items may have many contents
2808 * @deprecated Use elm_object_item_part_content_get instead.
2810 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2813 * Unset a content of an object item
2815 * @param it The Elementary object item
2816 * @param part The content part name to unset (NULL for the default content)
2818 * @note Elementary object items may have many contents
2819 * @deprecated Use elm_object_item_part_content_unset instead.
2821 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2824 * Get a label of an object item
2826 * @param it The Elementary object item
2827 * @param part The text part name to get (NULL for the default label)
2828 * @return text of the label or NULL for any error
2830 * @note Elementary object items may have many labels
2831 * @deprecated Use elm_object_item_part_text_get instead.
2833 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2836 * Set a label of an object item
2838 * @param it The Elementary object item
2839 * @param part The text part name to set (NULL for the default label)
2840 * @param label The new text of the label
2842 * @note Elementary object items may have many labels
2843 * @deprecated Use elm_object_item_part_text_set instead.
2845 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2848 * @brief Set the content of the panel.
2850 * @param obj The panel object
2851 * @param content The panel content
2853 * Once the content object is set, a previously set one will be deleted.
2854 * If you want to keep that old content object, use the
2855 * elm_panel_content_unset() function.
2857 * @deprecated use elm_object_content_set() instead
2860 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2863 * @brief Get the content of the panel.
2865 * @param obj The panel object
2866 * @return The content that is being used
2868 * Return the content object which is set for this widget.
2870 * @see elm_panel_content_set()
2872 * @deprecated use elm_object_content_get() instead
2875 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2878 * @brief Unset the content of the panel.
2880 * @param obj The panel object
2881 * @return The content that was being used
2883 * Unparent and return the content object which was set for this widget.
2885 * @see elm_panel_content_set()
2887 * @deprecated use elm_object_content_unset() instead
2890 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2893 * Set the left content of the panes widget.
2895 * @param obj The panes object.
2896 * @param content The new left content object.
2898 * Once the content object is set, a previously set one will be deleted.
2899 * If you want to keep that old content object, use the
2900 * elm_panes_content_left_unset() function.
2902 * If panes is displayed vertically, left content will be displayed at
2905 * @see elm_panes_content_left_get()
2906 * @see elm_panes_content_right_set() to set content on the other side.
2908 * @deprecated use elm_object_part_content_set() instead
2911 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2914 * Set the right content of the panes widget.
2916 * @param obj The panes object.
2917 * @param content The new right content object.
2919 * Once the content object is set, a previously set one will be deleted.
2920 * If you want to keep that old content object, use the
2921 * elm_panes_content_right_unset() function.
2923 * If panes is displayed vertically, left content will be displayed at
2926 * @see elm_panes_content_right_get()
2927 * @see elm_panes_content_left_set() to set content on the other side.
2929 * @deprecated use elm_object_part_content_set() instead
2932 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2935 * Get the left content of the panes.
2937 * @param obj The panes object.
2938 * @return The left content object that is being used.
2940 * Return the left content object which is set for this widget.
2942 * @see elm_panes_content_left_set() for details.
2944 * @deprecated use elm_object_part_content_get() instead
2947 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2950 * Get the right content of the panes.
2952 * @param obj The panes object
2953 * @return The right content object that is being used
2955 * Return the right content object which is set for this widget.
2957 * @see elm_panes_content_right_set() for details.
2959 * @deprecated use elm_object_part_content_get() instead
2962 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2965 * Unset the left content used for the panes.
2967 * @param obj The panes object.
2968 * @return The left content object that was being used.
2970 * Unparent and return the left content object which was set for this widget.
2972 * @see elm_panes_content_left_set() for details.
2973 * @see elm_panes_content_left_get().
2975 * @deprecated use elm_object_part_content_unset() instead
2978 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2981 * Unset the right content used for the panes.
2983 * @param obj The panes object.
2984 * @return The right content object that was being used.
2986 * Unparent and return the right content object which was set for this
2989 * @see elm_panes_content_right_set() for details.
2990 * @see elm_panes_content_right_get().
2992 * @deprecated use elm_object_part_content_unset() instead
2995 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2997 * Set the label of a given progress bar widget
2999 * @param obj The progress bar object
3000 * @param label The text label string, in UTF-8
3002 * @deprecated use elm_object_text_set() instead.
3004 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
3007 * Get the label of a given progress bar widget
3009 * @param obj The progressbar object
3010 * @return The text label string, in UTF-8
3012 * @deprecated use elm_object_text_set() instead.
3014 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
3017 * Set the icon object of a given progress bar widget
3019 * @param obj The progress bar object
3020 * @param icon The icon object
3022 * Use this call to decorate @p obj with an icon next to it.
3024 * @note Once the icon object is set, a previously set one will be
3025 * deleted. If you want to keep that old content object, use the
3026 * elm_progressbar_icon_unset() function.
3028 * @see elm_progressbar_icon_get()
3029 * @deprecated use elm_object_part_content_set() instead.
3032 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
3035 * Retrieve the icon object set for a given progress bar widget
3037 * @param obj The progress bar object
3038 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3039 * otherwise (and on errors)
3041 * @see elm_progressbar_icon_set() for more details
3042 * @deprecated use elm_object_part_content_get() instead.
3045 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
3048 * Unset an icon set on a given progress bar widget
3050 * @param obj The progress bar object
3051 * @return The icon object that was being used, if any was set, or
3052 * @c NULL, otherwise (and on errors)
3054 * This call will unparent and return the icon object which was set
3055 * for this widget, previously, on success.
3057 * @see elm_progressbar_icon_set() for more details
3058 * @deprecated use elm_object_part_content_unset() instead.
3061 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
3064 * @brief Set the text label of the radio object
3066 * @param obj The radio object
3067 * @param label The text label string in UTF-8
3069 * @deprecated use elm_object_text_set() instead.
3071 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
3074 * @brief Get the text label of the radio object
3076 * @param obj The radio object
3077 * @return The text label string in UTF-8
3079 * @deprecated use elm_object_text_set() instead.
3081 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
3084 * @brief Set the icon object of the radio object
3086 * @param obj The radio object
3087 * @param icon The icon object
3089 * Once the icon object is set, a previously set one will be deleted. If you
3090 * want to keep that old content object, use the elm_radio_icon_unset()
3093 * @deprecated use elm_object_part_content_set() instead.
3096 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
3099 * @brief Get the icon object of the radio object
3101 * @param obj The radio object
3102 * @return The icon object
3104 * @see elm_radio_icon_set()
3106 * @deprecated use elm_object_part_content_get() instead.
3109 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
3112 * @brief Unset the icon used for the radio object
3114 * @param obj The radio object
3115 * @return The icon object that was being used
3117 * Unparent and return the icon object which was set for this widget.
3119 * @see elm_radio_icon_set()
3120 * @deprecated use elm_object_part_content_unset() instead.
3123 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
3126 * Set the label of a given slider widget
3128 * @param obj The progress bar object
3129 * @param label The text label string, in UTF-8
3131 * @deprecated use elm_object_text_set() instead.
3133 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
3136 * Get the label of a given slider widget
3138 * @param obj The progressbar object
3139 * @return The text label string, in UTF-8
3141 * @deprecated use elm_object_text_get() instead.
3143 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
3146 * Set the icon object of the slider object.
3148 * @param obj The slider object.
3149 * @param icon The icon object.
3151 * On horizontal mode, icon is placed at left, and on vertical mode,
3154 * @note Once the icon object is set, a previously set one will be deleted.
3155 * If you want to keep that old content object, use the
3156 * elm_slider_icon_unset() function.
3158 * @warning If the object being set does not have minimum size hints set,
3159 * it won't get properly displayed.
3161 * @deprecated use elm_object_part_content_set() instead.
3163 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3166 * Unset an icon set on a given slider widget.
3168 * @param obj The slider object.
3169 * @return The icon object that was being used, if any was set, or
3170 * @c NULL, otherwise (and on errors).
3172 * On horizontal mode, icon is placed at left, and on vertical mode,
3175 * This call will unparent and return the icon object which was set
3176 * for this widget, previously, on success.
3178 * @see elm_slider_icon_set() for more details
3179 * @see elm_slider_icon_get()
3180 * @deprecated use elm_object_part_content_unset() instead.
3183 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3186 * Retrieve the icon object set for a given slider widget.
3188 * @param obj The slider object.
3189 * @return The icon object's handle, if @p obj had one set, or @c NULL,
3190 * otherwise (and on errors).
3192 * On horizontal mode, icon is placed at left, and on vertical mode,
3195 * @see elm_slider_icon_set() for more details
3196 * @see elm_slider_icon_unset()
3198 * @deprecated use elm_object_part_content_get() instead.
3201 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3204 * Set the end object of the slider object.
3206 * @param obj The slider object.
3207 * @param end The end object.
3209 * On horizontal mode, end is placed at left, and on vertical mode,
3212 * @note Once the icon object is set, a previously set one will be deleted.
3213 * If you want to keep that old content object, use the
3214 * elm_slider_end_unset() function.
3216 * @warning If the object being set does not have minimum size hints set,
3217 * it won't get properly displayed.
3219 * @deprecated use elm_object_part_content_set() instead.
3222 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3225 * Unset an end object set on a given slider widget.
3227 * @param obj The slider object.
3228 * @return The end object that was being used, if any was set, or
3229 * @c NULL, otherwise (and on errors).
3231 * On horizontal mode, end is placed at left, and on vertical mode,
3234 * This call will unparent and return the icon object which was set
3235 * for this widget, previously, on success.
3237 * @see elm_slider_end_set() for more details.
3238 * @see elm_slider_end_get()
3240 * @deprecated use elm_object_part_content_unset() instead
3244 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3247 * Retrieve the end object set for a given slider widget.
3249 * @param obj The slider object.
3250 * @return The end object's handle, if @p obj had one set, or @c NULL,
3251 * otherwise (and on errors).
3253 * On horizontal mode, icon is placed at right, and on vertical mode,
3256 * @see elm_slider_end_set() for more details.
3257 * @see elm_slider_end_unset()
3260 * @deprecated use elm_object_part_content_get() instead
3264 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3267 * Return the data associated with a given slideshow item
3269 * @param it The slideshow item
3270 * @return Returns the data associated to this item
3272 * @deprecated use elm_object_item_data_get() instead
3274 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3277 * Delete a given item from a slideshow widget.
3279 * @param it The slideshow item
3281 * @deprecated Use elm_object_item_de() instead
3283 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
3286 * Display a given slideshow widget's item, programmatically.
3288 * @param it The item to display on @p obj's viewport
3290 * The change between the current item and @p item will use the
3291 * transition @p obj is set to use (@see
3292 * elm_slideshow_transition_set()).
3294 * @deprecated use elm_slideshow_item_show() instead
3296 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
3299 * Get the toolbar object from an item.
3301 * @param it The item.
3302 * @return The toolbar object.
3304 * This returns the toolbar object itself that an item belongs to.
3306 * @deprecated use elm_object_item_object_get() instead.
3308 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3311 * Get the label of item.
3313 * @param it The item of toolbar.
3314 * @return The label of item.
3316 * The return value is a pointer to the label associated to @p item when
3317 * it was created, with function elm_toolbar_item_append() or similar,
3319 * with function elm_toolbar_item_label_set. If no label
3320 * was passed as argument, it will return @c NULL.
3322 * @see elm_toolbar_item_label_set() for more details.
3323 * @see elm_toolbar_item_append()
3325 * @deprecated use elm_object_item_text_get() instead.
3327 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3330 * Set the label of item.
3332 * @param it The item of toolbar.
3333 * @param label The label of item.
3335 * The label to be displayed by the item.
3336 * Label will be placed at icons bottom (if set).
3338 * If a label was passed as argument on item creation, with function
3339 * elm_toolbar_item_append() or similar, it will be already
3340 * displayed by the item.
3342 * @see elm_toolbar_item_label_get()
3343 * @see elm_toolbar_item_append()
3345 * @deprecated use elm_object_item_text_set() instead
3347 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3350 * Return the data associated with a given toolbar widget item.
3352 * @param it The toolbar widget item handle.
3353 * @return The data associated with @p item.
3355 * @see elm_toolbar_item_data_set()
3357 * @deprecated use elm_object_item_data_get() instead.
3359 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3362 * Set the data associated with a given toolbar widget item.
3364 * @param it The toolbar widget item handle
3365 * @param data The new data pointer to set to @p item.
3367 * This sets new item data on @p item.
3369 * @warning The old data pointer won't be touched by this function, so
3370 * the user had better to free that old data himself/herself.
3372 * @deprecated use elm_object_item_data_set() instead.
3374 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3377 * Get a value whether toolbar item is disabled or not.
3379 * @param it The item.
3380 * @return The disabled state.
3382 * @see elm_toolbar_item_disabled_set() for more details.
3384 * @deprecated use elm_object_item_disabled_get() instead.
3386 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3389 * Sets the disabled/enabled state of a toolbar item.
3391 * @param it The item.
3392 * @param disabled The disabled state.
3394 * A disabled item cannot be selected or unselected. It will also
3395 * change its appearance (generally greyed out). This sets the
3396 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3399 * @deprecated use elm_object_item_disabled_set() instead.
3401 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3404 * Change a toolbar's orientation
3405 * @param obj The toolbar object
3406 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3407 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3408 * @deprecated use elm_toolbar_horizontal_set() instead.
3410 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3413 * Get a toolbar's orientation
3414 * @param obj The toolbar object
3415 * @return If @c EINA_TRUE, the toolbar is vertical
3416 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3417 * @deprecated use elm_toolbar_horizontal_get() instead.
3419 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3422 * Set the function called when a toolbar item is freed.
3424 * @param it The item to set the callback on.
3425 * @param func The function called.
3427 * If there is a @p func, then it will be called prior item's memory release.
3428 * That will be called with the following arguments:
3430 * @li item's Evas object;
3433 * This way, a data associated to a toolbar item could be properly freed.
3435 * @deprecated Use elm_object_item_del_cb_set() instead
3437 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3440 * Delete them item from the toolbar.
3442 * @param it The item of toolbar to be deleted.
3444 * @deprecated Use elm_object_item_del() instead
3445 * @see elm_toolbar_item_append()
3448 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3451 * Set the content to be shown in the tooltip item.
3453 * Setup the tooltip to item. The item can have only one tooltip,
3454 * so any previous tooltip data is removed. @p func(with @p data) will
3455 * be called every time that need show the tooltip and it should
3456 * return a valid Evas_Object. This object is then managed fully by
3457 * tooltip system and is deleted when the tooltip is gone.
3459 * @param it the toolbar item being attached a tooltip.
3460 * @param func the function used to create the tooltip contents.
3461 * @param data what to provide to @a func as callback data/context.
3462 * @param del_cb called when data is not needed anymore, either when
3463 * another callback replaces @a func, the tooltip is unset with
3464 * elm_toolbar_item_tooltip_unset() or the owner @a item
3465 * dies. This callback receives as the first parameter the
3466 * given @a data, and @c event_info is the item.
3468 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3469 * @see elm_object_tooltip_content_cb_set() for more details.
3472 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);
3475 * Unset tooltip from item.
3477 * @param it toolbar item to remove previously set tooltip.
3479 * Remove tooltip from item. The callback provided as del_cb to
3480 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3481 * it is not used anymore.
3483 * @deprecated Use elm_object_item_tooltip_unset() instead
3484 * @see elm_object_tooltip_unset() for more details.
3485 * @see elm_toolbar_item_tooltip_content_cb_set()
3488 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3491 * Sets a different style for this item tooltip.
3493 * @note before you set a style you should define a tooltip with
3494 * elm_toolbar_item_tooltip_content_cb_set() or
3495 * elm_toolbar_item_tooltip_text_set()
3497 * @param it toolbar item with tooltip already set.
3498 * @param style the theme style to use (default, transparent, ...)
3500 * @deprecated Use elm_object_item_tooltip_style_set() instead
3501 * @see elm_object_tooltip_style_set() for more details.
3504 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3507 * Get the style for this item tooltip.
3509 * @param it toolbar item with tooltip already set.
3510 * @return style the theme style in use, defaults to "default". If the
3511 * object does not have a tooltip set, then NULL is returned.
3513 * @deprecated Use elm_object_item_style_get() instead
3514 * @see elm_object_tooltip_style_get() for more details.
3515 * @see elm_toolbar_item_tooltip_style_set()
3518 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3521 * Set the type of mouse pointer/cursor decoration to be shown,
3522 * when the mouse pointer is over the given toolbar widget item
3524 * @param it toolbar item to customize cursor on
3525 * @param cursor the cursor type's name
3527 * This function works analogously as elm_object_cursor_set(), but
3528 * here the cursor's changing area is restricted to the item's
3529 * area, and not the whole widget's. Note that that item cursors
3530 * have precedence over widget cursors, so that a mouse over an
3531 * item with custom cursor set will always show @b that cursor.
3533 * If this function is called twice for an object, a previously set
3534 * cursor will be unset on the second call.
3536 * @see elm_object_cursor_set()
3537 * @see elm_toolbar_item_cursor_get()
3538 * @see elm_toolbar_item_cursor_unset()
3540 * @deprecated use elm_object_item_cursor_set() instead
3543 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3546 * Get the type of mouse pointer/cursor decoration set to be shown,
3547 * when the mouse pointer is over the given toolbar widget item
3549 * @param it toolbar item with custom cursor set
3550 * @return the cursor type's name or @c NULL, if no custom cursors
3551 * were set to @p item (and on errors)
3553 * @see elm_object_cursor_get()
3554 * @see elm_toolbar_item_cursor_set()
3555 * @see elm_toolbar_item_cursor_unset()
3557 * @deprecated Use elm_object_item_cursor_get() instead
3560 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3563 * Unset any custom mouse pointer/cursor decoration set to be
3564 * shown, when the mouse pointer is over the given toolbar widget
3565 * item, thus making it show the @b default cursor again.
3567 * @param it a toolbar item
3569 * Use this call to undo any custom settings on this item's cursor
3570 * decoration, bringing it back to defaults (no custom style set).
3572 * @see elm_object_cursor_unset()
3573 * @see elm_toolbar_item_cursor_set()
3575 * @deprecated Use elm_object_item_cursor_unset() instead
3578 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3581 * Set a different @b style for a given custom cursor set for a
3584 * @param it toolbar item with custom cursor set
3585 * @param style the <b>theme style</b> to use (e.g. @c "default",
3586 * @c "transparent", etc)
3588 * This function only makes sense when one is using custom mouse
3589 * cursor decorations <b>defined in a theme file</b>, which can have,
3590 * given a cursor name/type, <b>alternate styles</b> on it. It
3591 * works analogously as elm_object_cursor_style_set(), but here
3592 * applies only to toolbar item objects.
3594 * @warning Before you set a cursor style you should have defined a
3595 * custom cursor previously on the item, with
3596 * elm_toolbar_item_cursor_set()
3598 * @see elm_toolbar_item_cursor_engine_only_set()
3599 * @see elm_toolbar_item_cursor_style_get()
3601 * @deprecated Use elm_object_item_cursor_style_set() instead
3604 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3607 * Get the current @b style set for a given toolbar item's custom
3610 * @param it toolbar item with custom cursor set.
3611 * @return style the cursor style in use. If the object does not
3612 * have a cursor set, then @c NULL is returned.
3614 * @see elm_toolbar_item_cursor_style_set() for more details
3616 * @deprecated Use elm_object_item_cursor_style_get() instead
3619 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3622 * Set if the (custom)cursor for a given toolbar item should be
3623 * searched in its theme, also, or should only rely on the
3626 * @param it item with custom (custom) cursor already set on
3627 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3628 * only on those provided by the rendering engine, @c EINA_FALSE to
3629 * have them searched on the widget's theme, as well.
3631 * @note This call is of use only if you've set a custom cursor
3632 * for toolbar items, with elm_toolbar_item_cursor_set().
3634 * @note By default, cursors will only be looked for between those
3635 * provided by the rendering engine.
3637 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3640 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3643 * Get if the (custom) cursor for a given toolbar item is being
3644 * searched in its theme, also, or is only relying on the rendering
3647 * @param it a toolbar item
3648 * @return @c EINA_TRUE, if cursors are being looked for only on
3649 * those provided by the rendering engine, @c EINA_FALSE if they
3650 * are being searched on the widget's theme, as well.
3652 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3654 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3657 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3660 * @brief Link a Elm_Payer with an Elm_Video object.
3662 * @param player the Elm_Player object.
3663 * @param video The Elm_Video object.
3665 * This mean that action on the player widget will affect the
3666 * video object and the state of the video will be reflected in
3667 * the player itself.
3669 * @see elm_player_add()
3670 * @see elm_video_add()
3671 * @deprecated use elm_object_part_content_set() instead
3674 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3677 * Set the label of item.
3679 * @param it The item of segment control.
3680 * @param label The label of item.
3682 * The label to be displayed by the item.
3683 * Label will be at right of the icon (if set).
3685 * If a label was passed as argument on item creation, with function
3686 * elm_control_segment_item_add(), it will be already
3687 * displayed by the item.
3689 * @see elm_segment_control_item_label_get()
3690 * @see elm_segment_control_item_add()
3691 * @deprecated Use elm_object_item_text_set() instead
3694 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3698 * Set the icon associated to the item.
3700 * @param it The segment control item.
3701 * @param icon The icon object to associate with @p it.
3703 * The icon object to use at left side of the item. An
3704 * icon can be any Evas object, but usually it is an icon created
3705 * with elm_icon_add().
3707 * Once the icon object is set, a previously set one will be deleted.
3708 * @warning Setting the same icon for two items will cause the icon to
3709 * disappear from the first item.
3711 * If an icon was passed as argument on item creation, with function
3712 * elm_segment_control_item_add(), it will be already
3713 * associated to the item.
3715 * @see elm_segment_control_item_add()
3716 * @see elm_segment_control_item_icon_get()
3717 * @deprecated Use elm_object_item_part_content_set() instead
3720 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3723 * Remove a segment control item from its parent, deleting it.
3725 * @param it The item to be removed.
3727 * Items can be added with elm_segment_control_item_add() or
3728 * elm_segment_control_item_insert_at().
3730 * @deprecated Use elm_object_item_del() instead
3732 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3737 * @param obj The multibuttonentry object
3738 * @return The label, or NULL if none
3740 * @deprecated Use elm_object_text_get() instead
3743 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3748 * @param obj The multibuttonentry object
3749 * @param label The text label string
3751 * @deprecated Use elm_object_text_set() instead
3754 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3757 * Get the label of a given item
3759 * @param it The item
3760 * @return The label of a given item, or NULL if none
3762 * @deprecated Use elm_object_item_text_get() instead
3765 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3768 * Set the label of a given item
3770 * @param it The item
3771 * @param str The text label string
3773 * @deprecated Use elm_object_item_text_set() instead
3775 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3778 * Delete a given item
3780 * @param it The item
3782 * @deprecated Use elm_object_item_del() instead
3785 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3788 * @brief Delete the given item instantly.
3790 * @param it The naviframe item
3792 * This just deletes the given item from the naviframe item list instantly.
3793 * So this would not emit any signals for view transitions but just change
3794 * the current view if the given item is a top one.
3796 * @deprecated Use elm_object_item_del() instead
3798 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3803 * Sets the disabled/enabled state of a list item.
3805 * @param it The item.
3806 * @param disabled The disabled state.
3808 * A disabled item cannot be selected or unselected. It will also
3809 * change its appearance (generally greyed out). This sets the
3810 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3813 * @deprecated Use elm_object_item_disabled_set() instead
3816 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3819 * Get a value whether list item is disabled or not.
3821 * @param it The item.
3822 * @return The disabled state.
3824 * @see elm_list_item_disabled_set() for more details.
3826 * @deprecated Use elm_object_item_disabled_get() instead
3829 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3832 * @brief Disable size restrictions on an object's tooltip
3833 * @param it The tooltip's anchor object
3834 * @param disable If EINA_TRUE, size restrictions are disabled
3835 * @return EINA_FALSE on failure, EINA_TRUE on success
3837 * This function allows a tooltip to expand beyond its parent window's canvas.
3838 * It will instead be limited only by the size of the display.
3840 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3843 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3846 * @brief Retrieve size restriction state of an object's tooltip
3847 * @param obj The tooltip's anchor object
3848 * @return If EINA_TRUE, size restrictions are disabled
3850 * This function returns whether a tooltip is allowed to expand beyond
3851 * its parent window's canvas.
3852 * It will instead be limited only by the size of the display.
3854 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3857 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3860 * Set the function called when a list item is freed.
3862 * @param it The item to set the callback on
3863 * @param func The function called
3865 * If there is a @p func, then it will be called prior item's memory release.
3866 * That will be called with the following arguments:
3868 * @li item's Evas object;
3871 * This way, a data associated to a list item could be properly freed.
3873 * @deprecated Please use elm_object_item_del_cb_set() instead.
3876 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3879 * Get the data associated to the item.
3881 * @param it The list item
3882 * @return The data associated to @p item
3884 * The return value is a pointer to data associated to @p item when it was
3885 * created, with function elm_list_item_append() or similar. If no data
3886 * was passed as argument, it will return @c NULL.
3888 * @see elm_list_item_append()
3890 * @deprecated Please use elm_object_item_data_get() instead.
3893 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
3896 * Get the left side icon associated to the item.
3898 * @param it The list item
3899 * @return The left side icon associated to @p item
3901 * The return value is a pointer to the icon associated to @p item when
3903 * created, with function elm_list_item_append() or similar, or later
3904 * with function elm_list_item_icon_set(). If no icon
3905 * was passed as argument, it will return @c NULL.
3907 * @see elm_list_item_append()
3908 * @see elm_list_item_icon_set()
3910 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3912 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
3915 * Set the left side icon associated to the item.
3917 * @param it The list item
3918 * @param icon The left side icon object to associate with @p item
3920 * The icon object to use at left side of the item. An
3921 * icon can be any Evas object, but usually it is an icon created
3922 * with elm_icon_add().
3924 * Once the icon object is set, a previously set one will be deleted.
3925 * @warning Setting the same icon for two items will cause the icon to
3926 * disappear from the first item.
3928 * If an icon was passed as argument on item creation, with function
3929 * elm_list_item_append() or similar, it will be already
3930 * associated to the item.
3932 * @see elm_list_item_append()
3933 * @see elm_list_item_icon_get()
3935 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3937 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3940 * Get the right side icon associated to the item.
3942 * @param it The list item
3943 * @return The right side icon associated to @p item
3945 * The return value is a pointer to the icon associated to @p item when
3947 * created, with function elm_list_item_append() or similar, or later
3948 * with function elm_list_item_icon_set(). If no icon
3949 * was passed as argument, it will return @c NULL.
3951 * @see elm_list_item_append()
3952 * @see elm_list_item_icon_set()
3954 * @deprecated Please use elm_object_item_part_content_get(item, "end");
3956 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
3959 * Set the right side icon associated to the item.
3961 * @param it The list item
3962 * @param end The right side icon object to associate with @p item
3964 * The icon object to use at right side of the item. An
3965 * icon can be any Evas object, but usually it is an icon created
3966 * with elm_icon_add().
3968 * Once the icon object is set, a previously set one will be deleted.
3969 * @warning Setting the same icon for two items will cause the icon to
3970 * disappear from the first item.
3972 * If an icon was passed as argument on item creation, with function
3973 * elm_list_item_append() or similar, it will be already
3974 * associated to the item.
3976 * @see elm_list_item_append()
3977 * @see elm_list_item_end_get()
3979 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3981 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3984 * Get the label of item.
3986 * @param it The item of list.
3987 * @return The label of item.
3989 * The return value is a pointer to the label associated to @p item when
3990 * it was created, with function elm_list_item_append(), or later
3991 * with function elm_list_item_label_set. If no label
3992 * was passed as argument, it will return @c NULL.
3994 * @see elm_list_item_label_set() for more details.
3995 * @see elm_list_item_append()
3997 * @deprecated Please use elm_object_item_text_get(item);
3999 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
4002 * Set the label of item.
4004 * @param it The item of list.
4005 * @param text The label of item.
4007 * The label to be displayed by the item.
4008 * Label will be placed between left and right side icons (if set).
4010 * If a label was passed as argument on item creation, with function
4011 * elm_list_item_append() or similar, it will be already
4012 * displayed by the item.
4014 * @see elm_list_item_label_get()
4015 * @see elm_list_item_append()
4017 * @deprecated Please use elm_object_item_text_set(item, text);
4019 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
4022 * Set the text to be shown in a given list item's tooltips.
4024 * @param it Target item.
4025 * @param text The text to set in the content.
4027 * Setup the text as tooltip to object. The item can have only one tooltip,
4028 * so any previous tooltip data - set with this function or
4029 * elm_list_item_tooltip_content_cb_set() - is removed.
4031 * @deprecated Use elm_object_item_tooltip_text_set() instead
4032 * @see elm_object_tooltip_text_set() for more details.
4035 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
4038 * Set the content to be shown in the tooltip item.
4040 * Setup the tooltip to item. The item can have only one tooltip,
4041 * so any previous tooltip data is removed. @p func(with @p data) will
4042 * be called every time that need show the tooltip and it should
4043 * return a valid Evas_Object. This object is then managed fully by
4044 * tooltip system and is deleted when the tooltip is gone.
4046 * @param it the list item being attached a tooltip.
4047 * @param func the function used to create the tooltip contents.
4048 * @param data what to provide to @a func as callback data/context.
4049 * @param del_cb called when data is not needed anymore, either when
4050 * another callback replaces @a func, the tooltip is unset with
4051 * elm_list_item_tooltip_unset() or the owner @a item
4052 * dies. This callback receives as the first parameter the
4053 * given @a data, and @c event_info is the item.
4055 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
4057 * @see elm_object_tooltip_content_cb_set() for more details.
4060 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);
4063 * Unset tooltip from item.
4065 * @param it list item to remove previously set tooltip.
4067 * Remove tooltip from item. The callback provided as del_cb to
4068 * elm_list_item_tooltip_content_cb_set() will be called to notify
4069 * it is not used anymore.
4071 * @deprecated Use elm_object_item_tooltip_unset() instead
4072 * @see elm_object_tooltip_unset() for more details.
4073 * @see elm_list_item_tooltip_content_cb_set()
4076 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
4079 * Sets a different style for this item tooltip.
4081 * @note before you set a style you should define a tooltip with
4082 * elm_list_item_tooltip_content_cb_set() or
4083 * elm_list_item_tooltip_text_set()
4085 * @param it list item with tooltip already set.
4086 * @param style the theme style to use (default, transparent, ...)
4089 * @deprecated Use elm_object_item_tooltip_style_set() instead
4090 * @see elm_object_tooltip_style_set() for more details.
4093 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
4096 * Get the style for this item tooltip.
4098 * @param it list item with tooltip already set.
4099 * @return style the theme style in use, defaults to "default". If the
4100 * object does not have a tooltip set, then NULL is returned.
4102 * @deprecated Use elm_object_item_tooltip_style_get() instead
4104 * @see elm_object_tooltip_style_get() for more details.
4105 * @see elm_list_item_tooltip_style_set()
4108 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
4111 * Set the type of mouse pointer/cursor decoration to be shown,
4112 * when the mouse pointer is over the given list widget item
4114 * @param it list item to customize cursor on
4115 * @param cursor the cursor type's name
4117 * This function works analogously as elm_object_cursor_set(), but
4118 * here the cursor's changing area is restricted to the item's
4119 * area, and not the whole widget's. Note that that item cursors
4120 * have precedence over widget cursors, so that a mouse over an
4121 * item with custom cursor set will always show @b that cursor.
4123 * If this function is called twice for an object, a previously set
4124 * cursor will be unset on the second call.
4126 * @see elm_object_cursor_set()
4127 * @see elm_list_item_cursor_get()
4128 * @see elm_list_item_cursor_unset()
4130 * @deprecated Please use elm_object_item_cursor_set() instead
4132 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
4135 * Get the type of mouse pointer/cursor decoration set to be shown,
4136 * when the mouse pointer is over the given list widget item
4138 * @param it list item with custom cursor set
4139 * @return the cursor type's name or @c NULL, if no custom cursors
4140 * were set to @p item (and on errors)
4142 * @see elm_object_cursor_get()
4143 * @see elm_list_item_cursor_set()
4144 * @see elm_list_item_cursor_unset()
4146 * @deprecated Please use elm_object_item_cursor_get() instead
4148 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
4151 * Unset any custom mouse pointer/cursor decoration set to be
4152 * shown, when the mouse pointer is over the given list widget
4153 * item, thus making it show the @b default cursor again.
4155 * @param it a list item
4157 * Use this call to undo any custom settings on this item's cursor
4158 * decoration, bringing it back to defaults (no custom style set).
4160 * @see elm_object_cursor_unset()
4161 * @see elm_list_item_cursor_set()
4163 * @deprecated Please use elm_list_item_cursor_unset() instead
4165 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
4168 * Set a different @b style for a given custom cursor set for a
4171 * @param it list item with custom cursor set
4172 * @param style the <b>theme style</b> to use (e.g. @c "default",
4173 * @c "transparent", etc)
4175 * This function only makes sense when one is using custom mouse
4176 * cursor decorations <b>defined in a theme file</b>, which can have,
4177 * given a cursor name/type, <b>alternate styles</b> on it. It
4178 * works analogously as elm_object_cursor_style_set(), but here
4179 * applies only to list item objects.
4181 * @warning Before you set a cursor style you should have defined a
4182 * custom cursor previously on the item, with
4183 * elm_list_item_cursor_set()
4185 * @see elm_list_item_cursor_engine_only_set()
4186 * @see elm_list_item_cursor_style_get()
4188 * @deprecated Please use elm_list_item_cursor_style_set() instead
4190 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
4193 * Get the current @b style set for a given list item's custom
4196 * @param it list item with custom cursor set.
4197 * @return style the cursor style in use. If the object does not
4198 * have a cursor set, then @c NULL is returned.
4200 * @see elm_list_item_cursor_style_set() for more details
4202 * @deprecated Please use elm_list_item_cursor_style_get() instead
4204 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
4207 * Get if the (custom) cursor for a given list item is being
4208 * searched in its theme, also, or is only relying on the rendering
4211 * @param it a list item
4212 * @return @c EINA_TRUE, if cursors are being looked for only on
4213 * those provided by the rendering engine, @c EINA_FALSE if they
4214 * are being searched on the widget's theme, as well.
4216 * @see elm_list_item_cursor_engine_only_set(), for more details
4218 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
4220 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
4223 * Delete the item from the list.
4225 * @param it The item of list to be deleted.
4227 * If deleting all list items is required, elm_list_clear()
4228 * should be used instead of getting items list and deleting each one.
4230 * @see elm_list_clear()
4231 * @see elm_list_item_append()
4232 * @see elm_widget_item_del_cb_set()
4233 * @deprecated Use elm_object_item_del() instead
4236 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
4240 * This sets a widget to be displayed to the left of a scrolled entry.
4242 * @param obj The scrolled entry object
4243 * @param icon The widget to display on the left side of the scrolled
4246 * @note A previously set widget will be destroyed.
4247 * @note If the object being set does not have minimum size hints set,
4248 * it won't get properly displayed.
4250 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4251 * @see elm_entry_end_set()
4253 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4256 * Gets the leftmost widget of the scrolled entry. This object is
4257 * owned by the scrolled entry and should not be modified.
4259 * @param obj The scrolled entry object
4260 * @return the left widget inside the scroller
4262 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4264 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
4267 * Unset the leftmost widget of the scrolled entry, unparenting and
4270 * @param obj The scrolled entry object
4271 * @return the previously set icon sub-object of this entry, on
4274 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4275 * @see elm_entry_icon_set()
4277 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
4280 * This sets a widget to be displayed to the end of a scrolled entry.
4282 * @param obj The scrolled entry object
4283 * @param end The widget to display on the right side of the scrolled
4286 * @note A previously set widget will be destroyed.
4287 * @note If the object being set does not have minimum size hints set,
4288 * it won't get properly displayed.
4290 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4291 * @see elm_entry_icon_set
4293 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4296 * Gets the endmost widget of the scrolled entry. This object is owned
4297 * by the scrolled entry and should not be modified.
4299 * @param obj The scrolled entry object
4300 * @return the right widget inside the scroller
4302 * @deprecated Use elm_object_part_content_get(entry, "end") instead
4304 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
4307 * Unset the endmost widget of the scrolled entry, unparenting and
4310 * @param obj The scrolled entry object
4311 * @return the previously set icon sub-object of this entry, on
4314 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4315 * @see elm_entry_icon_set()
4317 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
4320 * Set route service to be used. By default used source is
4321 * #ELM_MAP_ROUTE_SOURCE_YOURS.
4323 * @see elm_map_route_source_set()
4324 * @see elm_map_route_source_get()
4329 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
4330 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. */
4331 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
4332 ELM_MAP_ROUTE_SOURCE_LAST
4333 } Elm_Map_Route_Sources;
4336 * Convert a pixel coordinate into a rotated pixel coordinate.
4338 * @param obj The map object.
4339 * @param x horizontal coordinate of the point to rotate.
4340 * @param y vertical coordinate of the point to rotate.
4341 * @param cx rotation's center horizontal position.
4342 * @param cy rotation's center vertical position.
4343 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4344 * @param xx Pointer where to store rotated x.
4345 * @param yy Pointer where to store rotated y.
4347 * @deprecated Use elm_map_canvas_to_geo_convert() instead
4349 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);
4352 * Convert canvas coordinates into a geographic coordinate
4353 * (longitude, latitude).
4355 * @param obj The map object.
4356 * @param x horizontal coordinate of the point to convert.
4357 * @param y vertical coordinate of the point to convert.
4358 * @param lon A pointer to the longitude.
4359 * @param lat A pointer to the latitude.
4361 * This gets longitude and latitude from canvas x, y coordinates. The canvas
4362 * coordinates mean x, y coordinate from current viewport.
4364 * see elm_map_rotate_get()
4365 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
4368 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);
4371 * Get the current geographic coordinates of the map.
4373 * @param obj The map object.
4374 * @param lon Pointer to store longitude.
4375 * @param lat Pointer to store latitude.
4377 * This gets the current center coordinates of the map object. It can be
4378 * set by elm_map_region_bring_in() and elm_map_region_show().
4380 * @see elm_map_region_bring_in()
4381 * @see elm_map_region_show()
4383 * @deprecated Use elm_map_region_get() instead
4385 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
4388 * Animatedly bring in given coordinates to the center of the map.
4390 * @param obj The map object.
4391 * @param lon Longitude to center at.
4392 * @param lat Latitude to center at.
4394 * This causes map to jump to the given @p lat and @p lon coordinates
4395 * and show it (by scrolling) in the center of the viewport, if it is not
4396 * already centered. This will use animation to do so and take a period
4397 * of time to complete.
4399 * @see elm_map_region_show() for a function to avoid animation.
4400 * @see elm_map_region_get()
4402 * @deprecated Use elm_map_region_bring_in() instead
4404 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
4407 * Show the given coordinates at the center of the map, @b immediately.
4409 * @param obj The map object.
4410 * @param lon Longitude to center at.
4411 * @param lat Latitude to center at.
4413 * This causes map to @b redraw its viewport's contents to the
4414 * region containing the given @p lat and @p lon, that will be moved to the
4415 * center of the map.
4417 * @see elm_map_region_bring_in() for a function to move with animation.
4418 * @see elm_map_region_get()
4420 * @deprecated Use elm_map_region_show() instead
4422 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
4425 * Set the minimum zoom of the source.
4427 * @param obj The map object.
4428 * @param zoom New minimum zoom value to be used.
4430 * By default, it's 0.
4432 * @deprecated Use elm_map_zoom_min_set() instead
4434 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4437 * Get the minimum zoom of the source.
4439 * @param obj The map object.
4440 * @return Returns the minimum zoom of the source.
4442 * @see elm_map_zoom_min_set() for details.
4444 * @deprecated Use elm_map_zoom_min_get() instead
4446 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
4449 * Set the maximum zoom of the source.
4451 * @param obj The map object.
4452 * @param zoom New maximum zoom value to be used.
4454 * By default, it's 18.
4456 * @deprecated Use elm_map_zoom_max_set() instead
4458 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4461 * Get the maximum zoom of the source.
4463 * @param obj The map object.
4464 * @return Returns the maximum zoom of the source.
4466 * @see elm_map_zoom_min_set() for details.
4468 * @deprecated Use elm_map_zoom_max_get() instead
4470 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
4474 * Get the list of available sources.
4476 * @param obj The map object.
4477 * @return The source names list.
4479 * It will provide a list with all available sources, that can be set as
4480 * current source with elm_map_source_name_set(), or get with
4481 * elm_map_source_name_get().
4483 * Available sources:
4489 * @see elm_map_source_name_set() for more details.
4490 * @see elm_map_source_name_get()
4491 * @deprecated Use elm_map_sources_get() instead
4494 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
4497 * Set the source of the map.
4499 * @param obj The map object.
4500 * @param source_name The source to be used.
4502 * Map widget retrieves images that composes the map from a web service.
4503 * This web service can be set with this method.
4505 * A different service can return a different maps with different
4506 * information and it can use different zoom values.
4508 * The @p source_name need to match one of the names provided by
4509 * elm_map_source_names_get().
4511 * The current source can be get using elm_map_source_name_get().
4513 * @see elm_map_source_names_get()
4514 * @see elm_map_source_name_get()
4515 * @deprecated Use elm_map_source_set() instead
4518 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
4521 * Get the name of currently used source.
4523 * @param obj The map object.
4524 * @return Returns the name of the source in use.
4526 * @see elm_map_source_name_set() for more details.
4527 * @deprecated Use elm_map_source_get() instead
4530 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
4533 * Set the source of the route service to be used by the map.
4535 * @param obj The map object.
4536 * @param source The route service to be used, being it one of
4537 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4538 * and #ELM_MAP_ROUTE_SOURCE_ORS.
4540 * Each one has its own algorithm, so the route retrieved may
4541 * differ depending on the source route. Now, only the default is working.
4543 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4544 * http://www.yournavigation.org/.
4546 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4547 * assumptions. Its routing core is based on Contraction Hierarchies.
4549 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4551 * @see elm_map_route_source_get().
4552 * @deprecated Use elm_map_source_set() instead
4555 EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4558 * Get the current route source.
4560 * @param obj The map object.
4561 * @return The source of the route service used by the map.
4563 * @see elm_map_route_source_set() for details.
4564 * @deprecated Use elm_map_source_get() instead
4567 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4570 * Set the maximum numbers of markers' content to be displayed in a group.
4572 * @param obj The map object.
4573 * @param max The maximum numbers of items displayed in a bubble.
4575 * A bubble will be displayed when the user clicks over the group,
4576 * and will place the content of markers that belong to this group
4579 * A group can have a long list of markers, consequently the creation
4580 * of the content of the bubble can be very slow.
4582 * In order to avoid this, a maximum number of items is displayed
4585 * By default this number is 30.
4587 * Marker with the same group class are grouped if they are close.
4589 * @see elm_map_marker_add()
4591 * @deprecated Use Elm_Map_Overlay instead
4593 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4596 * Set to show markers during zoom level changes or not.
4598 * @param obj The map object.
4599 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4602 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4605 * The default is off.
4607 * This will stop zooming using animation, changing zoom levels will
4608 * change instantly. This will stop any existing animations that are running.
4610 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4613 * The default is off.
4615 * Enabling it will force the map to stop displaying the markers during
4616 * zoom level changes. Set to on if you have a large number of markers.
4618 * @see elm_map_paused_markers_get()
4620 * @deprecated Use Elm_Map_Overlay instead
4622 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4625 * Get a value whether markers will be displayed on zoom level changes or not
4627 * @param obj The map object.
4628 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4629 * indicates it will.
4631 * This gets the current markers paused state for the map object.
4633 * @see elm_map_paused_markers_set() for details.
4635 * @deprecated Use Elm_Map_Overlay instead
4637 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj);
4640 * Close all the bubbles opened by the user.
4642 * @param obj The map object.
4644 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4645 * when the user clicks on a marker.
4647 * This functions is set for the marker class with
4648 * elm_map_marker_class_get_cb_set().
4650 * @deprecated Use Elm_Map_Overlay instead
4652 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj);
4655 * Set the marker's style of a group class.
4657 * @param clas The group class.
4658 * @param style The style to be used by markers.
4660 * Each marker must be associated to a group class, and will use the style
4661 * defined by such class when grouped to other markers.
4663 * The following styles are provided by default theme:
4664 * @li @c radio - blue circle
4665 * @li @c radio2 - green circle
4668 * @see elm_map_group_class_new() for more details.
4669 * @see elm_map_marker_add()
4671 * @deprecated Use Elm_Map_Overlay instead
4673 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4676 * Set the icon callback function of a group class.
4678 * @param clas The group class.
4679 * @param icon_get The callback function that will return the icon.
4681 * Each marker must be associated to a group class, and it can display a
4682 * custom icon. The function @p icon_get must return this icon.
4684 * @see elm_map_group_class_new() for more details.
4685 * @see elm_map_marker_add()
4687 * @deprecated Use Elm_Map_Overlay instead
4689 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4692 * Set the data associated to the group class.
4694 * @param clas The group class.
4695 * @param data The new user data.
4697 * This data will be passed for callback functions, like icon get callback,
4698 * that can be set with elm_map_group_class_icon_cb_set().
4700 * If a data was previously set, the object will lose the pointer for it,
4701 * so if needs to be freed, you must do it yourself.
4703 * @see elm_map_group_class_new() for more details.
4704 * @see elm_map_group_class_icon_cb_set()
4705 * @see elm_map_marker_add()
4707 * @deprecated Use Elm_Map_Overlay instead
4709 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4712 * Set the minimum zoom from where the markers are displayed.
4714 * @param clas The group class.
4715 * @param zoom The minimum zoom.
4717 * Markers only will be displayed when the map is displayed at @p zoom
4720 * @see elm_map_group_class_new() for more details.
4721 * @see elm_map_marker_add()
4723 * @deprecated Use Elm_Map_Overlay instead
4725 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4728 * Set the zoom from where the markers are no more grouped.
4730 * @param clas The group class.
4731 * @param zoom The maximum zoom.
4733 * Markers only will be grouped when the map is displayed at
4734 * less than @p zoom.
4736 * @see elm_map_group_class_new() for more details.
4737 * @see elm_map_marker_add()
4739 * @deprecated Use Elm_Map_Overlay instead
4741 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4744 * Set if the markers associated to the group class @p clas are hidden or not.
4746 * @param clas The group class.
4747 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4750 * @param obj The map object.
4751 * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4754 * @deprecated Use Elm_Map_Overlay instead
4756 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4759 * Set the marker's style of a marker class.
4761 * @param clas The marker class.
4762 * @param style The style to be used by markers.
4764 * Each marker must be associated to a marker class, and will use the style
4765 * defined by such class when alone, i.e., @b not grouped to other markers.
4767 * The following styles are provided by default theme:
4772 * @see elm_map_marker_class_new() for more details.
4773 * @see elm_map_marker_add()
4775 * @deprecated Use Elm_Map_Overlay instead
4777 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4780 * Set the icon callback function of a marker class.
4782 * @param clas The marker class.
4783 * @param icon_get The callback function that will return the icon.
4785 * Each marker must be associated to a marker class, and it can display a
4786 * custom icon. The function @p icon_get must return this icon.
4788 * @see elm_map_marker_class_new() for more details.
4789 * @see elm_map_marker_add()
4791 * @deprecated Use Elm_Map_Overlay instead
4793 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4796 * Set the bubble content callback function of a marker class.
4798 * @param clas The marker class.
4799 * @param get The callback function that will return the content.
4801 * Each marker must be associated to a marker class, and it can display a
4802 * a content on a bubble that opens when the user click over the marker.
4803 * The function @p get must return this content object.
4805 * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4808 * @see elm_map_marker_class_new() for more details.
4809 * @see elm_map_marker_class_del_cb_set()
4810 * @see elm_map_marker_add()
4812 * @deprecated Use Elm_Map_Overlay instead
4814 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4817 * Set the callback function used to delete bubble content of a marker class.
4819 * @param clas The marker class.
4820 * @param del The callback function that will delete the content.
4822 * Each marker must be associated to a marker class, and it can display a
4823 * a content on a bubble that opens when the user click over the marker.
4824 * The function to return such content can be set with
4825 * elm_map_marker_class_get_cb_set().
4827 * If this content must be freed, a callback function need to be
4828 * set for that task with this function.
4830 * If this callback is defined it will have to delete (or not) the
4831 * object inside, but if the callback is not defined the object will be
4832 * destroyed with evas_object_del().
4834 * @see elm_map_marker_class_new() for more details.
4835 * @see elm_map_marker_class_get_cb_set()
4836 * @see elm_map_marker_add()
4838 * @deprecated Use Elm_Map_Overlay instead
4840 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4843 * Set the route color.
4845 * @param route The route object.
4846 * @param r Red channel value, from 0 to 255.
4847 * @param g Green channel value, from 0 to 255.
4848 * @param b Blue channel value, from 0 to 255.
4849 * @param a Alpha channel value, from 0 to 255.
4851 * It uses an additive color model, so each color channel represents
4852 * how much of each primary colors must to be used. 0 represents
4853 * absence of this color, so if all of the three are set to 0,
4854 * the color will be black.
4856 * These component values should be integers in the range 0 to 255,
4857 * (single 8-bit byte).
4859 * This sets the color used for the route. By default, it is set to
4860 * solid red (r = 255, g = 0, b = 0, a = 255).
4862 * For alpha channel, 0 represents completely transparent, and 255, opaque.
4864 * @see elm_map_route_color_get()
4865 * @deprecated Use elm_map_overlay_color_set() instead
4868 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4871 * Get the route color.
4873 * @param route The route object.
4874 * @param r Pointer to store the red channel value.
4875 * @param g Pointer to store the green channel value.
4876 * @param b Pointer to store the blue channel value.
4877 * @param a Pointer to store the alpha channel value.
4879 * @see elm_map_route_color_set() for details.
4880 * @deprecated Use elm_map_overlay_color_get() instead
4883 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4886 * Remove a name from the map.
4888 * @param name The name to remove.
4890 * Basically the struct handled by @p name will be freed, so conversions
4891 * between address and coordinates will be lost.
4893 * @see elm_map_utils_convert_name_into_coord()
4894 * @see elm_map_utils_convert_coord_into_name()
4895 * @deprecated Use elm_map_name_del() instead
4898 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name);
4901 * Get the gengrid object's handle which contains a given gengrid item
4903 * @param it The item to fetch the container from
4904 * @return The gengrid (parent) object
4906 * This returns the gengrid object itself that an item belongs to.
4908 * @deprecated Use elm_object_item_widget_get() instead
4910 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4913 * Return the data associated to a given gengrid item
4915 * @param it The gengrid item.
4916 * @return the data associated with this item.
4918 * This returns the @c data value passed on the
4919 * elm_gengrid_item_append() and related item addition calls.
4921 * @see elm_gengrid_item_append()
4922 * @see elm_gengrid_item_data_set()
4923 * @deprecated Use elm_object_item_data_get() instead
4925 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4928 * Set the data associated with a given gengrid item
4930 * @param it The gengrid item
4931 * @param data The data pointer to set on it
4933 * This @b overrides the @c data value passed on the
4934 * elm_gengrid_item_append() and related item addition calls. This
4935 * function @b won't call elm_gengrid_item_update() automatically,
4936 * so you'd issue it afterwards if you want to have the item
4937 * updated to reflect the new data.
4939 * @see elm_gengrid_item_data_get()
4940 * @see elm_gengrid_item_update()
4941 * @deprecated Use elm_object_item_data_set() instead
4944 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4947 * Set whether a given gengrid item is disabled or not.
4949 * @param it The gengrid item
4950 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4951 * to enable it back.
4953 * A disabled item cannot be selected or unselected. It will also
4954 * change its appearance, to signal the user it's disabled.
4956 * @see elm_gengrid_item_disabled_get()
4957 * @deprecated Use elm_object_item_disabled_set() instead
4960 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4963 * Get whether a given gengrid item is disabled or not.
4965 * @param it The gengrid item
4966 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4969 * @see elm_gengrid_item_disabled_set() for more details
4970 * @deprecated Use elm_object_item_disabled_get() instead
4973 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4976 * Remove a gengrid item from its parent, deleting it.
4978 * @param it The item to be removed.
4979 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4981 * @see elm_gengrid_clear(), to remove all items in a gengrid at
4983 * @deprecated use elm_object_item_de() instead
4986 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
4989 * Update the item class of a gengrid item.
4991 * This sets another class of the item, changing the way that it is
4992 * displayed. After changing the item class, elm_gengrid_item_update() is
4993 * called on the item @p it.
4995 * @param it The gengrid item
4996 * @param gic The gengrid item class describing the function pointers and the item style.
4998 * @deprecated Use elm_gengrid_item_item_class_update instead
5000 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
5003 * Insert an item in a gengrid widget using a user-defined sort function.
5005 * @param obj The gengrid object.
5006 * @param gic The item class for the item.
5007 * @param data The item data.
5008 * @param comp User defined comparison function that defines the sort order
5009 * based on Elm_Gen_Item.
5010 * @param func Convenience function called when the item is selected.
5011 * @param func_data Data to be passed to @p func.
5012 * @return A handle to the item added or @c NULL, on errors.
5014 * This inserts an item in the gengrid based on user defined comparison function.
5016 * @see elm_gengrid_item_append()
5017 * @see elm_gengrid_item_prepend()
5018 * @see elm_gengrid_item_insert_after()
5019 * @see elm_object_item_del()
5020 * @see elm_gengrid_item_sorted_insert()
5022 * @deprecated Use elm_gengrid_item_sorted_insert() instead
5024 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);
5027 * Append a filter function for text inserted in the entry
5029 * Append the given callback to the list. This functions will be called
5030 * whenever any text is inserted into the entry, with the text to be inserted
5031 * as a parameter. The callback function is free to alter the text in any way
5032 * it wants, but it must remember to free the given pointer and update it.
5033 * If the new text is to be discarded, the function can free it and set its
5034 * text parameter to NULL. This will also prevent any following filters from
5037 * @param obj The entry object
5038 * @param func The function to use as text filter
5039 * @param data User data to pass to @p func
5040 * @deprecated use elm_entry_markup_filter_append() instead
5042 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5045 * Prepend a filter function for text inserted in the entry
5047 * Prepend the given callback to the list. See elm_entry_text_filter_append()
5048 * for more information
5050 * @param obj The entry object
5051 * @param func The function to use as text filter
5052 * @param data User data to pass to @p func
5053 * @deprecated use elm_entry_markup_filter_prepend() instead
5055 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5058 * Remove a filter from the list
5060 * Removes the given callback from the filter list. See
5061 * elm_entry_text_filter_append() for more information.
5063 * @param obj The entry object
5064 * @param func The filter function to remove
5065 * @param data The user data passed when adding the function
5066 * @deprecated use elm_entry_markup_filter_remove() instead
5068 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5071 * @brief Set the front content of the flip widget.
5073 * @param obj The flip object
5074 * @param content The new front content object
5076 * Once the content object is set, a previously set one will be deleted.
5077 * If you want to keep that old content object, use the
5078 * elm_flip_content_front_unset() function.
5080 * @deprecated Use elm_object_part_content_set(flip, "front") instead
5082 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
5085 * @brief Set the back content of the flip widget.
5087 * @param obj The flip object
5088 * @param content The new back content object
5090 * Once the content object is set, a previously set one will be deleted.
5091 * If you want to keep that old content object, use the
5092 * elm_flip_content_back_unset() function.
5094 * @deprecated Use elm_object_part_content_set(flip, "back") instead
5096 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
5099 * @brief Get the front content used for the flip
5101 * @param obj The flip object
5102 * @return The front content object that is being used
5104 * Return the front content object which is set for this widget.
5106 * @deprecated Use elm_object_part_content_get(flip, "front") instead
5108 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj);
5111 * @brief Get the back content used for the flip
5113 * @param obj The flip object
5114 * @return The back content object that is being used
5116 * Return the back content object which is set for this widget.
5118 * @deprecated Use elm_object_part_content_get(flip, "back") instead
5120 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj);
5123 * @brief Unset the front content used for the flip
5125 * @param obj The flip object
5126 * @return The front content object that was being used
5128 * Unparent and return the front content object which was set for this widget.
5130 * @deprecated Use elm_object_part_content_unset(flip, "front") instead
5132 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj);
5135 * @brief Unset the back content used for the flip
5137 * @param obj The flip object
5138 * @return The back content object that was being used
5140 * Unparent and return the back content object which was set for this widget.
5142 * @deprecated Use elm_object_part_content_unset(flip, "back") instead
5144 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj);
5147 * @brief Get flip front visibility state
5149 * @param obj The flip object
5150 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
5153 * @deprecated Use elm_flip_front_visible_get() instead
5155 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj);
5158 * @brief Set the font size on the label object.
5160 * @param obj The label object
5161 * @param size font size
5163 * @warning NEVER use this. It is for hyper-special cases only. use styles
5164 * instead. e.g. "default", "marker", "slide_long" etc.
5165 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
5167 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize);
5170 * @brief Set the text color on the label object
5172 * @param obj The label object
5173 * @param r Red property background color of The label object
5174 * @param g Green property background color of The label object
5175 * @param b Blue property background color of The label object
5176 * @param a Alpha property background color of The label object
5178 * @warning NEVER use this. It is for hyper-special cases only. use styles
5179 * instead. e.g. "default", "marker", "slide_long" etc.
5180 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
5182 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5185 * @brief Set the text align on the label object
5187 * @param obj The label object
5188 * @param align align mode ("left", "center", "right")
5190 * @warning NEVER use this. It is for hyper-special cases only. use styles
5191 * instead. e.g. "default", "marker", "slide_long" etc.
5192 * @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%.
5194 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
5197 * @brief Set background color of the label
5199 * @param obj The label object
5200 * @param r Red property background color of The label object
5201 * @param g Green property background color of The label object
5202 * @param b Blue property background color of The label object
5203 * @param a Alpha property background alpha of The label object
5205 * @warning NEVER use this. It is for hyper-special cases only. use styles
5206 * instead. e.g. "default", "marker", "slide_long" etc.
5207 * @deprecated Just make colored background by yourself.
5209 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5212 * @brief Set wrap height of the label
5214 * @param obj The label object
5215 * @param h The wrap height in pixels at a minimum where words need to wrap
5217 * This function sets the maximum height size hint of the label.
5219 * @warning This is only relevant if the label is inside a container.
5220 * @deprecated This function should not be used because of wrong concept.
5222 EINA_DEPRECATED EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
5225 * @brief get wrap width of the label
5227 * @param obj The label object
5228 * @return The wrap height in pixels at a minimum where words need to wrap
5229 * @deprecated This function should not be used because of wrong concept.
5231 EINA_DEPRECATED EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj);
5234 * @brief Flush all caches.
5236 * Frees all data that was in cache and is not currently being used to reduce
5237 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
5238 * to calling all of the following functions:
5239 * @li edje_file_cache_flush()
5240 * @li edje_collection_cache_flush()
5241 * @li eet_clearcache()
5242 * @li evas_image_cache_flush()
5243 * @li evas_font_cache_flush()
5244 * @li evas_render_dump()
5245 * @note Evas caches are flushed for every canvas associated with a window.
5246 * @deprecated Use elm_cache_all_flush() instead.
5248 EINA_DEPRECATED EAPI void elm_all_flush(void);
5252 * @brief Define the uri that will be the video source.
5254 * @param video The video object to define the file for.
5255 * @param uri The uri to target.
5257 * This function will define an uri as a source for the video of the
5258 * Elm_Video object. URI could be remote source of video, like http:// or local
5259 * like for example WebCam who are most of the time v4l2:// (but that depend an
5260 * you should use Emotion API to request and list the available Webcam on your
5262 * @deprecated Use elm_video_file_set() instead.
5265 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri);
5268 * @brief Get the region of the image that is currently shown
5271 * @param x A pointer to the X-coordinate of region
5272 * @param y A pointer to the Y-coordinate of region
5273 * @param w A pointer to the width
5274 * @param h A pointer to the height
5276 * @deprecated Use elm_photocam_image_region_get() instead.
5278 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
5281 * @brief Set the gesture state for photocam.
5283 * @param obj The photocam object
5284 * @param gesture The gesture state to set
5286 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
5287 * photocam. The default is off. This will start multi touch zooming.
5289 * @deprecated Use elm_photocam_gesture_enabled_set() instead.
5291 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
5294 * @brief Get the gesture state for photocam.
5296 * @param obj The photocam object
5297 * @return The current gesture state
5299 * This gets the current gesture state for the photocam object.
5301 * @deprecated Use elm_photocam_gesture_enabled_get() instead.
5303 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj);
5304 /* No documentation for these API before.
5306 * @deprecated Use elm_route_latitude_min_max_get()
5307 * elm_route_longitude_min_max_get()
5310 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj);
5311 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj);
5312 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj);
5313 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj);
5317 * Get the duration after which tooltip will be shown.
5319 * @return Duration after which tooltip will be shown.
5320 * @deprecated Use elm_config_tooltip_delay_get(void);
5322 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void);
5325 * Set the duration after which tooltip will be shown.
5327 * @return EINA_TRUE if value is set.
5328 * @deprecated Use elm_config_tooltip_delay_set(double delay);
5330 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay);
5333 * Set the corner of the bubble
5335 * @param obj The bubble object.
5336 * @param corner The given corner for the bubble.
5338 * @deprecated Use elm_bubble_pos_set()
5341 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
5344 * Get the corner of the bubble
5346 * @param obj The bubble object.
5347 * @return The given corner for the bubble.
5349 * @deprecated Use elm_bubble_pos_get()
5351 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
5354 * Enable or disable day selection
5356 * @param obj The calendar object.
5357 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
5360 * @deprecated Use elm_calendar_day_selection_disabled_set()
5362 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
5365 * Get a value whether day selection is enabled or not.
5367 * @param obj The calendar object.
5368 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
5369 * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
5371 * @deprecated elm_calendar_day_selection_disabled_get()
5373 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
5376 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
5378 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
5381 * Get the configured font cache size
5383 * This gets the globally configured font cache size, in bytes.
5385 * @return The font cache size
5386 * @deprecated elm_cache_font_cache_size_get(void);
5388 EINA_DEPRECATED EAPI int elm_font_cache_get(void);
5391 * Set the configured font cache size
5393 * This sets the globally configured font cache size, in bytes
5395 * @param size The font cache size
5396 * @deprecated elm_cache_font_cache_size_set(int size);
5398 EINA_DEPRECATED EAPI void elm_font_cache_set(int size);
5401 * Get the configured image cache size
5403 * This gets the globally configured image cache size, in bytes
5405 * @return The image cache size
5407 EINA_DEPRECATED EAPI int elm_image_cache_get(void);
5408 EINA_DEPRECATED EAPI int elm_cache_image_cache_size_get(void);
5411 * Set the configured image cache size
5413 * This sets the globally configured image cache size, in bytes
5415 * @param size The image cache size
5416 * @deprecated Use elm_cache_image_cache_size_set(int size);
5418 EINA_DEPRECATED EAPI void elm_image_cache_set(int size);
5422 * Get the configured edje file cache size.
5424 * This gets the globally configured edje file cache size, in number
5427 * @return The edje file cache size
5428 * @deprecated Use elm_cache_edje_file_cache_size_get(void);
5430 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void);
5433 * Set the configured edje file cache size
5435 * This sets the globally configured edje file cache size, in number
5438 * @param size The edje file cache size
5439 * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
5441 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size);
5444 * Get the configured edje collections (groups) cache size.
5446 * This gets the globally configured edje collections cache size, in
5447 * number of collections.
5449 * @return The edje collections cache size
5450 * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
5452 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void);
5455 * Set the configured edje collections (groups) cache size
5457 * This sets the globally configured edje collections cache size, in
5458 * number of collections.
5460 * @param size The edje collections cache size
5461 * @deprecated elm_cache_edje_collection_cache_size_set(int size);
5463 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size);
5466 * Gets whether browsing history is enabled for the given object
5468 * @param obj The web object
5470 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
5472 * @deprecated Use elm_web_history_enabled_get()
5474 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj);
5477 * Enables or disables the browsing history
5479 * @param obj The web object
5480 * @param enable Whether to enable or disable the browsing history
5482 * @deprecated Use elm_web_history_enabled_set()
5485 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
5488 * @brief Add an object swallowed in an item at the end of the given menu
5491 * @param obj The menu object.
5492 * @param parent The parent menu item (optional)
5493 * @param subobj The object to swallow
5494 * @param func Function called when the user select the item.
5495 * @param data Data sent by the callback.
5496 * @return Returns the new item.
5498 * Add an evas object as an item to the menu.
5499 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
5501 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);
5504 * @brief Sets whether events should be passed to by a click outside
5507 * @param obj The notify object
5508 * @param repeat EINA_TRUE Events are repeats, else no
5510 * When true if the user clicks outside the window the events will be caught
5511 * by the others widgets, else the events are blocked.
5513 * @note The default value is EINA_TRUE.
5514 * @deprecated Please use elm_notify_allow_events_set() instead
5516 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
5519 * @brief Return true if events are repeat below the notify object
5520 * @param obj the notify object
5522 * @see elm_notify_repeat_events_set()
5523 * @deprecated Please use elm_notify_allow_events_get() instead
5525 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj);
5528 * Set if the cursor set should be searched on the theme or should use
5529 * the provided by the engine, only.
5531 * @param obj an object with cursor already set.
5532 * @param engine_only boolean to define if cursors should be looked only
5533 * between the provided by the engine or searched on widget's theme as well.
5535 * @deprecated Use elm_object_cursor_theme_search_enabled_set()
5537 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5540 * Get the cursor engine only usage for this object cursor.
5542 * @param obj an object with cursor already set.
5543 * @return engine_only boolean to define it cursors should be
5544 * looked only between the provided by the engine or searched on
5545 * widget's theme as well. If the object does not have a cursor
5546 * set, then EINA_FALSE is returned.
5548 * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5550 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj);
5553 * Go to a given items level on a index widget
5555 * @param obj The index object
5556 * @param level The index level (one of @c 0 or @c 1)
5558 * @deprecated please use "elm_index_level_go" instead.
5560 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level);
5563 * Enable or disable auto hiding feature for a given index widget.
5565 * @param obj The index object
5566 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5568 * @see elm_index_active_get()
5570 * @deprecated please use "elm_index_autohide_disabled_set" instead.
5572 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5575 * Get whether auto hiding feature is enabled or not for a given index widget.
5577 * @param obj The index object
5578 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5580 * @see elm_index_active_set() for more details
5582 * @deprecated please use "elm_index_autohide_disabled_get" instead.
5584 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
5587 * Append a new item, on a given index widget, <b>after the item
5588 * having @p relative as data</b>.
5590 * @param obj The index object.
5591 * @param letter Letter under which the item should be indexed
5592 * @param item The item data to set for the index's item
5593 * @param relative The index item to be the predecessor of this new one
5594 * @return A handle to the item added or @c NULL, on errors
5596 * Despite the most common usage of the @p letter argument is for
5597 * single char strings, one could use arbitrary strings as index
5600 * @c item will be the pointer returned back on @c "changed", @c
5601 * "delay,changed" and @c "selected" smart events.
5603 * @note If @p relative is @c NULL this function will behave as
5604 * elm_index_item_append().
5606 * @deprecated please use "elm_index_item_insert_after" instead.
5608 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);
5611 * Prepend a new item, on a given index widget, <b>after the item
5612 * having @p relative as data</b>.
5614 * @param obj The index object.
5615 * @param letter Letter under which the item should be indexed
5616 * @param item The item data to set for the index's item
5617 * @param relative The index item to be the successor of this new one
5618 * @return A handle to the item added or @c NULL, on errors
5620 * Despite the most common usage of the @p letter argument is for
5621 * single char strings, one could use arbitrary strings as index
5624 * @c item will be the pointer returned back on @c "changed", @c
5625 * "delay,changed" and @c "selected" smart events.
5627 * @note If @p relative is @c NULL this function will behave as
5628 * elm_index_item_prepend().
5630 * @deprecated please use "elm_index_item_insert_before" instead.
5632 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);
5635 * Set the transparency state of a window.
5637 * Use elm_win_alpha_set() instead.
5639 * @param obj The window object
5640 * @param transparent If true, the window is transparent
5642 * @see elm_win_alpha_set()
5643 * @deprecated Please use elm_win_alpha_set()
5645 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5648 * Get the transparency state of a window.
5650 * @param obj The window object
5651 * @return If true, the window is transparent
5653 * @see elm_win_transparent_set()
5654 * @deprecated Please use elm_win_alpha_get()
5656 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj);
5659 * Set the theme for all elementary using applications on the current display
5661 * @param theme The name of the theme to use. Format same as the ELM_THEME
5662 * environment variable.
5663 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5665 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme);
5668 * Returns the Evas_Object that represents the content area.
5670 * @param obj The conformant object.
5671 * @return The content area of the widget.
5674 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
5677 * Set if the object is (up/down) resizable.
5679 * @param obj The image object
5680 * @param scale_up A bool to set if the object is resizable up. Default is
5682 * @param scale_down A bool to set if the object is resizable down. Default
5685 * This function limits the image resize ability. If @p scale_up is set to
5686 * @c EINA_FALSE, the object can't have its height or width resized to a value
5687 * higher than the original image size. Same is valid for @p scale_down.
5689 * @see elm_image_scale_get()
5690 * @deprecated Please use elm_image_resizable_set()
5693 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5696 * Get if the object is (up/down) resizable.
5698 * @param obj The image object
5699 * @param scale_up A bool to set if the object is resizable up
5700 * @param scale_down A bool to set if the object is resizable down
5702 * @see elm_image_scale_set()
5703 * @deprecated Please use elm_image_resizable_get()
5706 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5709 * Set if the object is (up/down) resizable.
5711 * @param obj The icon object
5712 * @param scale_up A bool to set if the object is resizable up. Default is
5714 * @param scale_down A bool to set if the object is resizable down. Default
5717 * This function limits the icon object resize ability. If @p scale_up is set to
5718 * @c EINA_FALSE, the object can't have its height or width resized to a value
5719 * higher than the original icon size. Same is valid for @p scale_down.
5721 * @see elm_icon_scale_get()
5722 * @deprecated Please use elm_icon_resizable_set()
5725 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5728 * Get if the object is (up/down) resizable.
5730 * @param obj The icon object
5731 * @param scale_up A bool to set if the object is resizable up
5732 * @param scale_down A bool to set if the object is resizable down
5734 * @see elm_icon_scale_set()
5735 * @deprecated Please use elm_icon_resizable_get()
5738 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5741 * Enable or disable preloading of the icon
5743 * @param obj The icon object
5744 * @param disable If EINA_TRUE, preloading will be disabled
5745 * @deprecated Use elm_icon_preload_disabled_set() instead
5747 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5750 * Returns the last selected item, for a given index widget.
5752 * @param obj The index object.
5753 * @return The last item @b selected on @p obj (or @c NULL, on errors).
5754 * @deprecated Please use elm_index_selected_item_get() instead.
5758 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
5761 * Get the value of shrink_mode state.
5763 * @deprecated elm_multibuttonentry_expanded_get()
5765 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5768 * Set/Unset the multibuttonentry to shrink mode state of single line
5770 * @deprecated elm_multibuttonentry_expanded_set()
5772 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5775 * Get the guide text
5777 * @param obj The multibuttonentry object
5778 * @return The guide text, or NULL if none
5780 * @deprecated Please use elm_object_part_text_get(obj, "guide");
5782 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5785 * Set the guide text
5787 * @param obj The multibuttonentry object
5788 * @param guidetext The guide text string
5790 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5792 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5795 * Make the elementary object and its children to be unfocusable
5798 * @param obj The Elementary object to operate on
5799 * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5800 * @c EINA_FALSE for focusable.
5802 * This sets whether the object @p obj and its children objects
5803 * are able to take focus or not. If the tree is set as unfocusable,
5804 * newest focused object which is not in this tree will get focus.
5805 * This API can be helpful for an object to be deleted.
5806 * When an object will be deleted soon, it and its children may not
5807 * want to get focus (by focus reverting or by other focus controls).
5808 * Then, just use this API before deleting.
5810 * @see elm_object_tree_unfocusable_get()
5812 * @deprecated Please use elm_object_tree_unfocusable_set()
5814 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5817 * Get whether an Elementary object and its children are unfocusable or not.
5819 * @param obj The Elementary object to get the information from
5820 * @return @c EINA_TRUE, if the tree is unfocussable,
5821 * @c EINA_FALSE if not (and on errors).
5823 * @see elm_object_tree_unfocusable_set()
5825 * @deprecated Please use elm_object_tree_unfocusable_get()
5827 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj);
5830 * Animatedly bring in, to the visible are of a genlist, a given
5833 * @deprecated elm_genlist_item_bring_in()
5835 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5838 * Animatedly bring in, to the visible are of a genlist, a given
5841 * @deprecated elm_genlist_item_bring_in()
5843 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5846 * Show the portion of a genlist's internal list containing a given
5847 * item, immediately.
5849 * @param it The item to display
5851 * @deprecated elm_genlist_item_show()
5854 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it);
5857 * Show the portion of a genlist's internal list containing a given
5858 * item, immediately.
5860 * @param it The item to display
5862 * @deprecated elm_genlist_item_show()
5865 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it);
5868 * Enable or disable round mode.
5870 * @param obj The diskselector object.
5871 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
5874 * Disabled by default. If round mode is enabled the items list will
5875 * work like a circle list, so when the user reaches the last item,
5876 * the first one will popup.
5878 * @see elm_diskselector_round_enabled_get()
5880 * @deprecated elm_diskselector_round_enabled_set()
5882 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
5885 * Set whether items on a given gengrid widget are to get their
5886 * selection callbacks issued for @b every subsequent selection
5887 * click on them or just for the first click.
5889 * @param obj The gengrid object
5890 * @param always_select @c EINA_TRUE to make items "always
5891 * selected", @c EINA_FALSE, otherwise
5893 * By default, grid items will only call their selection callback
5894 * function when firstly getting selected, any subsequent further
5895 * clicks will do nothing. With this call, you make those
5896 * subsequent clicks also to issue the selection callbacks.
5898 * @note <b>Double clicks</b> will @b always be reported on items.
5900 * @see elm_gengrid_always_select_mode_get()
5903 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5906 * Get whether items on a given gengrid widget have their selection
5907 * callbacks issued for @b every subsequent selection click on them
5908 * or just for the first click.
5910 * @param obj The gengrid object.
5911 * @return @c EINA_TRUE if the gengrid items are "always selected",
5912 * @c EINA_FALSE, otherwise
5914 * @see elm_gengrid_always_select_mode_set() for more details
5917 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj);
5920 * Set whether items on a given gengrid widget can be selected or not.
5922 * @param obj The gengrid object
5923 * @param no_select @c EINA_TRUE to make items selectable,
5924 * @c EINA_FALSE otherwise
5926 * This will make items in @p obj selectable or not. In the latter
5927 * case, any user interaction on the gengrid items will neither make
5928 * them appear selected nor them call their selection callback
5931 * @see elm_gengrid_no_select_mode_get()
5934 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5937 * Get whether items on a given gengrid widget can be selected or
5940 * @param obj The gengrid object
5941 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
5944 * @see elm_gengrid_no_select_mode_set() for more details
5947 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj);
5950 * Get the side labels max length.
5952 * @see elm_diskselector_side_text_max_length_set() for details.
5954 * @param obj The diskselector object.
5955 * @return The max length defined for side labels, or 0 if not a valid
5958 * @deprecated elm_diskselector_side_text_max_length_get()
5960 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj);
5963 * Set the side labels max length.
5965 * @param obj The diskselector object.
5966 * @param len The max length defined for side labels.
5968 * Length is the number of characters of items' label that will be
5969 * visible when it's set on side positions. It will just crop
5970 * the string after defined size. E.g.:
5972 * An item with label "January" would be displayed on side position as
5973 * "Jan" if max length is set to 3, or "Janu", if this property
5976 * When it's selected, the entire label will be displayed, except for
5977 * width restrictions. In this case label will be cropped and "..."
5978 * will be concatenated.
5980 * Default side label max length is 3.
5982 * This property will be applied over all items, included before or
5983 * later this function call.
5985 * @deprecated elm_diskselector_side_text_max_length_set()
5987 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
5990 * Set whether the toolbar should always have an item selected.
5992 * @param obj The toolbar object.
5993 * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to
5996 * This will cause the toolbar to always have an item selected, and clicking
5997 * the selected item will not cause a selected event to be emitted. Enabling this mode
5998 * will immediately select the first toolbar item.
6000 * Always-selected is disabled by default.
6002 * @see elm_toolbar_always_select_mode_get().
6006 EINA_DEPRECATED EAPI void elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6009 * Get whether the toolbar should always have an item selected.
6011 * @param obj The toolbar object.
6012 * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates
6013 * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned.
6015 * @see elm_toolbar_always_select_mode_set() for details.
6019 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_always_select_mode_get(const Evas_Object *obj);
6022 * Set whether the toolbar items' should be selected by the user or not.
6024 * @param obj The toolbar object.
6025 * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to
6028 * This will turn off the ability to select items entirely and they will
6029 * neither appear selected nor emit selected signals. The clicked
6030 * callback function will still be called.
6032 * Selection is enabled by default.
6034 * @see elm_toolbar_no_select_mode_get().
6038 EINA_DEPRECATED EAPI void elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6041 * Set whether the toolbar items' should be selected by the user or not.
6043 * @param obj The toolbar object.
6044 * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates
6045 * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned.
6047 * @see elm_toolbar_no_select_mode_set() for details.
6051 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_no_select_mode_get(const Evas_Object *obj);
6054 * Set the interval on time updates for a user mouse button hold
6055 * on clock widgets' time edition.
6057 * @param obj The clock object
6058 * @param interval The (first) interval value in seconds
6060 * This interval value is @b decreased while the user holds the
6061 * mouse pointer either incrementing or decrementing a given the
6062 * clock digit's value.
6064 * This helps the user to get to a given time distant from the
6065 * current one easier/faster, as it will start to flip quicker and
6066 * quicker on mouse button holds.
6068 * The calculation for the next flip interval value, starting from
6069 * the one set with this call, is the previous interval divided by
6070 * 1.05, so it decreases a little bit.
6072 * The default starting interval value for automatic flips is
6075 * @deprecated elm_clock_first_interval_set()
6078 EINA_DEPRECATED EAPI void elm_clock_interval_set(Evas_Object *obj, double interval);
6081 * Get the interval on time updates for a user mouse button hold
6082 * on clock widgets' time edition.
6084 * @param obj The clock object
6085 * @return The (first) interval value, in seconds, set on it
6087 * @elm_clock_first_interval_get()
6089 EINA_DEPRECATED EAPI double elm_clock_interval_get(const Evas_Object *obj);
6092 * Set what digits of the given clock widget should be editable
6093 * when in edition mode.
6095 * @param obj The clock object
6096 * @param digedit Bit mask indicating the digits to be editable
6097 * (values in #Elm_Clock_Edit_Mode).
6099 * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
6100 * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
6103 * @deprecated elm_clock_edit_mode_set()
6105 EINA_DEPRECATED EAPI void elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
6108 * Retrieve what digits of the given clock widget should be
6109 * editable when in edition mode.
6111 * @param obj The clock object
6112 * @return Bit mask indicating the digits to be editable
6113 * (values in #Elm_Clock_Edit_Mode).
6115 * @deprecated elm_clock_edit_mode_get()
6117 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
6120 * Queries whether it's possible to go back in history
6122 * @param obj The web object
6124 * @return EINA_TRUE if it's possible to back in history, EINA_FALSE
6126 * @deprecated elm_web_back_possible_get();
6128 EINA_DEPRECATED EAPI Eina_Bool elm_web_backward_possible(Evas_Object *obj);
6131 * Queries whether it's possible to go forward in history
6133 * @param obj The web object
6135 * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE
6138 * @deprecated elm_web_forward_possible_get();
6140 EINA_DEPRECATED EAPI Eina_Bool elm_web_forward_possible(Evas_Object *obj);
6143 * Queries whether it's possible to jump the given number of steps
6145 * @deprecated elm_web_navigate_possible_get();
6148 EINA_DEPRECATED EAPI Eina_Bool elm_web_navigate_possible(Evas_Object *obj, int steps);
6151 * @brief Set the content of the scroller widget (the object to be scrolled around).
6153 * @param obj The scroller object
6154 * @param content The new content object
6156 * Once the content object is set, a previously set one will be deleted.
6157 * If you want to keep that old content object, use the
6158 * elm_scroller_content_unset() function.
6159 * @deprecated use elm_object_content_set() instead
6161 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
6164 * @brief Get the content of the scroller widget
6166 * @param obj The slider object
6167 * @return The content that is being used
6169 * Return the content object which is set for this widget
6171 * @see elm_scroller_content_set()
6172 * @deprecated use elm_object_content_get() instead.
6174 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
6177 * @brief Unset the content of the scroller widget
6179 * @param obj The slider object
6180 * @return The content that was being used
6182 * Unparent and return the content object which was set for this widget
6184 * @see elm_scroller_content_set()
6185 * @deprecated use elm_object_content_unset() instead.
6187 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
6190 * Set the shrink state of toolbar @p obj.
6192 * @param obj The toolbar object.
6193 * @param shrink_mode Toolbar's items display behavior.
6195 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
6196 * but will enforce a minimum size so all the items will fit, won't scroll
6197 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
6198 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
6199 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
6201 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
6203 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
6206 * Get the shrink mode of toolbar @p obj.
6208 * @param obj The toolbar object.
6209 * @return Toolbar's items display behavior.
6211 * @see elm_toolbar_shrink_mode_set() for details.
6213 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
6215 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
6218 * Set the text to be shown in a given toolbar item's tooltips.
6220 * @param it toolbar item.
6221 * @param text The text to set in the content.
6223 * Setup the text as tooltip to object. The item can have only one tooltip,
6224 * so any previous tooltip data - set with this function or
6225 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
6227 * @deprecated Use elm_object_item_tooltip_text_set() instead
6228 * @see elm_object_tooltip_text_set() for more details.
6231 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
6234 * Enable or disable always select mode on the list object.
6236 * @param obj The list object
6237 * @param always_select @c EINA_TRUE to enable always select mode or
6238 * @c EINA_FALSE to disable it.
6240 * @note Always select mode is disabled by default.
6242 * Default behavior of list items is to only call its callback function
6243 * the first time it's pressed, i.e., when it is selected. If a selected
6244 * item is pressed again, and multi-select is disabled, it won't call
6245 * this function (if multi-select is enabled it will unselect the item).
6247 * If always select is enabled, it will call the callback function
6248 * every time a item is pressed, so it will call when the item is selected,
6249 * and again when a selected item is pressed.
6251 * @deprecated elm_list_always_select_mode_set()
6253 EINA_DEPRECATED EAPI void elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6256 * Get a value whether always select mode is enabled or not, meaning that
6257 * an item will always call its callback function, even if already selected.
6259 * @param obj The list object
6260 * @return @c EINA_TRUE means horizontal mode selection is enabled.
6261 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
6262 * @c EINA_FALSE is returned.
6264 * @see elm_list_always_select_mode_set() for details.
6266 * @deprecated elm_list_always_select_mode_get()
6268 EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj);
6271 * Get the real Evas object created to implement the view of a
6272 * given genlist item
6274 * @param it The genlist item.
6275 * @return the Evas object implementing this item's view.
6277 * This returns the actual Evas object used to implement the
6278 * specified genlist item's view. This may be @c NULL, as it may
6279 * not have been created or may have been deleted, at any time, by
6280 * the genlist. <b>Do not modify this object</b> (move, resize,
6281 * show, hide, etc.), as the genlist is controlling it. This
6282 * function is for querying, emitting custom signals or hooking
6283 * lower level callbacks for events on that object. Do not delete
6284 * this object under any circumstances.
6286 * @see elm_object_item_data_get()
6287 * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit().
6290 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
6293 * Set the always select mode.
6295 * @param obj The genlist object
6296 * @param always_select The always select mode (@c EINA_TRUE = on, @c
6297 * EINA_FALSE = off). Default is @c EINA_FALSE.
6299 * Items will only call their selection func and callback when first
6300 * becoming selected. Any further clicks will do nothing, unless you
6301 * enable always select with elm_genlist_always_select_mode_set().
6302 * This means that, even if selected, every click will make the selected
6303 * callbacks be called.
6305 * @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.
6308 EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
6312 * Get the always select mode.
6314 * @param obj The genlist object
6315 * @return The always select mode
6316 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6318 * @deprecated use elm_genlist_select_mode_get instead.
6321 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj);
6324 * Enable/disable the no select mode.
6326 * @param obj The genlist object
6327 * @param no_select The no select mode
6328 * (EINA_TRUE = on, EINA_FALSE = off)
6330 * This will turn off the ability to select items entirely and they
6331 * will neither appear selected nor call selected callback functions.
6333 * @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.
6336 EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
6339 * Gets whether the no select mode is enabled.
6341 * @param obj The genlist object
6342 * @return The no select mode
6343 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6345 * @deprecated use elm_genlist_select_mode_get instead.
6348 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj);
6351 * Enable/disable compress mode.
6353 * @param obj The genlist object
6354 * @param compress The compress mode
6355 * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE.
6357 * This will enable the compress mode where items are "compressed"
6358 * horizontally to fit the genlist scrollable viewport width. This is
6359 * special for genlist. Do not rely on
6360 * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to
6361 * work as genlist needs to handle it specially.
6363 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6365 EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress);
6368 * Sets the display only state of an item.
6370 * @param it The item
6371 * @param display_only @c EINA_TRUE if the item is display only, @c
6372 * EINA_FALSE otherwise.
6374 * A display only item cannot be selected or unselected. It is for
6375 * display only and not selecting or otherwise clicking, dragging
6376 * etc. by the user, thus finger size rules will not be applied to
6379 * It's good to set group index items to display only state.
6381 * @see elm_genlist_item_display_only_get()
6383 * @deprecated elm_genlist_item_display_only_set()
6385 EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only);
6388 * Get the display only state of an item
6390 * @param it The item
6391 * @return @c EINA_TRUE if the item is display only, @c
6392 * EINA_FALSE otherwise.
6394 * @see elm_genlist_item_display_only_set()
6396 * @deprecated elm_genlist_item_display_only_get()
6398 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it);
6401 * Get whether the compress mode is enabled.
6403 * @param obj The genlist object
6404 * @return The compress mode
6405 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
6407 * @deprecated elm_genlsit_mode_get()
6409 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj);
6412 * Enable/disable height-for-width mode.
6414 * @param obj The genlist object
6415 * @param height_for_width The height-for-width mode (@c EINA_TRUE = on,
6416 * @c EINA_FALSE = off). Default is @c EINA_FALSE.
6418 * With height-for-width mode the item width will be fixed (restricted
6419 * to a minimum of) to the list width when calculating its size in
6420 * order to allow the height to be calculated based on it. This allows,
6421 * for instance, text block to wrap lines if the Edje part is
6422 * configured with "text.min: 0 1".
6424 * @note This mode will make list resize slower as it will have to
6425 * recalculate every item height again whenever the list width
6428 * @note When height-for-width mode is enabled, it also enables
6429 * compress mode (see elm_genlist_compress_mode_set()) and
6430 * disables homogeneous (see elm_genlist_homogeneous_set()).
6432 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6434 EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width);
6437 * Get whether the height-for-width mode is enabled.
6439 * @param obj The genlist object
6440 * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE =
6443 * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS)
6445 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj);
6448 * Activate a genlist mode on an item
6450 * @param it The genlist item
6451 * @param mode_type Mode name
6452 * @param mode_set Boolean to define set or unset mode.
6454 * A genlist mode is a different way of selecting an item. Once a mode is
6455 * activated on an item, any other selected item is immediately unselected.
6456 * This feature provides an easy way of implementing a new kind of animation
6457 * for selecting an item, without having to entirely rewrite the item style
6458 * theme. However, the elm_genlist_selected_* API can't be used to get what
6459 * item is activate for a mode.
6461 * The current item style will still be used, but applying a genlist mode to
6462 * an item will select it using a different kind of animation.
6464 * The current active item for a mode can be found by
6465 * elm_genlist_decorated_item_get().
6467 * The characteristics of genlist mode are:
6468 * - Only one mode can be active at any time, and for only one item.
6469 * - Genlist handles deactivating other items when one item is activated.
6470 * - A mode is defined in the genlist theme (edc), and more modes can easily
6472 * - A mode style and the genlist item style are different things. They
6473 * can be combined to provide a default style to the item, with some kind
6474 * of animation for that item when the mode is activated.
6476 * When a mode is activated on an item, a new view for that item is created.
6477 * The theme of this mode defines the animation that will be used to transit
6478 * the item from the old view to the new view. This second (new) view will be
6479 * active for that item while the mode is active on the item, and will be
6480 * destroyed after the mode is totally deactivated from that item.
6482 * @deprecated elm_genlist_item_decorate_mode_set()
6484 EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set);
6487 * Get the last (or current) genlist mode used.
6489 * @param obj The genlist object
6491 * This function just returns the name of the last used genlist mode. It will
6492 * be the current mode if it's still active.
6494 * @deprecated elm_genlist_item_decorate_mode_get()
6496 EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj);
6499 * Get active genlist mode item
6501 * @param obj The genlist object
6502 * @return The active item for that current mode. Or @c NULL if no item is
6503 * activated with any mode.
6505 * This function returns the item that was activated with a mode, by the
6506 * function elm_genlist_item_decorate_mode_set().
6508 * @deprecated elm_genlist_decorated_item_get()
6510 EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj);
6513 * Set Genlist edit mode
6515 * This sets Genlist edit mode.
6517 * @param obj The Genlist object
6518 * @param The edit mode status
6519 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
6521 * @deprecated elm_genlist_decorate_mode_set
6523 EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode);
6526 * Get Genlist edit mode
6528 * @param obj The genlist object
6529 * @return The edit mode status
6530 * (EINA_TRUE = edit mode, EINA_FALSE = normal mode
6532 * @deprecated elm_genlist_decorate_mode_get()
6534 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj);