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