update info file
[framework/uifw/elementary.git] / src / lib / elm_removed.h
1 /*
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).
5  *
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.
10  */
11
12 #error "do not include this"
13
14 /**
15  * @brief Get Elementary's rendering engine in use.
16  *
17  * @return The rendering engine's name
18  * @note there's no need to free the returned string, here.
19  *
20  * This gets the global rendering engine that is applied to all Elementary
21  * applications.
22  *
23  * @see elm_engine_set()
24  * @deprecated Use elm_engine_get() instead.
25  */
26 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
27
28 /**
29  * Set the configured finger size for all applications on the display
30  *
31  * This sets the globally configured finger size in pixels for all
32  * applications on the display
33  *
34  * @param size The finger size
35  * @ingroup Fingers
36  * @deprecated Use elm_finger_size_set() and elm_config_all_flush()
37  */
38 EINA_DEPRECATED EAPI void       elm_finger_size_all_set(Evas_Coord size);
39
40 /**
41  * Set the global scaling factor for all applications on the display
42  *
43  * This sets the globally configured scaling factor that is applied to all
44  * objects for all applications.
45  * @param scale The scaling factor to set
46  * @ingroup Scaling
47  * @deprecated use elm_scale_set() and elm_config_all_flush()
48  */
49 EINA_DEPRECATED EAPI void   elm_scale_all_set(double scale);
50
51 /**
52  * Apply the changes made with elm_font_overlay_set() and
53  * elm_font_overlay_unset() on all Elementary application windows.
54  *
55  * @ingroup Fonts
56  *
57  * This applies all font overlays set to all objects in the UI.
58  * @deprecated Use elm_font_overlay_apply and elm_config_all_flush()
59  */
60 EINA_DEPRECATED EAPI void             elm_font_overlay_all_apply(void);
61
62 /**
63  * Set the configured cache flush interval time for all applications on the
64  * display
65  *
66  * This sets the globally configured cache flush interval time -- in ticks
67  * -- for all applications on the display.
68  *
69  * @param size The cache flush interval time
70  * @deprecated Use elm_cache_flush_interval_set() and elm_config_all_flush()
71  * @ingroup Caches
72  */
73 EINA_DEPRECATED EAPI void      elm_cache_flush_interval_all_set(int size);
74
75 /**
76  * Set the configured cache flush enabled state for all applications on the
77  * display
78  *
79  * This sets the globally configured cache flush enabled state for all
80  * applications on the display.
81  *
82  * @param enabled The cache flush enabled state
83  * @deprecated Use elm_cache_flush_enabled_set adnd elm_config_all_flush()
84  * @ingroup Caches
85  */
86 EINA_DEPRECATED EAPI void      elm_cache_flush_enabled_all_set(Eina_Bool enabled);
87
88 /**
89  * Set the configured font cache size for all applications on the
90  * display
91  *
92  * This sets the globally configured font cache size -- in bytes
93  * -- for all applications on the display.
94  *
95  * @param size The font cache size
96  * @deprecated Use elm_font_cache_set() and elm_config_all_flush()
97  * @ingroup Caches
98  */
99 EINA_DEPRECATED EAPI void      elm_font_cache_all_set(int size);
100
101 /**
102  * Set the configured image cache size for all applications on the
103  * display
104  *
105  * This sets the globally configured image cache size -- in bytes
106  * -- for all applications on the display.
107  *
108  * @param size The image cache size
109  * @deprecated Use elm_image_cache_set() and elm_config_all_flush()
110  * @ingroup Caches
111  */
112 EINA_DEPRECATED EAPI void      elm_image_cache_all_set(int size);
113
114 /**
115  * Set the configured edje file cache size for all applications on the
116  * display
117  *
118  * This sets the globally configured edje file cache size -- in number
119  * of files -- for all applications on the display.
120  *
121  * @param size The edje file cache size
122  * @deprecated Use elm_edje_file_cache_set() and elm_config_all_flush()
123  * @ingroup Caches
124  */
125 EINA_DEPRECATED EAPI void      elm_edje_file_cache_all_set(int size);
126
127 /**
128  * Set the configured edje collections (groups) cache size for all
129  * applications on the display
130  *
131  * This sets the globally configured edje collections cache size -- in
132  * number of collections -- for all applications on the display.
133  *
134  * @param size The edje collections cache size
135  * @deprecated Use elm_edje_collection_cache_set() and elm_config_all_flush()
136  * @ingroup Caches
137  */
138 EINA_DEPRECATED EAPI void      elm_edje_collection_cache_all_set(int size);
139
140 /**
141  * Set Elementary's profile.
142  *
143  * This sets the global profile that is applied to all Elementary
144  * applications. All running Elementary windows will be affected.
145  *
146  * @param profile The profile's name
147  * @deprecated Use elm_profile_set() and elm_config_all_flush()
148  * @ingroup Profile
149  *
150  */
151 EINA_DEPRECATED EAPI void        elm_profile_all_set(const char *profile);
152
153 /**
154  * Set whether scrollers should bounce when they reach their
155  * viewport's edge during a scroll, for all Elementary application
156  * windows.
157  *
158  * @param enabled the thumb scroll bouncing state
159  *
160  * @see elm_thumbscroll_bounce_enabled_get()
161  * @deprecated Use elm_scroll_bounce_enabled_set() and elm_config_all_flush()
162  * @ingroup Scrolling
163  */
164 EINA_DEPRECATED EAPI void         elm_scroll_bounce_enabled_all_set(Eina_Bool enabled);
165
166 /**
167  * Set the amount of inertia a scroller will impose at bounce
168  * animations, for all Elementary application windows.
169  *
170  * @param friction the thumb scroll bounce friction
171  *
172  * @see elm_thumbscroll_bounce_friction_get()
173  * @deprecated Use elm_scroll_bounce_friction_set() and elm_config_all_flush()
174  * @ingroup Scrolling
175  */
176 EINA_DEPRECATED EAPI void         elm_scroll_bounce_friction_all_set(double friction);
177
178 /**
179  * Set the amount of inertia a <b>paged</b> scroller will impose at
180  * page fitting animations, for all Elementary application windows.
181  *
182  * @param friction the page scroll friction
183  *
184  * @see elm_thumbscroll_page_scroll_friction_get()
185  * @deprecated Use elm_scroll_page_scroll_friction_set() and 
186  * elm_config_all_flush()
187  * @ingroup Scrolling
188  */
189 EINA_DEPRECATED EAPI void         elm_scroll_page_scroll_friction_all_set(double friction);
190
191 /**
192  * Set the amount of inertia a scroller will impose at region bring
193  * animations, for all Elementary application windows.
194  *
195  * @param friction the bring in scroll friction
196  *
197  * @see elm_thumbscroll_bring_in_scroll_friction_get()
198  * @deprecated Use elm_scroll_bring_in_scroll_friction_set() and
199  * elm_config_all_flush()
200  * @ingroup Scrolling
201  */
202 EINA_DEPRECATED EAPI void         elm_scroll_bring_in_scroll_friction_all_set(double friction);
203
204 /**
205  * Set the amount of inertia scrollers will impose at animations
206  * triggered by Elementary widgets' zooming API, for all Elementary
207  * application windows.
208  *
209  * @param friction the zoom friction
210  *
211  * @see elm_thumbscroll_zoom_friction_get()
212  * @deprecated Use elm_scroll_zoom_friction_set() and elm_config_all_flush()
213  * @ingroup Scrolling
214  */
215 EINA_DEPRECATED EAPI void         elm_scroll_zoom_friction_all_set(double friction);
216
217 /**
218  * Set whether scrollers should be draggable from any point in their
219  * views, for all Elementary application windows.
220  *
221  * @param enabled the thumb scroll state
222  *
223  * @see elm_thumbscroll_enabled_get()
224  * @deprecated Use elm_scroll_thumbscroll_enabled_set()
225  * and elm_config_all_flush()
226  *
227  * @ingroup Scrolling
228  */
229 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_enabled_all_set(Eina_Bool enabled);
230
231 /**
232
233  * Set the number of pixels one should travel while dragging a
234  * scroller's view to actually trigger scrolling, for all Elementary
235  * application windows.
236  *
237  * @param threshold the thumb scroll threshold
238  *
239  * @see elm_thumbscroll_threshold_get()
240  * @deprecated Use elm_scroll_thumbscroll_threshold_set()
241  * and elm_config_all_flush()
242  *
243  * @ingroup Scrolling
244  */
245 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_threshold_all_set(unsigned int threshold);
246
247 /**
248  * Set the minimum speed of mouse cursor movement which will trigger
249  * list self scrolling animation after a mouse up event
250  * (pixels/second), for all Elementary application windows.
251  *
252  * @param threshold the thumb scroll momentum threshold
253  *
254  * @see elm_thumbscroll_momentum_threshold_get()
255  * @deprecated Use elm_scroll_thumbscroll_momentum_threshold_set()
256  * and elm_config_all_flush()
257  *
258  * @ingroup Scrolling
259  */
260 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_momentum_threshold_all_set(double threshold);
261
262 /**
263  * Set the amount of inertia a scroller will impose at self scrolling
264  * animations, for all Elementary application windows.
265  *
266  * @param friction the thumb scroll friction
267  *
268  * @see elm_thumbscroll_friction_get()
269  * @deprecated Use elm_scroll_thumbscroll_friction_set()
270  * and elm_config_all_flush()
271  *
272  * @ingroup Scrolling
273  */
274 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_friction_all_set(double friction);
275
276 /**
277  * Set the amount of lag between your actual mouse cursor dragging
278  * movement and a scroller's view movement itself, while pushing it
279  * into bounce state manually, for all Elementary application windows.
280  *
281  * @param friction the thumb scroll border friction. @c 0.0 for
282  *        perfect synchrony between two movements, @c 1.0 for maximum
283  *        lag.
284  *
285  * @see elm_thumbscroll_border_friction_get()
286  * @note parameter value will get bound to 0.0 - 1.0 interval, always
287  * @deprecated Use elm_scroll_thumbscroll_border_friction_set()
288  * and elm_config_all_flush()
289  *
290  * @ingroup Scrolling
291  */
292 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_border_friction_all_set(double friction);
293
294 /**
295  * Set the sensitivity amount which is be multiplied by the length of
296  * mouse dragging, for all Elementary application windows.
297  *
298  * @param friction the thumb scroll sensitivity friction. @c 0.1 for
299  *        minimum sensitivity, @c 1.0 for maximum sensitivity. 0.25
300  *        is proper.
301  *
302  * @see elm_thumbscroll_sensitivity_friction_get()
303  * @note parameter value will get bound to 0.1 - 1.0 interval, always
304  * @deprecated Use elm_scroll_thumbscroll_sensitivity_friction_set()
305  * and elm_config_all_flush()
306  *
307  * @ingroup Scrolling
308  */
309 EINA_DEPRECATED EAPI void         elm_scroll_thumbscroll_sensitivity_friction_all_set(double friction);
310
311 EINA_DEPRECATED EAPI void          elm_gen_clear(Evas_Object *obj);
312 EINA_DEPRECATED EAPI void          elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
313 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_item_selected_get(const Elm_Gen_Item *it);
314 EINA_DEPRECATED EAPI void          elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
315 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_always_select_mode_get(const Evas_Object *obj);
316 EINA_DEPRECATED EAPI void          elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
317 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_no_select_mode_get(const Evas_Object *obj);
318 EINA_DEPRECATED EAPI void          elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
319 EINA_DEPRECATED EAPI void          elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
320 EINA_DEPRECATED EAPI void          elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
321 EINA_DEPRECATED EAPI void          elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
322
323 EINA_DEPRECATED EAPI void          elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
324 EINA_DEPRECATED EAPI void          elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
325 EINA_DEPRECATED EAPI void          elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
326 EINA_DEPRECATED EAPI void          elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
327 EINA_DEPRECATED EAPI void          elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
328 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
329 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
330 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
331 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
332 EINA_DEPRECATED EAPI Evas_Object  *elm_gen_item_widget_get(const Elm_Gen_Item *it);
333
334 /**
335  * Get the widget object's handle which contains a given item
336  *
337  * @param it The Elementary object item
338  * @return The widget object
339  *
340  * @note This returns the widget object itself that an item belongs to.
341  * @note Every elm_object_item supports this API
342  * @deprecated Use elm_object_item_widget_get() instead
343  * @ingroup General
344  */
345 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_object_get(const Elm_Object_Item *it);
346
347 /**
348  * Set the text to show in the anchorblock
349  *
350  * Sets the text of the anchorblock to @p text. This text can include markup
351  * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
352  * of text that will be specially styled and react to click events, ended
353  * with either of \</a\> or \</\>. When clicked, the anchor will emit an
354  * "anchor,clicked" signal that you can attach a callback to with
355  * evas_object_smart_callback_add(). The name of the anchor given in the
356  * event info struct will be the one set in the href attribute, in this
357  * case, anchorname.
358  *
359  * Other markup can be used to style the text in different ways, but it's
360  * up to the style defined in the theme which tags do what.
361  * @deprecated use elm_object_text_set() instead.
362  */
363 EINA_DEPRECATED EAPI void        elm_anchorblock_text_set(Evas_Object *obj, const char *text);
364
365 /**
366  * Get the markup text set for the anchorblock
367  *
368  * Retrieves the text set on the anchorblock, with markup tags included.
369  *
370  * @param obj The anchorblock object
371  * @return The markup text set or @c NULL if nothing was set or an error
372  * occurred
373  * @deprecated use elm_object_text_set() instead.
374  */
375 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
376
377 /**
378  * Set the text to show in the anchorview
379  *
380  * Sets the text of the anchorview to @p text. This text can include markup
381  * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
382  * text that will be specially styled and react to click events, ended with
383  * either of \</a\> or \</\>. When clicked, the anchor will emit an
384  * "anchor,clicked" signal that you can attach a callback to with
385  * evas_object_smart_callback_add(). The name of the anchor given in the
386  * event info struct will be the one set in the href attribute, in this
387  * case, anchorname.
388  *
389  * Other markup can be used to style the text in different ways, but it's
390  * up to the style defined in the theme which tags do what.
391  * @deprecated use elm_object_text_set() instead.
392  */
393 EINA_DEPRECATED EAPI void        elm_anchorview_text_set(Evas_Object *obj, const char *text);
394
395 /**
396  * Get the markup text set for the anchorview
397  *
398  * Retrieves the text set on the anchorview, with markup tags included.
399  *
400  * @param obj The anchorview object
401  * @return The markup text set or @c NULL if nothing was set or an error
402  * occurred
403  * @deprecated use elm_object_text_set() instead.
404  */
405 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
406
407 /**
408  * @brief Get the ctxpopup item's disabled/enabled state.
409  *
410  * @param it Ctxpopup item to be enabled/disabled
411  * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
412  *
413  * @see elm_ctxpopup_item_disabled_set()
414  * @deprecated use elm_object_item_disabled_get() instead
415  *
416  * @ingroup Ctxpopup
417  */
418 EINA_DEPRECATED EAPI Eina_Bool                    elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
419
420 /**
421  * @brief Set the ctxpopup item's state as disabled or enabled.
422  *
423  * @param it Ctxpopup item to be enabled/disabled
424  * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
425  *
426  * When disabled the item is greyed out to indicate it's state.
427  * @deprecated use elm_object_item_disabled_set() instead
428  *
429  * @ingroup Ctxpopup
430  */
431 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
432
433 /**
434  * @brief Get the icon object for the given ctxpopup item.
435  *
436  * @param it Ctxpopup item
437  * @return icon object or @c NULL, if the item does not have icon or an error
438  * occurred
439  *
440  * @see elm_ctxpopup_item_append()
441  * @see elm_ctxpopup_item_icon_set()
442  *
443  * @deprecated use elm_object_item_part_content_get() instead
444  *
445  * @ingroup Ctxpopup
446  */
447 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
448
449 /**
450  * @brief Sets the side icon associated with the ctxpopup item
451  *
452  * @param it Ctxpopup item
453  * @param icon Icon object to be set
454  *
455  * Once the icon object is set, a previously set one will be deleted.
456  * @warning Setting the same icon for two items will cause the icon to
457  * disappear from the first item.
458  *
459  * @see elm_ctxpopup_item_append()
460  *
461  * @deprecated use elm_object_item_part_content_set() instead
462  *
463  * @ingroup Ctxpopup
464  */
465 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
466
467 /**
468  * @brief Get the label for the given ctxpopup item.
469  *
470  * @param it Ctxpopup item
471  * @return label string or @c NULL, if the item does not have label or an
472  * error occurred
473  *
474  * @see elm_ctxpopup_item_append()
475  * @see elm_ctxpopup_item_label_set()
476  *
477  * @deprecated use elm_object_item_text_get() instead
478  *
479  * @ingroup Ctxpopup
480  */
481 EINA_DEPRECATED EAPI const char  *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
482
483 /**
484  * @brief (Re)set the label on the given ctxpopup item.
485  *
486  * @param it Ctxpopup item
487  * @param label String to set as label
488  *
489  * @deprecated use elm_object_item_text_set() instead
490  *
491  * @ingroup Ctxpopup
492  */
493 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
494
495 /**
496  * @brief Set an elm widget as the content of the ctxpopup.
497  *
498  * @param obj Ctxpopup object
499  * @param content Content to be swallowed
500  *
501  * If the content object is already set, a previous one will be deleted. If
502  * you want to keep that old content object, use the
503  * elm_ctxpopup_content_unset() function.
504  *
505  * @warning Ctxpopup can't hold both a item list and a content at the same
506  * time. When a content is set, any previous items will be removed.
507  *
508  * @deprecated use elm_object_content_set() instead
509  *
510  * @ingroup Ctxpopup
511  */
512 EINA_DEPRECATED EAPI void         elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
513
514 /**
515  * @brief Unset the ctxpopup content
516  *
517  * @param obj Ctxpopup object
518  * @return The content that was being used
519  *
520  * Unparent and return the content object which was set for this widget.
521  *
522  * @deprecated use elm_object_content_unset()
523  *
524  * @see elm_ctxpopup_content_set()
525  *
526  * @deprecated use elm_object_content_unset() instead
527  *
528  * @ingroup Ctxpopup
529  */
530 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
531
532 /**
533  * @brief Delete the given item in a ctxpopup object.
534  *
535  * @param it Ctxpopup item to be deleted
536  *
537  * @deprecated Use elm_object_item_del() instead
538  * @see elm_ctxpopup_item_append()
539  *
540  * @ingroup Ctxpopup
541  */
542 EINA_DEPRECATED EAPI void                         elm_ctxpopup_item_del(Elm_Object_Item *it);
543
544 /**
545  * Set the label for a given file selector button widget
546  *
547  * @param obj The file selector button widget
548  * @param label The text label to be displayed on @p obj
549  *
550  * @deprecated use elm_object_text_set() instead.
551  */
552 EINA_DEPRECATED EAPI void        elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
553
554 /**
555  * Get the label set for a given file selector button widget
556  *
557  * @param obj The file selector button widget
558  * @return The button label
559  *
560  * @deprecated use elm_object_text_set() instead.
561  */
562 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
563
564 /**
565  * Set the icon on a given file selector button widget
566  *
567  * @param obj The file selector button widget
568  * @param icon The icon object for the button
569  *
570  * Once the icon object is set, a previously set one will be
571  * deleted. If you want to keep the latter, use the
572  * elm_fileselector_button_icon_unset() function.
573  *
574  * @deprecated Use elm_object_part_content_set() instead
575  * @see elm_fileselector_button_icon_get()
576  */
577 EINA_DEPRECATED EAPI void                        elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
578
579 /**
580  * Get the icon set for a given file selector button widget
581  *
582  * @param obj The file selector button widget
583  * @return The icon object currently set on @p obj or @c NULL, if
584  * none is
585  *
586  * @deprecated Use elm_object_part_content_get() instead
587  * @see elm_fileselector_button_icon_set()
588  */
589 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_button_icon_get(const Evas_Object *obj);
590
591 /**
592  * Unset the icon used in a given file selector button widget
593  *
594  * @param obj The file selector button widget
595  * @return The icon object that was being used on @p obj or @c
596  * NULL, on errors
597  *
598  * Unparent and return the icon object which was set for this
599  * widget.
600  *
601  * @deprecated Use elm_object_part_content_unset() instead
602  * @see elm_fileselector_button_icon_set()
603  */
604 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_button_icon_unset(Evas_Object *obj);
605
606 /**
607  * Set the label for a given file selector entry widget's button
608  *
609  * @param obj The file selector entry widget
610  * @param label The text label to be displayed on @p obj widget's
611  * button
612  *
613  * @deprecated use elm_object_text_set() instead.
614  */
615 EINA_DEPRECATED EAPI void        elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
616
617 /**
618  * Get the label set for a given file selector entry widget's button
619  *
620  * @param obj The file selector entry widget
621  * @return The widget button's label
622  *
623  * @deprecated use elm_object_text_set() instead.
624  */
625 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
626
627 /**
628  * Set the icon on a given file selector entry widget's button
629  *
630  * @param obj The file selector entry widget
631  * @param icon The icon object for the entry's button
632  *
633  * Once the icon object is set, a previously set one will be
634  * deleted. If you want to keep the latter, use the
635  * elm_fileselector_entry_button_icon_unset() function.
636  *
637  * @deprecated Use elm_object_part_content_set() instead
638  * @see elm_fileselector_entry_button_icon_get()
639  */
640 EINA_DEPRECATED EAPI void                        elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
641
642 /**
643  * Get the icon set for a given file selector entry widget's button
644  *
645  * @param obj The file selector entry widget
646  * @return The icon object currently set on @p obj widget's button
647  * or @c NULL, if none is
648  *
649  * @deprecated Use elm_object_part_content_get() instead
650  * @see elm_fileselector_entry_button_icon_set()
651  */
652 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
653
654 /**
655  * Unset the icon used in a given file selector entry widget's
656  * button
657  *
658  * @param obj The file selector entry widget
659  * @return The icon object that was being used on @p obj widget's
660  * button or @c NULL, on errors
661  *
662  * Unparent and return the icon object which was set for this
663  * widget's button.
664  *
665  * @deprecated Use elm_object_part_content_unset() instead
666  * @see elm_fileselector_entry_button_icon_set()
667  */
668 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
669
670 /**
671  * @brief Sets the content of the hover object and the direction in which it
672  * will pop out.
673  *
674  * @param obj The hover object
675  * @param swallow The direction that the object will be displayed
676  * at. Accepted values are "left", "top-left", "top", "top-right",
677  * "right", "bottom-right", "bottom", "bottom-left", "middle" and
678  * "smart".
679  * @param content The content to place at @p swallow
680  *
681  * Once the content object is set for a given direction, a previously
682  * set one (on the same direction) will be deleted. If you want to
683  * keep that old content object, use the elm_object_part_content_unset()
684  * function.
685  *
686  * All directions may have contents at the same time, except for
687  * "smart". This is a special placement hint and its use case
688  * depends of the calculations coming from
689  * elm_hover_best_content_location_get(). Its use is for cases when
690  * one desires only one hover content, but with a dynamic special
691  * placement within the hover area. The content's geometry, whenever
692  * it changes, will be used to decide on a best location, not
693  * extrapolating the hover's parent object view to show it in (still
694  * being the hover's target determinant of its medium part -- move and
695  * resize it to simulate finger sizes, for example). If one of the
696  * directions other than "smart" are used, a previously content set
697  * using it will be deleted, and vice-versa.
698  *
699  * @deprecated Use elm_object_part_content_set() instead
700  */
701 EINA_DEPRECATED EAPI void         elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
702
703 /**
704  * @brief Get the content of the hover object, in a given direction.
705  *
706  * Return the content object which was set for this widget in the
707  * @p swallow direction.
708  *
709  * @param obj The hover object
710  * @param swallow The direction that the object was display at.
711  * @return The content that was being used
712  *
713  * @deprecated Use elm_object_part_content_get() instead
714  * @see elm_object_part_content_set()
715  */
716 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
717
718 /**
719  * @brief Unset the content of the hover object, in a given direction.
720  *
721  * Unparent and return the content object set at @p swallow direction.
722  *
723  * @param obj The hover object
724  * @param swallow The direction that the object was display at.
725  * @return The content that was being used.
726  *
727  * @deprecated Use elm_object_part_content_unset() instead
728  * @see elm_object_part_content_set()
729  */
730 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
731
732 /**
733  * @brief Set the hoversel button label
734  *
735  * @param obj The hoversel object
736  * @param label The label text.
737  *
738  * This sets the label of the button that is always visible (before it is
739  * clicked and expanded).
740  *
741  * @deprecated elm_object_text_set()
742  */
743 EINA_DEPRECATED EAPI void         elm_hoversel_label_set(Evas_Object *obj, const char *label);
744
745 /**
746  * @brief Get the hoversel button label
747  *
748  * @param obj The hoversel object
749  * @return The label text.
750  *
751  * @deprecated elm_object_text_get()
752  */
753 EINA_DEPRECATED EAPI const char  *elm_hoversel_label_get(const Evas_Object *obj);
754
755 /**
756  * @brief Set the icon of the hoversel button
757  *
758  * @param obj The hoversel object
759  * @param icon The icon object
760  *
761  * Sets the icon of the button that is always visible (before it is clicked
762  * and expanded).  Once the icon object is set, a previously set one will be
763  * deleted, if you want to keep that old content object, use the
764  * elm_hoversel_icon_unset() function.
765  *
766  * @see elm_object_content_set() for the button widget
767  * @deprecated Use elm_object_item_part_content_set() instead
768  */
769 EINA_DEPRECATED EAPI void         elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
770
771 /**
772  * @brief Get the icon of the hoversel button
773  *
774  * @param obj The hoversel object
775  * @return The icon object
776  *
777  * Get the icon of the button that is always visible (before it is clicked
778  * and expanded). Also see elm_object_content_get() for the button widget.
779  *
780  * @see elm_hoversel_icon_set()
781  * @deprecated Use elm_object_item_part_content_get() instead
782  */
783 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
784
785 /**
786  * @brief Get and unparent the icon of the hoversel button
787  *
788  * @param obj The hoversel object
789  * @return The icon object that was being used
790  *
791  * Unparent and return the icon of the button that is always visible
792  * (before it is clicked and expanded).
793  *
794  * @see elm_hoversel_icon_set()
795  * @see elm_object_content_unset() for the button widget
796  * @deprecated Use elm_object_item_part_content_unset() instead
797  */
798 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
799
800 /**
801  * @brief This returns the data pointer supplied with elm_hoversel_item_add()
802  * that will be passed to associated function callbacks.
803  *
804  * @param it The item to get the data from
805  * @return The data pointer set with elm_hoversel_item_add()
806  *
807  * @see elm_hoversel_item_add()
808  * @deprecated Use elm_object_item_data_get() instead
809  */
810 EINA_DEPRECATED EAPI void        *elm_hoversel_item_data_get(const Elm_Object_Item *it);
811
812 /**
813  * @brief This returns the label text of the given hoversel item.
814  *
815  * @param it The item to get the label
816  * @return The label text of the hoversel item
817  *
818  * @see elm_hoversel_item_add()
819  * @deprecated Use elm_object_item_text_get() instead
820  */
821 EINA_DEPRECATED EAPI const char  *elm_hoversel_item_label_get(const Elm_Object_Item *it);
822
823 /**
824  * @brief Set the function to be called when an item from the hoversel is
825  * freed.
826  *
827  * @param it The item to set the callback on
828  * @param func The function called
829  *
830  * That function will receive these parameters:
831  * @li void * item data
832  * @li Evas_Object * hoversel object
833  * @li Elm_Object_Item * hoversel item
834  *
835  * @see elm_hoversel_item_add()
836  * @deprecated Use elm_object_item_del_cb_set() instead
837  */
838 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
839
840 /**
841  * @brief Delete an item from the hoversel
842  *
843  * @param it The item to delete
844  *
845  * This deletes the item from the hoversel (should not be called while the
846  * hoversel is active; use elm_hoversel_expanded_get() to check first).
847  *
848  * @deprecated Use elm_object_item_del() instead
849  * @see elm_hoversel_item_add()
850  */
851 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del(Elm_Object_Item *it);
852
853 /**
854  * Set actionslider labels.
855  *
856  * @param obj The actionslider object
857  * @param left_label The label to be set on the left.
858  * @param center_label The label to be set on the center.
859  * @param right_label The label to be set on the right.
860  * @deprecated use elm_object_text_set() instead.
861  */
862 EINA_DEPRECATED EAPI void        elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
863
864 /**
865  * Get actionslider labels.
866  *
867  * @param obj The actionslider object
868  * @param left_label A char** to place the left_label of @p obj into.
869  * @param center_label A char** to place the center_label of @p obj into.
870  * @param right_label A char** to place the right_label of @p obj into.
871  * @deprecated use elm_object_text_set() instead.
872  */
873 EINA_DEPRECATED EAPI void        elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
874
875 /**
876  * Set the label used on the indicator.
877  *
878  * @param obj The actionslider object
879  * @param label The label to be set on the indicator.
880  * @deprecated use elm_object_text_set() instead.
881  */
882 EINA_DEPRECATED EAPI void        elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
883
884 /**
885  * Get the label used on the indicator object.
886  *
887  * @param obj The actionslider object
888  * @return The indicator label
889  * @deprecated use elm_object_text_get() instead.
890  */
891 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
892
893 /**
894  * Set the overlay object used for the background object.
895  *
896  * @param obj The bg object
897  * @param overlay The overlay object
898  *
899  * This provides a way for elm_bg to have an 'overlay' that will be on top
900  * of the bg. Once the over object is set, a previously set one will be
901  * deleted, even if you set the new one to NULL. If you want to keep that
902  * old content object, use the elm_bg_overlay_unset() function.
903  *
904  * @deprecated use elm_object_part_content_set() instead
905  *
906  * @ingroup Bg
907  */
908
909 EINA_DEPRECATED EAPI void         elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
910
911 /**
912  * Get the overlay object used for the background object.
913  *
914  * @param obj The bg object
915  * @return The content that is being used
916  *
917  * Return the content object which is set for this widget
918  *
919  * @deprecated use elm_object_part_content_get() instead
920  *
921  * @ingroup Bg
922  */
923 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
924
925 /**
926  * Get the overlay object used for the background object.
927  *
928  * @param obj The bg object
929  * @return The content that was being used
930  *
931  * Unparent and return the overlay object which was set for this widget
932  *
933  * @deprecated use elm_object_part_content_unset() instead
934  *
935  * @ingroup Bg
936  */
937 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
938
939
940 /**
941  * Set the label of the bubble
942  *
943  * @param obj The bubble object
944  * @param label The string to set in the label
945  *
946  * This function sets the title of the bubble. Where this appears depends on
947  * the selected corner.
948  * @deprecated use elm_object_text_set() instead.
949  */
950 EINA_DEPRECATED EAPI void         elm_bubble_label_set(Evas_Object *obj, const char *label);
951
952 /**
953  * Get the label of the bubble
954  *
955  * @param obj The bubble object
956  * @return The string of set in the label
957  *
958  * This function gets the title of the bubble.
959  * @deprecated use elm_object_text_get() instead.
960  */
961 EINA_DEPRECATED EAPI const char  *elm_bubble_label_get(const Evas_Object *obj);
962
963 /**
964  * Set the info of the bubble
965  *
966  * @param obj The bubble object
967  * @param info The given info about the bubble
968  *
969  * This function sets the info of the bubble. Where this appears depends on
970  * the selected corner.
971  * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
972  */
973 EINA_DEPRECATED EAPI void         elm_bubble_info_set(Evas_Object *obj, const char *info);
974
975 /**
976  * Get the info of the bubble
977  *
978  * @param obj The bubble object
979  *
980  * @return The "info" string of the bubble
981  *
982  * This function gets the info text.
983  * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
984  */
985 EINA_DEPRECATED EAPI const char  *elm_bubble_info_get(const Evas_Object *obj);
986
987 /**
988  * Set the content to be shown in the bubble
989  *
990  * Once the content object is set, a previously set one will be deleted.
991  * If you want to keep the old content object, use the
992  * elm_bubble_content_unset() function.
993  *
994  * @param obj The bubble object
995  * @param content The given content of the bubble
996  *
997  * This function sets the content shown on the middle of the bubble.
998  *
999  * @deprecated use elm_object_content_set() instead
1000  *
1001  */
1002 EINA_DEPRECATED EAPI void         elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
1003
1004 /**
1005  * Get the content shown in the bubble
1006  *
1007  * Return the content object which is set for this widget.
1008  *
1009  * @param obj The bubble object
1010  * @return The content that is being used
1011  *
1012  * @deprecated use elm_object_content_get() instead
1013  *
1014  */
1015 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
1016
1017 /**
1018  * Unset the content shown in the bubble
1019  *
1020  * Unparent and return the content object which was set for this widget.
1021  *
1022  * @param obj The bubble object
1023  * @return The content that was being used
1024  *
1025  * @deprecated use elm_object_content_unset() instead
1026  *
1027  */
1028 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
1029
1030 /**
1031  * Set the icon of the bubble
1032  *
1033  * Once the icon object is set, a previously set one will be deleted.
1034  * If you want to keep the old content object, use the
1035  * elm_icon_content_unset() function.
1036  *
1037  * @param obj The bubble object
1038  * @param icon The given icon for the bubble
1039  *
1040  * @deprecated use elm_object_part_content_set() instead
1041  *
1042  */
1043 EINA_DEPRECATED EAPI void         elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
1044
1045 /**
1046  * Get the icon of the bubble
1047  *
1048  * @param obj The bubble object
1049  * @return The icon for the bubble
1050  *
1051  * This function gets the icon shown on the top left of bubble.
1052  *
1053  * @deprecated use elm_object_part_content_get() instead
1054  *
1055  */
1056 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
1057
1058 /**
1059  * Unset the icon of the bubble
1060  *
1061  * Unparent and return the icon object which was set for this widget.
1062  *
1063  * @param obj The bubble object
1064  * @return The icon that was being used
1065  *
1066  * @deprecated use elm_object_part_content_unset() instead
1067  *
1068  */
1069 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1070
1071
1072 /**
1073  * Set the label used in the button
1074  *
1075  * The passed @p label can be NULL to clean any existing text in it and
1076  * leave the button as an icon only object.
1077  *
1078  * @param obj The button object
1079  * @param label The text will be written on the button
1080  * @deprecated use elm_object_text_set() instead.
1081  */
1082 EINA_DEPRECATED EAPI void         elm_button_label_set(Evas_Object *obj, const char *label);
1083
1084 /**
1085  * Get the label set for the button
1086  *
1087  * The string returned is an internal pointer and should not be freed or
1088  * altered. It will also become invalid when the button is destroyed.
1089  * The string returned, if not NULL, is a stringshare, so if you need to
1090  * keep it around even after the button is destroyed, you can use
1091  * eina_stringshare_ref().
1092  *
1093  * @param obj The button object
1094  * @return The text set to the label, or NULL if nothing is set
1095  * @deprecated use elm_object_text_set() instead.
1096  */
1097 EINA_DEPRECATED EAPI const char  *elm_button_label_get(const Evas_Object *obj);
1098
1099 /**
1100  * Set the icon used for the button
1101  *
1102  * Setting a new icon will delete any other that was previously set, making
1103  * any reference to them invalid. If you need to maintain the previous
1104  * object alive, unset it first with elm_button_icon_unset().
1105  *
1106  * @param obj The button object
1107  * @param icon The icon object for the button
1108  * @deprecated use elm_object_part_content_set() instead.
1109  */
1110 EINA_DEPRECATED EAPI void         elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1111
1112 /**
1113  * Get the icon used for the button
1114  *
1115  * Return the icon object which is set for this widget. If the button is
1116  * destroyed or another icon is set, the returned object will be deleted
1117  * and any reference to it will be invalid.
1118  *
1119  * @param obj The button object
1120  * @return The icon object that is being used
1121  *
1122  * @deprecated use elm_object_part_content_get() instead
1123  */
1124 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1125
1126 /**
1127  * Remove the icon set without deleting it and return the object
1128  *
1129  * This function drops the reference the button holds of the icon object
1130  * and returns this last object. It is used in case you want to remove any
1131  * icon, or set another one, without deleting the actual object. The button
1132  * will be left without an icon set.
1133  *
1134  * @param obj The button object
1135  * @return The icon object that was being used
1136  * @deprecated use elm_object_part_content_unset() instead.
1137  */
1138 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1139
1140 /**
1141  * Set a day text color to the same that represents Saturdays.
1142  *
1143  * @param obj The calendar object.
1144  * @param pos The text position. Position is the cell counter, from left
1145  * to right, up to down. It starts on 0 and ends on 41.
1146  *
1147  * @deprecated use elm_calendar_mark_add() instead like:
1148  *
1149  * @code
1150  * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1151  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1152  * @endcode
1153  *
1154  * @see elm_calendar_mark_add()
1155  *
1156  * @ingroup Calendar
1157  */
1158 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1159
1160 /**
1161  * Set a day text color to the same that represents Sundays.
1162  *
1163  * @param obj The calendar object.
1164  * @param pos The text position. Position is the cell counter, from left
1165  * to right, up to down. It starts on 0 and ends on 41.
1166
1167  * @deprecated use elm_calendar_mark_add() instead like:
1168  *
1169  * @code
1170  * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1171  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1172  * @endcode
1173  *
1174  * @see elm_calendar_mark_add()
1175  *
1176  * @ingroup Calendar
1177  */
1178 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1179
1180 /**
1181  * Set a day text color to the same that represents Weekdays.
1182  *
1183  * @param obj The calendar object
1184  * @param pos The text position. Position is the cell counter, from left
1185  * to right, up to down. It starts on 0 and ends on 41.
1186  *
1187  * @deprecated use elm_calendar_mark_add() instead like:
1188  *
1189  * @code
1190  * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1191  *
1192  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1193  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1194  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1195  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1196  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1197  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1198  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1199  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1200  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1201  * @endcode
1202  *
1203  * @see elm_calendar_mark_add()
1204  *
1205  * @ingroup Calendar
1206  */
1207 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1208
1209
1210 /**
1211  * @brief Set the text label of the check object
1212  *
1213  * @param obj The check object
1214  * @param label The text label string in UTF-8
1215  *
1216  * @deprecated use elm_object_text_set() instead.
1217  */
1218 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
1219
1220 /**
1221  * @brief Get the text label of the check object
1222  *
1223  * @param obj The check object
1224  * @return The text label string in UTF-8
1225  *
1226  * @deprecated use elm_object_text_get() instead.
1227  */
1228 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
1229
1230 /**
1231  * @brief Set the icon object of the check object
1232  *
1233  * @param obj The check object
1234  * @param icon The icon object
1235  *
1236  * Once the icon object is set, a previously set one will be deleted.
1237  * If you want to keep that old content object, use the
1238  * elm_object_content_unset() function.
1239  *
1240  * @deprecated use elm_object_part_content_set() instead.
1241  *
1242  */
1243 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1244
1245 /**
1246  * @brief Get the icon object of the check object
1247  *
1248  * @param obj The check object
1249  * @return The icon object
1250  *
1251  * @deprecated use elm_object_part_content_get() instead.
1252  *
1253  */
1254 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1255
1256 /**
1257  * @brief Unset the icon used for the check object
1258  *
1259  * @param obj The check object
1260  * @return The icon object that was being used
1261  *
1262  * Unparent and return the icon object which was set for this widget.
1263  *
1264  * @deprecated use elm_object_part_content_unset() instead.
1265  *
1266  */
1267 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1268
1269 /**
1270  * @brief Set the text label of the check object
1271  *
1272  * @param obj The check object
1273  * @param label The text label string in UTF-8
1274  *
1275  * @deprecated use elm_object_text_set() instead.
1276  */
1277 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
1278
1279 /**
1280  * @brief Get the text label of the check object
1281  *
1282  * @param obj The check object
1283  * @return The text label string in UTF-8
1284  *
1285  * @deprecated use elm_object_text_get() instead.
1286  */
1287 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
1288
1289 /**
1290  * @brief Set the icon object of the check object
1291  *
1292  * @param obj The check object
1293  * @param icon The icon object
1294  *
1295  * Once the icon object is set, a previously set one will be deleted.
1296  * If you want to keep that old content object, use the
1297  * elm_object_content_unset() function.
1298  *
1299  * @deprecated use elm_object_part_content_set() instead.
1300  *
1301  */
1302 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1303
1304 /**
1305  * @brief Get the icon object of the check object
1306  *
1307  * @param obj The check object
1308  * @return The icon object
1309  *
1310  * @deprecated use elm_object_part_content_get() instead.
1311  *
1312  */
1313 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1314
1315 /**
1316  * @brief Unset the icon used for the check object
1317  *
1318  * @param obj The check object
1319  * @return The icon object that was being used
1320  *
1321  * Unparent and return the icon object which was set for this widget.
1322  *
1323  * @deprecated use elm_object_part_content_unset() instead.
1324  *
1325  */
1326 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1327
1328 EINA_DEPRECATED EAPI void         elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1329 EINA_DEPRECATED EAPI void         elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1330
1331
1332 /**
1333  * Set the content of the conformant widget.
1334  *
1335  * @param obj The conformant object.
1336  * @param content The content to be displayed by the conformant.
1337  *
1338  * Content will be sized and positioned considering the space required
1339  * to display a virtual keyboard. So it won't fill all the conformant
1340  * size. This way is possible to be sure that content won't resize
1341  * or be re-positioned after the keyboard is displayed.
1342  *
1343  * Once the content object is set, a previously set one will be deleted.
1344  * If you want to keep that old content object, use the
1345  * elm_object_content_unset() function.
1346  *
1347  * @see elm_object_content_unset()
1348  * @see elm_object_content_get()
1349  *
1350  * @deprecated use elm_object_content_set() instead
1351  *
1352  * @ingroup Conformant
1353  */
1354 EINA_DEPRECATED EAPI void         elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1355
1356 /**
1357  * Get the content of the conformant widget.
1358  *
1359  * @param obj The conformant object.
1360  * @return The content that is being used.
1361  *
1362  * Return the content object which is set for this widget.
1363  * It won't be unparent from conformant. For that, use
1364  * elm_object_content_unset().
1365  *
1366  * @see elm_object_content_set().
1367  * @see elm_object_content_unset()
1368  *
1369  * @deprecated use elm_object_content_get() instead
1370  *
1371  * @ingroup Conformant
1372  */
1373 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1374
1375 /**
1376  * Unset the content of the conformant widget.
1377  *
1378  * @param obj The conformant object.
1379  * @return The content that was being used.
1380  *
1381  * Unparent and return the content object which was set for this widget.
1382  *
1383  * @see elm_object_content_set().
1384  *
1385  * @deprecated use elm_object_content_unset() instead
1386  *
1387  * @ingroup Conformant
1388  */
1389 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1390
1391 /**
1392  * Get the side labels max length.
1393  *
1394  * @deprecated use elm_diskselector_side_label_length_get() instead:
1395  *
1396  * @param obj The diskselector object.
1397  * @return The max length defined for side labels, or 0 if not a valid
1398  * diskselector.
1399  *
1400  * @ingroup Diskselector
1401  */
1402 EINA_DEPRECATED EAPI int    elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1403
1404 /**
1405  * Set the side labels max length.
1406  *
1407  * @deprecated use elm_diskselector_side_label_length_set() instead:
1408  *
1409  * @param obj The diskselector object.
1410  * @param len The max length defined for side labels.
1411  *
1412  * @ingroup Diskselector
1413  */
1414 EINA_DEPRECATED EAPI void   elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1415
1416 /**
1417  * Get the data associated to the item.
1418  *
1419  * @param it The diskselector item
1420  * @return The data associated to @p it
1421  *
1422  * The return value is a pointer to data associated to @p item when it was
1423  * created, with function elm_diskselector_item_append(). If no data
1424  * was passed as argument, it will return @c NULL.
1425  *
1426  * @see elm_diskselector_item_append()
1427  * @deprecated Use elm_object_item_data_get()
1428  *
1429  * @ingroup Diskselector
1430  */
1431 EINA_DEPRECATED EAPI void                  *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1432
1433 /**
1434  * Set the icon associated to the item.
1435  *
1436  * @param it The diskselector item
1437  * @param icon The icon object to associate with @p it
1438  *
1439  * The icon object to use at left side of the item. An
1440  * icon can be any Evas object, but usually it is an icon created
1441  * with elm_icon_add().
1442  *
1443  * Once the icon object is set, a previously set one will be deleted.
1444  * @warning Setting the same icon for two items will cause the icon to
1445  * disappear from the first item.
1446  *
1447  * If an icon was passed as argument on item creation, with function
1448  * elm_diskselector_item_append(), it will be already
1449  * associated to the item.
1450  *
1451  * @see elm_diskselector_item_append()
1452  * @see elm_diskselector_item_icon_get()
1453  *
1454  * @deprecated Use elm_object_item_part_content_set() instead
1455  * @ingroup Diskselector
1456  */
1457 EINA_DEPRECATED EAPI void                   elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1458
1459 /**
1460  * Get the icon associated to the item.
1461  *
1462  * @param it The diskselector item
1463  * @return The icon associated to @p it
1464  *
1465  * The return value is a pointer to the icon associated to @p item when it was
1466  * created, with function elm_diskselector_item_append(), or later
1467  * with function elm_diskselector_item_icon_set. If no icon
1468  * was passed as argument, it will return @c NULL.
1469  *
1470  * @see elm_diskselector_item_append()
1471  * @see elm_diskselector_item_icon_set()
1472  *
1473  * @deprecated Use elm_object_item_part_content_set() instead
1474  * @ingroup Diskselector
1475  */
1476 EAPI Evas_Object           *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1477
1478 /**
1479  * Set the label of item.
1480  *
1481  * @param it The item of diskselector.
1482  * @param label The label of item.
1483  *
1484  * The label to be displayed by the item.
1485  *
1486  * If no icon is set, label will be centered on item position, otherwise
1487  * the icon will be placed at left of the label, that will be shifted
1488  * to the right.
1489  *
1490  * An item with label "January" would be displayed on side position as
1491  * "Jan" if max length is set to 3 with function
1492  * elm_diskselector_side_label_length_set(), or "Janu", if this property
1493  * is set to 4.
1494  *
1495  * When this @p item is selected, the entire label will be displayed,
1496  * except for width restrictions.
1497  * In this case label will be cropped and "..." will be concatenated,
1498  * but only for display purposes. It will keep the entire string, so
1499  * if diskselector is resized the remaining characters will be displayed.
1500  *
1501  * If a label was passed as argument on item creation, with function
1502  * elm_diskselector_item_append(), it will be already
1503  * displayed by the item.
1504  *
1505  * @see elm_diskselector_side_label_length_set()
1506  * @see elm_diskselector_item_label_get()
1507  * @see elm_diskselector_item_append()
1508  *
1509  * @deprecated Use elm_object_item_text_set() instead
1510  * @ingroup Diskselector
1511  */
1512 EINA_DEPRECATED EAPI void                   elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1513
1514 /**
1515  * Get the label of item.
1516  *
1517  * @param it The item of diskselector.
1518  * @return The label of item.
1519  *
1520  * The return value is a pointer to the label associated to @p item when it was
1521  * created, with function elm_diskselector_item_append(), or later
1522  * with function elm_diskselector_item_label_set. If no label
1523  * was passed as argument, it will return @c NULL.
1524  *
1525  * @see elm_diskselector_item_label_set() for more details.
1526  * @see elm_diskselector_item_append()
1527  * @deprecated Use elm_object_item_text_get() instead
1528  *
1529  * @ingroup Diskselector
1530  */
1531 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1532
1533 /**
1534  * Set the function called when a diskselector item is freed.
1535  *
1536  * @param it The item to set the callback on
1537  * @param func The function called
1538  *
1539  * If there is a @p func, then it will be called prior item's memory release.
1540  * That will be called with the following arguments:
1541  * @li item's data;
1542  * @li item's Evas object;
1543  * @li item itself;
1544  *
1545  * This way, a data associated to a diskselector item could be properly
1546  * freed.
1547  * @deprecated Use elm_object_item_del_cb_set() instead
1548  *
1549  * @ingroup Diskselector
1550  */
1551 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1552
1553 /**
1554  * Delete them item from the diskselector.
1555  *
1556  * @param it The item of diskselector to be deleted.
1557  *
1558  * If deleting all diskselector items is required, elm_diskselector_clear()
1559  * should be used instead of getting items list and deleting each one.
1560  *
1561  * @deprecated Use elm_object_item_del() instead
1562  * @see elm_diskselector_clear()
1563  * @see elm_diskselector_item_append()
1564  *
1565  * @ingroup Diskselector
1566  */
1567 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del(Elm_Object_Item *it);
1568
1569 /**
1570  * Set the text to be shown in the diskselector item.
1571  *
1572  * @param it Target item
1573  * @param text The text to set in the content
1574  *
1575  * Setup the text as tooltip to object. The item can have only one tooltip,
1576  * so any previous tooltip data is removed.
1577  *
1578  * @deprecated Use elm_object_item_tooltip_text_set() instead
1579  * @see elm_object_tooltip_text_set() for more details.
1580  *
1581  * @ingroup Diskselector
1582  */
1583 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1584
1585 /**
1586  * Set the content to be shown in the tooltip item.
1587  *
1588  * Setup the tooltip to item. The item can have only one tooltip,
1589  * so any previous tooltip data is removed. @p func(with @p data) will
1590  * be called every time that need show the tooltip and it should
1591  * return a valid Evas_Object. This object is then managed fully by
1592  * tooltip system and is deleted when the tooltip is gone.
1593  *
1594  * @param it the diskselector item being attached a tooltip.
1595  * @param func the function used to create the tooltip contents.
1596  * @param data what to provide to @a func as callback data/context.
1597  * @param del_cb called when data is not needed anymore, either when
1598  *        another callback replaces @p func, the tooltip is unset with
1599  *        elm_diskselector_item_tooltip_unset() or the owner @a item
1600  *        dies. This callback receives as the first parameter the
1601  *        given @a data, and @c event_info is the item.
1602  *
1603  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1604  * @see elm_object_tooltip_content_cb_set() for more details.
1605  *
1606  * @ingroup Diskselector
1607  */
1608 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
1609
1610 /**
1611  * Unset tooltip from item.
1612  *
1613  * @param it diskselector item to remove previously set tooltip.
1614  *
1615  * Remove tooltip from item. The callback provided as del_cb to
1616  * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1617  * it is not used anymore.
1618  *
1619  * @deprecated Use elm_object_item_tooltip_unset() instead
1620  * @see elm_object_tooltip_unset() for more details.
1621  * @see elm_diskselector_item_tooltip_content_cb_set()
1622  *
1623  * @ingroup Diskselector
1624  */
1625 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1626
1627 /**
1628  * Sets a different style for this item tooltip.
1629  *
1630  * @note before you set a style you should define a tooltip with
1631  *       elm_diskselector_item_tooltip_content_cb_set() or
1632  *       elm_diskselector_item_tooltip_text_set()
1633  *
1634  * @param it diskselector item with tooltip already set.
1635  * @param style the theme style to use (default, transparent, ...)
1636  *
1637  * @deprecated Use elm_object_item_tooltip_style_set() instead
1638  * @see elm_object_tooltip_style_set() for more details.
1639  *
1640  * @ingroup Diskselector
1641  */
1642 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1643
1644 /**
1645  * Get the style for this item tooltip.
1646  *
1647  * @param it diskselector item with tooltip already set.
1648  * @return style the theme style in use, defaults to "default". If the
1649  *         object does not have a tooltip set, then NULL is returned.
1650  *
1651  * @deprecated Use elm_object_item_tooltip_style_get() instead
1652  * @see elm_object_tooltip_style_get() for more details.
1653  * @see elm_diskselector_item_tooltip_style_set()
1654  *
1655  * @ingroup Diskselector
1656  */
1657 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1658
1659 /**
1660  * Set the cursor to be shown when mouse is over the diskselector item
1661  *
1662  * @param it Target item
1663  * @param cursor the cursor name to be used.
1664  *
1665  * @see elm_object_cursor_set() for more details.
1666  * @deprecated Use elm_object_item_cursor_set() instead
1667  *
1668  * @ingroup Diskselector
1669  */
1670 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1671
1672 /**
1673  * Get the cursor to be shown when mouse is over the diskselector item
1674  *
1675  * @param it diskselector item with cursor already set.
1676  * @return the cursor name.
1677  *
1678  * @see elm_object_cursor_get() for more details.
1679  * @see elm_diskselector_item_cursor_set()
1680  * @deprecated Use elm_object_item_cursor_get() instead
1681  *
1682  * @ingroup Diskselector
1683  */
1684 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1685
1686 /**
1687  * Unset the cursor to be shown when mouse is over the diskselector item
1688  *
1689  * @param it Target item
1690  *
1691  * @see elm_object_cursor_unset() for more details.
1692  * @see elm_diskselector_item_cursor_set()
1693  * @deprecated use elm_object_item_cursor_unset() instead
1694  *
1695  * @ingroup Diskselector
1696  */
1697 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1698
1699 /**
1700  * Sets a different style for this item cursor.
1701  *
1702  * @note before you set a style you should define a cursor with
1703  *       elm_diskselector_item_cursor_set()
1704  *
1705  * @param it diskselector item with cursor already set.
1706  * @param style the theme style to use (default, transparent, ...)
1707  *
1708  * @see elm_object_cursor_style_set() for more details.
1709  * @deprecated Use elm_object_item_cursor_style_set() instead
1710  *
1711  * @ingroup Diskselector
1712  */
1713 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1714
1715 /**
1716  * Get the style for this item cursor.
1717  *
1718  * @param it diskselector item with cursor already set.
1719  * @return style the theme style in use, defaults to "default". If the
1720  *         object does not have a cursor set, then @c NULL is returned.
1721  *
1722  * @see elm_object_cursor_style_get() for more details.
1723  * @see elm_diskselector_item_cursor_style_set()
1724  * @deprecated Use elm_object_item_cursor_style_get() instead
1725  *
1726  * @ingroup Diskselector
1727  */
1728 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1729
1730 /**
1731  * Set if the cursor set should be searched on the theme or should use
1732  * the provided by the engine, only.
1733  *
1734  * @note before you set if should look on theme you should define a cursor
1735  * with elm_diskselector_item_cursor_set().
1736  * By default it will only look for cursors provided by the engine.
1737  *
1738  * @param it widget item with cursor already set.
1739  * @param engine_only boolean to define if cursors set with
1740  * elm_diskselector_item_cursor_set() should be searched only
1741  * between cursors provided by the engine or searched on widget's
1742  * theme as well.
1743  *
1744  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1745  *
1746  * @ingroup Diskselector
1747  */
1748 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1749
1750 /**
1751  * Get the cursor engine only usage for this item cursor.
1752  *
1753  * @param it widget item with cursor already set.
1754  * @return engine_only boolean to define it cursors should be looked only
1755  * between the provided by the engine or searched on widget's theme as well.
1756  * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1757  *
1758  * @see elm_diskselector_item_cursor_engine_only_set()
1759  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1760  *
1761  * @ingroup Diskselector
1762  */
1763 EINA_DEPRECATED EAPI Eina_Bool              elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1764
1765 EINA_DEPRECATED EAPI void         elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1766 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1767
1768 /**
1769  * Get the label of a given flip selector widget's item.
1770  *
1771  * @param it The item to get label from
1772  * @return The text label of @p item or @c NULL, on errors
1773  *
1774  * @see elm_object_item_text_set()
1775  *
1776  * @deprecated see elm_object_item_text_get() instead
1777  * @ingroup Flipselector
1778  */
1779 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1780
1781 /**
1782  * Set the label of a given flip selector widget's item.
1783  *
1784  * @param it The item to set label on
1785  * @param label The text label string, in UTF-8 encoding
1786  *
1787  * @see elm_object_item_text_get()
1788  *
1789  * @deprecated see elm_object_item_text_set() instead
1790  * @ingroup Flipselector
1791  */
1792 EINA_DEPRECATED EAPI void        elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1793
1794 /**
1795  * Delete a given item from a flip selector widget.
1796  *
1797  * @param it The item to delete
1798  *
1799  * @deprecated Use elm_object_item_del() instead
1800  * @ingroup Flipselector
1801  */
1802 EINA_DEPRECATED EAPI void       elm_flipselector_item_del(Elm_Object_Item *it);
1803
1804 /**
1805  * Set the interval on time updates for a user mouse button hold
1806  * on a flip selector widget.
1807  *
1808  * @param obj The flip selector object
1809  * @param interval The (first) interval value in seconds
1810  *
1811  * This interval value is @b decreased while the user holds the
1812  * mouse pointer either flipping up or flipping down a given flip
1813  * selector.
1814  *
1815  * This helps the user to get to a given item distant from the
1816  * current one easier/faster, as it will start to flip quicker and
1817  * quicker on mouse button holds.
1818  *
1819  * The calculation for the next flip interval value, starting from
1820  * the one set with this call, is the previous interval divided by
1821  * 1.05, so it decreases a little bit.
1822  *
1823  * The default starting interval value for automatic flips is
1824  * @b 0.85 seconds.
1825  *
1826  * @see elm_flipselector_interval_get()
1827  * @deprecated Use elm_flipselector_first_interval_set()
1828  *
1829  * @ingroup Flipselector
1830  */
1831 EINA_DEPRECATED EAPI void                        elm_flipselector_interval_set(Evas_Object *obj, double interval);
1832
1833 /**
1834  * Get the interval on time updates for an user mouse button hold
1835  * on a flip selector widget.
1836  *
1837  * @param obj The flip selector object
1838  * @return The (first) interval value, in seconds, set on it
1839  *
1840  * @see elm_flipselector_interval_set() for more details
1841  * @deprecated Use elm_flipselector_first_interval_get()
1842  *
1843  * @ingroup Flipselector
1844  */
1845 EINA_DEPRECATED EAPI double                      elm_flipselector_interval_get(const Evas_Object *obj);
1846
1847 /**
1848  * Make a given Elementary object the focused one.
1849  *
1850  * @param obj The Elementary object to make focused.
1851  *
1852  * @note This object, if it can handle focus, will take the focus
1853  * away from the one who had it previously and will, for now on, be
1854  * the one receiving input events.
1855  *
1856  * @see elm_object_focus_get()
1857  * @deprecated use elm_object_focus_set() instead.
1858  *
1859  * @ingroup Focus
1860  */
1861 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1862
1863 /**
1864  * Give focus to next object in object tree.
1865  *
1866  * Give focus to next object in focus chain of one object sub-tree.
1867  * If the last object of chain already have focus, the focus will go to the
1868  * first object of chain.
1869  *
1870  * @param obj The object root of sub-tree
1871  * @param dir Direction to cycle the focus
1872  *
1873  * @deprecated Use elm_object_focus_next() instead
1874  *
1875  * @ingroup Focus
1876  */
1877 EINA_DEPRECATED EAPI void                 elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
1878
1879 /**
1880  * Remove the focus from an Elementary object
1881  *
1882  * @param obj The Elementary to take focus from
1883  *
1884  * This removes the focus from @p obj, passing it back to the
1885  * previous element in the focus chain list.
1886  *
1887  * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1888  * @deprecated use elm_object_focus_set() instead.
1889  *
1890  * @ingroup Focus
1891  */
1892 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1893
1894 /**
1895  * Give focus to near object in one direction.
1896  *
1897  * Give focus to near object in direction of one object.
1898  * If none focusable object in given direction, the focus will not change.
1899  *
1900  * @param obj The reference object
1901  * @param x Horizontal component of direction to focus
1902  * @param y Vertical component of direction to focus
1903  *
1904  * @deprecated Support it later.
1905  * @ingroup Focus
1906  */
1907 EINA_DEPRECATED EAPI void                 elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1908
1909 /**
1910  * @brief Set the frame label
1911  *
1912  * @param obj The frame object
1913  * @param label The label of this frame object
1914  *
1915  * @deprecated use elm_object_text_set() instead.
1916  */
1917 EINA_DEPRECATED EAPI void         elm_frame_label_set(Evas_Object *obj, const char *label);
1918
1919 /**
1920  * @brief Get the frame label
1921  *
1922  * @param obj The frame object
1923  *
1924  * @return The label of this frame object or NULL if unable to get frame
1925  *
1926  * @deprecated use elm_object_text_get() instead.
1927  */
1928 EINA_DEPRECATED EAPI const char  *elm_frame_label_get(const Evas_Object *obj);
1929
1930 /**
1931  * @brief Set the content of the frame widget
1932  *
1933  * Once the content object is set, a previously set one will be deleted.
1934  * If you want to keep that old content object, use the
1935  * elm_frame_content_unset() function.
1936  *
1937  * @param obj The frame object
1938  * @param content The content will be filled in this frame object
1939  *
1940  * @deprecated use elm_object_content_set() instead.
1941  */
1942 EINA_DEPRECATED EAPI void         elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1943
1944 /**
1945  * @brief Get the content of the frame widget
1946  *
1947  * Return the content object which is set for this widget
1948  *
1949  * @param obj The frame object
1950  * @return The content that is being used
1951  *
1952  * @deprecated use elm_object_content_get() instead.
1953  */
1954 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1955
1956 /**
1957  * @brief Unset the content of the frame widget
1958  *
1959  * Unparent and return the content object which was set for this widget
1960  *
1961  * @param obj The frame object
1962  * @return The content that was being used
1963  *
1964  * @deprecated use elm_object_content_unset() instead.
1965  */
1966 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1967
1968 EINA_DEPRECATED EAPI void          elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1969 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1970 EINA_DEPRECATED EAPI void          elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1971 /**
1972  * This sets the horizontal stretching mode.
1973  *
1974  * @param obj The genlist object
1975  * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1976  *
1977  * This sets the mode used for sizing items horizontally. Valid modes
1978  * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1979  * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1980  * the scroller will scroll horizontally. Otherwise items are expanded
1981  * to fill the width of the viewport of the scroller. If it is
1982  * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1983  * limited to that size.
1984  *
1985  * @see elm_genlist_horizontal_get()
1986  *
1987  * @deprecated use elm_genlist_mode_set()
1988  * @ingroup Genlist
1989  */
1990 EINA_DEPRECATED EAPI void                          elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1991
1992 /**
1993  * Gets the horizontal stretching mode.
1994  *
1995  * @param obj The genlist object
1996  * @return The mode to use
1997  * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1998  *
1999  * @see elm_genlist_horizontal_set()
2000  *
2001  * @deprecated use elm_genlist_mode_get()
2002  * @ingroup Genlist
2003  */
2004 EINA_DEPRECATED EAPI Elm_List_Mode                 elm_genlist_horizontal_get(const Evas_Object *obj);
2005
2006 /**
2007  * Return the data associated to a given genlist item
2008  *
2009  * @param it The genlist item.
2010  * @return the data associated to this item.
2011  *
2012  * This returns the @c data value passed on the
2013  * elm_genlist_item_append() and related item addition calls.
2014  *
2015  * @see elm_genlist_item_append()
2016  * @see elm_genlist_item_data_set()
2017  *
2018  * @deprecated Use elm_object_item_data_get() instead
2019  * @ingroup Genlist
2020  */
2021 EINA_DEPRECATED EAPI void                         *elm_genlist_item_data_get(const Elm_Object_Item *it);
2022
2023 /**
2024  * Set the data associated to a given genlist item
2025  *
2026  * @param it The genlist item
2027  * @param data The new data pointer to set on it
2028  *
2029  * This @b overrides the @c data value passed on the
2030  * elm_genlist_item_append() and related item addition calls. This
2031  * function @b won't call elm_genlist_item_update() automatically,
2032  * so you'd issue it afterwards if you want to hove the item
2033  * updated to reflect the that new data.
2034  *
2035  * @see elm_genlist_item_data_get()
2036  *
2037  * @deprecated Use elm_object_item_data_set() instead
2038  * @ingroup Genlist
2039  */
2040 EINA_DEPRECATED EAPI void                          elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
2041
2042 /**
2043  * Set whether a given genlist item is disabled or not.
2044  *
2045  * @param it The item
2046  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
2047  * to enable it back.
2048  *
2049  * A disabled item cannot be selected or unselected. It will also
2050  * change its appearance, to signal the user it's disabled.
2051  *
2052  * @see elm_genlist_item_disabled_get()
2053  * @deprecated Use elm_object_item_disabled_set() instead
2054  *
2055  * @ingroup Genlist
2056  */
2057 EINA_DEPRECATED EAPI void                          elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2058
2059 /**
2060  * Get whether a given genlist item is disabled or not.
2061  *
2062  * @param it The item
2063  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
2064  * (and on errors).
2065  *
2066  * @see elm_genlist_item_disabled_set() for more details
2067  * @deprecated Use elm_object_item_disabled_get() instead
2068  *
2069  * @ingroup Genlist
2070  */
2071 EINA_DEPRECATED EAPI Eina_Bool                     elm_genlist_item_disabled_get(const Elm_Object_Item *it);
2072
2073 /**
2074  * Remove a genlist item from the its parent, deleting it.
2075  *
2076  * @param it The item to be removed.
2077  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
2078  *
2079  * @see elm_genlist_clear(), to remove all items in a genlist at
2080  * once.
2081  *
2082  * @deprecated Use elm_object_item_del() instead
2083  * @ingroup Genlist
2084  */
2085 EINA_DEPRECATED EAPI void                          elm_genlist_item_del(Elm_Object_Item *it);
2086
2087 /**
2088  * Get the genlist object's handle which contains a given genlist
2089  * item
2090  *
2091  * @param it The item to fetch the container from
2092  * @return The genlist (parent) object
2093  *
2094  * This returns the genlist object itself that an item belongs to.
2095  * @deprecated Use elm_object_item_widget_get() instead
2096  *
2097  * @ingroup Genlist
2098  */
2099 EINA_DEPRECATED EAPI Evas_Object                  *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
2100
2101 /**
2102  * Get the mode item style of items in the genlist
2103  * @param obj The genlist object
2104  * @return The mode item style string, or NULL if none is specified
2105  *
2106  * This is a constant string and simply defines the name of the
2107  * style that will be used for mode animations. It can be
2108  * @c NULL if you don't plan to use Genlist mode. See
2109  * elm_genlist_item_mode_set() for more info.
2110  *
2111  * @ingroup Genlist
2112  */
2113 EINA_DEPRECATED EAPI const char                   *elm_genlist_mode_item_style_get(const Evas_Object *obj);
2114
2115 /**
2116  * Set the mode item style of items in the genlist
2117  * @param obj The genlist object
2118  * @param style The mode item style string, or NULL if none is desired
2119  *
2120  * This is a constant string and simply defines the name of the
2121  * style that will be used for mode animations. It can be
2122  * @c NULL if you don't plan to use Genlist mode. See
2123  * elm_genlist_item_mode_set() for more info.
2124  *
2125  * @ingroup Genlist
2126  */
2127 EINA_DEPRECATED EAPI void                          elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
2128
2129 /**
2130  * Get the Item's Flags
2131  *
2132  * @param it The genlist item
2133  * @return The item type.
2134  *
2135  * This function returns the item's type. Normally the item's type.
2136  * If it failed, return value is ELM_GENLIST_ITEM_MAX
2137  *
2138  * @deprecated Use elm_genlist_item_type_get() instead
2139  * @ingroup Genlist
2140  */
2141 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type        elm_genlist_item_flags_get(const Elm_Object_Item *it);
2142
2143 /**
2144  * Tells genlist to "orphan" contents fetched by the item class
2145  *
2146  * @param it The item
2147  *
2148  * This instructs genlist to release references to contents in the item,
2149  * meaning that they will no longer be managed by genlist and are
2150  * floating "orphans" that can be re-used elsewhere if the user wants
2151  * to.
2152  *
2153  * @deprecated Use elm_genlist_item_all_contents_unset() instead
2154  */
2155 EINA_DEPRECATED EAPI void                          elm_genlist_item_contents_orphan(Elm_Object_Item *it);
2156
2157 #define ELM_IMAGE_ROTATE_90_CW 1
2158 #define ELM_IMAGE_ROTATE_180_CW 2
2159 #define ELM_IMAGE_ROTATE_90_CCW 3
2160
2161 /**
2162  * Return the data associated with a given index widget item
2163  *
2164  * @param item The index widget item handle
2165  * @return The data associated with @p it
2166  * @deprecated Use elm_object_item_data_get() instead
2167  *
2168  * @see elm_index_item_data_set()
2169  *
2170  */
2171 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
2172
2173 /**
2174  * Set the data associated with a given index widget item
2175  *
2176  * @param it The index widget item handle
2177  * @param data The new data pointer to set to @p it
2178  *
2179  * This sets new item data on @p it.
2180  *
2181  * @warning The old data pointer won't be touched by this function, so
2182  * the user had better to free that old data himself/herself.
2183  *
2184  * @deprecated Use elm_object_item_data_set() instead
2185  */
2186 EINA_DEPRECATED EAPI void  elm_index_item_data_set(Elm_Object_Item *it, const void *data);
2187
2188 /**
2189  * Set the function to be called when a given index widget item is freed.
2190  *
2191  * @param it The item to set the callback on
2192  * @param func The function to call on the item's deletion
2193  *
2194  * When called, @p func will have both @c data and @c event_info
2195  * arguments with the @p it item's data value and, naturally, the
2196  * @c obj argument with a handle to the parent index widget.
2197  *
2198  * @deprecated Use elm_object_item_del_cb_set() instead
2199  */
2200 EINA_DEPRECATED EAPI void                  elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2201
2202 /**
2203  * Remove an item from a given index widget, <b>to be referenced by
2204  * it's data value</b>.
2205  *
2206  * @param obj The index object
2207  * @param item The item to be removed from @p obj
2208  *
2209  * If a deletion callback is set, via elm_object_item_del_cb_set(),
2210  * that callback function will be called by this one.
2211  *
2212  * @deprecated Use elm_object_item_del() instead
2213  */
2214 EINA_DEPRECATED EAPI void                  elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2215
2216 /**
2217 * @brief Set the label on the label object
2218  *
2219  * @param obj The label object
2220  * @param label The label will be used on the label object
2221  * @deprecated See elm_object_text_set()
2222  */
2223 EINA_DEPRECATED EAPI void        elm_label_label_set(Evas_Object *obj, const char *label);
2224
2225 /**
2226  * @brief Get the label used on the label object
2227  *
2228  * @param obj The label object
2229  * @return The string inside the label
2230  * @deprecated See elm_object_text_get()
2231  */
2232 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2233
2234
2235 /**
2236  * Set the layout content.
2237  *
2238  * @param obj The layout object
2239  * @param swallow The swallow part name in the edje file
2240  * @param content The child that will be added in this layout object
2241  * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2242  *
2243  * Once the content object is set, a previously set one will be deleted.
2244  * If you want to keep that old content object, use the
2245  * elm_object_part_content_unset() function.
2246  *
2247  * @note In an Edje theme, the part used as a content container is called @c
2248  * SWALLOW. This is why the parameter name is called @p swallow, but it is
2249  * expected to be a part name just like the second parameter of
2250  * elm_layout_box_append().
2251  *
2252  * @see elm_layout_box_append()
2253  * @see elm_object_part_content_get()
2254  * @see elm_object_part_content_unset()
2255  * @see @ref secBox
2256  * @deprecated use elm_object_part_content_set() instead
2257  *
2258  */
2259 EINA_DEPRECATED EAPI Eina_Bool    elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2260
2261 /**
2262  * Get the child object in the given content part.
2263  *
2264  * @param obj The layout object
2265  * @param swallow The SWALLOW part to get its content
2266  *
2267  * @return The swallowed object or NULL if none or an error occurred
2268  *
2269  * @deprecated use elm_object_part_content_get() instead
2270  *
2271  */
2272 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2273
2274 /**
2275  * Unset the layout content.
2276  *
2277  * @param obj The layout object
2278  * @param swallow The swallow part name in the edje file
2279  * @return The content that was being used
2280  *
2281  * Unparent and return the content object which was set for this part.
2282  *
2283  * @deprecated use elm_object_part_content_unset() instead
2284  *
2285  */
2286 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2287
2288 /**
2289  * Set the text of the given part
2290  *
2291  * @param obj The layout object
2292  * @param part The TEXT part where to set the text
2293  * @param text The text to set
2294  * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
2295  *
2296  * @deprecated use elm_object_part_text_set() instead.
2297  */
2298 EINA_DEPRECATED EAPI Eina_Bool    elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2299
2300 /**
2301  * Get the text set in the given part
2302  *
2303  * @param obj The layout object
2304  * @param part The TEXT part to retrieve the text off
2305  *
2306  * @return The text set in @p part
2307  *
2308  * @deprecated use elm_object_part_text_get() instead.
2309  */
2310 EINA_DEPRECATED EAPI const char  *elm_layout_text_get(const Evas_Object *obj, const char *part);
2311
2312 /**
2313  * @def elm_layout_label_set
2314  * Convenience macro to set the label in a layout that follows the
2315  * Elementary naming convention for its parts.
2316  *
2317  * @deprecated use elm_object_text_set() instead.
2318  */
2319 #define elm_layout_label_set(_ly, _txt) \
2320   elm_layout_text_set((_ly), "elm.text", (_txt))
2321
2322 /**
2323  * @def elm_layout_label_get
2324  * Convenience macro to get the label in a layout that follows the
2325  * Elementary naming convention for its parts.
2326  *
2327  * @deprecated use elm_object_text_set() instead.
2328  */
2329 #define elm_layout_label_get(_ly) \
2330   elm_layout_text_get((_ly), "elm.text")
2331
2332 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2333
2334
2335 /**
2336  * Set the content of the mapbuf.
2337  *
2338  * @param obj The mapbuf object.
2339  * @param content The content that will be filled in this mapbuf object.
2340  *
2341  * Once the content object is set, a previously set one will be deleted.
2342  * If you want to keep that old content object, use the
2343  * elm_mapbuf_content_unset() function.
2344  *
2345  * To enable map, elm_mapbuf_enabled_set() should be used.
2346  *
2347  * @deprecated use elm_object_content_set() instead
2348  *
2349  */
2350 EINA_DEPRECATED EAPI void         elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2351
2352 /**
2353  * Get the content of the mapbuf.
2354  *
2355  * @param obj The mapbuf object.
2356  * @return The content that is being used.
2357  *
2358  * Return the content object which is set for this widget.
2359  *
2360  * @see elm_mapbuf_content_set() for details.
2361  *
2362  * @deprecated use elm_object_content_get() instead
2363  *
2364  */
2365 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2366
2367 /**
2368  * Unset the content of the mapbuf.
2369  *
2370  * @param obj The mapbuf object.
2371  * @return The content that was being used.
2372  *
2373  * Unparent and return the content object which was set for this widget.
2374  *
2375  * @see elm_mapbuf_content_set() for details.
2376  *
2377  * @deprecated use elm_object_content_unset() instead
2378  *
2379  */
2380 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2381
2382 /**
2383  * @brief Set the label of a menu item
2384  *
2385  * @param it The menu item object.
2386  * @param label The label to set for @p item
2387  *
2388  * @warning Don't use this function on items created with
2389  * elm_menu_item_add_object() or elm_menu_item_separator_add().
2390  *
2391  * @deprecated Use elm_object_item_text_set() instead
2392  */
2393 EINA_DEPRECATED EAPI void         elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2394
2395 /**
2396  * @brief Get the label of a menu item
2397  *
2398  * @param it The menu item object.
2399  * @return The label of @p item
2400  * @deprecated Use elm_object_item_text_get() instead
2401  */
2402 EINA_DEPRECATED EAPI const char  *elm_menu_item_label_get(const Elm_Object_Item *it);
2403
2404 /**
2405  * @brief Set the content object of a menu item
2406  *
2407  * @param it The menu item object
2408  * @param The content object or NULL
2409  * @return EINA_TRUE on success, else EINA_FALSE
2410  *
2411  * Use this function to change the object swallowed by a menu item, deleting
2412  * any previously swallowed object.
2413  *
2414  * @deprecated Use elm_object_item_content_set() instead
2415  */
2416 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2417
2418 /**
2419  * @brief Get the content object of a menu item
2420  *
2421  * @param it The menu item object
2422  * @return The content object or NULL
2423  * @note If @p item was added with elm_menu_item_add_object, this
2424  * function will return the object passed, else it will return the
2425  * icon object.
2426  *
2427  * @see elm_menu_item_object_content_set()
2428  *
2429  * @deprecated Use elm_object_item_content_get() instead
2430  */
2431 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2432
2433 /**
2434  * @brief Set the disabled state of @p item.
2435  *
2436  * @param it The menu item object.
2437  * @param disabled The enabled/disabled state of the item
2438  * @deprecated Use elm_object_item_disabled_set() instead
2439  */
2440 EINA_DEPRECATED EAPI void         elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2441
2442 /**
2443  * @brief Get the disabled state of @p item.
2444  *
2445  * @param it The menu item object.
2446  * @return The enabled/disabled state of the item
2447  *
2448  * @see elm_menu_item_disabled_set()
2449  * @deprecated Use elm_object_item_disabled_get() instead
2450  */
2451 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_disabled_get(const Elm_Object_Item *it);
2452
2453 /**
2454  * @brief Returns the data associated with menu item @p item.
2455  *
2456  * @param it The item
2457  * @return The data associated with @p item or NULL if none was set.
2458  *
2459  * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2460  *
2461  * @deprecated Use elm_object_item_data_get() instead
2462  */
2463 EINA_DEPRECATED EAPI void        *elm_menu_item_data_get(const Elm_Object_Item *it);
2464
2465 /**
2466  * @brief Set the function called when a menu item is deleted.
2467  *
2468  * @param it The item to set the callback on
2469  * @param func The function called
2470  *
2471  * @see elm_menu_item_add()
2472  * @see elm_menu_item_del()
2473  * @deprecated Use elm_object_item_del_cb_set() instead
2474  */
2475 EINA_DEPRECATED EAPI void                         elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2476
2477 /**
2478  * @brief Sets the data to be associated with menu item @p item.
2479  *
2480  * @param it The item
2481  * @param data The data to be associated with @p item
2482  *
2483  * @deprecated Use elm_object_item_data_set() instead
2484  */
2485 EINA_DEPRECATED EAPI void         elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2486
2487 /**
2488  * @brief Deletes an item from the menu.
2489  *
2490  * @param it The item to delete.
2491  *
2492  * @deprecated Use elm_object_item_del() instead
2493  * @see elm_menu_item_add()
2494  */
2495 EINA_DEPRECATED EAPI void                         elm_menu_item_del(Elm_Object_Item *it);
2496
2497 /**
2498  * @brief @brief Return a menu item's owner menu
2499  *
2500  * @param it The menu item
2501  * @return The menu object owning @p item, or NULL on failure
2502  *
2503  * Use this function to get the menu object owning an item.
2504  * @deprecated Use elm_object_item_widget_get() instead
2505  */
2506 EINA_DEPRECATED EAPI Evas_Object                 *elm_menu_item_menu_get(const Elm_Object_Item *it);
2507
2508 /**
2509  * @brief Set the icon of a menu item to the standard icon with name @p icon
2510  *
2511  * @param it The menu item object.
2512  * @param icon The icon object to set for the content of @p item
2513  *
2514  * @deprecated elm_menu_item_icon_name_set() instead
2515  * Once this icon is set, any previously set icon will be deleted.
2516  */
2517 EINA_DEPRECATED EAPI void                         elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2518
2519 /**
2520  * @brief Get the string representation from the icon of a menu item
2521  *
2522  * @param it The menu item object.
2523  * @return The string representation of @p item's icon or NULL
2524  *
2525  * @deprecated elm_menu_item_icon_name_get() instead
2526  * @see elm_menu_item_icon_name_set()
2527  */
2528 EINA_DEPRECATED EAPI const char                  *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2529
2530 /**
2531  * @brief Set the content of the notify widget
2532  *
2533  * @param obj The notify object
2534  * @param content The content will be filled in this notify object
2535  *
2536  * Once the content object is set, a previously set one will be deleted. If
2537  * you want to keep that old content object, use the
2538  * elm_notify_content_unset() function.
2539  *
2540  * @deprecated use elm_object_content_set() instead
2541  *
2542  */
2543 EINA_DEPRECATED EAPI void         elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2544
2545 /**
2546  * @brief Unset the content of the notify widget
2547  *
2548  * @param obj The notify object
2549  * @return The content that was being used
2550  *
2551  * Unparent and return the content object which was set for this widget
2552  *
2553  * @see elm_notify_content_set()
2554  * @deprecated use elm_object_content_unset() instead
2555  *
2556  */
2557 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2558
2559 /**
2560  * @brief Return the content of the notify widget
2561  *
2562  * @param obj The notify object
2563  * @return The content that is being used
2564  *
2565  * @see elm_notify_content_set()
2566  * @deprecated use elm_object_content_get() instead
2567  *
2568  */
2569 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2570
2571 /**
2572  * Set a label of an object
2573  *
2574  * @param obj The Elementary object
2575  * @param part The text part name to set (NULL for the default label)
2576  * @param label The new text of the label
2577  *
2578  * @note Elementary objects may have many labels (e.g. Action Slider)
2579  * @deprecated Use elm_object_part_text_set() instead.
2580  */
2581 EINA_DEPRECATED EAPI void         elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2582
2583 /**
2584  * Get a label of an object
2585  *
2586  * @param obj The Elementary object
2587  * @param part The text part name to get (NULL for the default label)
2588  * @return text of the label or NULL for any error
2589  *
2590  * @note Elementary objects may have many labels (e.g. Action Slider)
2591  * @deprecated Use elm_object_part_text_get() instead.
2592  */
2593 EINA_DEPRECATED EAPI const char  *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2594
2595 /**
2596  * Set a content of an object
2597  *
2598  * @param obj The Elementary object
2599  * @param part The content part name to set (NULL for the default content)
2600  * @param content The new content of the object
2601  *
2602  * @note Elementary objects may have many contents
2603  * @deprecated Use elm_object_part_content_set instead.
2604  */
2605 EINA_DEPRECATED EAPI void         elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2606
2607 /**
2608  * Get a content of an object
2609  *
2610  * @param obj The Elementary object
2611  * @param part The content part name to get (NULL for the default content)
2612  * @return content of the object or NULL for any error
2613  *
2614  * @note Elementary objects may have many contents
2615  * @deprecated Use elm_object_part_content_get instead.
2616  */
2617 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2618
2619 /**
2620  * Unset a content of an object
2621  *
2622  * @param obj The Elementary object
2623  * @param part The content part name to unset (NULL for the default content)
2624  *
2625  * @note Elementary objects may have many contents
2626  * @deprecated Use elm_object_part_content_unset instead.
2627  */
2628 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2629
2630 /**
2631  * Set a content of an object item
2632  *
2633  * @param it The Elementary object item
2634  * @param part The content part name to set (NULL for the default content)
2635  * @param content The new content of the object item
2636  *
2637  * @note Elementary object items may have many contents
2638  * @deprecated Use elm_object_item_part_content_set instead.
2639  */
2640 EINA_DEPRECATED EAPI void         elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2641
2642 /**
2643  * Get a content of an object item
2644  *
2645  * @param it The Elementary object item
2646  * @param part The content part name to unset (NULL for the default content)
2647  * @return content of the object item or NULL for any error
2648  *
2649  * @note Elementary object items may have many contents
2650  * @deprecated Use elm_object_item_part_content_get instead.
2651  */
2652 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2653
2654 /**
2655  * Unset a content of an object item
2656  *
2657  * @param it The Elementary object item
2658  * @param part The content part name to unset (NULL for the default content)
2659  *
2660  * @note Elementary object items may have many contents
2661  * @deprecated Use elm_object_item_part_content_unset instead.
2662  */
2663 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2664
2665 /**
2666  * Get a label of an object item
2667  *
2668  * @param it The Elementary object item
2669  * @param part The text part name to get (NULL for the default label)
2670  * @return text of the label or NULL for any error
2671  *
2672  * @note Elementary object items may have many labels
2673  * @deprecated Use elm_object_item_part_text_get instead.
2674  */
2675 EINA_DEPRECATED EAPI const char  *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2676
2677 /**
2678  * Set a label of an object item
2679  *
2680  * @param it The Elementary object item
2681  * @param part The text part name to set (NULL for the default label)
2682  * @param label The new text of the label
2683  *
2684  * @note Elementary object items may have many labels
2685  * @deprecated Use elm_object_item_part_text_set instead.
2686  */
2687 EINA_DEPRECATED EAPI void         elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2688
2689 /**
2690  * @brief Set the content of the panel.
2691  *
2692  * @param obj The panel object
2693  * @param content The panel content
2694  *
2695  * Once the content object is set, a previously set one will be deleted.
2696  * If you want to keep that old content object, use the
2697  * elm_panel_content_unset() function.
2698  *
2699  * @deprecated use elm_object_content_set() instead
2700  *
2701  */
2702 EINA_DEPRECATED EAPI void         elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2703
2704 /**
2705  * @brief Get the content of the panel.
2706  *
2707  * @param obj The panel object
2708  * @return The content that is being used
2709  *
2710  * Return the content object which is set for this widget.
2711  *
2712  * @see elm_panel_content_set()
2713  *
2714  * @deprecated use elm_object_content_get() instead
2715  *
2716  */
2717 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2718
2719 /**
2720  * @brief Unset the content of the panel.
2721  *
2722  * @param obj The panel object
2723  * @return The content that was being used
2724  *
2725  * Unparent and return the content object which was set for this widget.
2726  *
2727  * @see elm_panel_content_set()
2728  *
2729  * @deprecated use elm_object_content_unset() instead
2730  *
2731  */
2732 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2733
2734 /**
2735  * Set the left content of the panes widget.
2736  *
2737  * @param obj The panes object.
2738  * @param content The new left content object.
2739  *
2740  * Once the content object is set, a previously set one will be deleted.
2741  * If you want to keep that old content object, use the
2742  * elm_panes_content_left_unset() function.
2743  *
2744  * If panes is displayed vertically, left content will be displayed at
2745  * top.
2746  *
2747  * @see elm_panes_content_left_get()
2748  * @see elm_panes_content_right_set() to set content on the other side.
2749  *
2750  * @deprecated use elm_object_part_content_set() instead
2751  *
2752  */
2753 EINA_DEPRECATED EAPI void         elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2754
2755 /**
2756  * Set the right content of the panes widget.
2757  *
2758  * @param obj The panes object.
2759  * @param content The new right content object.
2760  *
2761  * Once the content object is set, a previously set one will be deleted.
2762  * If you want to keep that old content object, use the
2763  * elm_panes_content_right_unset() function.
2764  *
2765  * If panes is displayed vertically, left content will be displayed at
2766  * bottom.
2767  *
2768  * @see elm_panes_content_right_get()
2769  * @see elm_panes_content_left_set() to set content on the other side.
2770  *
2771  * @deprecated use elm_object_part_content_set() instead
2772  *
2773  */
2774 EINA_DEPRECATED EAPI void         elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2775
2776 /**
2777  * Get the left content of the panes.
2778  *
2779  * @param obj The panes object.
2780  * @return The left content object that is being used.
2781  *
2782  * Return the left content object which is set for this widget.
2783  *
2784  * @see elm_panes_content_left_set() for details.
2785  *
2786  * @deprecated use elm_object_part_content_get() instead
2787  *
2788  */
2789 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2790
2791 /**
2792  * Get the right content of the panes.
2793  *
2794  * @param obj The panes object
2795  * @return The right content object that is being used
2796  *
2797  * Return the right content object which is set for this widget.
2798  *
2799  * @see elm_panes_content_right_set() for details.
2800  *
2801  * @deprecated use elm_object_part_content_get() instead
2802  *
2803  */
2804 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2805
2806 /**
2807  * Unset the left content used for the panes.
2808  *
2809  * @param obj The panes object.
2810  * @return The left content object that was being used.
2811  *
2812  * Unparent and return the left content object which was set for this widget.
2813  *
2814  * @see elm_panes_content_left_set() for details.
2815  * @see elm_panes_content_left_get().
2816  *
2817  * @deprecated use elm_object_part_content_unset() instead
2818  *
2819  */
2820 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2821
2822 /**
2823  * Unset the right content used for the panes.
2824  *
2825  * @param obj The panes object.
2826  * @return The right content object that was being used.
2827  *
2828  * Unparent and return the right content object which was set for this
2829  * widget.
2830  *
2831  * @see elm_panes_content_right_set() for details.
2832  * @see elm_panes_content_right_get().
2833  *
2834  * @deprecated use elm_object_part_content_unset() instead
2835  *
2836  */
2837 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2838 /**
2839  * Set the label of a given progress bar widget
2840  *
2841  * @param obj The progress bar object
2842  * @param label The text label string, in UTF-8
2843  *
2844  * @deprecated use elm_object_text_set() instead.
2845  */
2846 EINA_DEPRECATED EAPI void         elm_progressbar_label_set(Evas_Object *obj, const char *label);
2847
2848 /**
2849  * Get the label of a given progress bar widget
2850  *
2851  * @param obj The progressbar object
2852  * @return The text label string, in UTF-8
2853  *
2854  * @deprecated use elm_object_text_set() instead.
2855  */
2856 EINA_DEPRECATED EAPI const char  *elm_progressbar_label_get(const Evas_Object *obj);
2857
2858 /**
2859  * Set the icon object of a given progress bar widget
2860  *
2861  * @param obj The progress bar object
2862  * @param icon The icon object
2863  *
2864  * Use this call to decorate @p obj with an icon next to it.
2865  *
2866  * @note Once the icon object is set, a previously set one will be
2867  * deleted. If you want to keep that old content object, use the
2868  * elm_progressbar_icon_unset() function.
2869  *
2870  * @see elm_progressbar_icon_get()
2871  * @deprecated use elm_object_part_content_set() instead.
2872  *
2873  */
2874 EINA_DEPRECATED EAPI void         elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2875
2876 /**
2877  * Retrieve the icon object set for a given progress bar widget
2878  *
2879  * @param obj The progress bar object
2880  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2881  * otherwise (and on errors)
2882  *
2883  * @see elm_progressbar_icon_set() for more details
2884  * @deprecated use elm_object_part_content_get() instead.
2885  *
2886  */
2887 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2888
2889 /**
2890  * Unset an icon set on a given progress bar widget
2891  *
2892  * @param obj The progress bar object
2893  * @return The icon object that was being used, if any was set, or
2894  * @c NULL, otherwise (and on errors)
2895  *
2896  * This call will unparent and return the icon object which was set
2897  * for this widget, previously, on success.
2898  *
2899  * @see elm_progressbar_icon_set() for more details
2900  * @deprecated use elm_object_part_content_unset() instead.
2901  *
2902  */
2903 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2904
2905 /**
2906  * @brief Set the text label of the radio object
2907  *
2908  * @param obj The radio object
2909  * @param label The text label string in UTF-8
2910  *
2911  * @deprecated use elm_object_text_set() instead.
2912  */
2913 EINA_DEPRECATED EAPI void         elm_radio_label_set(Evas_Object *obj, const char *label);
2914
2915 /**
2916  * @brief Get the text label of the radio object
2917  *
2918  * @param obj The radio object
2919  * @return The text label string in UTF-8
2920  *
2921  * @deprecated use elm_object_text_set() instead.
2922  */
2923 EINA_DEPRECATED EAPI const char  *elm_radio_label_get(const Evas_Object *obj);
2924
2925 /**
2926  * @brief Set the icon object of the radio object
2927  *
2928  * @param obj The radio object
2929  * @param icon The icon object
2930  *
2931  * Once the icon object is set, a previously set one will be deleted. If you
2932  * want to keep that old content object, use the elm_radio_icon_unset()
2933  * function.
2934  *
2935  * @deprecated use elm_object_part_content_set() instead.
2936  *
2937  */
2938 EINA_DEPRECATED EAPI void         elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2939
2940 /**
2941  * @brief Get the icon object of the radio object
2942  *
2943  * @param obj The radio object
2944  * @return The icon object
2945  *
2946  * @see elm_radio_icon_set()
2947  *
2948  * @deprecated use elm_object_part_content_get() instead.
2949  *
2950  */
2951 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2952
2953 /**
2954  * @brief Unset the icon used for the radio object
2955  *
2956  * @param obj The radio object
2957  * @return The icon object that was being used
2958  *
2959  * Unparent and return the icon object which was set for this widget.
2960  *
2961  * @see elm_radio_icon_set()
2962  * @deprecated use elm_object_part_content_unset() instead.
2963  *
2964  */
2965 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2966
2967 /**
2968  * Set the label of a given slider widget
2969  *
2970  * @param obj The progress bar object
2971  * @param label The text label string, in UTF-8
2972  *
2973  * @deprecated use elm_object_text_set() instead.
2974  */
2975 EINA_DEPRECATED EAPI void         elm_slider_label_set(Evas_Object *obj, const char *label);
2976
2977 /**
2978  * Get the label of a given slider widget
2979  *
2980  * @param obj The progressbar object
2981  * @return The text label string, in UTF-8
2982  *
2983  * @deprecated use elm_object_text_get() instead.
2984  */
2985 EINA_DEPRECATED EAPI const char  *elm_slider_label_get(const Evas_Object *obj);
2986
2987 /**
2988  * Set the icon object of the slider object.
2989  *
2990  * @param obj The slider object.
2991  * @param icon The icon object.
2992  *
2993  * On horizontal mode, icon is placed at left, and on vertical mode,
2994  * placed at top.
2995  *
2996  * @note Once the icon object is set, a previously set one will be deleted.
2997  * If you want to keep that old content object, use the
2998  * elm_slider_icon_unset() function.
2999  *
3000  * @warning If the object being set does not have minimum size hints set,
3001  * it won't get properly displayed.
3002  *
3003  * @deprecated use elm_object_part_content_set() instead.
3004  */
3005 EINA_DEPRECATED EAPI void         elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
3006
3007 /**
3008  * Unset an icon set on a given slider widget.
3009  *
3010  * @param obj The slider object.
3011  * @return The icon object that was being used, if any was set, or
3012  * @c NULL, otherwise (and on errors).
3013  *
3014  * On horizontal mode, icon is placed at left, and on vertical mode,
3015  * placed at top.
3016  *
3017  * This call will unparent and return the icon object which was set
3018  * for this widget, previously, on success.
3019  *
3020  * @see elm_slider_icon_set() for more details
3021  * @see elm_slider_icon_get()
3022  * @deprecated use elm_object_part_content_unset() instead.
3023  *
3024  */
3025 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
3026
3027 /**
3028  * Retrieve the icon object set for a given slider widget.
3029  *
3030  * @param obj The slider object.
3031  * @return The icon object's handle, if @p obj had one set, or @c NULL,
3032  * otherwise (and on errors).
3033  *
3034  * On horizontal mode, icon is placed at left, and on vertical mode,
3035  * placed at top.
3036  *
3037  * @see elm_slider_icon_set() for more details
3038  * @see elm_slider_icon_unset()
3039  *
3040  * @deprecated use elm_object_part_content_get() instead.
3041  *
3042  */
3043 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
3044
3045 /**
3046  * Set the end object of the slider object.
3047  *
3048  * @param obj The slider object.
3049  * @param end The end object.
3050  *
3051  * On horizontal mode, end is placed at left, and on vertical mode,
3052  * placed at bottom.
3053  *
3054  * @note Once the icon object is set, a previously set one will be deleted.
3055  * If you want to keep that old content object, use the
3056  * elm_slider_end_unset() function.
3057  *
3058  * @warning If the object being set does not have minimum size hints set,
3059  * it won't get properly displayed.
3060  *
3061  * @deprecated use elm_object_part_content_set() instead.
3062  *
3063  */
3064 EINA_DEPRECATED EAPI void         elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
3065
3066 /**
3067  * Unset an end object set on a given slider widget.
3068  *
3069  * @param obj The slider object.
3070  * @return The end object that was being used, if any was set, or
3071  * @c NULL, otherwise (and on errors).
3072  *
3073  * On horizontal mode, end is placed at left, and on vertical mode,
3074  * placed at bottom.
3075  *
3076  * This call will unparent and return the icon object which was set
3077  * for this widget, previously, on success.
3078  *
3079  * @see elm_slider_end_set() for more details.
3080  * @see elm_slider_end_get()
3081  *
3082  * @deprecated use elm_object_part_content_unset() instead
3083  * instead.
3084  *
3085  */
3086 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
3087
3088 /**
3089  * Retrieve the end object set for a given slider widget.
3090  *
3091  * @param obj The slider object.
3092  * @return The end object's handle, if @p obj had one set, or @c NULL,
3093  * otherwise (and on errors).
3094  *
3095  * On horizontal mode, icon is placed at right, and on vertical mode,
3096  * placed at bottom.
3097  *
3098  * @see elm_slider_end_set() for more details.
3099  * @see elm_slider_end_unset()
3100  *
3101  *
3102  * @deprecated use elm_object_part_content_get() instead
3103  * instead.
3104  *
3105  */
3106 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
3107
3108 /**
3109  * Return the data associated with a given slideshow item
3110  *
3111  * @param it The slideshow item
3112  * @return Returns the data associated to this item
3113  *
3114  * @deprecated use elm_object_item_data_get() instead
3115  */
3116 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
3117
3118 /**
3119  * Delete a given item from a slideshow widget.
3120  *
3121  * @param it The slideshow item
3122  *
3123  * @deprecated Use elm_object_item_de() instead
3124  */
3125 EINA_DEPRECATED EAPI void                  elm_slideshow_item_del(Elm_Object_Item *it);
3126
3127 /**
3128  * Display a given slideshow widget's item, programmatically.
3129  *
3130  * @param it The item to display on @p obj's viewport
3131  *
3132  * The change between the current item and @p item will use the
3133  * transition @p obj is set to use (@see
3134  * elm_slideshow_transition_set()).
3135  *
3136  * @deprecated use elm_slideshow_item_show() instead
3137  */
3138 EINA_DEPRECATED EAPI void                  elm_slideshow_show(Elm_Object_Item *it);
3139
3140 /**
3141  * Get the toolbar object from an item.
3142  *
3143  * @param it The item.
3144  * @return The toolbar object.
3145  *
3146  * This returns the toolbar object itself that an item belongs to.
3147  *
3148  * @deprecated use elm_object_item_object_get() instead.
3149  */
3150 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
3151
3152 /**
3153  * Get the label of item.
3154  *
3155  * @param it The item of toolbar.
3156  * @return The label of item.
3157  *
3158  * The return value is a pointer to the label associated to @p item when
3159  * it was created, with function elm_toolbar_item_append() or similar,
3160  * or later,
3161  * with function elm_toolbar_item_label_set. If no label
3162  * was passed as argument, it will return @c NULL.
3163  *
3164  * @see elm_toolbar_item_label_set() for more details.
3165  * @see elm_toolbar_item_append()
3166  *
3167  * @deprecated use elm_object_item_text_get() instead.
3168  */
3169 EINA_DEPRECATED EAPI const char  *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3170
3171 /**
3172  * Set the label of item.
3173  *
3174  * @param it The item of toolbar.
3175  * @param label The label of item.
3176  *
3177  * The label to be displayed by the item.
3178  * Label will be placed at icons bottom (if set).
3179  *
3180  * If a label was passed as argument on item creation, with function
3181  * elm_toolbar_item_append() or similar, it will be already
3182  * displayed by the item.
3183  *
3184  * @see elm_toolbar_item_label_get()
3185  * @see elm_toolbar_item_append()
3186  *
3187  * @deprecated use elm_object_item_text_set() instead
3188  */
3189 EINA_DEPRECATED EAPI void         elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3190
3191 /**
3192  * Return the data associated with a given toolbar widget item.
3193  *
3194  * @param it The toolbar widget item handle.
3195  * @return The data associated with @p item.
3196  *
3197  * @see elm_toolbar_item_data_set()
3198  *
3199  * @deprecated use elm_object_item_data_get() instead.
3200  */
3201 EINA_DEPRECATED EAPI void        *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3202
3203 /**
3204  * Set the data associated with a given toolbar widget item.
3205  *
3206  * @param it The toolbar widget item handle
3207  * @param data The new data pointer to set to @p item.
3208  *
3209  * This sets new item data on @p item.
3210  *
3211  * @warning The old data pointer won't be touched by this function, so
3212  * the user had better to free that old data himself/herself.
3213  *
3214  * @deprecated use elm_object_item_data_set() instead.
3215  */
3216 EINA_DEPRECATED EAPI void         elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3217
3218 /**
3219  * Get a value whether toolbar item is disabled or not.
3220  *
3221  * @param it The item.
3222  * @return The disabled state.
3223  *
3224  * @see elm_toolbar_item_disabled_set() for more details.
3225  *
3226  * @deprecated use elm_object_item_disabled_get() instead.
3227  */
3228 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3229
3230 /**
3231  * Sets the disabled/enabled state of a toolbar item.
3232  *
3233  * @param it The item.
3234  * @param disabled The disabled state.
3235  *
3236  * A disabled item cannot be selected or unselected. It will also
3237  * change its appearance (generally greyed out). This sets the
3238  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3239  * enabled).
3240  *
3241  * @deprecated use elm_object_item_disabled_set() instead.
3242  */
3243 EINA_DEPRECATED EAPI void         elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3244
3245 /**
3246  * Change a toolbar's orientation
3247  * @param obj The toolbar object
3248  * @param vertical If @c EINA_TRUE, the toolbar is vertical
3249  * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3250  * @deprecated use elm_toolbar_horizontal_set() instead.
3251  */
3252 EINA_DEPRECATED EAPI void         elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3253
3254 /**
3255  * Get a toolbar's orientation
3256  * @param obj The toolbar object
3257  * @return If @c EINA_TRUE, the toolbar is vertical
3258  * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3259  * @deprecated use elm_toolbar_horizontal_get() instead.
3260  */
3261 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_orientation_get(const Evas_Object *obj);
3262
3263 /**
3264  * Set the function called when a toolbar item is freed.
3265  *
3266  * @param it The item to set the callback on.
3267  * @param func The function called.
3268  *
3269  * If there is a @p func, then it will be called prior item's memory release.
3270  * That will be called with the following arguments:
3271  * @li item's data;
3272  * @li item's Evas object;
3273  * @li item itself;
3274  *
3275  * This way, a data associated to a toolbar item could be properly freed.
3276  *
3277  * @deprecated Use elm_object_item_del_cb_set() instead
3278  */
3279 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3280
3281 /**
3282  * Delete them item from the toolbar.
3283  *
3284  * @param it The item of toolbar to be deleted.
3285  *
3286  * @deprecated Use elm_object_item_del() instead
3287  * @see elm_toolbar_item_append()
3288  *
3289  */
3290 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del(Elm_Object_Item *it);
3291
3292 /**
3293  * Set the content to be shown in the tooltip item.
3294  *
3295  * Setup the tooltip to item. The item can have only one tooltip,
3296  * so any previous tooltip data is removed. @p func(with @p data) will
3297  * be called every time that need show the tooltip and it should
3298  * return a valid Evas_Object. This object is then managed fully by
3299  * tooltip system and is deleted when the tooltip is gone.
3300  *
3301  * @param it the toolbar item being attached a tooltip.
3302  * @param func the function used to create the tooltip contents.
3303  * @param data what to provide to @a func as callback data/context.
3304  * @param del_cb called when data is not needed anymore, either when
3305  *        another callback replaces @a func, the tooltip is unset with
3306  *        elm_toolbar_item_tooltip_unset() or the owner @a item
3307  *        dies. This callback receives as the first parameter the
3308  *        given @a data, and @c event_info is the item.
3309  *
3310  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3311  * @see elm_object_tooltip_content_cb_set() for more details.
3312  *
3313  */
3314 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
3315
3316 /**
3317  * Unset tooltip from item.
3318  *
3319  * @param it toolbar item to remove previously set tooltip.
3320  *
3321  * Remove tooltip from item. The callback provided as del_cb to
3322  * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3323  * it is not used anymore.
3324  *
3325  * @deprecated Use elm_object_item_tooltip_unset() instead
3326  * @see elm_object_tooltip_unset() for more details.
3327  * @see elm_toolbar_item_tooltip_content_cb_set()
3328  *
3329  */
3330 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3331
3332 /**
3333  * Sets a different style for this item tooltip.
3334  *
3335  * @note before you set a style you should define a tooltip with
3336  *       elm_toolbar_item_tooltip_content_cb_set() or
3337  *       elm_toolbar_item_tooltip_text_set()
3338  *
3339  * @param it toolbar item with tooltip already set.
3340  * @param style the theme style to use (default, transparent, ...)
3341  *
3342  * @deprecated Use elm_object_item_tooltip_style_set() instead
3343  * @see elm_object_tooltip_style_set() for more details.
3344  *
3345  */
3346 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3347
3348 /**
3349  * Get the style for this item tooltip.
3350  *
3351  * @param it toolbar item with tooltip already set.
3352  * @return style the theme style in use, defaults to "default". If the
3353  *         object does not have a tooltip set, then NULL is returned.
3354  *
3355  * @deprecated Use elm_object_item_style_get() instead
3356  * @see elm_object_tooltip_style_get() for more details.
3357  * @see elm_toolbar_item_tooltip_style_set()
3358  *
3359  */
3360 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3361
3362 /**
3363  * Set the type of mouse pointer/cursor decoration to be shown,
3364  * when the mouse pointer is over the given toolbar widget item
3365  *
3366  * @param it toolbar item to customize cursor on
3367  * @param cursor the cursor type's name
3368  *
3369  * This function works analogously as elm_object_cursor_set(), but
3370  * here the cursor's changing area is restricted to the item's
3371  * area, and not the whole widget's. Note that that item cursors
3372  * have precedence over widget cursors, so that a mouse over an
3373  * item with custom cursor set will always show @b that cursor.
3374  *
3375  * If this function is called twice for an object, a previously set
3376  * cursor will be unset on the second call.
3377  *
3378  * @see elm_object_cursor_set()
3379  * @see elm_toolbar_item_cursor_get()
3380  * @see elm_toolbar_item_cursor_unset()
3381  *
3382  * @deprecated use elm_object_item_cursor_set() instead
3383  *
3384  */
3385 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3386
3387 /*
3388  * Get the type of mouse pointer/cursor decoration set to be shown,
3389  * when the mouse pointer is over the given toolbar widget item
3390  *
3391  * @param it toolbar item with custom cursor set
3392  * @return the cursor type's name or @c NULL, if no custom cursors
3393  * were set to @p item (and on errors)
3394  *
3395  * @see elm_object_cursor_get()
3396  * @see elm_toolbar_item_cursor_set()
3397  * @see elm_toolbar_item_cursor_unset()
3398  *
3399  * @deprecated Use elm_object_item_cursor_get() instead
3400  *
3401  */
3402 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3403
3404 /**
3405  * Unset any custom mouse pointer/cursor decoration set to be
3406  * shown, when the mouse pointer is over the given toolbar widget
3407  * item, thus making it show the @b default cursor again.
3408  *
3409  * @param it a toolbar item
3410  *
3411  * Use this call to undo any custom settings on this item's cursor
3412  * decoration, bringing it back to defaults (no custom style set).
3413  *
3414  * @see elm_object_cursor_unset()
3415  * @see elm_toolbar_item_cursor_set()
3416  *
3417  * @deprecated Use elm_object_item_cursor_unset() instead
3418  *
3419  */
3420 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3421
3422 /**
3423  * Set a different @b style for a given custom cursor set for a
3424  * toolbar item.
3425  *
3426  * @param it toolbar item with custom cursor set
3427  * @param style the <b>theme style</b> to use (e.g. @c "default",
3428  * @c "transparent", etc)
3429  *
3430  * This function only makes sense when one is using custom mouse
3431  * cursor decorations <b>defined in a theme file</b>, which can have,
3432  * given a cursor name/type, <b>alternate styles</b> on it. It
3433  * works analogously as elm_object_cursor_style_set(), but here
3434  * applies only to toolbar item objects.
3435  *
3436  * @warning Before you set a cursor style you should have defined a
3437  *       custom cursor previously on the item, with
3438  *       elm_toolbar_item_cursor_set()
3439  *
3440  * @see elm_toolbar_item_cursor_engine_only_set()
3441  * @see elm_toolbar_item_cursor_style_get()
3442  *
3443  * @deprecated Use elm_object_item_cursor_style_set() instead
3444  *
3445  */
3446 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3447
3448 /**
3449  * Get the current @b style set for a given toolbar item's custom
3450  * cursor
3451  *
3452  * @param it toolbar item with custom cursor set.
3453  * @return style the cursor style in use. If the object does not
3454  *         have a cursor set, then @c NULL is returned.
3455  *
3456  * @see elm_toolbar_item_cursor_style_set() for more details
3457  *
3458  * @deprecated Use elm_object_item_cursor_style_get() instead
3459  *
3460  */
3461 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3462
3463 /**
3464  * Set if the (custom)cursor for a given toolbar item should be
3465  * searched in its theme, also, or should only rely on the
3466  * rendering engine.
3467  *
3468  * @param it item with custom (custom) cursor already set on
3469  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3470  * only on those provided by the rendering engine, @c EINA_FALSE to
3471  * have them searched on the widget's theme, as well.
3472  *
3473  * @note This call is of use only if you've set a custom cursor
3474  * for toolbar items, with elm_toolbar_item_cursor_set().
3475  *
3476  * @note By default, cursors will only be looked for between those
3477  * provided by the rendering engine.
3478  *
3479  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3480  *
3481  */
3482 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3483
3484 /**
3485  * Get if the (custom) cursor for a given toolbar item is being
3486  * searched in its theme, also, or is only relying on the rendering
3487  * engine.
3488  *
3489  * @param it a toolbar item
3490  * @return @c EINA_TRUE, if cursors are being looked for only on
3491  * those provided by the rendering engine, @c EINA_FALSE if they
3492  * are being searched on the widget's theme, as well.
3493  *
3494  * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3495  *
3496  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3497  *
3498  */
3499 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3500
3501 /**
3502  * @brief Link a Elm_Payer with an Elm_Video object.
3503  *
3504  * @param player the Elm_Player object.
3505  * @param video The Elm_Video object.
3506  *
3507  * This mean that action on the player widget will affect the
3508  * video object and the state of the video will be reflected in
3509  * the player itself.
3510  *
3511  * @see elm_player_add()
3512  * @see elm_video_add()
3513  * @deprecated use elm_object_part_content_set() instead
3514  *
3515  */
3516 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3517
3518 /**
3519  * Set the label of item.
3520  *
3521  * @param it The item of segment control.
3522  * @param label The label of item.
3523  *
3524  * The label to be displayed by the item.
3525  * Label will be at right of the icon (if set).
3526  *
3527  * If a label was passed as argument on item creation, with function
3528  * elm_control_segment_item_add(), it will be already
3529  * displayed by the item.
3530  *
3531  * @see elm_segment_control_item_label_get()
3532  * @see elm_segment_control_item_add()
3533  * @deprecated Use elm_object_item_text_set() instead
3534  *
3535  */
3536 EINA_DEPRECATED EAPI void              elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3537
3538
3539 /**
3540  * Set the icon associated to the item.
3541  *
3542  * @param it The segment control item.
3543  * @param icon The icon object to associate with @p it.
3544  *
3545  * The icon object to use at left side of the item. An
3546  * icon can be any Evas object, but usually it is an icon created
3547  * with elm_icon_add().
3548  *
3549  * Once the icon object is set, a previously set one will be deleted.
3550  * @warning Setting the same icon for two items will cause the icon to
3551  * disappear from the first item.
3552  *
3553  * If an icon was passed as argument on item creation, with function
3554  * elm_segment_control_item_add(), it will be already
3555  * associated to the item.
3556  *
3557  * @see elm_segment_control_item_add()
3558  * @see elm_segment_control_item_icon_get()
3559  * @deprecated Use elm_object_item_part_content_set() instead
3560  *
3561  */
3562 EINA_DEPRECATED EAPI void              elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3563
3564 /**
3565  * Remove a segment control item from its parent, deleting it.
3566  *
3567  * @param it The item to be removed.
3568  *
3569  * Items can be added with elm_segment_control_item_add() or
3570  * elm_segment_control_item_insert_at().
3571  *
3572  * @deprecated Use elm_object_item_del() instead
3573  */
3574 EINA_DEPRECATED EAPI void              elm_segment_control_item_del(Elm_Object_Item *it);
3575
3576 /**
3577  * Get the label
3578  *
3579  * @param obj The multibuttonentry object
3580  * @return The label, or NULL if none
3581  *
3582  * @deprecated Use elm_object_text_get() instead
3583  *
3584  */
3585 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_label_get(const Evas_Object *obj);
3586
3587 /**
3588  * Set the label
3589  *
3590  * @param obj The multibuttonentry object
3591  * @param label The text label string
3592  *
3593  * @deprecated Use elm_object_text_set() instead
3594  *
3595  */
3596 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3597
3598 /**
3599  * Get the label of a given item
3600  *
3601  * @param it The item
3602  * @return The label of a given item, or NULL if none
3603  *
3604  * @deprecated Use elm_object_item_text_get() instead
3605  *
3606  */
3607 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3608
3609 /**
3610  * Set the label of a given item
3611  *
3612  * @param it The item
3613  * @param str The text label string
3614  *
3615  * @deprecated Use elm_object_item_text_set() instead
3616  */
3617 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3618
3619 /**
3620  * Delete a given item
3621  *
3622  * @param it The item
3623  *
3624  * @deprecated Use elm_object_item_del() instead
3625  *
3626  */
3627 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_del(Elm_Object_Item *it);
3628
3629 /**
3630  * @brief Delete the given item instantly.
3631  *
3632  * @param it The naviframe item
3633  *
3634  * This just deletes the given item from the naviframe item list instantly.
3635  * So this would not emit any signals for view transitions but just change
3636  * the current view if the given item is a top one.
3637  *
3638  * @deprecated Use elm_object_item_del() instead
3639  */
3640 EINA_DEPRECATED EAPI void             elm_naviframe_item_del(Elm_Object_Item *it);
3641
3642
3643
3644 /**
3645  * Sets the disabled/enabled state of a list item.
3646  *
3647  * @param it The item.
3648  * @param disabled The disabled state.
3649  *
3650  * A disabled item cannot be selected or unselected. It will also
3651  * change its appearance (generally greyed out). This sets the
3652  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3653  * enabled).
3654  *
3655  * @deprecated Use elm_object_item_disabled_set() instead
3656  *
3657  */
3658 EINA_DEPRECATED EAPI void                         elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3659
3660 /**
3661  * Get a value whether list item is disabled or not.
3662  *
3663  * @param it The item.
3664  * @return The disabled state.
3665  *
3666  * @see elm_list_item_disabled_set() for more details.
3667  *
3668  * @deprecated Use elm_object_item_disabled_get() instead
3669  *
3670  */
3671 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_disabled_get(const Elm_Object_Item *it);
3672
3673 /**
3674  * @brief Disable size restrictions on an object's tooltip
3675  * @param it The tooltip's anchor object
3676  * @param disable If EINA_TRUE, size restrictions are disabled
3677  * @return EINA_FALSE on failure, EINA_TRUE on success
3678  *
3679  * This function allows a tooltip to expand beyond its parent window's canvas.
3680  * It will instead be limited only by the size of the display.
3681  *
3682  * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3683  *
3684  */
3685 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3686
3687 /**
3688  * @brief Retrieve size restriction state of an object's tooltip
3689  * @param obj The tooltip's anchor object
3690  * @return If EINA_TRUE, size restrictions are disabled
3691  *
3692  * This function returns whether a tooltip is allowed to expand beyond
3693  * its parent window's canvas.
3694  * It will instead be limited only by the size of the display.
3695  *
3696  * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3697  *
3698  */
3699 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3700
3701 /**
3702  * This sets a widget to be displayed to the left of a scrolled entry.
3703  *
3704  * @param obj The scrolled entry object
3705  * @param icon The widget to display on the left side of the scrolled
3706  * entry.
3707  *
3708  * @note A previously set widget will be destroyed.
3709  * @note If the object being set does not have minimum size hints set,
3710  * it won't get properly displayed.
3711  *
3712  * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
3713  * @see elm_entry_end_set()
3714  */
3715 EINA_DEPRECATED EAPI void               elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
3716
3717 /**
3718  * Gets the leftmost widget of the scrolled entry. This object is
3719  * owned by the scrolled entry and should not be modified.
3720  *
3721  * @param obj The scrolled entry object
3722  * @return the left widget inside the scroller
3723  *
3724  * @deprecated Use elm_object_part_content_get(entry, "icon") instead
3725  */
3726 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_get(const Evas_Object *obj);
3727
3728 /**
3729  * Unset the leftmost widget of the scrolled entry, unparenting and
3730  * returning it.
3731  *
3732  * @param obj The scrolled entry object
3733  * @return the previously set icon sub-object of this entry, on
3734  * success.
3735  *
3736  * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
3737  * @see elm_entry_icon_set()
3738  */
3739 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_unset(Evas_Object *obj);
3740
3741 /**
3742  * This sets a widget to be displayed to the end of a scrolled entry.
3743  *
3744  * @param obj The scrolled entry object
3745  * @param end The widget to display on the right side of the scrolled
3746  * entry.
3747  *
3748  * @note A previously set widget will be destroyed.
3749  * @note If the object being set does not have minimum size hints set,
3750  * it won't get properly displayed.
3751  *
3752  * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
3753  * @see elm_entry_icon_set
3754  */
3755 EINA_DEPRECATED EAPI void               elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
3756
3757 /**
3758  * Gets the endmost widget of the scrolled entry. This object is owned
3759  * by the scrolled entry and should not be modified.
3760  *
3761  * @param obj The scrolled entry object
3762  * @return the right widget inside the scroller
3763  *
3764  * @deprecated Use elm_object_part_content_get(entry, "end") instead
3765  */
3766 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_end_get(const Evas_Object *obj);
3767
3768 /**
3769  * Unset the endmost widget of the scrolled entry, unparenting and
3770  * returning it.
3771  *
3772  * @param obj The scrolled entry object
3773  * @return the previously set icon sub-object of this entry, on
3774  * success.
3775  *
3776  * @deprecated Use elm_object_part_content_unset(entry, "end") instead
3777  * @see elm_entry_icon_set()
3778  */
3779 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_end_unset(Evas_Object *obj);
3780
3781 /**
3782  * Set route service to be used. By default used source is
3783  * #ELM_MAP_ROUTE_SOURCE_YOURS.
3784  *
3785  * @see elm_map_route_source_set()
3786  * @see elm_map_route_source_get()
3787  *
3788  */
3789 typedef enum
3790 {
3791    ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
3792    ELM_MAP_ROUTE_SOURCE_MONAV, /**< MoNav offers exact routing without heuristic assumptions. Its routing core is based on Contraction Hierarchies. It's not working with Map yet. */
3793    ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
3794    ELM_MAP_ROUTE_SOURCE_LAST
3795 } Elm_Map_Route_Sources;
3796
3797 /**
3798  * Convert a pixel coordinate into a rotated pixel coordinate.
3799  *
3800  * @param obj The map object.
3801  * @param x horizontal coordinate of the point to rotate.
3802  * @param y vertical coordinate of the point to rotate.
3803  * @param cx rotation's center horizontal position.
3804  * @param cy rotation's center vertical position.
3805  * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
3806  * @param xx Pointer where to store rotated x.
3807  * @param yy Pointer where to store rotated y.
3808  *
3809  * @deprecated Use elm_map_canvas_to_geo_convert() instead
3810  */
3811 EINA_DEPRECATED EAPI void                  elm_map_utils_rotate_coord(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, const Evas_Coord cx, const Evas_Coord cy, const double degree, Evas_Coord *xx, Evas_Coord *yy);
3812
3813 /**
3814  * Convert canvas coordinates into a geographic coordinate
3815  * (longitude, latitude).
3816  *
3817  * @param obj The map object.
3818  * @param x   horizontal coordinate of the point to convert.
3819  * @param y   vertical coordinate of the point to convert.
3820  * @param lon A pointer to the longitude.
3821  * @param lat A pointer to the latitude.
3822  *
3823  * This gets longitude and latitude from canvas x, y coordinates. The canvas
3824  * coordinates mean x, y coordinate from current viewport.
3825  *
3826  * see elm_map_rotate_get()
3827  * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
3828  *
3829  */
3830 EINA_DEPRECATED EAPI void                  elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat);
3831
3832 /**
3833  * Get the current geographic coordinates of the map.
3834  *
3835  * @param obj The map object.
3836  * @param lon Pointer to store longitude.
3837  * @param lat Pointer to store latitude.
3838  *
3839  * This gets the current center coordinates of the map object. It can be
3840  * set by elm_map_region_bring_in() and elm_map_region_show().
3841  *
3842  * @see elm_map_region_bring_in()
3843  * @see elm_map_region_show()
3844  *
3845  * @deprecated Use elm_map_region_get() instead
3846  */
3847 EINA_DEPRECATED EAPI void                  elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
3848
3849 /**
3850  * Animatedly bring in given coordinates to the center of the map.
3851  *
3852  * @param obj The map object.
3853  * @param lon Longitude to center at.
3854  * @param lat Latitude to center at.
3855  *
3856  * This causes map to jump to the given @p lat and @p lon coordinates
3857  * and show it (by scrolling) in the center of the viewport, if it is not
3858  * already centered. This will use animation to do so and take a period
3859  * of time to complete.
3860  *
3861  * @see elm_map_region_show() for a function to avoid animation.
3862  * @see elm_map_region_get()
3863  *
3864  * @deprecated Use elm_map_region_bring_in() instead
3865  */
3866 EINA_DEPRECATED EAPI void                  elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
3867
3868 /**
3869  * Show the given coordinates at the center of the map, @b immediately.
3870  *
3871  * @param obj The map object.
3872  * @param lon Longitude to center at.
3873  * @param lat Latitude to center at.
3874  *
3875  * This causes map to @b redraw its viewport's contents to the
3876  * region containing the given @p lat and @p lon, that will be moved to the
3877  * center of the map.
3878  *
3879  * @see elm_map_region_bring_in() for a function to move with animation.
3880  * @see elm_map_region_get()
3881  *
3882  * @deprecated Use elm_map_region_show() instead
3883  */
3884 EINA_DEPRECATED EAPI void                  elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
3885
3886 /**
3887  * Set the minimum zoom of the source.
3888  *
3889  * @param obj The map object.
3890  * @param zoom New minimum zoom value to be used.
3891  *
3892  * By default, it's 0.
3893  *
3894  * @deprecated Use elm_map_zoom_min_set() instead
3895  */
3896 EINA_DEPRECATED EAPI void                  elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
3897
3898 /**
3899  * Get the minimum zoom of the source.
3900  *
3901  * @param obj The map object.
3902  * @return Returns the minimum zoom of the source.
3903  *
3904  * @see elm_map_zoom_min_set() for details.
3905  *
3906  * @deprecated Use elm_map_zoom_min_get() instead
3907  */
3908 EINA_DEPRECATED EAPI int                   elm_map_source_zoom_min_get(const Evas_Object *obj);
3909
3910 /**
3911  * Set the maximum zoom of the source.
3912  *
3913  * @param obj The map object.
3914  * @param zoom New maximum zoom value to be used.
3915  *
3916  * By default, it's 18.
3917  *
3918  * @deprecated Use elm_map_zoom_max_set() instead
3919  */
3920 EINA_DEPRECATED EAPI void                  elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
3921
3922 /**
3923  * Get the maximum zoom of the source.
3924  *
3925  * @param obj The map object.
3926  * @return Returns the maximum zoom of the source.
3927  *
3928  * @see elm_map_zoom_min_set() for details.
3929  *
3930  * @deprecated Use elm_map_zoom_max_get() instead
3931  */
3932 EINA_DEPRECATED EAPI int                   elm_map_source_zoom_max_get(const Evas_Object *obj);
3933
3934
3935 /**
3936  * Get the list of available sources.
3937  *
3938  * @param obj The map object.
3939  * @return The source names list.
3940  *
3941  * It will provide a list with all available sources, that can be set as
3942  * current source with elm_map_source_name_set(), or get with
3943  * elm_map_source_name_get().
3944  *
3945  * Available sources:
3946  * @li "Mapnik"
3947  * @li "Osmarender"
3948  * @li "CycleMap"
3949  * @li "Maplint"
3950  *
3951  * @see elm_map_source_name_set() for more details.
3952  * @see elm_map_source_name_get()
3953  * @deprecated Use elm_map_sources_get() instead
3954  *
3955  */
3956 EINA_DEPRECATED EAPI const char          **elm_map_source_names_get(const Evas_Object *obj);
3957
3958 /**
3959  * Set the source of the map.
3960  *
3961  * @param obj The map object.
3962  * @param source_name The source to be used.
3963  *
3964  * Map widget retrieves images that composes the map from a web service.
3965  * This web service can be set with this method.
3966  *
3967  * A different service can return a different maps with different
3968  * information and it can use different zoom values.
3969  *
3970  * The @p source_name need to match one of the names provided by
3971  * elm_map_source_names_get().
3972  *
3973  * The current source can be get using elm_map_source_name_get().
3974  *
3975  * @see elm_map_source_names_get()
3976  * @see elm_map_source_name_get()
3977  * @deprecated Use elm_map_source_set() instead
3978  *
3979  */
3980 EINA_DEPRECATED EAPI void                  elm_map_source_name_set(Evas_Object *obj, const char *source_name);
3981
3982 /**
3983  * Get the name of currently used source.
3984  *
3985  * @param obj The map object.
3986  * @return Returns the name of the source in use.
3987  *
3988  * @see elm_map_source_name_set() for more details.
3989  * @deprecated Use elm_map_source_get() instead
3990  *
3991  */
3992 EINA_DEPRECATED EAPI const char           *elm_map_source_name_get(const Evas_Object *obj);
3993
3994 /**
3995  * Set the source of the route service to be used by the map.
3996  *
3997  * @param obj The map object.
3998  * @param source The route service to be used, being it one of
3999  * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4000  * and #ELM_MAP_ROUTE_SOURCE_ORS.
4001  *
4002  * Each one has its own algorithm, so the route retrieved may
4003  * differ depending on the source route. Now, only the default is working.
4004  *
4005  * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4006  * http://www.yournavigation.org/.
4007  *
4008  * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4009  * assumptions. Its routing core is based on Contraction Hierarchies.
4010  *
4011  * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4012  *
4013  * @see elm_map_route_source_get().
4014  * @deprecated Use elm_map_source_set() instead
4015  *
4016  */
4017 EINA_DEPRECATED EAPI void                  elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4018
4019 /**
4020  * Get the current route source.
4021  *
4022  * @param obj The map object.
4023  * @return The source of the route service used by the map.
4024  *
4025  * @see elm_map_route_source_set() for details.
4026  * @deprecated Use elm_map_source_get() instead
4027  *
4028  */
4029 EINA_DEPRECATED EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4030
4031 /**
4032  * Set the maximum numbers of markers' content to be displayed in a group.
4033  *
4034  * @param obj The map object.
4035  * @param max The maximum numbers of items displayed in a bubble.
4036  *
4037  * A bubble will be displayed when the user clicks over the group,
4038  * and will place the content of markers that belong to this group
4039  * inside it.
4040  *
4041  * A group can have a long list of markers, consequently the creation
4042  * of the content of the bubble can be very slow.
4043  *
4044  * In order to avoid this, a maximum number of items is displayed
4045  * in a bubble.
4046  *
4047  * By default this number is 30.
4048  *
4049  * Marker with the same group class are grouped if they are close.
4050  *
4051  * @see elm_map_marker_add()
4052  *
4053  * @deprecated Use Elm_Map_Overlay instead
4054  */
4055 EINA_DEPRECATED EAPI void                  elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4056
4057 /**
4058  * Set to show markers during zoom level changes or not.
4059  *
4060  * @param obj The map object.
4061  * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4062  * to show them.
4063  *
4064  * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4065  * for map.
4066  *
4067  * The default is off.
4068  *
4069  * This will stop zooming using animation, changing zoom levels will
4070  * change instantly. This will stop any existing animations that are running.
4071  *
4072  * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4073  * for the markers.
4074  *
4075  * The default  is off.
4076  *
4077  * Enabling it will force the map to stop displaying the markers during
4078  * zoom level changes. Set to on if you have a large number of markers.
4079  *
4080  * @see elm_map_paused_markers_get()
4081  *
4082  * @deprecated Use Elm_Map_Overlay instead
4083  */
4084 EINA_DEPRECATED EAPI void                  elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4085
4086 /**
4087  * Get a value whether markers will be displayed on zoom level changes or not
4088  *
4089  * @param obj The map object.
4090  * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4091  * indicates it will.
4092  *
4093  * This gets the current markers paused state for the map object.
4094  *
4095  * @see elm_map_paused_markers_set() for details.
4096  *
4097  * @deprecated Use Elm_Map_Overlay instead
4098  */
4099 EINA_DEPRECATED EAPI Eina_Bool             elm_map_paused_markers_get(const Evas_Object *obj);
4100
4101 /**
4102  * Close all the bubbles opened by the user.
4103  *
4104  * @param obj The map object.
4105  *
4106  * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4107  * when the user clicks on a marker.
4108  *
4109  * This functions is set for the marker class with
4110  * elm_map_marker_class_get_cb_set().
4111  *
4112  * @deprecated Use Elm_Map_Overlay instead
4113  */
4114 EINA_DEPRECATED EAPI void                  elm_map_bubbles_close(Evas_Object *obj);
4115
4116 /**
4117  * Set the marker's style of a group class.
4118  *
4119  * @param clas The group class.
4120  * @param style The style to be used by markers.
4121  *
4122  * Each marker must be associated to a group class, and will use the style
4123  * defined by such class when grouped to other markers.
4124  *
4125  * The following styles are provided by default theme:
4126  * @li @c radio - blue circle
4127  * @li @c radio2 - green circle
4128  * @li @c empty
4129  *
4130  * @see elm_map_group_class_new() for more details.
4131  * @see elm_map_marker_add()
4132  *
4133  * @deprecated Use Elm_Map_Overlay instead
4134  */
4135 EINA_DEPRECATED EAPI void                  elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4136
4137 /**
4138  * Set the icon callback function of a group class.
4139  *
4140  * @param clas The group class.
4141  * @param icon_get The callback function that will return the icon.
4142  *
4143  * Each marker must be associated to a group class, and it can display a
4144  * custom icon. The function @p icon_get must return this icon.
4145  *
4146  * @see elm_map_group_class_new() for more details.
4147  * @see elm_map_marker_add()
4148  *
4149  * @deprecated Use Elm_Map_Overlay instead
4150  */
4151 EINA_DEPRECATED EAPI void                  elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4152
4153 /**
4154  * Set the data associated to the group class.
4155  *
4156  * @param clas The group class.
4157  * @param data The new user data.
4158  *
4159  * This data will be passed for callback functions, like icon get callback,
4160  * that can be set with elm_map_group_class_icon_cb_set().
4161  *
4162  * If a data was previously set, the object will lose the pointer for it,
4163  * so if needs to be freed, you must do it yourself.
4164  *
4165  * @see elm_map_group_class_new() for more details.
4166  * @see elm_map_group_class_icon_cb_set()
4167  * @see elm_map_marker_add()
4168  *
4169  * @deprecated Use Elm_Map_Overlay instead
4170  */
4171 EINA_DEPRECATED EAPI void                  elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4172
4173 /**
4174  * Set the minimum zoom from where the markers are displayed.
4175  *
4176  * @param clas The group class.
4177  * @param zoom The minimum zoom.
4178  *
4179  * Markers only will be displayed when the map is displayed at @p zoom
4180  * or bigger.
4181  *
4182  * @see elm_map_group_class_new() for more details.
4183  * @see elm_map_marker_add()
4184  *
4185  * @deprecated Use Elm_Map_Overlay instead
4186  */
4187 EINA_DEPRECATED EAPI void                  elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4188
4189 /**
4190  * Set the zoom from where the markers are no more grouped.
4191  *
4192  * @param clas The group class.
4193  * @param zoom The maximum zoom.
4194  *
4195  * Markers only will be grouped when the map is displayed at
4196  * less than @p zoom.
4197  *
4198  * @see elm_map_group_class_new() for more details.
4199  * @see elm_map_marker_add()
4200  *
4201  * @deprecated Use Elm_Map_Overlay instead
4202  */
4203 EINA_DEPRECATED EAPI void                  elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4204
4205 /**
4206  * Set if the markers associated to the group class @p clas are hidden or not.
4207  *
4208  * @param clas The group class.
4209  * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4210  * to show them.
4211  *
4212  * @param obj The map object.
4213  * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4214  * is to show them.
4215  *
4216  * @deprecated Use Elm_Map_Overlay instead
4217  */
4218 EINA_DEPRECATED EAPI void                  elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4219
4220 /**
4221  * Set the marker's style of a marker class.
4222  *
4223  * @param clas The marker class.
4224  * @param style The style to be used by markers.
4225  *
4226  * Each marker must be associated to a marker class, and will use the style
4227  * defined by such class when alone, i.e., @b not grouped to other markers.
4228  *
4229  * The following styles are provided by default theme:
4230  * @li @c radio
4231  * @li @c radio2
4232  * @li @c empty
4233  *
4234  * @see elm_map_marker_class_new() for more details.
4235  * @see elm_map_marker_add()
4236  *
4237  * @deprecated Use Elm_Map_Overlay instead
4238  */
4239 EINA_DEPRECATED EAPI void                  elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4240
4241 /**
4242  * Set the icon callback function of a marker class.
4243  *
4244  * @param clas The marker class.
4245  * @param icon_get The callback function that will return the icon.
4246  *
4247  * Each marker must be associated to a marker class, and it can display a
4248  * custom icon. The function @p icon_get must return this icon.
4249  *
4250  * @see elm_map_marker_class_new() for more details.
4251  * @see elm_map_marker_add()
4252  *
4253  * @deprecated Use Elm_Map_Overlay instead
4254  */
4255 EINA_DEPRECATED EAPI void                  elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4256
4257 /**
4258  * Set the bubble content callback function of a marker class.
4259  *
4260  * @param clas The marker class.
4261  * @param get The callback function that will return the content.
4262  *
4263  * Each marker must be associated to a marker class, and it can display a
4264  * a content on a bubble that opens when the user click over the marker.
4265  * The function @p get must return this content object.
4266  *
4267  * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4268  * can be used.
4269  *
4270  * @see elm_map_marker_class_new() for more details.
4271  * @see elm_map_marker_class_del_cb_set()
4272  * @see elm_map_marker_add()
4273  *
4274  * @deprecated Use Elm_Map_Overlay instead
4275  */
4276 EINA_DEPRECATED EAPI void                  elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4277
4278 /**
4279  * Set the callback function used to delete bubble content of a marker class.
4280  *
4281  * @param clas The marker class.
4282  * @param del The callback function that will delete the content.
4283  *
4284  * Each marker must be associated to a marker class, and it can display a
4285  * a content on a bubble that opens when the user click over the marker.
4286  * The function to return such content can be set with
4287  * elm_map_marker_class_get_cb_set().
4288  *
4289  * If this content must be freed, a callback function need to be
4290  * set for that task with this function.
4291  *
4292  * If this callback is defined it will have to delete (or not) the
4293  * object inside, but if the callback is not defined the object will be
4294  * destroyed with evas_object_del().
4295  *
4296  * @see elm_map_marker_class_new() for more details.
4297  * @see elm_map_marker_class_get_cb_set()
4298  * @see elm_map_marker_add()
4299  *
4300  * @deprecated Use Elm_Map_Overlay instead
4301  */
4302 EINA_DEPRECATED EAPI void                  elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4303
4304 /**
4305  * Set the route color.
4306  *
4307  * @param route The route object.
4308  * @param r Red channel value, from 0 to 255.
4309  * @param g Green channel value, from 0 to 255.
4310  * @param b Blue channel value, from 0 to 255.
4311  * @param a Alpha channel value, from 0 to 255.
4312  *
4313  * It uses an additive color model, so each color channel represents
4314  * how much of each primary colors must to be used. 0 represents
4315  * absence of this color, so if all of the three are set to 0,
4316  * the color will be black.
4317  *
4318  * These component values should be integers in the range 0 to 255,
4319  * (single 8-bit byte).
4320  *
4321  * This sets the color used for the route. By default, it is set to
4322  * solid red (r = 255, g = 0, b = 0, a = 255).
4323  *
4324  * For alpha channel, 0 represents completely transparent, and 255, opaque.
4325  *
4326  * @see elm_map_route_color_get()
4327  * @deprecated Use elm_map_overlay_color_set() instead
4328  *
4329  */
4330 EINA_DEPRECATED EAPI void                  elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4331
4332 /**
4333  * Get the route color.
4334  *
4335  * @param route The route object.
4336  * @param r Pointer to store the red channel value.
4337  * @param g Pointer to store the green channel value.
4338  * @param b Pointer to store the blue channel value.
4339  * @param a Pointer to store the alpha channel value.
4340  *
4341  * @see elm_map_route_color_set() for details.
4342  * @deprecated Use elm_map_overlay_color_get() instead
4343  *
4344  */
4345 EINA_DEPRECATED EAPI void                  elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4346
4347 /**
4348  * Remove a name from the map.
4349  *
4350  * @param name The name to remove.
4351  *
4352  * Basically the struct handled by @p name will be freed, so conversions
4353  * between address and coordinates will be lost.
4354  *
4355  * @see elm_map_utils_convert_name_into_coord()
4356  * @see elm_map_utils_convert_coord_into_name()
4357  * @deprecated Use elm_map_name_del() instead
4358  *
4359  */
4360 EINA_DEPRECATED EAPI void                  elm_map_name_remove(Elm_Map_Name *name);
4361
4362 /**
4363  * Get the gengrid object's handle which contains a given gengrid item
4364  *
4365  * @param it The item to fetch the container from
4366  * @return The gengrid (parent) object
4367  *
4368  * This returns the gengrid object itself that an item belongs to.
4369  *
4370  * @deprecated Use elm_object_item_widget_get() instead
4371  */
4372 EINA_DEPRECATED EAPI Evas_Object                  *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4373
4374 /**
4375  * Return the data associated to a given gengrid item
4376  *
4377  * @param it The gengrid item.
4378  * @return the data associated with this item.
4379  *
4380  * This returns the @c data value passed on the
4381  * elm_gengrid_item_append() and related item addition calls.
4382  *
4383  * @see elm_gengrid_item_append()
4384  * @see elm_gengrid_item_data_set()
4385  * @deprecated Use elm_object_item_data_get() instead
4386  */
4387 EINA_DEPRECATED EAPI void                         *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4388
4389 /**
4390  * Set the data associated with a given gengrid item
4391  *
4392  * @param it The gengrid item
4393  * @param data The data pointer to set on it
4394  *
4395  * This @b overrides the @c data value passed on the
4396  * elm_gengrid_item_append() and related item addition calls. This
4397  * function @b won't call elm_gengrid_item_update() automatically,
4398  * so you'd issue it afterwards if you want to have the item
4399  * updated to reflect the new data.
4400  *
4401  * @see elm_gengrid_item_data_get()
4402  * @see elm_gengrid_item_update()
4403  * @deprecated Use elm_object_item_data_set() instead
4404  *
4405  */
4406 EINA_DEPRECATED EAPI void                          elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4407
4408 /**
4409  * Set whether a given gengrid item is disabled or not.
4410  *
4411  * @param it The gengrid item
4412  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4413  * to enable it back.
4414  *
4415  * A disabled item cannot be selected or unselected. It will also
4416  * change its appearance, to signal the user it's disabled.
4417  *
4418  * @see elm_gengrid_item_disabled_get()
4419  * @deprecated Use elm_object_item_disabled_set() instead
4420  *
4421  */
4422 EINA_DEPRECATED EAPI void                          elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4423
4424 /**
4425  * Get whether a given gengrid item is disabled or not.
4426  *
4427  * @param it The gengrid item
4428  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4429  * (and on errors).
4430  *
4431  * @see elm_gengrid_item_disabled_set() for more details
4432  * @deprecated Use elm_object_item_disabled_get() instead
4433  *
4434  */
4435 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4436
4437 /**
4438  * Remove a gengrid item from its parent, deleting it.
4439  *
4440  * @param it The item to be removed.
4441  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4442  *
4443  * @see elm_gengrid_clear(), to remove all items in a gengrid at
4444  * once.
4445  * @deprecated use elm_object_item_de() instead
4446  *
4447  */
4448 EINA_DEPRECATED EAPI void                          elm_gengrid_item_del(Elm_Object_Item *it);
4449
4450 /**
4451  * Update the item class of a gengrid item.
4452  *
4453  * This sets another class of the item, changing the way that it is
4454  * displayed. After changing the item class, elm_gengrid_item_update() is
4455  * called on the item @p it.
4456  *
4457  * @param it The gengrid item
4458  * @param gic The gengrid item class describing the function pointers and the item style.
4459  *
4460  * @deprecated Use elm_gengrid_item_item_class_update instead
4461  */
4462 EINA_DEPRECATED EAPI void                          elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
4463
4464 /**
4465  * Insert an item in a gengrid widget using a user-defined sort function.
4466  *
4467  * @param obj The gengrid object.
4468  * @param gic The item class for the item.
4469  * @param data The item data.
4470  * @param comp User defined comparison function that defines the sort order
4471  *             based on Elm_Gen_Item.
4472  * @param func Convenience function called when the item is selected.
4473  * @param func_data Data to be passed to @p func.
4474  * @return A handle to the item added or @c NULL, on errors.
4475  *
4476  * This inserts an item in the gengrid based on user defined comparison function.
4477  *
4478  * @see elm_gengrid_item_append()
4479  * @see elm_gengrid_item_prepend()
4480  * @see elm_gengrid_item_insert_after()
4481  * @see elm_object_item_del()
4482  * @see elm_gengrid_item_sorted_insert()
4483  *
4484  * @deprecated Use elm_gengrid_item_sorted_insert() instead
4485  */
4486 EINA_DEPRECATED EAPI Elm_Object_Item             *elm_gengrid_item_direct_sorted_insert(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Eina_Compare_Cb comp, Evas_Smart_Cb func, const void *func_data);
4487
4488 /**
4489  * Append a filter function for text inserted in the entry
4490  *
4491  * Append the given callback to the list. This functions will be called
4492  * whenever any text is inserted into the entry, with the text to be inserted
4493  * as a parameter. The callback function is free to alter the text in any way
4494  * it wants, but it must remember to free the given pointer and update it.
4495  * If the new text is to be discarded, the function can free it and set its
4496  * text parameter to NULL. This will also prevent any following filters from
4497  * being called.
4498  *
4499  * @param obj The entry object
4500  * @param func The function to use as text filter
4501  * @param data User data to pass to @p func
4502  * @deprecated use elm_entry_markup_filter_append() instead
4503  */
4504 EINA_DEPRECATED EAPI void               elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4505
4506 /**
4507  * Prepend a filter function for text inserted in the entry
4508  *
4509  * Prepend the given callback to the list. See elm_entry_text_filter_append()
4510  * for more information
4511  *
4512  * @param obj The entry object
4513  * @param func The function to use as text filter
4514  * @param data User data to pass to @p func
4515  * @deprecated use elm_entry_markup_filter_prepend() instead
4516  */
4517 EINA_DEPRECATED EAPI void               elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4518
4519 /**
4520  * Remove a filter from the list
4521  *
4522  * Removes the given callback from the filter list. See
4523  * elm_entry_text_filter_append() for more information.
4524  *
4525  * @param obj The entry object
4526  * @param func The filter function to remove
4527  * @param data The user data passed when adding the function
4528  * @deprecated use elm_entry_markup_filter_remove() instead
4529  */
4530 EINA_DEPRECATED EAPI void               elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4531
4532 /**
4533  * @brief Set the front content of the flip widget.
4534  *
4535  * @param obj The flip object
4536  * @param content The new front content object
4537  *
4538  * Once the content object is set, a previously set one will be deleted.
4539  * If you want to keep that old content object, use the
4540  * elm_flip_content_front_unset() function.
4541  *
4542  * @deprecated Use elm_object_part_content_set(flip, "front") instead
4543  */
4544 EINA_DEPRECATED EAPI void                 elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
4545
4546 /**
4547  * @brief Set the back content of the flip widget.
4548  *
4549  * @param obj The flip object
4550  * @param content The new back content object
4551  *
4552  * Once the content object is set, a previously set one will be deleted.
4553  * If you want to keep that old content object, use the
4554  * elm_flip_content_back_unset() function.
4555  *
4556  * @deprecated Use elm_object_part_content_set(flip, "back") instead
4557  */
4558 EINA_DEPRECATED EAPI void                 elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
4559
4560 /**
4561  * @brief Get the front content used for the flip
4562  *
4563  * @param obj The flip object
4564  * @return The front content object that is being used
4565  *
4566  * Return the front content object which is set for this widget.
4567  *
4568  * @deprecated Use elm_object_part_content_get(flip, "front") instead
4569  */
4570 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_get(const Evas_Object *obj);
4571
4572 /**
4573  * @brief Get the back content used for the flip
4574  *
4575  * @param obj The flip object
4576  * @return The back content object that is being used
4577  *
4578  * Return the back content object which is set for this widget.
4579  *
4580  * @deprecated Use elm_object_part_content_get(flip, "back") instead
4581  */
4582 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_get(const Evas_Object *obj);
4583
4584 /**
4585  * @brief Unset the front content used for the flip
4586  *
4587  * @param obj The flip object
4588  * @return The front content object that was being used
4589  *
4590  * Unparent and return the front content object which was set for this widget.
4591  *
4592  * @deprecated Use elm_object_part_content_unset(flip, "front") instead
4593  */
4594 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_unset(Evas_Object *obj);
4595
4596 /**
4597  * @brief Unset the back content used for the flip
4598  *
4599  * @param obj The flip object
4600  * @return The back content object that was being used
4601  *
4602  * Unparent and return the back content object which was set for this widget.
4603  *
4604  * @deprecated Use elm_object_part_content_unset(flip, "back") instead
4605  */
4606 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_unset(Evas_Object *obj);
4607
4608 /**
4609  * @brief Get flip front visibility state
4610  *
4611  * @param obj The flip object
4612  * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
4613  * showing.
4614  *
4615  * @deprecated Use elm_flip_front_visible_get() instead
4616  */
4617 EINA_DEPRECATED EAPI Eina_Bool            elm_flip_front_get(const Evas_Object *obj);
4618
4619 /**
4620  * @brief Set the font size on the label object.
4621  *
4622  * @param obj The label object
4623  * @param size font size
4624  *
4625  * @warning NEVER use this. It is for hyper-special cases only. use styles
4626  * instead. e.g. "default", "marker", "slide_long" etc.
4627  * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
4628  */
4629 EINA_DEPRECATED EAPI void                        elm_label_fontsize_set(Evas_Object *obj, int fontsize);
4630
4631 /**
4632  * @brief Set the text color on the label object
4633  *
4634  * @param obj The label object
4635  * @param r Red property background color of The label object
4636  * @param g Green property background color of The label object
4637  * @param b Blue property background color of The label object
4638  * @param a Alpha property background color of The label object
4639  *
4640  * @warning NEVER use this. It is for hyper-special cases only. use styles
4641  * instead. e.g. "default", "marker", "slide_long" etc.
4642  * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
4643  */
4644 EINA_DEPRECATED EAPI void                        elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4645
4646 /**
4647  * @brief Set the text align on the label object
4648  *
4649  * @param obj The label object
4650  * @param align align mode ("left", "center", "right")
4651  *
4652  * @warning NEVER use this. It is for hyper-special cases only. use styles
4653  * instead. e.g. "default", "marker", "slide_long" etc.
4654  * @deprecated Use <align> tag instead. about <align> tag - Either "auto" (meaning according to text direction), "left", "right", "center", "middle", a value between 0.0 and 1.0, or a value between 0% to 100%.
4655  */
4656 EINA_DEPRECATED EAPI void                        elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
4657
4658 /**
4659  * @brief Set background color of the label
4660  *
4661  * @param obj The label object
4662  * @param r Red property background color of The label object
4663  * @param g Green property background color of The label object
4664  * @param b Blue property background color of The label object
4665  * @param a Alpha property background alpha of The label object
4666  *
4667  * @warning NEVER use this. It is for hyper-special cases only. use styles
4668  * instead. e.g. "default", "marker", "slide_long" etc.
4669  * @deprecated Just make colored background by yourself.
4670  */
4671 EINA_DEPRECATED EAPI void                        elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4672
4673 /**
4674  * @brief Set wrap height of the label
4675  *
4676  * @param obj The label object
4677  * @param h The wrap height in pixels at a minimum where words need to wrap
4678  *
4679  * This function sets the maximum height size hint of the label.
4680  *
4681  * @warning This is only relevant if the label is inside a container.
4682  * @deprecated This function should not be used because of wrong concept.
4683  */
4684 EINA_DEPRECATED EAPI void                        elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
4685
4686 /**
4687  * @brief get wrap width of the label
4688  *
4689  * @param obj The label object
4690  * @return The wrap height in pixels at a minimum where words need to wrap
4691  * @deprecated This function should not be used because of wrong concept.
4692  */
4693 EINA_DEPRECATED EAPI Evas_Coord                  elm_label_wrap_height_get(const Evas_Object *obj);
4694
4695 /**
4696  * @brief Flush all caches.
4697  *
4698  * Frees all data that was in cache and is not currently being used to reduce
4699  * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
4700  * to calling all of the following functions:
4701  * @li edje_file_cache_flush()
4702  * @li edje_collection_cache_flush()
4703  * @li eet_clearcache()
4704  * @li evas_image_cache_flush()
4705  * @li evas_font_cache_flush()
4706  * @li evas_render_dump()
4707  * @note Evas caches are flushed for every canvas associated with a window.
4708  * @deprecated Use elm_cache_all_flush() instead.
4709  */
4710 EINA_DEPRECATED EAPI void      elm_all_flush(void);
4711
4712
4713 /**
4714  * @brief Define the uri that will be the video source.
4715  *
4716  * @param video The video object to define the file for.
4717  * @param uri The uri to target.
4718  *
4719  * This function will define an uri as a source for the video of the
4720  * Elm_Video object. URI could be remote source of video, like http:// or local
4721  * like for example WebCam who are most of the time v4l2:// (but that depend an
4722  * you should use Emotion API to request and list the available Webcam on your
4723  *
4724  * @deprecated Use elm_video_file_set() instead.
4725  *
4726  */
4727 EINA_DEPRECATED EAPI void                 elm_video_uri_set(Evas_Object *video, const char *uri);
4728
4729 /**
4730  * @brief Get the region of the image that is currently shown
4731  *
4732  * @param obj
4733  * @param x A pointer to the X-coordinate of region
4734  * @param y A pointer to the Y-coordinate of region
4735  * @param w A pointer to the width
4736  * @param h A pointer to the height
4737  *
4738  * @deprecated Use elm_photocam_image_region_get() instead.
4739  */
4740 EINA_DEPRECATED EAPI void                   elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
4741
4742 /**
4743  * @brief Set the gesture state for photocam.
4744  *
4745  * @param obj The photocam object
4746  * @param gesture The gesture state to set
4747  *
4748  * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
4749  * photocam. The default is off. This will start multi touch zooming.
4750  *
4751  * @deprecated Use elm_photocam_gesture_enabled_set() instead.
4752  */
4753 EINA_DEPRECATED EAPI void                   elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
4754
4755 /**
4756  * @brief Get the gesture state for photocam.
4757  *
4758  * @param obj The photocam object
4759  * @return The current gesture state
4760  *
4761  * This gets the current gesture state for the photocam object.
4762  *
4763  * @deprecated Use elm_photocam_gesture_enabled_get() instead.
4764  */
4765 EINA_DEPRECATED EAPI Eina_Bool              elm_photocam_gesture_get(const Evas_Object *obj);
4766 /* No documentation for these API before.
4767  *
4768  * @deprecated Use elm_route_latitude_min_max_get()
4769  *             elm_route_longitude_min_max_get()
4770  *             instead.
4771  */
4772 EINA_DEPRECATED EAPI double       elm_route_lon_min_get(Evas_Object *obj);
4773 EINA_DEPRECATED EAPI double       elm_route_lat_min_get(Evas_Object *obj);
4774 EINA_DEPRECATED EAPI double       elm_route_lon_max_get(Evas_Object *obj);
4775 EINA_DEPRECATED EAPI double       elm_route_lat_max_get(Evas_Object *obj);
4776
4777
4778 /**
4779  * Get the duration after which tooltip will be shown.
4780  *
4781  * @return Duration after which tooltip will be shown.
4782  * @deprecated Use elm_config_tooltip_delay_get(void);
4783  */
4784 EINA_DEPRECATED EAPI double      elm_tooltip_delay_get(void);
4785
4786 /**
4787  * Set the duration after which tooltip will be shown.
4788  *
4789  * @return EINA_TRUE if value is set.
4790  * @deprecated Use elm_config_tooltip_delay_set(double delay);
4791  */
4792 EINA_DEPRECATED EAPI Eina_Bool   elm_tooltip_delay_set(double delay);
4793
4794 /**
4795  * Set the corner of the bubble
4796  *
4797  * @param obj The bubble object.
4798  * @param corner The given corner for the bubble.
4799  *
4800  * @deprecated Use elm_bubble_pos_set()
4801  *
4802  */
4803 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
4804
4805 /**
4806  * Get the corner of the bubble
4807  *
4808  * @param obj The bubble object.
4809  * @return The given corner for the bubble.
4810  *
4811  * @deprecated Use elm_bubble_pos_get()
4812  */
4813 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
4814
4815 /**
4816  * Enable or disable day selection
4817  *
4818  * @param obj The calendar object.
4819  * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
4820  * disable it.
4821  *
4822  * @deprecated Use elm_calendar_day_selection_disabled_set()
4823  */
4824 EINA_DEPRECATED EAPI void                 elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
4825
4826 /**
4827  * Get a value whether day selection is enabled or not.
4828  *
4829  * @param obj The calendar object.
4830  * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
4831  * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
4832  *
4833  * @deprecated elm_calendar_day_selection_disabled_get()
4834  */
4835 EINA_DEPRECATED EAPI Eina_Bool            elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
4836
4837 /**
4838  * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
4839  */
4840 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
4841
4842 /**
4843  * Get the configured font cache size
4844  *
4845  * This gets the globally configured font cache size, in bytes.
4846  *
4847  * @return The font cache size
4848  * @deprecated elm_cache_font_cache_size_get(void);
4849  */
4850 EINA_DEPRECATED EAPI int       elm_font_cache_get(void);
4851
4852 /**
4853  * Set the configured font cache size
4854  *
4855  * This sets the globally configured font cache size, in bytes
4856  *
4857  * @param size The font cache size
4858  * @deprecated elm_cache_font_cache_size_set(int size);
4859  */
4860 EINA_DEPRECATED EAPI void      elm_font_cache_set(int size);
4861
4862 /**
4863  * Get the configured image cache size
4864  *
4865  * This gets the globally configured image cache size, in bytes
4866  *
4867  * @return The image cache size
4868  */
4869 EINA_DEPRECATED EAPI int       elm_image_cache_get(void);
4870 EINA_DEPRECATED EAPI int       elm_cache_image_cache_size_get(void);
4871
4872 /**
4873  * Set the configured image cache size
4874  *
4875  * This sets the globally configured image cache size, in bytes
4876  *
4877  * @param size The image cache size
4878  * @deprecated Use elm_cache_image_cache_size_set(int size);
4879  */
4880 EINA_DEPRECATED EAPI void      elm_image_cache_set(int size);
4881
4882
4883 /**
4884  * Get the configured edje file cache size.
4885  *
4886  * This gets the globally configured edje file cache size, in number
4887  * of files.
4888  *
4889  * @return The edje file cache size
4890  * @deprecated Use elm_cache_edje_file_cache_size_get(void);
4891  */
4892 EINA_DEPRECATED EAPI int       elm_edje_file_cache_get(void);
4893
4894 /**
4895  * Set the configured edje file cache size
4896  *
4897  * This sets the globally configured edje file cache size, in number
4898  * of files.
4899  *
4900  * @param size The edje file cache size
4901  * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
4902  */
4903 EINA_DEPRECATED EAPI void      elm_edje_file_cache_set(int size);
4904
4905 /**
4906  * Get the configured edje collections (groups) cache size.
4907  *
4908  * This gets the globally configured edje collections cache size, in
4909  * number of collections.
4910  *
4911  * @return The edje collections cache size
4912  * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
4913  */
4914 EINA_DEPRECATED EAPI int       elm_edje_collection_cache_get(void);
4915
4916 /**
4917  * Set the configured edje collections (groups) cache size
4918  *
4919  * This sets the globally configured edje collections cache size, in
4920  * number of collections.
4921  *
4922  * @param size The edje collections cache size
4923  * @deprecated elm_cache_edje_collection_cache_size_set(int size);
4924  */
4925 EINA_DEPRECATED EAPI void      elm_edje_collection_cache_set(int size);
4926
4927 /**
4928  * Gets whether browsing history is enabled for the given object
4929  *
4930  * @param obj The web object
4931  *
4932  * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
4933  *
4934  * @deprecated Use elm_web_history_enabled_get()
4935  */
4936 EINA_DEPRECATED EAPI Eina_Bool         elm_web_history_enable_get(const Evas_Object *obj);
4937
4938 /**
4939  * Enables or disables the browsing history
4940  *
4941  * @param obj The web object
4942  * @param enable Whether to enable or disable the browsing history
4943  *
4944  * @deprecated Use elm_web_history_enabled_set()
4945  *
4946  */
4947 EINA_DEPRECATED EAPI void              elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
4948
4949 /**
4950  * @brief Add an object swallowed in an item at the end of the given menu
4951  * widget
4952  *
4953  * @param obj The menu object.
4954  * @param parent The parent menu item (optional)
4955  * @param subobj The object to swallow
4956  * @param func Function called when the user select the item.
4957  * @param data Data sent by the callback.
4958  * @return Returns the new item.
4959  *
4960  * Add an evas object as an item to the menu.
4961  * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
4962  */
4963 EINA_DEPRECATED EAPI Elm_Object_Item             *elm_menu_item_add_object(Evas_Object *obj, Elm_Object_Item *parent, Evas_Object *subobj, Evas_Smart_Cb func, const void *data);
4964
4965 /**
4966  * @brief Sets whether events should be passed to by a click outside
4967  * its area.
4968  *
4969  * @param obj The notify object
4970  * @param repeat EINA_TRUE Events are repeats, else no
4971  *
4972  * When true if the user clicks outside the window the events will be caught
4973  * by the others widgets, else the events are blocked.
4974  *
4975  * @note The default value is EINA_TRUE.
4976  * @deprecated Please use elm_notify_allow_events_set() instead
4977  */
4978 EINA_DEPRECATED EAPI void                         elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
4979
4980 /**
4981  * @brief Return true if events are repeat below the notify object
4982  * @param obj the notify object
4983  *
4984  * @see elm_notify_repeat_events_set()
4985  * @deprecated Please use elm_notify_allow_events_get() instead
4986  */
4987 EINA_DEPRECATED EAPI Eina_Bool                    elm_notify_repeat_events_get(const Evas_Object *obj);
4988
4989 /**
4990  * Set if the cursor set should be searched on the theme or should use
4991  * the provided by the engine, only.
4992  *
4993  * @param obj an object with cursor already set.
4994  * @param engine_only boolean to define if cursors should be looked only
4995  * between the provided by the engine or searched on widget's theme as well.
4996  *
4997  * @deprecated Use elm_object_cursor_theme_search_enabled_set()
4998  */
4999 EINA_DEPRECATED EAPI void        elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5000
5001 /**
5002  * Get the cursor engine only usage for this object cursor.
5003  *
5004  * @param obj an object with cursor already set.
5005  * @return engine_only boolean to define it cursors should be
5006  * looked only between the provided by the engine or searched on
5007  * widget's theme as well. If the object does not have a cursor
5008  * set, then EINA_FALSE is returned.
5009  *
5010  * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5011  */
5012 EINA_DEPRECATED EAPI Eina_Bool   elm_object_cursor_engine_only_get(const Evas_Object *obj);
5013
5014 /**
5015  * Go to a given items level on a index widget
5016  *
5017  * @param obj The index object
5018  * @param level The index level (one of @c 0 or @c 1)
5019  *
5020  * @deprecated please use "elm_index_level_go" instead.
5021  */
5022 EINA_DEPRECATED EAPI void                  elm_index_item_go(Evas_Object *obj, int level);
5023
5024 /**
5025  * Enable or disable auto hiding feature for a given index widget.
5026  *
5027  * @param obj The index object
5028  * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5029  *
5030  * @see elm_index_active_get()
5031  *
5032  * @deprecated please use "elm_index_autohide_disabled_set" instead.
5033  */
5034 EINA_DEPRECATED EAPI void                  elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5035
5036 /**
5037  * Get whether auto hiding feature is enabled or not for a given index widget.
5038  *
5039  * @param obj The index object
5040  * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5041  *
5042  * @see elm_index_active_set() for more details
5043  *
5044  * @deprecated please use "elm_index_autohide_disabled_get" instead.
5045  */
5046 EINA_DEPRECATED EAPI Eina_Bool             elm_index_active_get(const Evas_Object *obj);
5047
5048 /**
5049  * Append a new item, on a given index widget, <b>after the item
5050  * having @p relative as data</b>.
5051  *
5052  * @param obj The index object.
5053  * @param letter Letter under which the item should be indexed
5054  * @param item The item data to set for the index's item
5055  * @param relative The index item to be the predecessor of this new one
5056  * @return A handle to the item added or @c NULL, on errors 
5057  *
5058  * Despite the most common usage of the @p letter argument is for
5059  * single char strings, one could use arbitrary strings as index
5060  * entries.
5061  *
5062  * @c item will be the pointer returned back on @c "changed", @c
5063  * "delay,changed" and @c "selected" smart events.
5064  *
5065  * @note If @p relative is @c NULL this function will behave as
5066  * elm_index_item_append().
5067  *
5068  * @deprecated please use "elm_index_item_insert_after" instead.
5069  */
5070 EINA_DEPRECATED EAPI Elm_Object_Item      *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5071
5072 /**
5073  * Prepend a new item, on a given index widget, <b>after the item
5074  * having @p relative as data</b>.
5075  *
5076  * @param obj The index object.
5077  * @param letter Letter under which the item should be indexed
5078  * @param item The item data to set for the index's item
5079  * @param relative The index item to be the successor of this new one
5080  * @return A handle to the item added or @c NULL, on errors 
5081  *
5082  * Despite the most common usage of the @p letter argument is for
5083  * single char strings, one could use arbitrary strings as index
5084  * entries.
5085  *
5086  * @c item will be the pointer returned back on @c "changed", @c
5087  * "delay,changed" and @c "selected" smart events.
5088  *
5089  * @note If @p relative is @c NULL this function will behave as
5090  * elm_index_item_prepend().
5091  *
5092  * @deprecated please use "elm_index_item_insert_before" instead.
5093  */
5094 EINA_DEPRECATED EAPI Elm_Object_Item      *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5095
5096 /**
5097  * Set the transparency state of a window.
5098  *
5099  * Use elm_win_alpha_set() instead.
5100  *
5101  * @param obj The window object
5102  * @param transparent If true, the window is transparent
5103  *
5104  * @see elm_win_alpha_set()
5105  * @deprecated Please use elm_win_alpha_set()
5106  */
5107 EINA_DEPRECATED EAPI void                  elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5108
5109 /**
5110  * Get the transparency state of a window.
5111  *
5112  * @param obj The window object
5113  * @return If true, the window is transparent
5114  *
5115  * @see elm_win_transparent_set()
5116  * @deprecated Please use elm_win_alpha_get()
5117  */
5118 EINA_DEPRECATED EAPI Eina_Bool             elm_win_transparent_get(const Evas_Object *obj);
5119
5120 /**
5121  * Set the theme for all elementary using applications on the current display
5122  *
5123  * @param theme The name of the theme to use. Format same as the ELM_THEME
5124  * environment variable.
5125  * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5126  */
5127 EINA_DEPRECATED EAPI void             elm_theme_all_set(const char *theme);
5128
5129 /**
5130  * Returns the Evas_Object that represents the content area.
5131  *
5132  * @param obj The conformant object.
5133  * @return The content area of the widget.
5134  *
5135  */
5136 EINA_DEPRECATED EAPI Evas_Object                 *elm_conformant_content_area_get(const Evas_Object *obj);
5137
5138 /**
5139  * Set if the object is (up/down) resizable.
5140  *
5141  * @param obj The image object
5142  * @param scale_up A bool to set if the object is resizable up. Default is
5143  * @c EINA_TRUE.
5144  * @param scale_down A bool to set if the object is resizable down. Default
5145  * is @c EINA_TRUE.
5146  *
5147  * This function limits the image resize ability. If @p scale_up is set to
5148  * @c EINA_FALSE, the object can't have its height or width resized to a value
5149  * higher than the original image size. Same is valid for @p scale_down.
5150  *
5151  * @see elm_image_scale_get()
5152  * @deprecated Please use elm_image_resizable_set()
5153  *
5154  */
5155 EINA_DEPRECATED EAPI void             elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5156
5157 /**
5158  * Get if the object is (up/down) resizable.
5159  *
5160  * @param obj The image object
5161  * @param scale_up A bool to set if the object is resizable up
5162  * @param scale_down A bool to set if the object is resizable down
5163  *
5164  * @see elm_image_scale_set()
5165  * @deprecated Please use elm_image_resizable_get()
5166  *
5167  */
5168 EINA_DEPRECATED EAPI void             elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5169
5170 /**
5171  * Set if the object is (up/down) resizable.
5172  *
5173  * @param obj The icon object
5174  * @param scale_up A bool to set if the object is resizable up. Default is
5175  * @c EINA_TRUE.
5176  * @param scale_down A bool to set if the object is resizable down. Default
5177  * is @c EINA_TRUE.
5178  *
5179  * This function limits the icon object resize ability. If @p scale_up is set to
5180  * @c EINA_FALSE, the object can't have its height or width resized to a value
5181  * higher than the original icon size. Same is valid for @p scale_down.
5182  *
5183  * @see elm_icon_scale_get()
5184  * @deprecated Please use elm_icon_resizable_set()
5185  *
5186  */
5187 EINA_DEPRECATED EAPI void                  elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5188
5189 /**
5190  * Get if the object is (up/down) resizable.
5191  *
5192  * @param obj The icon object
5193  * @param scale_up A bool to set if the object is resizable up
5194  * @param scale_down A bool to set if the object is resizable down
5195  *
5196  * @see elm_icon_scale_set()
5197  * @deprecated Please use elm_icon_resizable_get()
5198  *
5199  */
5200 EINA_DEPRECATED EAPI void                  elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5201
5202 /**
5203  * Enable or disable preloading of the icon
5204  *
5205  * @param obj The icon object
5206  * @param disable If EINA_TRUE, preloading will be disabled
5207  * @deprecated Use elm_icon_preload_disabled_set() instead
5208  */
5209 EINA_DEPRECATED EAPI void                  elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5210
5211 /**
5212  * Returns the last selected item, for a given index widget.
5213  *
5214  * @param obj The index object.
5215  * @return The last item @b selected on @p obj (or @c NULL, on errors).
5216  * @deprecated Please use elm_index_selected_item_get() instead.
5217  *
5218  *
5219  */
5220 EINA_DEPRECATED EAPI Elm_Object_Item      *elm_index_item_selected_get(const Evas_Object *obj, int level);
5221
5222 /**
5223  * Get the value of shrink_mode state.
5224  *
5225  * @deprecated elm_multibuttonentry_expanded_get()
5226  */
5227 EINA_DEPRECATED EAPI int                        elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5228
5229 /**
5230  * Set/Unset the multibuttonentry to shrink mode state of single line
5231  *
5232  * @deprecated elm_multibuttonentry_expanded_set()
5233  */
5234 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5235
5236 /**
5237  * Get the guide text
5238  *
5239  * @param obj The multibuttonentry object
5240  * @return The guide text, or NULL if none
5241  *
5242  * @deprecated Please use elm_object_part_text_get(obj, "guide");
5243  */
5244 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5245
5246 /**
5247  * Set the guide text
5248  *
5249  * @param obj The multibuttonentry object
5250  * @param guidetext The guide text string
5251  *
5252  * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5253  */
5254 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5255
5256 /**
5257  * Make the elementary object and its children to be unfocusable
5258  * (or focusable).
5259  *
5260  * @param obj The Elementary object to operate on
5261  * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5262  *        @c EINA_FALSE for focusable.
5263  *
5264  * This sets whether the object @p obj and its children objects
5265  * are able to take focus or not. If the tree is set as unfocusable,
5266  * newest focused object which is not in this tree will get focus.
5267  * This API can be helpful for an object to be deleted.
5268  * When an object will be deleted soon, it and its children may not
5269  * want to get focus (by focus reverting or by other focus controls).
5270  * Then, just use this API before deleting.
5271  *
5272  * @see elm_object_tree_unfocusable_get()
5273  *
5274  * @deprecated Please use elm_object_tree_unfocusable_set()
5275  */
5276 EINA_DEPRECATED EAPI void                 elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5277
5278 /**
5279  * Get whether an Elementary object and its children are unfocusable or not.
5280  *
5281  * @param obj The Elementary object to get the information from
5282  * @return @c EINA_TRUE, if the tree is unfocussable,
5283  *         @c EINA_FALSE if not (and on errors).
5284  *
5285  * @see elm_object_tree_unfocusable_set()
5286  *
5287  * @deprecated Please use elm_object_tree_unfocusable_get()
5288  */
5289 EINA_DEPRECATED EAPI Eina_Bool            elm_object_tree_unfocusable_get(const Evas_Object *obj);
5290
5291 /**
5292  * Animatedly bring in, to the visible are of a genlist, a given
5293  * item on it.
5294  *
5295  * @deprecated elm_genlist_item_bring_in()
5296  */
5297 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5298
5299 /**
5300  * Animatedly bring in, to the visible are of a genlist, a given
5301  * item on it.
5302  *
5303  * @deprecated elm_genlist_item_bring_in()
5304  */
5305 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5306
5307 /**
5308  * Show the portion of a genlist's internal list containing a given
5309  * item, immediately.
5310  *
5311  * @param it The item to display
5312  *
5313  * @deprecated elm_genlist_item_show()
5314  *
5315  */
5316 EINA_DEPRECATED EAPI void                          elm_genlist_item_top_show(Elm_Object_Item *it);
5317
5318 /**
5319  * Show the portion of a genlist's internal list containing a given
5320  * item, immediately.
5321  *
5322  * @param it The item to display
5323  *
5324  * @deprecated elm_genlist_item_show()
5325  *
5326  */
5327 EINA_DEPRECATED EAPI void                          elm_genlist_item_middle_show(Elm_Object_Item *it);
5328
5329 /**
5330  * Enable or disable round mode.
5331  *
5332  * @param obj The diskselector object.
5333  * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
5334  * disable it.
5335  *
5336  * Disabled by default. If round mode is enabled the items list will
5337  * work like a circle list, so when the user reaches the last item,
5338  * the first one will popup.
5339  *
5340  * @see elm_diskselector_round_enabled_get()
5341  *
5342  * @deprecated elm_diskselector_round_enabled_set()
5343  */
5344 EINA_DEPRECATED EAPI void                   elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
5345
5346 /**
5347  * Set whether items on a given gengrid widget are to get their
5348  * selection callbacks issued for @b every subsequent selection
5349  * click on them or just for the first click.
5350  *
5351  * @param obj The gengrid object
5352  * @param always_select @c EINA_TRUE to make items "always
5353  * selected", @c EINA_FALSE, otherwise
5354  *
5355  * By default, grid items will only call their selection callback
5356  * function when firstly getting selected, any subsequent further
5357  * clicks will do nothing. With this call, you make those
5358  * subsequent clicks also to issue the selection callbacks.
5359  *
5360  * @note <b>Double clicks</b> will @b always be reported on items.
5361  *
5362  * @see elm_gengrid_always_select_mode_get()
5363  *
5364  */
5365 EINA_DEPRECATED EAPI void                          elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5366
5367 /**
5368  * Get whether items on a given gengrid widget have their selection
5369  * callbacks issued for @b every subsequent selection click on them
5370  * or just for the first click.
5371  *
5372  * @param obj The gengrid object.
5373  * @return @c EINA_TRUE if the gengrid items are "always selected",
5374  * @c EINA_FALSE, otherwise
5375  *
5376  * @see elm_gengrid_always_select_mode_set() for more details
5377  *
5378  */
5379 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_always_select_mode_get(const Evas_Object *obj);
5380
5381 /**
5382  * Set whether items on a given gengrid widget can be selected or not.
5383  *
5384  * @param obj The gengrid object
5385  * @param no_select @c EINA_TRUE to make items selectable,
5386  * @c EINA_FALSE otherwise
5387  *
5388  * This will make items in @p obj selectable or not. In the latter
5389  * case, any user interaction on the gengrid items will neither make
5390  * them appear selected nor them call their selection callback
5391  * functions.
5392  *
5393  * @see elm_gengrid_no_select_mode_get()
5394  *
5395  */
5396 EINA_DEPRECATED EAPI void                          elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5397
5398 /**
5399  * Get whether items on a given gengrid widget can be selected or
5400  * not.
5401  *
5402  * @param obj The gengrid object
5403  * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
5404  * otherwise
5405  *
5406  * @see elm_gengrid_no_select_mode_set() for more details
5407  *
5408  */
5409 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_no_select_mode_get(const Evas_Object *obj);
5410
5411 /**
5412  * Get the side labels max length.
5413  *
5414  * @see elm_diskselector_side_text_max_length_set() for details.
5415  *
5416  * @param obj The diskselector object.
5417  * @return The max length defined for side labels, or 0 if not a valid
5418  * diskselector.
5419  *
5420  * @deprecated elm_diskselector_side_text_max_length_get()
5421  */
5422 EINA_DEPRECATED EAPI int                    elm_diskselector_side_label_length_get(const Evas_Object *obj);
5423
5424 /**
5425  * Set the side labels max length.
5426  *
5427  * @param obj The diskselector object.
5428  * @param len The max length defined for side labels.
5429  *
5430  * Length is the number of characters of items' label that will be
5431  * visible when it's set on side positions. It will just crop
5432  * the string after defined size. E.g.:
5433  *
5434  * An item with label "January" would be displayed on side position as
5435  * "Jan" if max length is set to 3, or "Janu", if this property
5436  * is set to 4.
5437  *
5438  * When it's selected, the entire label will be displayed, except for
5439  * width restrictions. In this case label will be cropped and "..."
5440  * will be concatenated.
5441  *
5442  * Default side label max length is 3.
5443  *
5444  * This property will be applied over all items, included before or
5445  * later this function call.
5446  *
5447  * @deprecated elm_diskselector_side_text_max_length_set()
5448  */
5449 EINA_DEPRECATED EAPI void                   elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
5450
5451 /**
5452  * Set whether the toolbar should always have an item selected.
5453  *
5454  * @param obj The toolbar object.
5455  * @param always_select @c EINA_TRUE to enable always-select mode or @c EINA_FALSE to
5456  * disable it.
5457  *
5458  * This will cause the toolbar to always have an item selected, and clicking
5459  * the selected item will not cause a selected event to be emitted. Enabling this mode
5460  * will immediately select the first toolbar item.
5461  *
5462  * Always-selected is disabled by default.
5463  *
5464  * @see elm_toolbar_always_select_mode_get().
5465  *
5466  * @ingroup Toolbar
5467  */
5468 EINA_DEPRECATED EAPI void                         elm_toolbar_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5469
5470 /**
5471  * Get whether the toolbar should always have an item selected.
5472  *
5473  * @param obj The toolbar object.
5474  * @return @c EINA_TRUE means an item will always be selected, @c EINA_FALSE indicates
5475  * that it is possible to have no items selected. If @p obj is @c NULL, @c EINA_FALSE is returned.
5476  *
5477  * @see elm_toolbar_always_select_mode_set() for details.
5478  *
5479  * @ingroup Toolbar
5480  */
5481 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_always_select_mode_get(const Evas_Object *obj);
5482
5483 /**
5484  * Set whether the toolbar items' should be selected by the user or not.
5485  *
5486  * @param obj The toolbar object.
5487  * @param no_select @c EINA_TRUE to disable selection or @c EINA_FALSE to
5488  * enable it.
5489  *
5490  * This will turn off the ability to select items entirely and they will
5491  * neither appear selected nor emit selected signals. The clicked
5492  * callback function will still be called.
5493  *
5494  * Selection is enabled by default.
5495  *
5496  * @see elm_toolbar_no_select_mode_get().
5497  *
5498  * @ingroup Toolbar
5499  */
5500 EINA_DEPRECATED EAPI void                         elm_toolbar_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5501
5502 /**
5503  * Set whether the toolbar items' should be selected by the user or not.
5504  *
5505  * @param obj The toolbar object.
5506  * @return @c EINA_TRUE means items can be selected. @c EINA_FALSE indicates
5507  * they can't. If @p obj is @c NULL, @c EINA_FALSE is returned.
5508  *
5509  * @see elm_toolbar_no_select_mode_set() for details.
5510  *
5511  * @ingroup Toolbar
5512  */
5513 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_no_select_mode_get(const Evas_Object *obj);
5514
5515 /*
5516  * Set the interval on time updates for a user mouse button hold
5517  * on clock widgets' time edition.
5518  *
5519  * @param obj The clock object
5520  * @param interval The (first) interval value in seconds
5521  *
5522  * This interval value is @b decreased while the user holds the
5523  * mouse pointer either incrementing or decrementing a given the
5524  * clock digit's value.
5525  *
5526  * This helps the user to get to a given time distant from the
5527  * current one easier/faster, as it will start to flip quicker and
5528  * quicker on mouse button holds.
5529  *
5530  * The calculation for the next flip interval value, starting from
5531  * the one set with this call, is the previous interval divided by
5532  * 1.05, so it decreases a little bit.
5533  *
5534  * The default starting interval value for automatic flips is
5535  * @b 0.85 seconds.
5536  *
5537  * @deprecated elm_clock_first_interval_set()
5538  *
5539  */
5540 EINA_DEPRECATED EAPI void              elm_clock_interval_set(Evas_Object *obj, double interval);
5541
5542 /**
5543  * Get the interval on time updates for a user mouse button hold
5544  * on clock widgets' time edition.
5545  *
5546  * @param obj The clock object
5547  * @return The (first) interval value, in seconds, set on it
5548  *
5549  * @elm_clock_first_interval_get()
5550  */
5551 EINA_DEPRECATED EAPI double            elm_clock_interval_get(const Evas_Object *obj);
5552
5553 /**
5554  * Set what digits of the given clock widget should be editable
5555  * when in edition mode.
5556  *
5557  * @param obj The clock object
5558  * @param digedit Bit mask indicating the digits to be editable
5559  * (values in #Elm_Clock_Edit_Mode).
5560  *
5561  * If the @p digedit param is #ELM_CLOCK_NONE, editing will be
5562  * disabled on @p obj (same effect as elm_clock_edit_set(), with @c
5563  * EINA_FALSE).
5564  *
5565  * @deprecated elm_clock_edit_mode_set()
5566  */
5567 EINA_DEPRECATED EAPI void              elm_clock_digit_edit_set(Evas_Object *obj, Elm_Clock_Edit_Mode digedit);
5568
5569 /**
5570  * Retrieve what digits of the given clock widget should be
5571  * editable when in edition mode.
5572  *
5573  * @param obj The clock object
5574  * @return Bit mask indicating the digits to be editable
5575  * (values in #Elm_Clock_Edit_Mode).
5576  *
5577  * @deprecated elm_clock_edit_mode_get()
5578  */
5579 EINA_DEPRECATED EAPI Elm_Clock_Edit_Mode elm_clock_digit_edit_get(const Evas_Object *obj);
5580
5581 /*
5582  * Queries whether it's possible to go back in history
5583  *
5584  * @param obj The web object
5585  *
5586  * @return EINA_TRUE if it's possible to back in history, EINA_FALSE
5587  * otherwise
5588  * @deprecated elm_web_back_possible_get();
5589  */
5590 EINA_DEPRECATED EAPI Eina_Bool         elm_web_backward_possible(Evas_Object *obj);
5591
5592 /**
5593  * Queries whether it's possible to go forward in history
5594  *
5595  * @param obj The web object
5596  *
5597  * @return EINA_TRUE if it's possible to forward in history, EINA_FALSE
5598  * otherwise
5599  *
5600  * @deprecated elm_web_forward_possible_get();
5601  */
5602 EINA_DEPRECATED EAPI Eina_Bool         elm_web_forward_possible(Evas_Object *obj);
5603
5604 /**
5605  * Queries whether it's possible to jump the given number of steps
5606  *
5607  * @deprecated elm_web_navigate_possible_get();
5608  *
5609  */
5610 EINA_DEPRECATED EAPI Eina_Bool         elm_web_navigate_possible(Evas_Object *obj, int steps);
5611
5612 /**
5613  * @brief Set the content of the scroller widget (the object to be scrolled around).
5614  *
5615  * @param obj The scroller object
5616  * @param content The new content object
5617  *
5618  * Once the content object is set, a previously set one will be deleted.
5619  * If you want to keep that old content object, use the
5620  * elm_scroller_content_unset() function.
5621  * @deprecated use elm_object_content_set() instead
5622  */
5623 EINA_DEPRECATED EAPI void         elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
5624
5625 /**
5626  * @brief Get the content of the scroller widget
5627  *
5628  * @param obj The slider object
5629  * @return The content that is being used
5630  *
5631  * Return the content object which is set for this widget
5632  *
5633  * @see elm_scroller_content_set()
5634  * @deprecated use elm_object_content_get() instead.
5635  */
5636 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
5637
5638 /**
5639  * @brief Unset the content of the scroller widget
5640  *
5641  * @param obj The slider object
5642  * @return The content that was being used
5643  *
5644  * Unparent and return the content object which was set for this widget
5645  *
5646  * @see elm_scroller_content_set()
5647  * @deprecated use elm_object_content_unset() instead.
5648  */
5649 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
5650
5651 /**
5652  * Set the shrink state of toolbar @p obj.
5653  *
5654  * @param obj The toolbar object.
5655  * @param shrink_mode Toolbar's items display behavior.
5656  *
5657  * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
5658  * but will enforce a minimum size so all the items will fit, won't scroll
5659  * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
5660  * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
5661  * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
5662  *
5663  * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
5664  */
5665 EINA_DEPRECATED EAPI void                         elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
5666
5667 /**
5668  * Get the shrink mode of toolbar @p obj.
5669  *
5670  * @param obj The toolbar object.
5671  * @return Toolbar's items display behavior.
5672  *
5673  * @see elm_toolbar_shrink_mode_set() for details.
5674  *
5675  * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
5676  */
5677 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode      elm_toolbar_mode_shrink_get(const Evas_Object *obj);
5678
5679 /**
5680  * Set the text to be shown in a given toolbar item's tooltips.
5681  *
5682  * @param it toolbar item.
5683  * @param text The text to set in the content.
5684  *
5685  * Setup the text as tooltip to object. The item can have only one tooltip,
5686  * so any previous tooltip data - set with this function or
5687  * elm_toolbar_item_tooltip_content_cb_set() - is removed.
5688  *
5689  * @deprecated Use elm_object_item_tooltip_text_set() instead
5690  * @see elm_object_tooltip_text_set() for more details.
5691  *
5692  */
5693 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
5694
5695 /**
5696  * Enable or disable always select mode on the list object.
5697  *
5698  * @param obj The list object
5699  * @param always_select @c EINA_TRUE to enable always select mode or
5700  * @c EINA_FALSE to disable it.
5701  *
5702  * @note Always select mode is disabled by default.
5703  *
5704  * Default behavior of list items is to only call its callback function
5705  * the first time it's pressed, i.e., when it is selected. If a selected
5706  * item is pressed again, and multi-select is disabled, it won't call
5707  * this function (if multi-select is enabled it will unselect the item).
5708  *
5709  * If always select is enabled, it will call the callback function
5710  * every time a item is pressed, so it will call when the item is selected,
5711  * and again when a selected item is pressed.
5712  *
5713  * @deprecated elm_list_always_select_mode_set()
5714  */
5715 EINA_DEPRECATED EAPI void                         elm_list_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5716
5717 /**
5718  * Get a value whether always select mode is enabled or not, meaning that
5719  * an item will always call its callback function, even if already selected.
5720  *
5721  * @param obj The list object
5722  * @return @c EINA_TRUE means horizontal mode selection is enabled.
5723  * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
5724  * @c EINA_FALSE is returned.
5725  *
5726  * @see elm_list_always_select_mode_set() for details.
5727  *
5728  * @deprecated elm_list_always_select_mode_get()
5729  */
5730 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_always_select_mode_get(const Evas_Object *obj);
5731