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