Fix typos in documentation #4
[framework/uifw/elementary.git] / src / lib / elm_deprecated.h
1 EINA_DEPRECATED EAPI void          elm_gen_clear(Evas_Object *obj);
2 EINA_DEPRECATED EAPI void          elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
3 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_item_selected_get(const Elm_Gen_Item *it);
4 EINA_DEPRECATED EAPI void          elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_always_select_mode_get(const Evas_Object *obj);
6 EINA_DEPRECATED EAPI void          elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
7 EINA_DEPRECATED EAPI Eina_Bool     elm_gen_no_select_mode_get(const Evas_Object *obj);
8 EINA_DEPRECATED EAPI void          elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
9 EINA_DEPRECATED EAPI void          elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
10 EINA_DEPRECATED EAPI void          elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
11 EINA_DEPRECATED EAPI void          elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
12
13 EINA_DEPRECATED EAPI void          elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
14 EINA_DEPRECATED EAPI void          elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
15 EINA_DEPRECATED EAPI void          elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
16 EINA_DEPRECATED EAPI void          elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
17 EINA_DEPRECATED EAPI void          elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
18 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
19 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
20 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
21 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
22 EINA_DEPRECATED EAPI Evas_Object  *elm_gen_item_widget_get(const Elm_Gen_Item *it);
23
24 /**
25  * Get the widget object's handle which contains a given item
26  *
27  * @param it The Elementary object item
28  * @return The widget object
29  *
30  * @note This returns the widget object itself that an item belongs to.
31  * @note Every elm_object_item supports this API
32  * @deprecated Use elm_object_item_widget_get() instead
33  * @ingroup General
34  */
35 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_object_get(const Elm_Object_Item *it);
36
37 /**
38  * @defgroup Toggle Toggle
39  *
40  * @image html img/widget/toggle/preview-00.png
41  * @image latex img/widget/toggle/preview-00.eps
42  *
43  * @brief A toggle is a slider which can be used to toggle between
44  * two values.  It has two states: on and off.
45  *
46  * This widget is deprecated. Please use elm_check_add() instead using the
47  * toggle style like:
48  *
49  * @code
50  * obj = elm_check_add(parent);
51  * elm_object_style_set(obj, "toggle");
52  * elm_object_part_text_set(obj, "on", "ON");
53  * elm_object_part_text_set(obj, "off", "OFF");
54  * @endcode
55  *
56  * Signals that you can add callbacks for are:
57  * @li "changed" - Whenever the toggle value has been changed.  Is not called
58  *                 until the toggle is released by the cursor (assuming it
59  *                 has been triggered by the cursor in the first place).
60  *
61  * Default contents parts of the toggle widget that you can use for are:
62  * @li "icon" - An icon of the toggle
63  *
64  * Default text parts of the toggle widget that you can use for are:
65  * @li "elm.text" - Label of the toggle
66  *
67  * @ref tutorial_toggle show how to use a toggle.
68  * @{
69  */
70
71 /**
72  * @brief Add a toggle to @p parent.
73  *
74  * @param parent The parent object
75  *
76  * @return The toggle object
77  */
78 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
79
80 /**
81  * @brief Sets the label to be displayed with the toggle.
82  *
83  * @param obj The toggle object
84  * @param label The label to be displayed
85  *
86  * @deprecated use elm_object_text_set() instead.
87  */
88 EINA_DEPRECATED EAPI void         elm_toggle_label_set(Evas_Object *obj, const char *label);
89
90 /**
91  * @brief Gets the label of the toggle
92  *
93  * @param obj  toggle object
94  * @return The label of the toggle
95  *
96  * @deprecated use elm_object_text_get() instead.
97  */
98 EINA_DEPRECATED EAPI const char  *elm_toggle_label_get(const Evas_Object *obj);
99
100 /**
101  * @brief Set the icon used for the toggle
102  *
103  * @param obj The toggle object
104  * @param icon The icon object for the button
105  *
106  * Once the icon object is set, a previously set one will be deleted
107  * If you want to keep that old content object, use the
108  * elm_toggle_icon_unset() function.
109  *
110  * @deprecated use elm_object_part_content_set() instead.
111  */
112 EINA_DEPRECATED EAPI void         elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
113
114 /**
115  * @brief Get the icon used for the toggle
116  *
117  * @param obj The toggle object
118  * @return The icon object that is being used
119  *
120  * Return the icon object which is set for this widget.
121  *
122  * @see elm_toggle_icon_set()
123  *
124  * @deprecated use elm_object_part_content_get() instead.
125  */
126 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
127
128 /**
129  * @brief Unset the icon used for the toggle
130  *
131  * @param obj The toggle object
132  * @return The icon object that was being used
133  *
134  * Unparent and return the icon object which was set for this widget.
135  *
136  * @see elm_toggle_icon_set()
137  *
138  * @deprecated use elm_object_part_content_unset() instead.
139  */
140 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
141
142 /**
143  * @brief Sets the labels to be associated with the on and off states of the toggle.
144  *
145  * @param obj The toggle object
146  * @param onlabel The label displayed when the toggle is in the "on" state
147  * @param offlabel The label displayed when the toggle is in the "off" state
148  *
149  * @deprecated use elm_object_part_text_set() for "on" and "off" parts
150  * instead.
151  */
152 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
153
154 /**
155  * @brief Gets the labels associated with the on and off states of the
156  * toggle.
157  *
158  * @param obj The toggle object
159  * @param onlabel A char** to place the onlabel of @p obj into
160  * @param offlabel A char** to place the offlabel of @p obj into
161  *
162  * @deprecated use elm_object_part_text_get() for "on" and "off" parts
163  * instead.
164  */
165 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
166
167 /**
168  * @brief Sets the state of the toggle to @p state.
169  *
170  * @param obj The toggle object
171  * @param state The state of @p obj
172  *
173  * @deprecated use elm_check_state_set() instead.
174  */
175 EINA_DEPRECATED EAPI void         elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
176
177 /**
178  * @brief Gets the state of the toggle to @p state.
179  *
180  * @param obj The toggle object
181  * @return The state of @p obj
182  *
183  * @deprecated use elm_check_state_get() instead.
184  */
185 EINA_DEPRECATED EAPI Eina_Bool    elm_toggle_state_get(const Evas_Object *obj);
186
187 /**
188  * @brief Sets the state pointer of the toggle to @p statep.
189  *
190  * @param obj The toggle object
191  * @param statep The state pointer of @p obj
192  *
193  * @deprecated use elm_check_state_pointer_set() instead.
194  */
195 EINA_DEPRECATED EAPI void         elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
196
197 /**
198  * @}
199  */
200
201 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
202 EINA_DEPRECATED EAPI void         elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
203 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_single_line_get(const Evas_Object *obj);
204 EINA_DEPRECATED EAPI void         elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
205 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_password_get(const Evas_Object *obj);
206 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
207 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_entry_get(const Evas_Object *obj);
208 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
209 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_is_empty(const Evas_Object *obj);
210 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_selection_get(const Evas_Object *obj);
211 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
212 EINA_DEPRECATED EAPI void         elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
213 EINA_DEPRECATED EAPI void         elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
214 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_editable_get(const Evas_Object *obj);
215 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_none(Evas_Object *obj);
216 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_all(Evas_Object *obj);
217 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_next(Evas_Object *obj);
218 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_prev(Evas_Object *obj);
219 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_up(Evas_Object *obj);
220 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_down(Evas_Object *obj);
221 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
222 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
223 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
224 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
225 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
226 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
227 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
228 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
229 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
230 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
231 EINA_DEPRECATED EAPI int          elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
232 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_cut(Evas_Object *obj);
233 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_copy(Evas_Object *obj);
234 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_paste(Evas_Object *obj);
235 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
236 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data);
237 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
238 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
239 EINA_DEPRECATED EAPI void         elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
240 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
241 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
242 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
243 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
244 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
245 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
246 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
247 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
248 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
249 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
250 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_append(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
251 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_prepend(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
252 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_remove(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
253 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
254 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
255 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
256 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
257 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
258 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_save(Evas_Object *obj);
259 EINA_DEPRECATED EAPI void         elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
260 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_autosave_get(const Evas_Object *obj);
261 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
262 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
263
264 /**
265  * Set the text to show in the anchorblock
266  *
267  * Sets the text of the anchorblock to @p text. This text can include markup
268  * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
269  * of text that will be specially styled and react to click events, ended
270  * with either of \</a\> or \</\>. When clicked, the anchor will emit an
271  * "anchor,clicked" signal that you can attach a callback to with
272  * evas_object_smart_callback_add(). The name of the anchor given in the
273  * event info struct will be the one set in the href attribute, in this
274  * case, anchorname.
275  *
276  * Other markup can be used to style the text in different ways, but it's
277  * up to the style defined in the theme which tags do what.
278  * @deprecated use elm_object_text_set() instead.
279  */
280 EINA_DEPRECATED EAPI void        elm_anchorblock_text_set(Evas_Object *obj, const char *text);
281
282 /**
283  * Get the markup text set for the anchorblock
284  *
285  * Retrieves the text set on the anchorblock, with markup tags included.
286  *
287  * @param obj The anchorblock object
288  * @return The markup text set or @c NULL if nothing was set or an error
289  * occurred
290  * @deprecated use elm_object_text_set() instead.
291  */
292 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
293
294 /**
295  * Set the text to show in the anchorview
296  *
297  * Sets the text of the anchorview to @p text. This text can include markup
298  * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
299  * text that will be specially styled and react to click events, ended with
300  * either of \</a\> or \</\>. When clicked, the anchor will emit an
301  * "anchor,clicked" signal that you can attach a callback to with
302  * evas_object_smart_callback_add(). The name of the anchor given in the
303  * event info struct will be the one set in the href attribute, in this
304  * case, anchorname.
305  *
306  * Other markup can be used to style the text in different ways, but it's
307  * up to the style defined in the theme which tags do what.
308  * @deprecated use elm_object_text_set() instead.
309  */
310 EINA_DEPRECATED EAPI void        elm_anchorview_text_set(Evas_Object *obj, const char *text);
311
312 /**
313  * Get the markup text set for the anchorview
314  *
315  * Retrieves the text set on the anchorview, with markup tags included.
316  *
317  * @param obj The anchorview object
318  * @return The markup text set or @c NULL if nothing was set or an error
319  * occurred
320  * @deprecated use elm_object_text_set() instead.
321  */
322 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
323
324 /**
325  * @brief Get the ctxpopup item's disabled/enabled state.
326  *
327  * @param it Ctxpopup item to be enabled/disabled
328  * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
329  *
330  * @see elm_ctxpopup_item_disabled_set()
331  * @deprecated use elm_object_item_disabled_get() instead
332  *
333  * @ingroup Ctxpopup
334  */
335 EINA_DEPRECATED EAPI Eina_Bool                    elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
336
337 /**
338  * @brief Set the ctxpopup item's state as disabled or enabled.
339  *
340  * @param it Ctxpopup item to be enabled/disabled
341  * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
342  *
343  * When disabled the item is greyed out to indicate it's state.
344  * @deprecated use elm_object_item_disabled_set() instead
345  *
346  * @ingroup Ctxpopup
347  */
348 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
349
350 /**
351  * @brief Get the icon object for the given ctxpopup item.
352  *
353  * @param it Ctxpopup item
354  * @return icon object or @c NULL, if the item does not have icon or an error
355  * occurred
356  *
357  * @see elm_ctxpopup_item_append()
358  * @see elm_ctxpopup_item_icon_set()
359  *
360  * @deprecated use elm_object_item_part_content_get() instead
361  *
362  * @ingroup Ctxpopup
363  */
364 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
365
366 /**
367  * @brief Sets the side icon associated with the ctxpopup item
368  *
369  * @param it Ctxpopup item
370  * @param icon Icon object to be set
371  *
372  * Once the icon object is set, a previously set one will be deleted.
373  * @warning Setting the same icon for two items will cause the icon to
374  * disappear from the first item.
375  *
376  * @see elm_ctxpopup_item_append()
377  *
378  * @deprecated use elm_object_item_part_content_set() instead
379  *
380  * @ingroup Ctxpopup
381  */
382 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
383
384 /**
385  * @brief Get the label for the given ctxpopup item.
386  *
387  * @param it Ctxpopup item
388  * @return label string or @c NULL, if the item does not have label or an
389  * error occurred
390  *
391  * @see elm_ctxpopup_item_append()
392  * @see elm_ctxpopup_item_label_set()
393  *
394  * @deprecated use elm_object_item_text_get() instead
395  *
396  * @ingroup Ctxpopup
397  */
398 EINA_DEPRECATED EAPI const char  *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
399
400 /**
401  * @brief (Re)set the label on the given ctxpopup item.
402  *
403  * @param it Ctxpopup item
404  * @param label String to set as label
405  *
406  * @deprecated use elm_object_item_text_set() instead
407  *
408  * @ingroup Ctxpopup
409  */
410 EINA_DEPRECATED EAPI void         elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
411
412 /**
413  * @brief Set an elm widget as the content of the ctxpopup.
414  *
415  * @param obj Ctxpopup object
416  * @param content Content to be swallowed
417  *
418  * If the content object is already set, a previous one will be deleted. If
419  * you want to keep that old content object, use the
420  * elm_ctxpopup_content_unset() function.
421  *
422  * @warning Ctxpopup can't hold both a item list and a content at the same
423  * time. When a content is set, any previous items will be removed.
424  *
425  * @deprecated use elm_object_content_set() instead
426  *
427  * @ingroup Ctxpopup
428  */
429 EINA_DEPRECATED EAPI void         elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
430
431 /**
432  * @brief Unset the ctxpopup content
433  *
434  * @param obj Ctxpopup object
435  * @return The content that was being used
436  *
437  * Unparent and return the content object which was set for this widget.
438  *
439  * @deprecated use elm_object_content_unset()
440  *
441  * @see elm_ctxpopup_content_set()
442  *
443  * @deprecated use elm_object_content_unset() instead
444  *
445  * @ingroup Ctxpopup
446  */
447 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
448
449 /**
450  * @brief Delete the given item in a ctxpopup object.
451  *
452  * @param it Ctxpopup item to be deleted
453  *
454  * @deprecated Use elm_object_item_del() instead
455  * @see elm_ctxpopup_item_append()
456  *
457  * @ingroup Ctxpopup
458  */
459 EINA_DEPRECATED EAPI void                         elm_ctxpopup_item_del(Elm_Object_Item *it);
460
461 /**
462  * Set the label for a given file selector button widget
463  *
464  * @param obj The file selector button widget
465  * @param label The text label to be displayed on @p obj
466  *
467  * @deprecated use elm_object_text_set() instead.
468  */
469 EINA_DEPRECATED EAPI void        elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
470
471 /**
472  * Get the label set for a given file selector button widget
473  *
474  * @param obj The file selector button widget
475  * @return The button label
476  *
477  * @deprecated use elm_object_text_set() instead.
478  */
479 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
480
481 /**
482  * Set the icon on a given file selector button widget
483  *
484  * @param obj The file selector button widget
485  * @param icon The icon object for the button
486  *
487  * Once the icon object is set, a previously set one will be
488  * deleted. If you want to keep the latter, use the
489  * elm_fileselector_button_icon_unset() function.
490  *
491  * @deprecated Use elm_object_part_content_set() instead
492  * @see elm_fileselector_button_icon_get()
493  */
494 EINA_DEPRECATED EAPI void                        elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
495
496 /**
497  * Get the icon set for a given file selector button widget
498  *
499  * @param obj The file selector button widget
500  * @return The icon object currently set on @p obj or @c NULL, if
501  * none is
502  *
503  * @deprecated Use elm_object_part_content_get() instead
504  * @see elm_fileselector_button_icon_set()
505  */
506 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_button_icon_get(const Evas_Object *obj);
507
508 /**
509  * Unset the icon used in a given file selector button widget
510  *
511  * @param obj The file selector button widget
512  * @return The icon object that was being used on @p obj or @c
513  * NULL, on errors
514  *
515  * Unparent and return the icon object which was set for this
516  * widget.
517  *
518  * @deprecated Use elm_object_part_content_unset() instead
519  * @see elm_fileselector_button_icon_set()
520  */
521 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_button_icon_unset(Evas_Object *obj);
522
523 /**
524  * Set the label for a given file selector entry widget's button
525  *
526  * @param obj The file selector entry widget
527  * @param label The text label to be displayed on @p obj widget's
528  * button
529  *
530  * @deprecated use elm_object_text_set() instead.
531  */
532 EINA_DEPRECATED EAPI void        elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
533
534 /**
535  * Get the label set for a given file selector entry widget's button
536  *
537  * @param obj The file selector entry widget
538  * @return The widget button's label
539  *
540  * @deprecated use elm_object_text_set() instead.
541  */
542 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
543
544 /**
545  * Set the icon on a given file selector entry widget's button
546  *
547  * @param obj The file selector entry widget
548  * @param icon The icon object for the entry's button
549  *
550  * Once the icon object is set, a previously set one will be
551  * deleted. If you want to keep the latter, use the
552  * elm_fileselector_entry_button_icon_unset() function.
553  *
554  * @deprecated Use elm_object_part_content_set() instead
555  * @see elm_fileselector_entry_button_icon_get()
556  */
557 EINA_DEPRECATED EAPI void                        elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
558
559 /**
560  * Get the icon set for a given file selector entry widget's button
561  *
562  * @param obj The file selector entry widget
563  * @return The icon object currently set on @p obj widget's button
564  * or @c NULL, if none is
565  *
566  * @deprecated Use elm_object_part_content_get() instead
567  * @see elm_fileselector_entry_button_icon_set()
568  */
569 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
570
571 /**
572  * Unset the icon used in a given file selector entry widget's
573  * button
574  *
575  * @param obj The file selector entry widget
576  * @return The icon object that was being used on @p obj widget's
577  * button or @c NULL, on errors
578  *
579  * Unparent and return the icon object which was set for this
580  * widget's button.
581  *
582  * @deprecated Use elm_object_part_content_unset() instead
583  * @see elm_fileselector_entry_button_icon_set()
584  */
585 EINA_DEPRECATED EAPI Evas_Object                *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
586
587 /**
588  * @brief Sets the content of the hover object and the direction in which it
589  * will pop out.
590  *
591  * @param obj The hover object
592  * @param swallow The direction that the object will be displayed
593  * at. Accepted values are "left", "top-left", "top", "top-right",
594  * "right", "bottom-right", "bottom", "bottom-left", "middle" and
595  * "smart".
596  * @param content The content to place at @p swallow
597  *
598  * Once the content object is set for a given direction, a previously
599  * set one (on the same direction) will be deleted. If you want to
600  * keep that old content object, use the elm_object_part_content_unset()
601  * function.
602  *
603  * All directions may have contents at the same time, except for
604  * "smart". This is a special placement hint and its use case
605  * depends of the calculations coming from
606  * elm_hover_best_content_location_get(). Its use is for cases when
607  * one desires only one hover content, but with a dynamic special
608  * placement within the hover area. The content's geometry, whenever
609  * it changes, will be used to decide on a best location, not
610  * extrapolating the hover's parent object view to show it in (still
611  * being the hover's target determinant of its medium part -- move and
612  * resize it to simulate finger sizes, for example). If one of the
613  * directions other than "smart" are used, a previously content set
614  * using it will be deleted, and vice-versa.
615  *
616  * @deprecated Use elm_object_part_content_set() instead
617  */
618 EINA_DEPRECATED EAPI void         elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
619
620 /**
621  * @brief Get the content of the hover object, in a given direction.
622  *
623  * Return the content object which was set for this widget in the
624  * @p swallow direction.
625  *
626  * @param obj The hover object
627  * @param swallow The direction that the object was display at.
628  * @return The content that was being used
629  *
630  * @deprecated Use elm_object_part_content_get() instead
631  * @see elm_object_part_content_set()
632  */
633 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
634
635 /**
636  * @brief Unset the content of the hover object, in a given direction.
637  *
638  * Unparent and return the content object set at @p swallow direction.
639  *
640  * @param obj The hover object
641  * @param swallow The direction that the object was display at.
642  * @return The content that was being used.
643  *
644  * @deprecated Use elm_object_part_content_unset() instead
645  * @see elm_object_part_content_set()
646  */
647 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
648
649 /**
650  * @brief Set the hoversel button label
651  *
652  * @param obj The hoversel object
653  * @param label The label text.
654  *
655  * This sets the label of the button that is always visible (before it is
656  * clicked and expanded).
657  *
658  * @deprecated elm_object_text_set()
659  */
660 EINA_DEPRECATED EAPI void         elm_hoversel_label_set(Evas_Object *obj, const char *label);
661
662 /**
663  * @brief Get the hoversel button label
664  *
665  * @param obj The hoversel object
666  * @return The label text.
667  *
668  * @deprecated elm_object_text_get()
669  */
670 EINA_DEPRECATED EAPI const char  *elm_hoversel_label_get(const Evas_Object *obj);
671
672 /**
673  * @brief Set the icon of the hoversel button
674  *
675  * @param obj The hoversel object
676  * @param icon The icon object
677  *
678  * Sets the icon of the button that is always visible (before it is clicked
679  * and expanded).  Once the icon object is set, a previously set one will be
680  * deleted, if you want to keep that old content object, use the
681  * elm_hoversel_icon_unset() function.
682  *
683  * @see elm_object_content_set() for the button widget
684  * @deprecated Use elm_object_item_part_content_set() instead
685  */
686 EINA_DEPRECATED EAPI void         elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
687
688 /**
689  * @brief Get the icon of the hoversel button
690  *
691  * @param obj The hoversel object
692  * @return The icon object
693  *
694  * Get the icon of the button that is always visible (before it is clicked
695  * and expanded). Also see elm_object_content_get() for the button widget.
696  *
697  * @see elm_hoversel_icon_set()
698  * @deprecated Use elm_object_item_part_content_get() instead
699  */
700 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
701
702 /**
703  * @brief Get and unparent the icon of the hoversel button
704  *
705  * @param obj The hoversel object
706  * @return The icon object that was being used
707  *
708  * Unparent and return the icon of the button that is always visible
709  * (before it is clicked and expanded).
710  *
711  * @see elm_hoversel_icon_set()
712  * @see elm_object_content_unset() for the button widget
713  * @deprecated Use elm_object_item_part_content_unset() instead
714  */
715 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
716
717 /**
718  * @brief This returns the data pointer supplied with elm_hoversel_item_add()
719  * that will be passed to associated function callbacks.
720  *
721  * @param it The item to get the data from
722  * @return The data pointer set with elm_hoversel_item_add()
723  *
724  * @see elm_hoversel_item_add()
725  * @deprecated Use elm_object_item_data_get() instead
726  */
727 EINA_DEPRECATED EAPI void        *elm_hoversel_item_data_get(const Elm_Object_Item *it);
728
729 /**
730  * @brief This returns the label text of the given hoversel item.
731  *
732  * @param it The item to get the label
733  * @return The label text of the hoversel item
734  *
735  * @see elm_hoversel_item_add()
736  * @deprecated Use elm_object_item_text_get() instead
737  */
738 EINA_DEPRECATED EAPI const char  *elm_hoversel_item_label_get(const Elm_Object_Item *it);
739
740 /**
741  * @brief Set the function to be called when an item from the hoversel is
742  * freed.
743  *
744  * @param it The item to set the callback on
745  * @param func The function called
746  *
747  * That function will receive these parameters:
748  * @li void * item data
749  * @li Evas_Object * hoversel object
750  * @li Elm_Object_Item * hoversel item
751  *
752  * @see elm_hoversel_item_add()
753  * @deprecated Use elm_object_item_del_cb_set() instead
754  */
755 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
756
757 /**
758  * @brief Delete an item from the hoversel
759  *
760  * @param it The item to delete
761  *
762  * This deletes the item from the hoversel (should not be called while the
763  * hoversel is active; use elm_hoversel_expanded_get() to check first).
764  *
765  * @deprecated Use elm_object_item_del() instead
766  * @see elm_hoversel_item_add()
767  */
768 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del(Elm_Object_Item *it);
769
770 /**
771  * Set actionslider labels.
772  *
773  * @param obj The actionslider object
774  * @param left_label The label to be set on the left.
775  * @param center_label The label to be set on the center.
776  * @param right_label The label to be set on the right.
777  * @deprecated use elm_object_text_set() instead.
778  */
779 EINA_DEPRECATED EAPI void        elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
780
781 /**
782  * Get actionslider labels.
783  *
784  * @param obj The actionslider object
785  * @param left_label A char** to place the left_label of @p obj into.
786  * @param center_label A char** to place the center_label of @p obj into.
787  * @param right_label A char** to place the right_label of @p obj into.
788  * @deprecated use elm_object_text_set() instead.
789  */
790 EINA_DEPRECATED EAPI void        elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
791
792 /**
793  * Set the label used on the indicator.
794  *
795  * @param obj The actionslider object
796  * @param label The label to be set on the indicator.
797  * @deprecated use elm_object_text_set() instead.
798  */
799 EINA_DEPRECATED EAPI void        elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
800
801 /**
802  * Get the label used on the indicator object.
803  *
804  * @param obj The actionslider object
805  * @return The indicator label
806  * @deprecated use elm_object_text_get() instead.
807  */
808 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
809
810 /**
811  * Set the overlay object used for the background object.
812  *
813  * @param obj The bg object
814  * @param overlay The overlay object
815  *
816  * This provides a way for elm_bg to have an 'overlay' that will be on top
817  * of the bg. Once the over object is set, a previously set one will be
818  * deleted, even if you set the new one to NULL. If you want to keep that
819  * old content object, use the elm_bg_overlay_unset() function.
820  *
821  * @deprecated use elm_object_part_content_set() instead
822  *
823  * @ingroup Bg
824  */
825
826 EINA_DEPRECATED EAPI void         elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
827
828 /**
829  * Get the overlay object used for the background object.
830  *
831  * @param obj The bg object
832  * @return The content that is being used
833  *
834  * Return the content object which is set for this widget
835  *
836  * @deprecated use elm_object_part_content_get() instead
837  *
838  * @ingroup Bg
839  */
840 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
841
842 /**
843  * Get the overlay object used for the background object.
844  *
845  * @param obj The bg object
846  * @return The content that was being used
847  *
848  * Unparent and return the overlay object which was set for this widget
849  *
850  * @deprecated use elm_object_part_content_unset() instead
851  *
852  * @ingroup Bg
853  */
854 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
855
856
857 /**
858  * Set the label of the bubble
859  *
860  * @param obj The bubble object
861  * @param label The string to set in the label
862  *
863  * This function sets the title of the bubble. Where this appears depends on
864  * the selected corner.
865  * @deprecated use elm_object_text_set() instead.
866  */
867 EINA_DEPRECATED EAPI void         elm_bubble_label_set(Evas_Object *obj, const char *label);
868
869 /**
870  * Get the label of the bubble
871  *
872  * @param obj The bubble object
873  * @return The string of set in the label
874  *
875  * This function gets the title of the bubble.
876  * @deprecated use elm_object_text_get() instead.
877  */
878 EINA_DEPRECATED EAPI const char  *elm_bubble_label_get(const Evas_Object *obj);
879
880 /**
881  * Set the info of the bubble
882  *
883  * @param obj The bubble object
884  * @param info The given info about the bubble
885  *
886  * This function sets the info of the bubble. Where this appears depends on
887  * the selected corner.
888  * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
889  */
890 EINA_DEPRECATED EAPI void         elm_bubble_info_set(Evas_Object *obj, const char *info);
891
892 /**
893  * Get the info of the bubble
894  *
895  * @param obj The bubble object
896  *
897  * @return The "info" string of the bubble
898  *
899  * This function gets the info text.
900  * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
901  */
902 EINA_DEPRECATED EAPI const char  *elm_bubble_info_get(const Evas_Object *obj);
903
904 /**
905  * Set the content to be shown in the bubble
906  *
907  * Once the content object is set, a previously set one will be deleted.
908  * If you want to keep the old content object, use the
909  * elm_bubble_content_unset() function.
910  *
911  * @param obj The bubble object
912  * @param content The given content of the bubble
913  *
914  * This function sets the content shown on the middle of the bubble.
915  *
916  * @deprecated use elm_object_content_set() instead
917  *
918  */
919 EINA_DEPRECATED EAPI void         elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
920
921 /**
922  * Get the content shown in the bubble
923  *
924  * Return the content object which is set for this widget.
925  *
926  * @param obj The bubble object
927  * @return The content that is being used
928  *
929  * @deprecated use elm_object_content_get() instead
930  *
931  */
932 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
933
934 /**
935  * Unset the content shown in the bubble
936  *
937  * Unparent and return the content object which was set for this widget.
938  *
939  * @param obj The bubble object
940  * @return The content that was being used
941  *
942  * @deprecated use elm_object_content_unset() instead
943  *
944  */
945 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
946
947 /**
948  * Set the icon of the bubble
949  *
950  * Once the icon object is set, a previously set one will be deleted.
951  * If you want to keep the old content object, use the
952  * elm_icon_content_unset() function.
953  *
954  * @param obj The bubble object
955  * @param icon The given icon for the bubble
956  *
957  * @deprecated use elm_object_part_content_set() instead
958  *
959  */
960 EINA_DEPRECATED EAPI void         elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
961
962 /**
963  * Get the icon of the bubble
964  *
965  * @param obj The bubble object
966  * @return The icon for the bubble
967  *
968  * This function gets the icon shown on the top left of bubble.
969  *
970  * @deprecated use elm_object_part_content_get() instead
971  *
972  */
973 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
974
975 /**
976  * Unset the icon of the bubble
977  *
978  * Unparent and return the icon object which was set for this widget.
979  *
980  * @param obj The bubble object
981  * @return The icon that was being used
982  *
983  * @deprecated use elm_object_part_content_unset() instead
984  *
985  */
986 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
987
988
989 /**
990  * Set the label used in the button
991  *
992  * The passed @p label can be NULL to clean any existing text in it and
993  * leave the button as an icon only object.
994  *
995  * @param obj The button object
996  * @param label The text will be written on the button
997  * @deprecated use elm_object_text_set() instead.
998  */
999 EINA_DEPRECATED EAPI void         elm_button_label_set(Evas_Object *obj, const char *label);
1000
1001 /**
1002  * Get the label set for the button
1003  *
1004  * The string returned is an internal pointer and should not be freed or
1005  * altered. It will also become invalid when the button is destroyed.
1006  * The string returned, if not NULL, is a stringshare, so if you need to
1007  * keep it around even after the button is destroyed, you can use
1008  * eina_stringshare_ref().
1009  *
1010  * @param obj The button object
1011  * @return The text set to the label, or NULL if nothing is set
1012  * @deprecated use elm_object_text_set() instead.
1013  */
1014 EINA_DEPRECATED EAPI const char  *elm_button_label_get(const Evas_Object *obj);
1015
1016 /**
1017  * Set the icon used for the button
1018  *
1019  * Setting a new icon will delete any other that was previously set, making
1020  * any reference to them invalid. If you need to maintain the previous
1021  * object alive, unset it first with elm_button_icon_unset().
1022  *
1023  * @param obj The button object
1024  * @param icon The icon object for the button
1025  * @deprecated use elm_object_part_content_set() instead.
1026  */
1027 EINA_DEPRECATED EAPI void         elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1028
1029 /**
1030  * Get the icon used for the button
1031  *
1032  * Return the icon object which is set for this widget. If the button is
1033  * destroyed or another icon is set, the returned object will be deleted
1034  * and any reference to it will be invalid.
1035  *
1036  * @param obj The button object
1037  * @return The icon object that is being used
1038  *
1039  * @deprecated use elm_object_part_content_get() instead
1040  */
1041 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1042
1043 /**
1044  * Remove the icon set without deleting it and return the object
1045  *
1046  * This function drops the reference the button holds of the icon object
1047  * and returns this last object. It is used in case you want to remove any
1048  * icon, or set another one, without deleting the actual object. The button
1049  * will be left without an icon set.
1050  *
1051  * @param obj The button object
1052  * @return The icon object that was being used
1053  * @deprecated use elm_object_part_content_unset() instead.
1054  */
1055 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1056
1057 /**
1058  * Set a day text color to the same that represents Saturdays.
1059  *
1060  * @param obj The calendar object.
1061  * @param pos The text position. Position is the cell counter, from left
1062  * to right, up to down. It starts on 0 and ends on 41.
1063  *
1064  * @deprecated use elm_calendar_mark_add() instead like:
1065  *
1066  * @code
1067  * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1068  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1069  * @endcode
1070  *
1071  * @see elm_calendar_mark_add()
1072  *
1073  * @ingroup Calendar
1074  */
1075 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1076
1077 /**
1078  * Set a day text color to the same that represents Sundays.
1079  *
1080  * @param obj The calendar object.
1081  * @param pos The text position. Position is the cell counter, from left
1082  * to right, up to down. It starts on 0 and ends on 41.
1083
1084  * @deprecated use elm_calendar_mark_add() instead like:
1085  *
1086  * @code
1087  * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1088  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1089  * @endcode
1090  *
1091  * @see elm_calendar_mark_add()
1092  *
1093  * @ingroup Calendar
1094  */
1095 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1096
1097 /**
1098  * Set a day text color to the same that represents Weekdays.
1099  *
1100  * @param obj The calendar object
1101  * @param pos The text position. Position is the cell counter, from left
1102  * to right, up to down. It starts on 0 and ends on 41.
1103  *
1104  * @deprecated use elm_calendar_mark_add() instead like:
1105  *
1106  * @code
1107  * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1108  *
1109  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1110  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1111  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1112  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1113  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1114  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1115  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1116  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1117  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1118  * @endcode
1119  *
1120  * @see elm_calendar_mark_add()
1121  *
1122  * @ingroup Calendar
1123  */
1124 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1125
1126
1127 /**
1128  * @brief Set the text label of the check object
1129  *
1130  * @param obj The check object
1131  * @param label The text label string in UTF-8
1132  *
1133  * @deprecated use elm_object_text_set() instead.
1134  */
1135 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
1136
1137 /**
1138  * @brief Get the text label of the check object
1139  *
1140  * @param obj The check object
1141  * @return The text label string in UTF-8
1142  *
1143  * @deprecated use elm_object_text_get() instead.
1144  */
1145 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
1146
1147 /**
1148  * @brief Set the icon object of the check object
1149  *
1150  * @param obj The check object
1151  * @param icon The icon object
1152  *
1153  * Once the icon object is set, a previously set one will be deleted.
1154  * If you want to keep that old content object, use the
1155  * elm_object_content_unset() function.
1156  *
1157  * @deprecated use elm_object_part_content_set() instead.
1158  *
1159  */
1160 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1161
1162 /**
1163  * @brief Get the icon object of the check object
1164  *
1165  * @param obj The check object
1166  * @return The icon object
1167  *
1168  * @deprecated use elm_object_part_content_get() instead.
1169  *
1170  */
1171 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1172
1173 /**
1174  * @brief Unset the icon used for the check object
1175  *
1176  * @param obj The check object
1177  * @return The icon object that was being used
1178  *
1179  * Unparent and return the icon object which was set for this widget.
1180  *
1181  * @deprecated use elm_object_part_content_unset() instead.
1182  *
1183  */
1184 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1185
1186 /**
1187  * @brief Set the text label of the check object
1188  *
1189  * @param obj The check object
1190  * @param label The text label string in UTF-8
1191  *
1192  * @deprecated use elm_object_text_set() instead.
1193  */
1194 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
1195
1196 /**
1197  * @brief Get the text label of the check object
1198  *
1199  * @param obj The check object
1200  * @return The text label string in UTF-8
1201  *
1202  * @deprecated use elm_object_text_get() instead.
1203  */
1204 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
1205
1206 /**
1207  * @brief Set the icon object of the check object
1208  *
1209  * @param obj The check object
1210  * @param icon The icon object
1211  *
1212  * Once the icon object is set, a previously set one will be deleted.
1213  * If you want to keep that old content object, use the
1214  * elm_object_content_unset() function.
1215  *
1216  * @deprecated use elm_object_part_content_set() instead.
1217  *
1218  */
1219 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1220
1221 /**
1222  * @brief Get the icon object of the check object
1223  *
1224  * @param obj The check object
1225  * @return The icon object
1226  *
1227  * @deprecated use elm_object_part_content_get() instead.
1228  *
1229  */
1230 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1231
1232 /**
1233  * @brief Unset the icon used for the check object
1234  *
1235  * @param obj The check object
1236  * @return The icon object that was being used
1237  *
1238  * Unparent and return the icon object which was set for this widget.
1239  *
1240  * @deprecated use elm_object_part_content_unset() instead.
1241  *
1242  */
1243 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1244
1245 EINA_DEPRECATED EAPI void         elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1246 EINA_DEPRECATED EAPI void         elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1247
1248
1249 /**
1250  * Set the content of the conformant widget.
1251  *
1252  * @param obj The conformant object.
1253  * @param content The content to be displayed by the conformant.
1254  *
1255  * Content will be sized and positioned considering the space required
1256  * to display a virtual keyboard. So it won't fill all the conformant
1257  * size. This way is possible to be sure that content won't resize
1258  * or be re-positioned after the keyboard is displayed.
1259  *
1260  * Once the content object is set, a previously set one will be deleted.
1261  * If you want to keep that old content object, use the
1262  * elm_object_content_unset() function.
1263  *
1264  * @see elm_object_content_unset()
1265  * @see elm_object_content_get()
1266  *
1267  * @deprecated use elm_object_content_set() instead
1268  *
1269  * @ingroup Conformant
1270  */
1271 EINA_DEPRECATED EAPI void         elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1272
1273 /**
1274  * Get the content of the conformant widget.
1275  *
1276  * @param obj The conformant object.
1277  * @return The content that is being used.
1278  *
1279  * Return the content object which is set for this widget.
1280  * It won't be unparent from conformant. For that, use
1281  * elm_object_content_unset().
1282  *
1283  * @see elm_object_content_set().
1284  * @see elm_object_content_unset()
1285  *
1286  * @deprecated use elm_object_content_get() instead
1287  *
1288  * @ingroup Conformant
1289  */
1290 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1291
1292 /**
1293  * Unset the content of the conformant widget.
1294  *
1295  * @param obj The conformant object.
1296  * @return The content that was being used.
1297  *
1298  * Unparent and return the content object which was set for this widget.
1299  *
1300  * @see elm_object_content_set().
1301  *
1302  * @deprecated use elm_object_content_unset() instead
1303  *
1304  * @ingroup Conformant
1305  */
1306 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1307
1308 /**
1309  * Get the side labels max length.
1310  *
1311  * @deprecated use elm_diskselector_side_label_length_get() instead:
1312  *
1313  * @param obj The diskselector object.
1314  * @return The max length defined for side labels, or 0 if not a valid
1315  * diskselector.
1316  *
1317  * @ingroup Diskselector
1318  */
1319 EINA_DEPRECATED EAPI int    elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1320
1321 /**
1322  * Set the side labels max length.
1323  *
1324  * @deprecated use elm_diskselector_side_label_length_set() instead:
1325  *
1326  * @param obj The diskselector object.
1327  * @param len The max length defined for side labels.
1328  *
1329  * @ingroup Diskselector
1330  */
1331 EINA_DEPRECATED EAPI void   elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1332
1333 /**
1334  * Get the data associated to the item.
1335  *
1336  * @param it The diskselector item
1337  * @return The data associated to @p it
1338  *
1339  * The return value is a pointer to data associated to @p item when it was
1340  * created, with function elm_diskselector_item_append(). If no data
1341  * was passed as argument, it will return @c NULL.
1342  *
1343  * @see elm_diskselector_item_append()
1344  * @deprecated Use elm_object_item_data_get()
1345  *
1346  * @ingroup Diskselector
1347  */
1348 EINA_DEPRECATED EAPI void                  *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1349
1350 /**
1351  * Set the icon associated to the item.
1352  *
1353  * @param it The diskselector item
1354  * @param icon The icon object to associate with @p it
1355  *
1356  * The icon object to use at left side of the item. An
1357  * icon can be any Evas object, but usually it is an icon created
1358  * with elm_icon_add().
1359  *
1360  * Once the icon object is set, a previously set one will be deleted.
1361  * @warning Setting the same icon for two items will cause the icon to
1362  * disappear from the first item.
1363  *
1364  * If an icon was passed as argument on item creation, with function
1365  * elm_diskselector_item_append(), it will be already
1366  * associated to the item.
1367  *
1368  * @see elm_diskselector_item_append()
1369  * @see elm_diskselector_item_icon_get()
1370  *
1371  * @deprecated Use elm_object_item_part_content_set() instead
1372  * @ingroup Diskselector
1373  */
1374 EINA_DEPRECATED EAPI void                   elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1375
1376 /**
1377  * Get the icon associated to the item.
1378  *
1379  * @param item The diskselector item
1380  * @return The icon associated to @p it
1381  *
1382  * The return value is a pointer to the icon associated to @p item when it was
1383  * created, with function elm_diskselector_item_append(), or later
1384  * with function elm_diskselector_item_icon_set. If no icon
1385  * was passed as argument, it will return @c NULL.
1386  *
1387  * @see elm_diskselector_item_append()
1388  * @see elm_diskselector_item_icon_set()
1389  *
1390  * @deprecated Use elm_object_item_part_content_set() instead
1391  * @ingroup Diskselector
1392  */
1393 EAPI Evas_Object           *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1394
1395 /**
1396  * Set the label of item.
1397  *
1398  * @param it The item of diskselector.
1399  * @param label The label of item.
1400  *
1401  * The label to be displayed by the item.
1402  *
1403  * If no icon is set, label will be centered on item position, otherwise
1404  * the icon will be placed at left of the label, that will be shifted
1405  * to the right.
1406  *
1407  * An item with label "January" would be displayed on side position as
1408  * "Jan" if max length is set to 3 with function
1409  * elm_diskselector_side_label_length_set(), or "Janu", if this property
1410  * is set to 4.
1411  *
1412  * When this @p item is selected, the entire label will be displayed,
1413  * except for width restrictions.
1414  * In this case label will be cropped and "..." will be concatenated,
1415  * but only for display purposes. It will keep the entire string, so
1416  * if diskselector is resized the remaining characters will be displayed.
1417  *
1418  * If a label was passed as argument on item creation, with function
1419  * elm_diskselector_item_append(), it will be already
1420  * displayed by the item.
1421  *
1422  * @see elm_diskselector_side_label_length_set()
1423  * @see elm_diskselector_item_label_get()
1424  * @see elm_diskselector_item_append()
1425  *
1426  * @deprecated Use elm_object_item_text_set() instead
1427  * @ingroup Diskselector
1428  */
1429 EINA_DEPRECATED EAPI void                   elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1430
1431 /**
1432  * Get the label of item.
1433  *
1434  * @param it The item of diskselector.
1435  * @return The label of item.
1436  *
1437  * The return value is a pointer to the label associated to @p item when it was
1438  * created, with function elm_diskselector_item_append(), or later
1439  * with function elm_diskselector_item_label_set. If no label
1440  * was passed as argument, it will return @c NULL.
1441  *
1442  * @see elm_diskselector_item_label_set() for more details.
1443  * @see elm_diskselector_item_append()
1444  * @use elm_object_item_text_get()
1445  *
1446  * @ingroup Diskselector
1447  */
1448 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1449
1450 /**
1451  * Set the function called when a diskselector item is freed.
1452  *
1453  * @param it The item to set the callback on
1454  * @param func The function called
1455  *
1456  * If there is a @p func, then it will be called prior item's memory release.
1457  * That will be called with the following arguments:
1458  * @li item's data;
1459  * @li item's Evas object;
1460  * @li item itself;
1461  *
1462  * This way, a data associated to a diskselector item could be properly
1463  * freed.
1464  * @deprecated Use elm_object_item_del_cb_set() instead
1465  *
1466  * @ingroup Diskselector
1467  */
1468 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1469
1470 /**
1471  * Delete them item from the diskselector.
1472  *
1473  * @param it The item of diskselector to be deleted.
1474  *
1475  * If deleting all diskselector items is required, elm_diskselector_clear()
1476  * should be used instead of getting items list and deleting each one.
1477  *
1478  * @deprecated Use elm_object_item_del() instead
1479  * @see elm_diskselector_clear()
1480  * @see elm_diskselector_item_append()
1481  *
1482  * @ingroup Diskselector
1483  */
1484 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del(Elm_Object_Item *it);
1485
1486 /**
1487  * Set the text to be shown in the diskselector item.
1488  *
1489  * @param it Target item
1490  * @param text The text to set in the content
1491  *
1492  * Setup the text as tooltip to object. The item can have only one tooltip,
1493  * so any previous tooltip data is removed.
1494  *
1495  * @deprecated Use elm_object_item_tooltip_text_set() instead
1496  * @see elm_object_tooltip_text_set() for more details.
1497  *
1498  * @ingroup Diskselector
1499  */
1500 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1501
1502 /**
1503  * Set the content to be shown in the tooltip item.
1504  *
1505  * Setup the tooltip to item. The item can have only one tooltip,
1506  * so any previous tooltip data is removed. @p func(with @p data) will
1507  * be called every time that need show the tooltip and it should
1508  * return a valid Evas_Object. This object is then managed fully by
1509  * tooltip system and is deleted when the tooltip is gone.
1510  *
1511  * @param it the diskselector item being attached a tooltip.
1512  * @param func the function used to create the tooltip contents.
1513  * @param data what to provide to @a func as callback data/context.
1514  * @param del_cb called when data is not needed anymore, either when
1515  *        another callback replaces @p func, the tooltip is unset with
1516  *        elm_diskselector_item_tooltip_unset() or the owner @a item
1517  *        dies. This callback receives as the first parameter the
1518  *        given @a data, and @c event_info is the item.
1519  *
1520  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1521  * @see elm_object_tooltip_content_cb_set() for more details.
1522  *
1523  * @ingroup Diskselector
1524  */
1525 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);
1526
1527 /**
1528  * Unset tooltip from item.
1529  *
1530  * @param it diskselector item to remove previously set tooltip.
1531  *
1532  * Remove tooltip from item. The callback provided as del_cb to
1533  * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1534  * it is not used anymore.
1535  *
1536  * @deprecated Use elm_object_item_tooltip_unset() instead
1537  * @see elm_object_tooltip_unset() for more details.
1538  * @see elm_diskselector_item_tooltip_content_cb_set()
1539  *
1540  * @ingroup Diskselector
1541  */
1542 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1543
1544 /**
1545  * Sets a different style for this item tooltip.
1546  *
1547  * @note before you set a style you should define a tooltip with
1548  *       elm_diskselector_item_tooltip_content_cb_set() or
1549  *       elm_diskselector_item_tooltip_text_set()
1550  *
1551  * @param it diskselector item with tooltip already set.
1552  * @param style the theme style to use (default, transparent, ...)
1553  *
1554  * @deprecated Use elm_object_item_tooltip_style_set() instead
1555  * @see elm_object_tooltip_style_set() for more details.
1556  *
1557  * @ingroup Diskselector
1558  */
1559 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1560
1561 /**
1562  * Get the style for this item tooltip.
1563  *
1564  * @param it diskselector item with tooltip already set.
1565  * @return style the theme style in use, defaults to "default". If the
1566  *         object does not have a tooltip set, then NULL is returned.
1567  *
1568  * @deprecated Use elm_object_item_tooltip_style_get() instead
1569  * @see elm_object_tooltip_style_get() for more details.
1570  * @see elm_diskselector_item_tooltip_style_set()
1571  *
1572  * @ingroup Diskselector
1573  */
1574 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1575
1576 /**
1577  * Set the cursor to be shown when mouse is over the diskselector item
1578  *
1579  * @param it Target item
1580  * @param cursor the cursor name to be used.
1581  *
1582  * @see elm_object_cursor_set() for more details.
1583  * @deprecated Use elm_object_item_cursor_set() instead
1584  *
1585  * @ingroup Diskselector
1586  */
1587 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1588
1589 /**
1590  * Get the cursor to be shown when mouse is over the diskselector item
1591  *
1592  * @param it diskselector item with cursor already set.
1593  * @return the cursor name.
1594  *
1595  * @see elm_object_cursor_get() for more details.
1596  * @see elm_diskselector_cursor_set()
1597  * @deprecated Use elm_object_item_cursor_get() instead
1598  *
1599  * @ingroup Diskselector
1600  */
1601 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1602
1603 /**
1604  * Unset the cursor to be shown when mouse is over the diskselector item
1605  *
1606  * @param it Target item
1607  *
1608  * @see elm_object_cursor_unset() for more details.
1609  * @see elm_diskselector_cursor_set()
1610  * @deprecated use elm_object_item_cursor_unset() instead
1611  *
1612  * @ingroup Diskselector
1613  */
1614 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1615
1616 /**
1617  * Sets a different style for this item cursor.
1618  *
1619  * @note before you set a style you should define a cursor with
1620  *       elm_diskselector_item_cursor_set()
1621  *
1622  * @param it diskselector item with cursor already set.
1623  * @param style the theme style to use (default, transparent, ...)
1624  *
1625  * @see elm_object_cursor_style_set() for more details.
1626  * @deprecated Use elm_object_item_cursor_style_set() instead
1627  *
1628  * @ingroup Diskselector
1629  */
1630 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1631
1632 /**
1633  * Get the style for this item cursor.
1634  *
1635  * @param it diskselector item with cursor already set.
1636  * @return style the theme style in use, defaults to "default". If the
1637  *         object does not have a cursor set, then @c NULL is returned.
1638  *
1639  * @see elm_object_cursor_style_get() for more details.
1640  * @see elm_diskselector_item_cursor_style_set()
1641  * @deprecated Use elm_object_item_cursor_style_get() instead
1642  *
1643  * @ingroup Diskselector
1644  */
1645 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1646
1647 /**
1648  * Set if the cursor set should be searched on the theme or should use
1649  * the provided by the engine, only.
1650  *
1651  * @note before you set if should look on theme you should define a cursor
1652  * with elm_diskselector_item_cursor_set().
1653  * By default it will only look for cursors provided by the engine.
1654  *
1655  * @param it widget item with cursor already set.
1656  * @param engine_only boolean to define if cursors set with
1657  * elm_diskselector_item_cursor_set() should be searched only
1658  * between cursors provided by the engine or searched on widget's
1659  * theme as well.
1660  *
1661  * @see elm_object_cursor_engine_only_set() for more details.
1662  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1663  *
1664  * @ingroup Diskselector
1665  */
1666 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1667
1668 /**
1669  * Get the cursor engine only usage for this item cursor.
1670  *
1671  * @param it widget item with cursor already set.
1672  * @return engine_only boolean to define it cursors should be looked only
1673  * between the provided by the engine or searched on widget's theme as well.
1674  * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1675  *
1676  * @see elm_object_cursor_engine_only_get() for more details.
1677  * @see elm_diskselector_item_cursor_engine_only_set()
1678  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1679  *
1680  * @ingroup Diskselector
1681  */
1682 EINA_DEPRECATED EAPI Eina_Bool              elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1683
1684 EINA_DEPRECATED EAPI void         elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1685 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1686
1687 /**
1688  * Get the label of a given flip selector widget's item.
1689  *
1690  * @param it The item to get label from
1691  * @return The text label of @p item or @c NULL, on errors
1692  *
1693  * @see elm_object_item_text_set()
1694  *
1695  * @deprecated see elm_object_item_text_get() instead
1696  * @ingroup Flipselector
1697  */
1698 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1699
1700 /**
1701  * Set the label of a given flip selector widget's item.
1702  *
1703  * @param it The item to set label on
1704  * @param label The text label string, in UTF-8 encoding
1705  *
1706  * @see elm_object_item_text_get()
1707  *
1708  * @deprecated see elm_object_item_text_set() instead
1709  * @ingroup Flipselector
1710  */
1711 EINA_DEPRECATED EAPI void        elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1712
1713 /**
1714  * Delete a given item from a flip selector widget.
1715  *
1716  * @param it The item to delete
1717  *
1718  * @deprecated Use elm_object_item_del() instead
1719  * @ingroup Flipselector
1720  */
1721 EINA_DEPRECATED EAPI void       elm_flipselector_item_del(Elm_Object_Item *it);
1722
1723 /**
1724  * Make a given Elementary object the focused one.
1725  *
1726  * @param obj The Elementary object to make focused.
1727  *
1728  * @note This object, if it can handle focus, will take the focus
1729  * away from the one who had it previously and will, for now on, be
1730  * the one receiving input events.
1731  *
1732  * @see elm_object_focus_get()
1733  * @deprecated use elm_object_focus_set() instead.
1734  *
1735  * @ingroup Focus
1736  */
1737 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1738
1739 /**
1740  * Remove the focus from an Elementary object
1741  *
1742  * @param obj The Elementary to take focus from
1743  *
1744  * This removes the focus from @p obj, passing it back to the
1745  * previous element in the focus chain list.
1746  *
1747  * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1748  * @deprecated use elm_object_focus_set() instead.
1749  *
1750  * @ingroup Focus
1751  */
1752 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1753
1754 /**
1755  * @brief Set the frame label
1756  *
1757  * @param obj The frame object
1758  * @param label The label of this frame object
1759  *
1760  * @deprecated use elm_object_text_set() instead.
1761  */
1762 EINA_DEPRECATED EAPI void         elm_frame_label_set(Evas_Object *obj, const char *label);
1763
1764 /**
1765  * @brief Get the frame label
1766  *
1767  * @param obj The frame object
1768  *
1769  * @return The label of this frame object or NULL if unable to get frame
1770  *
1771  * @deprecated use elm_object_text_get() instead.
1772  */
1773 EINA_DEPRECATED EAPI const char  *elm_frame_label_get(const Evas_Object *obj);
1774
1775 /**
1776  * @brief Set the content of the frame widget
1777  *
1778  * Once the content object is set, a previously set one will be deleted.
1779  * If you want to keep that old content object, use the
1780  * elm_frame_content_unset() function.
1781  *
1782  * @param obj The frame object
1783  * @param content The content will be filled in this frame object
1784  *
1785  * @deprecated use elm_object_content_set() instead.
1786  */
1787 EINA_DEPRECATED EAPI void         elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1788
1789 /**
1790  * @brief Get the content of the frame widget
1791  *
1792  * Return the content object which is set for this widget
1793  *
1794  * @param obj The frame object
1795  * @return The content that is being used
1796  *
1797  * @deprecated use elm_object_content_get() instead.
1798  */
1799 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1800
1801 /**
1802  * @brief Unset the content of the frame widget
1803  *
1804  * Unparent and return the content object which was set for this widget
1805  *
1806  * @param obj The frame object
1807  * @return The content that was being used
1808  *
1809  * @deprecated use elm_object_content_unset() instead.
1810  */
1811 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1812
1813 EINA_DEPRECATED EAPI void          elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1814 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1815 EINA_DEPRECATED EAPI void          elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1816 /**
1817  * This sets the horizontal stretching mode.
1818  *
1819  * @param obj The genlist object
1820  * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1821  *
1822  * This sets the mode used for sizing items horizontally. Valid modes
1823  * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1824  * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1825  * the scroller will scroll horizontally. Otherwise items are expanded
1826  * to fill the width of the viewport of the scroller. If it is
1827  * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1828  * limited to that size.
1829  *
1830  * @see elm_genlist_horizontal_get()
1831  *
1832  * @deprecated use elm_genlist_mode_set()
1833  * @ingroup Genlist
1834  */
1835 EINA_DEPRECATED EAPI void                          elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1836
1837 /**
1838  * Gets the horizontal stretching mode.
1839  *
1840  * @param obj The genlist object
1841  * @return The mode to use
1842  * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1843  *
1844  * @see elm_genlist_horizontal_set()
1845  *
1846  * @deprecated use elm_genlist_mode_get()
1847  * @ingroup Genlist
1848  */
1849 EINA_DEPRECATED EAPI Elm_List_Mode                 elm_genlist_horizontal_get(const Evas_Object *obj);
1850
1851 /**
1852  * Return the data associated to a given genlist item
1853  *
1854  * @param it The genlist item.
1855  * @return the data associated to this item.
1856  *
1857  * This returns the @c data value passed on the
1858  * elm_genlist_item_append() and related item addition calls.
1859  *
1860  * @see elm_genlist_item_append()
1861  * @see elm_genlist_item_data_set()
1862  *
1863  * @deprecated Use elm_object_item_data_get() instead
1864  * @ingroup Genlist
1865  */
1866 EINA_DEPRECATED EAPI void                         *elm_genlist_item_data_get(const Elm_Object_Item *it);
1867
1868 /**
1869  * Set the data associated to a given genlist item
1870  *
1871  * @param it The genlist item
1872  * @param data The new data pointer to set on it
1873  *
1874  * This @b overrides the @c data value passed on the
1875  * elm_genlist_item_append() and related item addition calls. This
1876  * function @b won't call elm_genlist_item_update() automatically,
1877  * so you'd issue it afterwards if you want to hove the item
1878  * updated to reflect the that new data.
1879  *
1880  * @see elm_genlist_item_data_get()
1881  *
1882  * @deprecated Use elm_object_item_data_set() instead
1883  * @ingroup Genlist
1884  */
1885 EINA_DEPRECATED EAPI void                          elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
1886
1887 /**
1888  * Set whether a given genlist item is disabled or not.
1889  *
1890  * @param it The item
1891  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
1892  * to enable it back.
1893  *
1894  * A disabled item cannot be selected or unselected. It will also
1895  * change its appearance, to signal the user it's disabled.
1896  *
1897  * @see elm_genlist_item_disabled_get()
1898  * @deprecated Use elm_object_item_disabled_set() instead
1899  *
1900  * @ingroup Genlist
1901  */
1902 EINA_DEPRECATED EAPI void                          elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1903
1904 /**
1905  * Get whether a given genlist item is disabled or not.
1906  *
1907  * @param it The item
1908  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
1909  * (and on errors).
1910  *
1911  * @see elm_genlist_item_disabled_set() for more details
1912  * @deprecated Use elm_object_item_disabled_get() instead
1913  *
1914  * @ingroup Genlist
1915  */
1916 EINA_DEPRECATED EAPI Eina_Bool                     elm_genlist_item_disabled_get(const Elm_Object_Item *it);
1917
1918 /**
1919  * Remove a genlist item from the its parent, deleting it.
1920  *
1921  * @param it The item to be removed.
1922  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
1923  *
1924  * @see elm_genlist_clear(), to remove all items in a genlist at
1925  * once.
1926  *
1927  * @deprecated Use elm_object_item_del() instead
1928  * @ingroup Genlist
1929  */
1930 EINA_DEPRECATED EAPI void                          elm_genlist_item_del(Elm_Object_Item *it);
1931
1932 /**
1933  * Get the genlist object's handle which contains a given genlist
1934  * item
1935  *
1936  * @param it The item to fetch the container from
1937  * @return The genlist (parent) object
1938  *
1939  * This returns the genlist object itself that an item belongs to.
1940  * @deprecated Use elm_object_item_widget_get() instead
1941  *
1942  * @ingroup Genlist
1943  */
1944 EINA_DEPRECATED EAPI Evas_Object                  *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
1945
1946
1947 #define ELM_IMAGE_ROTATE_90_CW 1
1948 #define ELM_IMAGE_ROTATE_180_CW 2
1949 #define ELM_IMAGE_ROTATE_90_CCW 3
1950
1951 /**
1952  * Return the data associated with a given index widget item
1953  *
1954  * @param it The index widget item handle
1955  * @return The data associated with @p it
1956  * @deprecated Use elm_object_item_data_get() instead
1957  *
1958  * @see elm_index_item_data_set()
1959  *
1960  * @ingroup Index
1961  */
1962 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1963
1964 /**
1965  * Set the data associated with a given index widget item
1966  *
1967  * @param it The index widget item handle
1968  * @param data The new data pointer to set to @p it
1969  *
1970  * This sets new item data on @p it.
1971  *
1972  * @warning The old data pointer won't be touched by this function, so
1973  * the user had better to free that old data himself/herself.
1974  *
1975  * @deprecated Use elm_object_item_data_set() instead
1976  * @ingroup Index
1977  */
1978 EINA_DEPRECATED EAPI void  elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1979
1980 /**
1981  * Set the function to be called when a given index widget item is freed.
1982  *
1983  * @param it The item to set the callback on
1984  * @param func The function to call on the item's deletion
1985  *
1986  * When called, @p func will have both @c data and @c event_info
1987  * arguments with the @p it item's data value and, naturally, the
1988  * @c obj argument with a handle to the parent index widget.
1989  *
1990  * @deprecated Use elm_object_item_del_cb_set() instead
1991  * @ingroup Index
1992  */
1993 EINA_DEPRECATED EAPI void                  elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1994
1995 /**
1996  * Remove an item from a given index widget, <b>to be referenced by
1997  * it's data value</b>.
1998  *
1999  * @param obj The index object
2000  * @param item The item to be removed from @p obj
2001  *
2002  * If a deletion callback is set, via elm_object_item_del_cb_set(),
2003  * that callback function will be called by this one.
2004  *
2005  * @deprecated Use elm_object_item_del() instead
2006  * @ingroup Index
2007  */
2008 EINA_DEPRECATED EAPI void                  elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2009
2010 /**
2011 * @brief Set the label on the label object
2012  *
2013  * @param obj The label object
2014  * @param label The label will be used on the label object
2015  * @deprecated See elm_object_text_set()
2016  */
2017 EINA_DEPRECATED EAPI void        elm_label_label_set(Evas_Object *obj, const char *label);
2018
2019 /**
2020  * @brief Get the label used on the label object
2021  *
2022  * @param obj The label object
2023  * @return The string inside the label
2024  * @deprecated See elm_object_text_get()
2025  */
2026 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2027
2028
2029 /**
2030  * Set the layout content.
2031  *
2032  * @param obj The layout object
2033  * @param swallow The swallow part name in the edje file
2034  * @param content The child that will be added in this layout object
2035  *
2036  * Once the content object is set, a previously set one will be deleted.
2037  * If you want to keep that old content object, use the
2038  * elm_object_part_content_unset() function.
2039  *
2040  * @note In an Edje theme, the part used as a content container is called @c
2041  * SWALLOW. This is why the parameter name is called @p swallow, but it is
2042  * expected to be a part name just like the second parameter of
2043  * elm_layout_box_append().
2044  *
2045  * @see elm_layout_box_append()
2046  * @see elm_object_part_content_get()
2047  * @see elm_object_part_content_unset()
2048  * @see @ref secBox
2049  * @deprecated use elm_object_part_content_set() instead
2050  *
2051  * @ingroup Layout
2052  */
2053 EINA_DEPRECATED EAPI void         elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2054
2055 /**
2056  * Get the child object in the given content part.
2057  *
2058  * @param obj The layout object
2059  * @param swallow The SWALLOW part to get its content
2060  *
2061  * @return The swallowed object or NULL if none or an error occurred
2062  *
2063  * @deprecated use elm_object_part_content_get() instead
2064  *
2065  * @ingroup Layout
2066  */
2067 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2068
2069 /**
2070  * Unset the layout content.
2071  *
2072  * @param obj The layout object
2073  * @param swallow The swallow part name in the edje file
2074  * @return The content that was being used
2075  *
2076  * Unparent and return the content object which was set for this part.
2077  *
2078  * @deprecated use elm_object_part_content_unset() instead
2079  *
2080  * @ingroup Layout
2081  */
2082 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2083
2084 /**
2085  * Set the text of the given part
2086  *
2087  * @param obj The layout object
2088  * @param part The TEXT part where to set the text
2089  * @param text The text to set
2090  *
2091  * @ingroup Layout
2092  * @deprecated use elm_object_part_text_set() instead.
2093  */
2094 EINA_DEPRECATED EAPI void         elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2095
2096 /**
2097  * Get the text set in the given part
2098  *
2099  * @param obj The layout object
2100  * @param part The TEXT part to retrieve the text off
2101  *
2102  * @return The text set in @p part
2103  *
2104  * @ingroup Layout
2105  * @deprecated use elm_object_part_text_get() instead.
2106  */
2107 EINA_DEPRECATED EAPI const char  *elm_layout_text_get(const Evas_Object *obj, const char *part);
2108
2109 /**
2110  * @def elm_layout_label_set
2111  * Convenience macro to set the label in a layout that follows the
2112  * Elementary naming convention for its parts.
2113  *
2114  * @ingroup Layout
2115  * @deprecated use elm_object_text_set() instead.
2116  */
2117 #define elm_layout_label_set(_ly, _txt) \
2118   elm_layout_text_set((_ly), "elm.text", (_txt))
2119
2120 /**
2121  * @def elm_layout_label_get
2122  * Convenience macro to get the label in a layout that follows the
2123  * Elementary naming convention for its parts.
2124  *
2125  * @ingroup Layout
2126  * @deprecated use elm_object_text_set() instead.
2127  */
2128 #define elm_layout_label_get(_ly) \
2129   elm_layout_text_get((_ly), "elm.text")
2130
2131 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2132
2133
2134 /**
2135  * Set the content of the mapbuf.
2136  *
2137  * @param obj The mapbuf object.
2138  * @param content The content that will be filled in this mapbuf object.
2139  *
2140  * Once the content object is set, a previously set one will be deleted.
2141  * If you want to keep that old content object, use the
2142  * elm_mapbuf_content_unset() function.
2143  *
2144  * To enable map, elm_mapbuf_enabled_set() should be used.
2145  *
2146  * @deprecated use elm_object_content_set() instead
2147  *
2148  * @ingroup Mapbuf
2149  */
2150 EINA_DEPRECATED EAPI void         elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2151
2152 /**
2153  * Get the content of the mapbuf.
2154  *
2155  * @param obj The mapbuf object.
2156  * @return The content that is being used.
2157  *
2158  * Return the content object which is set for this widget.
2159  *
2160  * @see elm_mapbuf_content_set() for details.
2161  *
2162  * @deprecated use elm_object_content_get() instead
2163  *
2164  * @ingroup Mapbuf
2165  */
2166 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2167
2168 /**
2169  * Unset the content of the mapbuf.
2170  *
2171  * @param obj The mapbuf object.
2172  * @return The content that was being used.
2173  *
2174  * Unparent and return the content object which was set for this widget.
2175  *
2176  * @see elm_mapbuf_content_set() for details.
2177  *
2178  * @deprecated use elm_object_content_unset() instead
2179  *
2180  * @ingroup Mapbuf
2181  */
2182 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2183
2184 /**
2185  * @brief Set the label of a menu item
2186  *
2187  * @param it The menu item object.
2188  * @param label The label to set for @p item
2189  *
2190  * @warning Don't use this function on items created with
2191  * elm_menu_item_add_object() or elm_menu_item_separator_add().
2192  *
2193  * @deprecated Use elm_object_item_text_set() instead
2194  */
2195 EINA_DEPRECATED EAPI void         elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2196
2197 /**
2198  * @brief Get the label of a menu item
2199  *
2200  * @param it The menu item object.
2201  * @return The label of @p item
2202  * @deprecated Use elm_object_item_text_get() instead
2203  */
2204 EINA_DEPRECATED EAPI const char  *elm_menu_item_label_get(const Elm_Object_Item *it);
2205
2206 /**
2207  * @brief Set the content object of a menu item
2208  *
2209  * @param it The menu item object
2210  * @param The content object or NULL
2211  * @return EINA_TRUE on success, else EINA_FALSE
2212  *
2213  * Use this function to change the object swallowed by a menu item, deleting
2214  * any previously swallowed object.
2215  *
2216  * @deprecated Use elm_object_item_content_set() instead
2217  */
2218 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2219
2220 /**
2221  * @brief Get the content object of a menu item
2222  *
2223  * @param it The menu item object
2224  * @return The content object or NULL
2225  * @note If @p item was added with elm_menu_item_add_object, this
2226  * function will return the object passed, else it will return the
2227  * icon object.
2228  *
2229  * @see elm_menu_item_object_content_set()
2230  *
2231  * @deprecated Use elm_object_item_content_get() instead
2232  */
2233 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2234
2235 /**
2236  * @brief Set the disabled state of @p item.
2237  *
2238  * @param it The menu item object.
2239  * @param disabled The enabled/disabled state of the item
2240  * @deprecated Use elm_object_item_disabled_set() instead
2241  */
2242 EINA_DEPRECATED EAPI void         elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2243
2244 /**
2245  * @brief Get the disabled state of @p item.
2246  *
2247  * @param it The menu item object.
2248  * @return The enabled/disabled state of the item
2249  *
2250  * @see elm_menu_item_disabled_set()
2251  * @deprecated Use elm_object_item_disabled_get() instead
2252  */
2253 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_disabled_get(const Elm_Object_Item *it);
2254
2255 /**
2256  * @brief Returns the data associated with menu item @p item.
2257  *
2258  * @param it The item
2259  * @return The data associated with @p item or NULL if none was set.
2260  *
2261  * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2262  *
2263  * @deprecated Use elm_object_item_data_get() instead
2264  */
2265 EINA_DEPRECATED EAPI void        *elm_menu_item_data_get(const Elm_Object_Item *it);
2266
2267 /**
2268  * @brief Set the function called when a menu item is deleted.
2269  *
2270  * @param it The item to set the callback on
2271  * @param func The function called
2272  *
2273  * @see elm_menu_item_add()
2274  * @see elm_menu_item_del()
2275  * @deprecated Use elm_object_item_del_cb_set() instead
2276  */
2277 EINA_DEPRECATED EAPI void                         elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2278
2279 /**
2280  * @brief Sets the data to be associated with menu item @p item.
2281  *
2282  * @param it The item
2283  * @param data The data to be associated with @p item
2284  *
2285  * @deprecated Use elm_object_item_data_set() instead
2286  */
2287 EINA_DEPRECATED EAPI void         elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2288
2289 /**
2290  * @brief Deletes an item from the menu.
2291  *
2292  * @param it The item to delete.
2293  *
2294  * @deprecated Use elm_object_item_del() instead
2295  * @see elm_menu_item_add()
2296  */
2297 EINA_DEPRECATED EAPI void                         elm_menu_item_del(Elm_Object_Item *it);
2298
2299 /**
2300  * @brief Set the content of the notify widget
2301  *
2302  * @param obj The notify object
2303  * @param content The content will be filled in this notify object
2304  *
2305  * Once the content object is set, a previously set one will be deleted. If
2306  * you want to keep that old content object, use the
2307  * elm_notify_content_unset() function.
2308  *
2309  * @deprecated use elm_object_content_set() instead
2310  *
2311  */
2312 EINA_DEPRECATED EAPI void         elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2313
2314 /**
2315  * @brief Unset the content of the notify widget
2316  *
2317  * @param obj The notify object
2318  * @return The content that was being used
2319  *
2320  * Unparent and return the content object which was set for this widget
2321  *
2322  * @see elm_notify_content_set()
2323  * @deprecated use elm_object_content_unset() instead
2324  *
2325  */
2326 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2327
2328 /**
2329  * @brief Return the content of the notify widget
2330  *
2331  * @param obj The notify object
2332  * @return The content that is being used
2333  *
2334  * @see elm_notify_content_set()
2335  * @deprecated use elm_object_content_get() instead
2336  *
2337  */
2338 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2339
2340 /**
2341  * Set a label of an object
2342  *
2343  * @param obj The Elementary object
2344  * @param part The text part name to set (NULL for the default label)
2345  * @param label The new text of the label
2346  *
2347  * @note Elementary objects may have many labels (e.g. Action Slider)
2348  * @deprecated Use elm_object_part_text_set() instead.
2349  * @ingroup General
2350  */
2351 EINA_DEPRECATED EAPI void         elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2352
2353 /**
2354  * Get a label of an object
2355  *
2356  * @param obj The Elementary object
2357  * @param part The text part name to get (NULL for the default label)
2358  * @return text of the label or NULL for any error
2359  *
2360  * @note Elementary objects may have many labels (e.g. Action Slider)
2361  * @deprecated Use elm_object_part_text_get() instead.
2362  * @ingroup General
2363  */
2364 EINA_DEPRECATED EAPI const char  *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2365
2366 /**
2367  * Set a content of an object
2368  *
2369  * @param obj The Elementary object
2370  * @param part The content part name to set (NULL for the default content)
2371  * @param content The new content of the object
2372  *
2373  * @note Elementary objects may have many contents
2374  * @deprecated Use elm_object_part_content_set instead.
2375  * @ingroup General
2376  */
2377 EINA_DEPRECATED EAPI void         elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2378
2379 /**
2380  * Get a content of an object
2381  *
2382  * @param obj The Elementary object
2383  * @param part The content part name to get (NULL for the default content)
2384  * @return content of the object or NULL for any error
2385  *
2386  * @note Elementary objects may have many contents
2387  * @deprecated Use elm_object_part_content_get instead.
2388  * @ingroup General
2389  */
2390 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2391
2392 /**
2393  * Unset a content of an object
2394  *
2395  * @param obj The Elementary object
2396  * @param part The content part name to unset (NULL for the default content)
2397  *
2398  * @note Elementary objects may have many contents
2399  * @deprecated Use elm_object_part_content_unset instead.
2400  * @ingroup General
2401  */
2402 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2403
2404 /**
2405  * Set a content of an object item
2406  *
2407  * @param it The Elementary object item
2408  * @param part The content part name to set (NULL for the default content)
2409  * @param content The new content of the object item
2410  *
2411  * @note Elementary object items may have many contents
2412  * @deprecated Use elm_object_item_part_content_set instead.
2413  * @ingroup General
2414  */
2415 EINA_DEPRECATED EAPI void         elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2416
2417 /**
2418  * Get a content of an object item
2419  *
2420  * @param it The Elementary object item
2421  * @param part The content part name to unset (NULL for the default content)
2422  * @return content of the object item or NULL for any error
2423  *
2424  * @note Elementary object items may have many contents
2425  * @deprecated Use elm_object_item_part_content_get instead.
2426  * @ingroup General
2427  */
2428 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2429
2430 /**
2431  * Unset a content of an object item
2432  *
2433  * @param it The Elementary object item
2434  * @param part The content part name to unset (NULL for the default content)
2435  *
2436  * @note Elementary object items may have many contents
2437  * @deprecated Use elm_object_item_part_content_unset instead.
2438  * @ingroup General
2439  */
2440 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2441
2442 /**
2443  * Get a label of an object item
2444  *
2445  * @param it The Elementary object item
2446  * @param part The text part name to get (NULL for the default label)
2447  * @return text of the label or NULL for any error
2448  *
2449  * @note Elementary object items may have many labels
2450  * @deprecated Use elm_object_item_part_text_get instead.
2451  * @ingroup General
2452  */
2453 EINA_DEPRECATED EAPI const char  *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2454
2455 /**
2456  * Set a label of an object item
2457  *
2458  * @param it The Elementary object item
2459  * @param part The text part name to set (NULL for the default label)
2460  * @param label The new text of the label
2461  *
2462  * @note Elementary object items may have many labels
2463  * @deprecated Use elm_object_item_part_text_set instead.
2464  * @ingroup General
2465  */
2466 EINA_DEPRECATED EAPI void         elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2467
2468 /**
2469  * @brief Set the content of the panel.
2470  *
2471  * @param obj The panel object
2472  * @param content The panel content
2473  *
2474  * Once the content object is set, a previously set one will be deleted.
2475  * If you want to keep that old content object, use the
2476  * elm_panel_content_unset() function.
2477  *
2478  * @deprecated use elm_object_content_set() instead
2479  *
2480  */
2481 EINA_DEPRECATED EAPI void         elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2482
2483 /**
2484  * @brief Get the content of the panel.
2485  *
2486  * @param obj The panel object
2487  * @return The content that is being used
2488  *
2489  * Return the content object which is set for this widget.
2490  *
2491  * @see elm_panel_content_set()
2492  *
2493  * @deprecated use elm_object_content_get() instead
2494  *
2495  */
2496 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2497
2498 /**
2499  * @brief Unset the content of the panel.
2500  *
2501  * @param obj The panel object
2502  * @return The content that was being used
2503  *
2504  * Unparent and return the content object which was set for this widget.
2505  *
2506  * @see elm_panel_content_set()
2507  *
2508  * @deprecated use elm_object_content_unset() instead
2509  *
2510  */
2511 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2512
2513 /**
2514  * Set the left content of the panes widget.
2515  *
2516  * @param obj The panes object.
2517  * @param content The new left content object.
2518  *
2519  * Once the content object is set, a previously set one will be deleted.
2520  * If you want to keep that old content object, use the
2521  * elm_panes_content_left_unset() function.
2522  *
2523  * If panes is displayed vertically, left content will be displayed at
2524  * top.
2525  *
2526  * @see elm_panes_content_left_get()
2527  * @see elm_panes_content_right_set() to set content on the other side.
2528  *
2529  * @deprecated use elm_object_part_content_set() instead
2530  *
2531  * @ingroup Panes
2532  */
2533 EINA_DEPRECATED EAPI void         elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2534
2535 /**
2536  * Set the right content of the panes widget.
2537  *
2538  * @param obj The panes object.
2539  * @param content The new right content object.
2540  *
2541  * Once the content object is set, a previously set one will be deleted.
2542  * If you want to keep that old content object, use the
2543  * elm_panes_content_right_unset() function.
2544  *
2545  * If panes is displayed vertically, left content will be displayed at
2546  * bottom.
2547  *
2548  * @see elm_panes_content_right_get()
2549  * @see elm_panes_content_left_set() to set content on the other side.
2550  *
2551  * @deprecated use elm_object_part_content_set() instead
2552  *
2553  * @ingroup Panes
2554  */
2555 EINA_DEPRECATED EAPI void         elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2556
2557 /**
2558  * Get the left content of the panes.
2559  *
2560  * @param obj The panes object.
2561  * @return The left content object that is being used.
2562  *
2563  * Return the left content object which is set for this widget.
2564  *
2565  * @see elm_panes_content_left_set() for details.
2566  *
2567  * @deprecated use elm_object_part_content_get() instead
2568  *
2569  * @ingroup Panes
2570  */
2571 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2572
2573 /**
2574  * Get the right content of the panes.
2575  *
2576  * @param obj The panes object
2577  * @return The right content object that is being used
2578  *
2579  * Return the right content object which is set for this widget.
2580  *
2581  * @see elm_panes_content_right_set() for details.
2582  *
2583  * @deprecated use elm_object_part_content_get() instead
2584  *
2585  * @ingroup Panes
2586  */
2587 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2588
2589 /**
2590  * Unset the left content used for the panes.
2591  *
2592  * @param obj The panes object.
2593  * @return The left content object that was being used.
2594  *
2595  * Unparent and return the left content object which was set for this widget.
2596  *
2597  * @see elm_panes_content_left_set() for details.
2598  * @see elm_panes_content_left_get().
2599  *
2600  * @deprecated use elm_object_part_content_unset() instead
2601  *
2602  * @ingroup Panes
2603  */
2604 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2605
2606 /**
2607  * Unset the right content used for the panes.
2608  *
2609  * @param obj The panes object.
2610  * @return The right content object that was being used.
2611  *
2612  * Unparent and return the right content object which was set for this
2613  * widget.
2614  *
2615  * @see elm_panes_content_right_set() for details.
2616  * @see elm_panes_content_right_get().
2617  *
2618  * @deprecated use elm_object_part_content_unset() instead
2619  *
2620  * @ingroup Panes
2621  */
2622 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2623 /**
2624  * Set the label of a given progress bar widget
2625  *
2626  * @param obj The progress bar object
2627  * @param label The text label string, in UTF-8
2628  *
2629  * @ingroup Progressbar
2630  * @deprecated use elm_object_text_set() instead.
2631  */
2632 EINA_DEPRECATED EAPI void         elm_progressbar_label_set(Evas_Object *obj, const char *label);
2633
2634 /**
2635  * Get the label of a given progress bar widget
2636  *
2637  * @param obj The progressbar object
2638  * @return The text label string, in UTF-8
2639  *
2640  * @ingroup Progressbar
2641  * @deprecated use elm_object_text_set() instead.
2642  */
2643 EINA_DEPRECATED EAPI const char  *elm_progressbar_label_get(const Evas_Object *obj);
2644
2645 /**
2646  * Set the icon object of a given progress bar widget
2647  *
2648  * @param obj The progress bar object
2649  * @param icon The icon object
2650  *
2651  * Use this call to decorate @p obj with an icon next to it.
2652  *
2653  * @note Once the icon object is set, a previously set one will be
2654  * deleted. If you want to keep that old content object, use the
2655  * elm_progressbar_icon_unset() function.
2656  *
2657  * @see elm_progressbar_icon_get()
2658  * @deprecated use elm_object_part_content_set() instead.
2659  *
2660  * @ingroup Progressbar
2661  */
2662 EINA_DEPRECATED EAPI void         elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2663
2664 /**
2665  * Retrieve the icon object set for a given progress bar widget
2666  *
2667  * @param obj The progress bar object
2668  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2669  * otherwise (and on errors)
2670  *
2671  * @see elm_progressbar_icon_set() for more details
2672  * @deprecated use elm_object_part_content_get() instead.
2673  *
2674  * @ingroup Progressbar
2675  */
2676 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2677
2678 /**
2679  * Unset an icon set on a given progress bar widget
2680  *
2681  * @param obj The progress bar object
2682  * @return The icon object that was being used, if any was set, or
2683  * @c NULL, otherwise (and on errors)
2684  *
2685  * This call will unparent and return the icon object which was set
2686  * for this widget, previously, on success.
2687  *
2688  * @see elm_progressbar_icon_set() for more details
2689  * @deprecated use elm_object_part_content_unset() instead.
2690  *
2691  * @ingroup Progressbar
2692  */
2693 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2694
2695 /**
2696  * @brief Set the text label of the radio object
2697  *
2698  * @param obj The radio object
2699  * @param label The text label string in UTF-8
2700  *
2701  * @deprecated use elm_object_text_set() instead.
2702  */
2703 EINA_DEPRECATED EAPI void         elm_radio_label_set(Evas_Object *obj, const char *label);
2704
2705 /**
2706  * @brief Get the text label of the radio object
2707  *
2708  * @param obj The radio object
2709  * @return The text label string in UTF-8
2710  *
2711  * @deprecated use elm_object_text_set() instead.
2712  */
2713 EINA_DEPRECATED EAPI const char  *elm_radio_label_get(const Evas_Object *obj);
2714
2715 /**
2716  * @brief Set the icon object of the radio object
2717  *
2718  * @param obj The radio object
2719  * @param icon The icon object
2720  *
2721  * Once the icon object is set, a previously set one will be deleted. If you
2722  * want to keep that old content object, use the elm_radio_icon_unset()
2723  * function.
2724  *
2725  * @deprecated use elm_object_part_content_set() instead.
2726  *
2727  */
2728 EINA_DEPRECATED EAPI void         elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2729
2730 /**
2731  * @brief Get the icon object of the radio object
2732  *
2733  * @param obj The radio object
2734  * @return The icon object
2735  *
2736  * @see elm_radio_icon_set()
2737  *
2738  * @deprecated use elm_object_part_content_get() instead.
2739  *
2740  */
2741 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2742
2743 /**
2744  * @brief Unset the icon used for the radio object
2745  *
2746  * @param obj The radio object
2747  * @return The icon object that was being used
2748  *
2749  * Unparent and return the icon object which was set for this widget.
2750  *
2751  * @see elm_radio_icon_set()
2752  * @deprecated use elm_object_part_content_unset() instead.
2753  *
2754  */
2755 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2756
2757 /**
2758  * @brief Set the content of the scroller widget (the object to be scrolled around).
2759  *
2760  * @param obj The scroller object
2761  * @param content The new content object
2762  *
2763  * Once the content object is set, a previously set one will be deleted.
2764  * If you want to keep that old content object, use the
2765  * elm_scroller_content_unset() function.
2766  * @deprecated use elm_object_content_set() instead
2767  */
2768 EINA_DEPRECATED EAPI void         elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2769
2770 /**
2771  * @brief Get the content of the scroller widget
2772  *
2773  * @param obj The slider object
2774  * @return The content that is being used
2775  *
2776  * Return the content object which is set for this widget
2777  *
2778  * @see elm_scroller_content_set()
2779  * @deprecated use elm_object_content_get() instead.
2780  */
2781 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2782
2783 /**
2784  * @brief Unset the content of the scroller widget
2785  *
2786  * @param obj The slider object
2787  * @return The content that was being used
2788  *
2789  * Unparent and return the content object which was set for this widget
2790  *
2791  * @see elm_scroller_content_set()
2792  * @deprecated use elm_object_content_unset() instead.
2793  */
2794 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2795
2796 /**
2797  * Set the label of a given slider widget
2798  *
2799  * @param obj The progress bar object
2800  * @param label The text label string, in UTF-8
2801  *
2802  * @ingroup Slider
2803  * @deprecated use elm_object_text_set() instead.
2804  */
2805 EINA_DEPRECATED EAPI void         elm_slider_label_set(Evas_Object *obj, const char *label);
2806
2807 /**
2808  * Get the label of a given slider widget
2809  *
2810  * @param obj The progressbar object
2811  * @return The text label string, in UTF-8
2812  *
2813  * @ingroup Slider
2814  * @deprecated use elm_object_text_get() instead.
2815  */
2816 EINA_DEPRECATED EAPI const char  *elm_slider_label_get(const Evas_Object *obj);
2817
2818 /**
2819  * Set the icon object of the slider object.
2820  *
2821  * @param obj The slider object.
2822  * @param icon The icon object.
2823  *
2824  * On horizontal mode, icon is placed at left, and on vertical mode,
2825  * placed at top.
2826  *
2827  * @note Once the icon object is set, a previously set one will be deleted.
2828  * If you want to keep that old content object, use the
2829  * elm_slider_icon_unset() function.
2830  *
2831  * @warning If the object being set does not have minimum size hints set,
2832  * it won't get properly displayed.
2833  *
2834  * @ingroup Slider
2835  * @deprecated use elm_object_part_content_set() instead.
2836  */
2837 EINA_DEPRECATED EAPI void         elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2838
2839 /**
2840  * Unset an icon set on a given slider widget.
2841  *
2842  * @param obj The slider object.
2843  * @return The icon object that was being used, if any was set, or
2844  * @c NULL, otherwise (and on errors).
2845  *
2846  * On horizontal mode, icon is placed at left, and on vertical mode,
2847  * placed at top.
2848  *
2849  * This call will unparent and return the icon object which was set
2850  * for this widget, previously, on success.
2851  *
2852  * @see elm_slider_icon_set() for more details
2853  * @see elm_slider_icon_get()
2854  * @deprecated use elm_object_part_content_unset() instead.
2855  *
2856  * @ingroup Slider
2857  */
2858 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2859
2860 /**
2861  * Retrieve the icon object set for a given slider widget.
2862  *
2863  * @param obj The slider object.
2864  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2865  * otherwise (and on errors).
2866  *
2867  * On horizontal mode, icon is placed at left, and on vertical mode,
2868  * placed at top.
2869  *
2870  * @see elm_slider_icon_set() for more details
2871  * @see elm_slider_icon_unset()
2872  *
2873  * @deprecated use elm_object_part_content_get() instead.
2874  *
2875  * @ingroup Slider
2876  */
2877 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2878
2879 /**
2880  * Set the end object of the slider object.
2881  *
2882  * @param obj The slider object.
2883  * @param end The end object.
2884  *
2885  * On horizontal mode, end is placed at left, and on vertical mode,
2886  * placed at bottom.
2887  *
2888  * @note Once the icon object is set, a previously set one will be deleted.
2889  * If you want to keep that old content object, use the
2890  * elm_slider_end_unset() function.
2891  *
2892  * @warning If the object being set does not have minimum size hints set,
2893  * it won't get properly displayed.
2894  *
2895  * @deprecated use elm_object_part_content_set() instead.
2896  *
2897  * @ingroup Slider
2898  */
2899 EINA_DEPRECATED EAPI void         elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2900
2901 /**
2902  * Unset an end object set on a given slider widget.
2903  *
2904  * @param obj The slider object.
2905  * @return The end object that was being used, if any was set, or
2906  * @c NULL, otherwise (and on errors).
2907  *
2908  * On horizontal mode, end is placed at left, and on vertical mode,
2909  * placed at bottom.
2910  *
2911  * This call will unparent and return the icon object which was set
2912  * for this widget, previously, on success.
2913  *
2914  * @see elm_slider_end_set() for more details.
2915  * @see elm_slider_end_get()
2916  *
2917  * @deprecated use elm_object_part_content_unset() instead
2918  * instead.
2919  *
2920  * @ingroup Slider
2921  */
2922 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2923
2924 /**
2925  * Retrieve the end object set for a given slider widget.
2926  *
2927  * @param obj The slider object.
2928  * @return The end object's handle, if @p obj had one set, or @c NULL,
2929  * otherwise (and on errors).
2930  *
2931  * On horizontal mode, icon is placed at right, and on vertical mode,
2932  * placed at bottom.
2933  *
2934  * @see elm_slider_end_set() for more details.
2935  * @see elm_slider_end_unset()
2936  *
2937  *
2938  * @deprecated use elm_object_part_content_get() instead
2939  * instead.
2940  *
2941  * @ingroup Slider
2942  */
2943 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2944
2945 /**
2946  * Return the data associated with a given slideshow item
2947  *
2948  * @param it The slideshow item
2949  * @return Returns the data associated to this item
2950  *
2951  * @deprecated use elm_object_item_data_get() instead
2952  * @ingroup Slideshow
2953  */
2954 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2955
2956 /**
2957  * Delete a given item from a slideshow widget.
2958  *
2959  * @param it The slideshow item
2960  *
2961  * @deprecated Use elm_object_item_de() instead
2962  * @ingroup Slideshow
2963  */
2964 EINA_DEPRECATED EAPI void                  elm_slideshow_item_del(Elm_Object_Item *it);
2965
2966 /**
2967  * Get the toolbar object from an item.
2968  *
2969  * @param it The item.
2970  * @return The toolbar object.
2971  *
2972  * This returns the toolbar object itself that an item belongs to.
2973  *
2974  * @deprecated use elm_object_item_object_get() instead.
2975  * @ingroup Toolbar
2976  */
2977 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2978
2979 /**
2980  * Get the label of item.
2981  *
2982  * @param it The item of toolbar.
2983  * @return The label of item.
2984  *
2985  * The return value is a pointer to the label associated to @p item when
2986  * it was created, with function elm_toolbar_item_append() or similar,
2987  * or later,
2988  * with function elm_toolbar_item_label_set. If no label
2989  * was passed as argument, it will return @c NULL.
2990  *
2991  * @see elm_toolbar_item_label_set() for more details.
2992  * @see elm_toolbar_item_append()
2993  *
2994  * @deprecated use elm_object_item_text_get() instead.
2995  * @ingroup Toolbar
2996  */
2997 EINA_DEPRECATED EAPI const char  *elm_toolbar_item_label_get(const Elm_Object_Item *it);
2998
2999 /**
3000  * Set the label of item.
3001  *
3002  * @param it The item of toolbar.
3003  * @param text The label of item.
3004  *
3005  * The label to be displayed by the item.
3006  * Label will be placed at icons bottom (if set).
3007  *
3008  * If a label was passed as argument on item creation, with function
3009  * elm_toolbar_item_append() or similar, it will be already
3010  * displayed by the item.
3011  *
3012  * @see elm_toolbar_item_label_get()
3013  * @see elm_toolbar_item_append()
3014  *
3015  * @deprecated use elm_object_item_text_set() instead
3016  * @ingroup Toolbar
3017  */
3018 EINA_DEPRECATED EAPI void         elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3019
3020 /**
3021  * Return the data associated with a given toolbar widget item.
3022  *
3023  * @param it The toolbar widget item handle.
3024  * @return The data associated with @p item.
3025  *
3026  * @see elm_toolbar_item_data_set()
3027  *
3028  * @deprecated use elm_object_item_data_get() instead.
3029  * @ingroup Toolbar
3030  */
3031 EINA_DEPRECATED EAPI void        *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3032
3033 /**
3034  * Set the data associated with a given toolbar widget item.
3035  *
3036  * @param it The toolbar widget item handle
3037  * @param data The new data pointer to set to @p item.
3038  *
3039  * This sets new item data on @p item.
3040  *
3041  * @warning The old data pointer won't be touched by this function, so
3042  * the user had better to free that old data himself/herself.
3043  *
3044  * @deprecated use elm_object_item_data_set() instead.
3045  * @ingroup Toolbar
3046  */
3047 EINA_DEPRECATED EAPI void         elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3048
3049 /**
3050  * Get a value whether toolbar item is disabled or not.
3051  *
3052  * @param it The item.
3053  * @return The disabled state.
3054  *
3055  * @see elm_toolbar_item_disabled_set() for more details.
3056  *
3057  * @deprecated use elm_object_item_disabled_get() instead.
3058  * @ingroup Toolbar
3059  */
3060 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3061
3062 /**
3063  * Sets the disabled/enabled state of a toolbar item.
3064  *
3065  * @param it The item.
3066  * @param disabled The disabled state.
3067  *
3068  * A disabled item cannot be selected or unselected. It will also
3069  * change its appearance (generally greyed out). This sets the
3070  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3071  * enabled).
3072  *
3073  * @deprecated use elm_object_item_disabled_set() instead.
3074  * @ingroup Toolbar
3075  */
3076 EINA_DEPRECATED EAPI void         elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3077
3078 /**
3079  * Change a toolbar's orientation
3080  * @param obj The toolbar object
3081  * @param vertical If @c EINA_TRUE, the toolbar is vertical
3082  * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3083  * @ingroup Toolbar
3084  * @deprecated use elm_toolbar_horizontal_set() instead.
3085  */
3086 EINA_DEPRECATED EAPI void         elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3087
3088 /**
3089  * Get a toolbar's orientation
3090  * @param obj The toolbar object
3091  * @return If @c EINA_TRUE, the toolbar is vertical
3092  * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3093  * @ingroup Toolbar
3094  * @deprecated use elm_toolbar_horizontal_get() instead.
3095  */
3096 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_orientation_get(const Evas_Object *obj);
3097
3098 /**
3099  * Set the function called when a toolbar item is freed.
3100  *
3101  * @param it The item to set the callback on.
3102  * @param func The function called.
3103  *
3104  * If there is a @p func, then it will be called prior item's memory release.
3105  * That will be called with the following arguments:
3106  * @li item's data;
3107  * @li item's Evas object;
3108  * @li item itself;
3109  *
3110  * This way, a data associated to a toolbar item could be properly freed.
3111  *
3112  * @deprecated Use elm_object_item_del_cb_set() instead 
3113  * @ingroup Toolbar
3114  */
3115 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3116
3117 /**
3118  * Delete them item from the toolbar.
3119  *
3120  * @param it The item of toolbar to be deleted.
3121  *
3122  * @deprecated Use elm_object_item_del() instead
3123  * @see elm_toolbar_item_append()
3124  *
3125  * @ingroup Toolbar
3126  */
3127 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del(Elm_Object_Item *it);
3128
3129 /**
3130  * Set the text to be shown in a given toolbar item's tooltips.
3131  *
3132  * @param it toolbar item.
3133  * @param text The text to set in the content.
3134  *
3135  * Setup the text as tooltip to object. The item can have only one tooltip,
3136  * so any previous tooltip data - set with this function or
3137  * elm_toolbar_item_tooltip_content_cb_set() - is removed.
3138  *
3139  * @deprecated Use elm_object_item_tooltip_text_set() instead
3140  * @see elm_object_tooltip_text_set() for more details.
3141  *
3142  * @ingroup Toolbar
3143  */
3144 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3145
3146 /**
3147  * Set the content to be shown in the tooltip item.
3148  *
3149  * Setup the tooltip to item. The item can have only one tooltip,
3150  * so any previous tooltip data is removed. @p func(with @p data) will
3151  * be called every time that need show the tooltip and it should
3152  * return a valid Evas_Object. This object is then managed fully by
3153  * tooltip system and is deleted when the tooltip is gone.
3154  *
3155  * @param it the toolbar item being attached a tooltip.
3156  * @param func the function used to create the tooltip contents.
3157  * @param data what to provide to @a func as callback data/context.
3158  * @param del_cb called when data is not needed anymore, either when
3159  *        another callback replaces @a func, the tooltip is unset with
3160  *        elm_toolbar_item_tooltip_unset() or the owner @a item
3161  *        dies. This callback receives as the first parameter the
3162  *        given @a data, and @c event_info is the item.
3163  *
3164  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3165  * @see elm_object_tooltip_content_cb_set() for more details.
3166  *
3167  * @ingroup Toolbar
3168  */
3169 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);
3170
3171 /**
3172  * Unset tooltip from item.
3173  *
3174  * @param it toolbar item to remove previously set tooltip.
3175  *
3176  * Remove tooltip from item. The callback provided as del_cb to
3177  * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3178  * it is not used anymore.
3179  *
3180  * @deprecated Use elm_object_item_tooltip_unset() instead
3181  * @see elm_object_tooltip_unset() for more details.
3182  * @see elm_toolbar_item_tooltip_content_cb_set()
3183  *
3184  * @ingroup Toolbar
3185  */
3186 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3187
3188 /**
3189  * Sets a different style for this item tooltip.
3190  *
3191  * @note before you set a style you should define a tooltip with
3192  *       elm_toolbar_item_tooltip_content_cb_set() or
3193  *       elm_toolbar_item_tooltip_text_set()
3194  *
3195  * @param it toolbar item with tooltip already set.
3196  * @param style the theme style to use (default, transparent, ...)
3197  *
3198  * @deprecated Use elm_object_item_tooltip_style_set() instead
3199  * @see elm_object_tooltip_style_set() for more details.
3200  *
3201  * @ingroup Toolbar
3202  */
3203 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3204
3205 /**
3206  * Get the style for this item tooltip.
3207  *
3208  * @param it toolbar item with tooltip already set.
3209  * @return style the theme style in use, defaults to "default". If the
3210  *         object does not have a tooltip set, then NULL is returned.
3211  *
3212  * @deprecated Use elm_object_item_style_get() instead
3213  * @see elm_object_tooltip_style_get() for more details.
3214  * @see elm_toolbar_item_tooltip_style_set()
3215  *
3216  * @ingroup Toolbar
3217  */
3218 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3219
3220 /**
3221  * Set the type of mouse pointer/cursor decoration to be shown,
3222  * when the mouse pointer is over the given toolbar widget item
3223  *
3224  * @param it toolbar item to customize cursor on
3225  * @param cursor the cursor type's name
3226  *
3227  * This function works analogously as elm_object_cursor_set(), but
3228  * here the cursor's changing area is restricted to the item's
3229  * area, and not the whole widget's. Note that that item cursors
3230  * have precedence over widget cursors, so that a mouse over an
3231  * item with custom cursor set will always show @b that cursor.
3232  *
3233  * If this function is called twice for an object, a previously set
3234  * cursor will be unset on the second call.
3235  *
3236  * @see elm_object_cursor_set()
3237  * @see elm_toolbar_item_cursor_get()
3238  * @see elm_toolbar_item_cursor_unset()
3239  *
3240  * @deprecated use elm_object_item_cursor_set() instead
3241  *
3242  * @ingroup Toolbar
3243  */
3244 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3245
3246 /*
3247  * Get the type of mouse pointer/cursor decoration set to be shown,
3248  * when the mouse pointer is over the given toolbar widget item
3249  *
3250  * @param it toolbar item with custom cursor set
3251  * @return the cursor type's name or @c NULL, if no custom cursors
3252  * were set to @p item (and on errors)
3253  *
3254  * @see elm_object_cursor_get()
3255  * @see elm_toolbar_item_cursor_set()
3256  * @see elm_toolbar_item_cursor_unset()
3257  *
3258  * @deprecated Use elm_object_item_cursor_get() instead
3259  *
3260  * @ingroup Toolbar
3261  */
3262 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3263
3264 /**
3265  * Unset any custom mouse pointer/cursor decoration set to be
3266  * shown, when the mouse pointer is over the given toolbar widget
3267  * item, thus making it show the @b default cursor again.
3268  *
3269  * @param it a toolbar item
3270  *
3271  * Use this call to undo any custom settings on this item's cursor
3272  * decoration, bringing it back to defaults (no custom style set).
3273  *
3274  * @see elm_object_cursor_unset()
3275  * @see elm_toolbar_item_cursor_set()
3276  *
3277  * @deprecated Use elm_object_item_cursor_unset() instead
3278  *
3279  * @ingroup Toolbar
3280  */
3281 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3282
3283 /**
3284  * Set a different @b style for a given custom cursor set for a
3285  * toolbar item.
3286  *
3287  * @param it toolbar item with custom cursor set
3288  * @param style the <b>theme style</b> to use (e.g. @c "default",
3289  * @c "transparent", etc)
3290  *
3291  * This function only makes sense when one is using custom mouse
3292  * cursor decorations <b>defined in a theme file</b>, which can have,
3293  * given a cursor name/type, <b>alternate styles</b> on it. It
3294  * works analogously as elm_object_cursor_style_set(), but here
3295  * applies only to toolbar item objects.
3296  *
3297  * @warning Before you set a cursor style you should have defined a
3298  *       custom cursor previously on the item, with
3299  *       elm_toolbar_item_cursor_set()
3300  *
3301  * @see elm_toolbar_item_cursor_engine_only_set()
3302  * @see elm_toolbar_item_cursor_style_get()
3303  *
3304  * @deprecated Use elm_object_item_cursor_style_set() instead
3305  *
3306  * @ingroup Toolbar
3307  */
3308 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3309
3310 /**
3311  * Get the current @b style set for a given toolbar item's custom
3312  * cursor
3313  *
3314  * @param it toolbar item with custom cursor set.
3315  * @return style the cursor style in use. If the object does not
3316  *         have a cursor set, then @c NULL is returned.
3317  *
3318  * @see elm_toolbar_item_cursor_style_set() for more details
3319  *
3320  * @deprecated Use elm_object_item_cursor_style_get() instead
3321  *
3322  * @ingroup Toolbar
3323  */
3324 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3325
3326 /**
3327  * Set if the (custom)cursor for a given toolbar item should be
3328  * searched in its theme, also, or should only rely on the
3329  * rendering engine.
3330  *
3331  * @param it item with custom (custom) cursor already set on
3332  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3333  * only on those provided by the rendering engine, @c EINA_FALSE to
3334  * have them searched on the widget's theme, as well.
3335  *
3336  * @note This call is of use only if you've set a custom cursor
3337  * for toolbar items, with elm_toolbar_item_cursor_set().
3338  *
3339  * @note By default, cursors will only be looked for between those
3340  * provided by the rendering engine.
3341  *
3342  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3343  *
3344  * @ingroup Toolbar
3345  */
3346 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3347
3348 /**
3349  * Get if the (custom) cursor for a given toolbar item is being
3350  * searched in its theme, also, or is only relying on the rendering
3351  * engine.
3352  *
3353  * @param it a toolbar item
3354  * @return @c EINA_TRUE, if cursors are being looked for only on
3355  * those provided by the rendering engine, @c EINA_FALSE if they
3356  * are being searched on the widget's theme, as well.
3357  *
3358  * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3359  *
3360  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3361  *
3362  * @ingroup Toolbar
3363  */
3364 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3365
3366 /**
3367  * @brief Link a Elm_Payer with an Elm_Video object.
3368  *
3369  * @param player the Elm_Player object.
3370  * @param video The Elm_Video object.
3371  *
3372  * This mean that action on the player widget will affect the
3373  * video object and the state of the video will be reflected in
3374  * the player itself.
3375  *
3376  * @see elm_player_add()
3377  * @see elm_video_add()
3378  * @deprecated use elm_object_part_content_set() instead
3379  *
3380  * @ingroup Video
3381  */
3382 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3383
3384 /**
3385  * Set the label of item.
3386  *
3387  * @param it The item of segment control.
3388  * @param text The label of item.
3389  *
3390  * The label to be displayed by the item.
3391  * Label will be at right of the icon (if set).
3392  *
3393  * If a label was passed as argument on item creation, with function
3394  * elm_control_segment_item_add(), it will be already
3395  * displayed by the item.
3396  *
3397  * @see elm_segment_control_item_label_get()
3398  * @see elm_segment_control_item_add()
3399  * @deprecated Use elm_object_item_text_set() instead
3400  *
3401  * @ingroup SegmentControl
3402  */
3403 EINA_DEPRECATED EAPI void              elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3404
3405
3406 /**
3407  * Set the icon associated to the item.
3408  *
3409  * @param it The segment control item.
3410  * @param icon The icon object to associate with @p it.
3411  *
3412  * The icon object to use at left side of the item. An
3413  * icon can be any Evas object, but usually it is an icon created
3414  * with elm_icon_add().
3415  *
3416  * Once the icon object is set, a previously set one will be deleted.
3417  * @warning Setting the same icon for two items will cause the icon to
3418  * disappear from the first item.
3419  *
3420  * If an icon was passed as argument on item creation, with function
3421  * elm_segment_control_item_add(), it will be already
3422  * associated to the item.
3423  *
3424  * @see elm_segment_control_item_add()
3425  * @see elm_segment_control_item_icon_get()
3426  * @deprecated Use elm_object_item_part_content_set() instead
3427  *
3428  * @ingroup SegmentControl
3429  */
3430 EINA_DEPRECATED EAPI void              elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3431
3432 /**
3433  * Remove a segment control item from its parent, deleting it.
3434  *
3435  * @param it The item to be removed.
3436  *
3437  * Items can be added with elm_segment_control_item_add() or
3438  * elm_segment_control_item_insert_at().
3439  *
3440  * @deprecated Use elm_object_item_del() instead
3441  * @ingroup SegmentControl
3442  */
3443 EINA_DEPRECATED EAPI void              elm_segment_control_item_del(Elm_Object_Item *it);
3444
3445 /**
3446  * Get the label
3447  *
3448  * @param obj The multibuttonentry object
3449  * @return The label, or NULL if none
3450  *
3451  * @deprecated Use elm_object_text_get() instead 
3452  *
3453  */
3454 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_label_get(const Evas_Object *obj);
3455
3456 /**
3457  * Set the label
3458  *
3459  * @param obj The multibuttonentry object
3460  * @param label The text label string
3461  *
3462  * @deprecated Use elm_object_text_set() instead
3463  *
3464  */
3465 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3466
3467 /**
3468  * Get the label of a given item
3469  *
3470  * @param it The item
3471  * @return The label of a given item, or NULL if none
3472  *
3473  * @deprecated Use elm_object_item_text_get() instead
3474  *
3475  */
3476 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3477
3478 /**
3479  * Set the label of a given item
3480  *
3481  * @param it The item
3482  * @param str The text label string
3483  *
3484  * @deprecated Use elm_object_item_text_set() instead
3485  */
3486 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3487
3488 /**
3489  * Delete a given item
3490  *
3491  * @param it The item
3492  * 
3493  * @deprecated Use elm_object_item_del() instead 
3494  *
3495  */
3496 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_del(Elm_Object_Item *it);
3497
3498 /**
3499  * @brief Delete the given item instantly.
3500  *
3501  * @param it The naviframe item
3502  *
3503  * This just deletes the given item from the naviframe item list instantly.
3504  * So this would not emit any signals for view transitions but just change
3505  * the current view if the given item is a top one.
3506  *
3507  * @deprecated Use elm_object_item_del() instead
3508  * @ingroup Naviframe
3509  */
3510 EINA_DEPRECATED EAPI void             elm_naviframe_item_del(Elm_Object_Item *it);
3511
3512
3513
3514 /**
3515  * Sets the disabled/enabled state of a list item.
3516  *
3517  * @param it The item.
3518  * @param disabled The disabled state.
3519  *
3520  * A disabled item cannot be selected or unselected. It will also
3521  * change its appearance (generally greyed out). This sets the
3522  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3523  * enabled).
3524  *
3525  * @deprecated Use elm_object_item_disabled_set() instead
3526  * 
3527  * @ingroup List
3528  */
3529 EINA_DEPRECATED EAPI void                         elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3530
3531 /**
3532  * Get a value whether list item is disabled or not.
3533  *
3534  * @param it The item.
3535  * @return The disabled state.
3536  *
3537  * @see elm_list_item_disabled_set() for more details.
3538  *
3539  * @deprecated Use elm_object_item_disabled_get() instead
3540  * 
3541  * @ingroup List
3542  */
3543 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_disabled_get(const Elm_Object_Item *it);
3544
3545 /**
3546  * Set the function called when a list item is freed.
3547  *
3548  * @param it The item to set the callback on
3549  * @param func The function called
3550  *
3551  * If there is a @p func, then it will be called prior item's memory release.
3552  * That will be called with the following arguments:
3553  * @li item's data;
3554  * @li item's Evas object;
3555  * @li item itself;
3556  *
3557  * This way, a data associated to a list item could be properly freed.
3558  * 
3559  * @deprecated Please use elm_object_item_del_cb_set() instead.
3560  *
3561  * @ingroup List
3562  */
3563 EINA_DEPRECATED EAPI void                         elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3564
3565 /**
3566  * Get the data associated to the item.
3567  *
3568  * @param it The list item
3569  * @return The data associated to @p item
3570  *
3571  * The return value is a pointer to data associated to @p item when it was
3572  * created, with function elm_list_item_append() or similar. If no data
3573  * was passed as argument, it will return @c NULL.
3574  *
3575  * @see elm_list_item_append()
3576  *
3577  * @deprecated Please use elm_object_item_data_get() instead.
3578  * 
3579  * @ingroup List
3580  */
3581 EINA_DEPRECATED EAPI void                        *elm_list_item_data_get(const Elm_Object_Item *it);
3582
3583 /**
3584  * Get the left side icon associated to the item.
3585  *
3586  * @param it The list item
3587  * @return The left side icon associated to @p item
3588  *
3589  * The return value is a pointer to the icon associated to @p item when
3590  * it was
3591  * created, with function elm_list_item_append() or similar, or later
3592  * with function elm_list_item_icon_set(). If no icon
3593  * was passed as argument, it will return @c NULL.
3594  *
3595  * @see elm_list_item_append()
3596  * @see elm_list_item_icon_set()
3597  *
3598  * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3599  * @ingroup List
3600  */
3601 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_icon_get(const Elm_Object_Item *it);
3602
3603 /**
3604  * Set the left side icon associated to the item.
3605  *
3606  * @param it The list item
3607  * @param icon The left side icon object to associate with @p item
3608  *
3609  * The icon object to use at left side of the item. An
3610  * icon can be any Evas object, but usually it is an icon created
3611  * with elm_icon_add().
3612  *
3613  * Once the icon object is set, a previously set one will be deleted.
3614  * @warning Setting the same icon for two items will cause the icon to
3615  * disappear from the first item.
3616  *
3617  * If an icon was passed as argument on item creation, with function
3618  * elm_list_item_append() or similar, it will be already
3619  * associated to the item.
3620  *
3621  * @see elm_list_item_append()
3622  * @see elm_list_item_icon_get()
3623  *
3624  * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3625  * @ingroup List
3626  */
3627 EINA_DEPRECATED EAPI void                         elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3628
3629 /**
3630  * Get the right side icon associated to the item.
3631  *
3632  * @param it The list item
3633  * @return The right side icon associated to @p item
3634  *
3635  * The return value is a pointer to the icon associated to @p item when
3636  * it was
3637  * created, with function elm_list_item_append() or similar, or later
3638  * with function elm_list_item_icon_set(). If no icon
3639  * was passed as argument, it will return @c NULL.
3640  *
3641  * @see elm_list_item_append()
3642  * @see elm_list_item_icon_set()
3643  *
3644  * @deprecated Please use elm_object_item_part_content_get(item, "end");
3645  * @ingroup List
3646  */
3647 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_end_get(const Elm_Object_Item *it);
3648
3649 /**
3650  * Set the right side icon associated to the item.
3651  *
3652  * @param it The list item
3653  * @param end The right side icon object to associate with @p item
3654  *
3655  * The icon object to use at right side of the item. An
3656  * icon can be any Evas object, but usually it is an icon created
3657  * with elm_icon_add().
3658  *
3659  * Once the icon object is set, a previously set one will be deleted.
3660  * @warning Setting the same icon for two items will cause the icon to
3661  * disappear from the first item.
3662  *
3663  * If an icon was passed as argument on item creation, with function
3664  * elm_list_item_append() or similar, it will be already
3665  * associated to the item.
3666  *
3667  * @see elm_list_item_append()
3668  * @see elm_list_item_end_get()
3669  *
3670  * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3671  * @ingroup List
3672  */
3673 EINA_DEPRECATED EAPI void                         elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3674
3675 /**
3676  * Get the label of item.
3677  *
3678  * @param it The item of list.
3679  * @return The label of item.
3680  *
3681  * The return value is a pointer to the label associated to @p item when
3682  * it was created, with function elm_list_item_append(), or later
3683  * with function elm_list_item_label_set. If no label
3684  * was passed as argument, it will return @c NULL.
3685  *
3686  * @see elm_list_item_label_set() for more details.
3687  * @see elm_list_item_append()
3688  *
3689  * @deprecated Please use elm_object_item_text_get(item);
3690  * @ingroup List
3691  */
3692 EINA_DEPRECATED EAPI const char                  *elm_list_item_label_get(const Elm_Object_Item *it);
3693
3694 /**
3695  * Set the label of item.
3696  *
3697  * @param it The item of list.
3698  * @param text The label of item.
3699  *
3700  * The label to be displayed by the item.
3701  * Label will be placed between left and right side icons (if set).
3702  *
3703  * If a label was passed as argument on item creation, with function
3704  * elm_list_item_append() or similar, it will be already
3705  * displayed by the item.
3706  *
3707  * @see elm_list_item_label_get()
3708  * @see elm_list_item_append()
3709  *
3710  * @deprecated Please use elm_object_item_text_set(item, text);
3711  * @ingroup List
3712  */
3713 EINA_DEPRECATED EAPI void                         elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3714
3715 /**
3716  * Set the text to be shown in a given list item's tooltips.
3717  *
3718  * @param it Target item.
3719  * @param text The text to set in the content.
3720  *
3721  * Setup the text as tooltip to object. The item can have only one tooltip,
3722  * so any previous tooltip data - set with this function or
3723  * elm_list_item_tooltip_content_cb_set() - is removed.
3724  *
3725  * @deprecated Use elm_object_item_tooltip_text_set() instead
3726  * @see elm_object_tooltip_text_set() for more details.
3727  *
3728  * @ingroup List
3729  */
3730 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3731
3732 /**
3733  * @brief Disable size restrictions on an object's tooltip
3734  * @param it The tooltip's anchor object
3735  * @param disable If EINA_TRUE, size restrictions are disabled
3736  * @return EINA_FALSE on failure, EINA_TRUE on success
3737  *
3738  * This function allows a tooltip to expand beyond its parent window's canvas.
3739  * It will instead be limited only by the size of the display.
3740  *
3741  * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3742  *
3743  */
3744 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3745
3746 /**
3747  * @brief Retrieve size restriction state of an object's tooltip
3748  * @param obj The tooltip's anchor object
3749  * @return If EINA_TRUE, size restrictions are disabled
3750  *
3751  * This function returns whether a tooltip is allowed to expand beyond
3752  * its parent window's canvas.
3753  * It will instead be limited only by the size of the display.
3754  *
3755  * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3756  *
3757  */
3758 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3759
3760 /**
3761  * Set the content to be shown in the tooltip item.
3762  *
3763  * Setup the tooltip to item. The item can have only one tooltip,
3764  * so any previous tooltip data is removed. @p func(with @p data) will
3765  * be called every time that need show the tooltip and it should
3766  * return a valid Evas_Object. This object is then managed fully by
3767  * tooltip system and is deleted when the tooltip is gone.
3768  *
3769  * @param it the list item being attached a tooltip.
3770  * @param func the function used to create the tooltip contents.
3771  * @param data what to provide to @a func as callback data/context.
3772  * @param del_cb called when data is not needed anymore, either when
3773  *        another callback replaces @a func, the tooltip is unset with
3774  *        elm_list_item_tooltip_unset() or the owner @a item
3775  *        dies. This callback receives as the first parameter the
3776  *        given @a data, and @c event_info is the item.
3777  *
3778  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3779  *
3780  * @see elm_object_tooltip_content_cb_set() for more details.
3781  *
3782  * @ingroup List
3783  */
3784 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);
3785
3786 /**
3787  * Unset tooltip from item.
3788  *
3789  * @param it list item to remove previously set tooltip.
3790  *
3791  * Remove tooltip from item. The callback provided as del_cb to
3792  * elm_list_item_tooltip_content_cb_set() will be called to notify
3793  * it is not used anymore.
3794  *
3795  * @deprecated Use elm_object_item_tooltip_unset() instead
3796  * @see elm_object_tooltip_unset() for more details.
3797  * @see elm_list_item_tooltip_content_cb_set()
3798  *
3799  * @ingroup List
3800  */
3801 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_unset(Elm_Object_Item *it);
3802
3803 /**
3804  * Sets a different style for this item tooltip.
3805  *
3806  * @note before you set a style you should define a tooltip with
3807  *       elm_list_item_tooltip_content_cb_set() or
3808  *       elm_list_item_tooltip_text_set()
3809  *
3810  * @param it list item with tooltip already set.
3811  * @param style the theme style to use (default, transparent, ...)
3812  *
3813  *
3814  * @deprecated Use elm_object_item_tooltip_style_set() instead
3815  * @see elm_object_tooltip_style_set() for more details.
3816  *
3817  * @ingroup List
3818  */
3819 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3820
3821 /**
3822  * Get the style for this item tooltip.
3823  *
3824  * @param item list item with tooltip already set.
3825  * @return style the theme style in use, defaults to "default". If the
3826  *         object does not have a tooltip set, then NULL is returned.
3827  *
3828  * @deprecated Use elm_object_item_tooltip_style_get() instead
3829  *
3830  * @see elm_object_tooltip_style_get() for more details.
3831  * @see elm_list_item_tooltip_style_set()
3832  *
3833  * @ingroup List
3834  */
3835 EINA_DEPRECATED EAPI const char                  *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
3836
3837 /**
3838  * Set the type of mouse pointer/cursor decoration to be shown,
3839  * when the mouse pointer is over the given list widget item
3840  *
3841  * @param it list item to customize cursor on
3842  * @param cursor the cursor type's name
3843  *
3844  * This function works analogously as elm_object_cursor_set(), but
3845  * here the cursor's changing area is restricted to the item's
3846  * area, and not the whole widget's. Note that that item cursors
3847  * have precedence over widget cursors, so that a mouse over an
3848  * item with custom cursor set will always show @b that cursor.
3849  *
3850  * If this function is called twice for an object, a previously set
3851  * cursor will be unset on the second call.
3852  *
3853  * @see elm_object_cursor_set()
3854  * @see elm_list_item_cursor_get()
3855  * @see elm_list_item_cursor_unset()
3856  *
3857  * @deprecated Please use elm_object_item_cursor_set() instead
3858  * @ingroup List
3859  */
3860 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3861
3862 /*
3863  * Get the type of mouse pointer/cursor decoration set to be shown,
3864  * when the mouse pointer is over the given list widget item
3865  *
3866  * @param it list item with custom cursor set
3867  * @return the cursor type's name or @c NULL, if no custom cursors
3868  * were set to @p item (and on errors)
3869  *
3870  * @see elm_object_cursor_get()
3871  * @see elm_list_item_cursor_set()
3872  * @see elm_list_item_cursor_unset()
3873  *
3874  * @deprecated Please use elm_object_item_cursor_get() instead
3875  * @ingroup List
3876  */
3877 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_get(const Elm_Object_Item *it);
3878
3879 /**
3880  * Unset any custom mouse pointer/cursor decoration set to be
3881  * shown, when the mouse pointer is over the given list widget
3882  * item, thus making it show the @b default cursor again.
3883  *
3884  * @param it a list item
3885  *
3886  * Use this call to undo any custom settings on this item's cursor
3887  * decoration, bringing it back to defaults (no custom style set).
3888  *
3889  * @see elm_object_cursor_unset()
3890  * @see elm_list_item_cursor_set()
3891  *
3892  * @deprecated Please use elm_list_item_cursor_unset() instead
3893  * @ingroup List
3894  */
3895 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_unset(Elm_Object_Item *it);
3896
3897 /**
3898  * Set a different @b style for a given custom cursor set for a
3899  * list item.
3900  *
3901  * @param it list item with custom cursor set
3902  * @param style the <b>theme style</b> to use (e.g. @c "default",
3903  * @c "transparent", etc)
3904  *
3905  * This function only makes sense when one is using custom mouse
3906  * cursor decorations <b>defined in a theme file</b>, which can have,
3907  * given a cursor name/type, <b>alternate styles</b> on it. It
3908  * works analogously as elm_object_cursor_style_set(), but here
3909  * applies only to list item objects.
3910  *
3911  * @warning Before you set a cursor style you should have defined a
3912  *       custom cursor previously on the item, with
3913  *       elm_list_item_cursor_set()
3914  *
3915  * @see elm_list_item_cursor_engine_only_set()
3916  * @see elm_list_item_cursor_style_get()
3917  *
3918  * @deprecated Please use elm_list_item_cursor_style_set() instead
3919  * @ingroup List
3920  */
3921 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3922
3923 /**
3924  * Get the current @b style set for a given list item's custom
3925  * cursor
3926  *
3927  * @param it list item with custom cursor set.
3928  * @return style the cursor style in use. If the object does not
3929  *         have a cursor set, then @c NULL is returned.
3930  *
3931  * @see elm_list_item_cursor_style_set() for more details
3932  *
3933  * @deprecated Please use elm_list_item_cursor_style_get() instead
3934  * @ingroup List
3935  */
3936 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
3937
3938 /**
3939  * Set if the (custom)cursor for a given list item should be
3940  * searched in its theme, also, or should only rely on the
3941  * rendering engine.
3942  *
3943  * @param it item with custom (custom) cursor already set on
3944  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3945  * only on those provided by the rendering engine, @c EINA_FALSE to
3946  * have them searched on the widget's theme, as well.
3947  *
3948  * @note This call is of use only if you've set a custom cursor
3949  * for list items, with elm_list_item_cursor_set().
3950  *
3951  * @note By default, cursors will only be looked for between those
3952  * provided by the rendering engine.
3953  *
3954  * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
3955  * @ingroup List
3956  */
3957 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3958
3959 /**
3960  * Get if the (custom) cursor for a given list item is being
3961  * searched in its theme, also, or is only relying on the rendering
3962  * engine.
3963  *
3964  * @param it a list item
3965  * @return @c EINA_TRUE, if cursors are being looked for only on
3966  * those provided by the rendering engine, @c EINA_FALSE if they
3967  * are being searched on the widget's theme, as well.
3968  *
3969  * @see elm_list_item_cursor_engine_only_set(), for more details
3970  *
3971  * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
3972  * @ingroup List
3973  */
3974 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
3975
3976 /**
3977  * Delete the item from the list.
3978  *
3979  * @param it The item of list to be deleted.
3980  *
3981  * If deleting all list items is required, elm_list_clear()
3982  * should be used instead of getting items list and deleting each one.
3983  *
3984  * @see elm_list_clear()
3985  * @see elm_list_item_append()
3986  * @see elm_widget_item_del_cb_set()
3987  * @deprecated Use elm_object_item_del() instead
3988  *
3989  * @ingroup List
3990  */
3991 EINA_DEPRECATED EAPI void                         elm_list_item_del(Elm_Object_Item *it);
3992
3993 /**
3994  * Set the shrink state of toolbar @p obj.
3995  *
3996  * @param obj The toolbar object.
3997  * @param shrink_mode Toolbar's items display behavior.
3998  *
3999  * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
4000  * but will enforce a minimum size so all the items will fit, won't scroll
4001  * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
4002  * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
4003  * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
4004  *
4005  * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
4006  * @ingroup Toolbar
4007  */
4008 EINA_DEPRECATED EAPI void                         elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
4009
4010 /**
4011  * Get the shrink mode of toolbar @p obj.
4012  *
4013  * @param obj The toolbar object.
4014  * @return Toolbar's items display behavior.
4015  *
4016  * @see elm_toolbar_shrink_mode_set() for details.
4017  *
4018  * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
4019  * @ingroup Toolbar
4020  */
4021 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode      elm_toolbar_mode_shrink_get(const Evas_Object *obj);
4022
4023 /**
4024  * This sets a widget to be displayed to the left of a scrolled entry.
4025  *
4026  * @param obj The scrolled entry object
4027  * @param icon The widget to display on the left side of the scrolled
4028  * entry.
4029  *
4030  * @note A previously set widget will be destroyed.
4031  * @note If the object being set does not have minimum size hints set,
4032  * it won't get properly displayed.
4033  *
4034  * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4035  * @see elm_entry_end_set()
4036  */
4037 EINA_DEPRECATED EAPI void               elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4038
4039 /**
4040  * Gets the leftmost widget of the scrolled entry. This object is
4041  * owned by the scrolled entry and should not be modified.
4042  *
4043  * @param obj The scrolled entry object
4044  * @return the left widget inside the scroller
4045  *
4046  * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4047  */
4048 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_get(const Evas_Object *obj);
4049
4050 /**
4051  * Unset the leftmost widget of the scrolled entry, unparenting and
4052  * returning it.
4053  *
4054  * @param obj The scrolled entry object
4055  * @return the previously set icon sub-object of this entry, on
4056  * success.
4057  *
4058  * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4059  * @see elm_entry_icon_set()
4060  */
4061 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_unset(Evas_Object *obj);
4062
4063 /**
4064  * This sets a widget to be displayed to the end of a scrolled entry.
4065  *
4066  * @param obj The scrolled entry object
4067  * @param end The widget to display on the right side of the scrolled
4068  * entry.
4069  *
4070  * @note A previously set widget will be destroyed.
4071  * @note If the object being set does not have minimum size hints set,
4072  * it won't get properly displayed.
4073  *
4074  * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4075  * @see elm_entry_icon_set
4076  */
4077 EINA_DEPRECATED EAPI void               elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4078
4079 /**
4080  * Gets the endmost widget of the scrolled entry. This object is owned
4081  * by the scrolled entry and should not be modified.
4082  *
4083  * @param obj The scrolled entry object
4084  * @return the right widget inside the scroller
4085  *
4086  * @deprecated Use elm_object_part_content_get(entry, "end") instead
4087  */
4088 EAPI Evas_Object       *elm_entry_end_get(const Evas_Object *obj);
4089
4090 /**
4091  * Unset the endmost widget of the scrolled entry, unparenting and
4092  * returning it.
4093  *
4094  * @param obj The scrolled entry object
4095  * @return the previously set icon sub-object of this entry, on
4096  * success.
4097  *
4098  * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4099  * @see elm_entry_icon_set()
4100  */
4101 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_end_unset(Evas_Object *obj);
4102
4103 /**
4104  * Convert a pixel coordinate into a rotated pixel coordinate.
4105  *
4106  * @param obj The map object.
4107  * @param x horizontal coordinate of the point to rotate.
4108  * @param y vertical coordinate of the point to rotate.
4109  * @param cx rotation's center horizontal position.
4110  * @param cy rotation's center vertical position.
4111  * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4112  * @param xx Pointer where to store rotated x.
4113  * @param yy Pointer where to store rotated y.
4114  *
4115  * @ingroup Map
4116  * @deprecated Rotation is not needed to know. Use elm_map_canvas_to_geo_convert() instead
4117  */
4118 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);
4119
4120 /**
4121  * Get the gengrid object's handle which contains a given gengrid item
4122  *
4123  * @param it The item to fetch the container from
4124  * @return The gengrid (parent) object
4125  *
4126  * This returns the gengrid object itself that an item belongs to.
4127  *
4128  * @deprecated Use elm_object_item_widget_get() instead
4129  * @ingroup Gengrid
4130  */
4131 EINA_DEPRECATED EAPI Evas_Object                  *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4132
4133 /**
4134  * Return the data associated to a given gengrid item
4135  *
4136  * @param it The gengrid item.
4137  * @return the data associated with this item.
4138  *
4139  * This returns the @c data value passed on the
4140  * elm_gengrid_item_append() and related item addition calls.
4141  *
4142  * @see elm_gengrid_item_append()
4143  * @see elm_gengrid_item_data_set()
4144  * @deprecated Use elm_object_item_data_get() instead
4145  * @ingroup Gengrid
4146  */
4147 EINA_DEPRECATED EAPI void                         *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4148
4149 /**
4150  * Set the data associated with a given gengrid item
4151  *
4152  * @param it The gengrid item
4153  * @param data The data pointer to set on it
4154  *
4155  * This @b overrides the @c data value passed on the
4156  * elm_gengrid_item_append() and related item addition calls. This
4157  * function @b won't call elm_gengrid_item_update() automatically,
4158  * so you'd issue it afterwards if you want to have the item
4159  * updated to reflect the new data.
4160  *
4161  * @see elm_gengrid_item_data_get()
4162  * @see elm_gengrid_item_update()
4163  * @deprecated Use elm_object_item_data_set() instead
4164  *
4165  * @ingroup Gengrid
4166  */
4167 EINA_DEPRECATED EAPI void                          elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4168
4169 /**
4170  * Set whether a given gengrid item is disabled or not.
4171  *
4172  * @param it The gengrid item
4173  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4174  * to enable it back.
4175  *
4176  * A disabled item cannot be selected or unselected. It will also
4177  * change its appearance, to signal the user it's disabled.
4178  *
4179  * @see elm_gengrid_item_disabled_get()
4180  * @deprecated Use elm_object_item_disabled_set() instead
4181  *
4182  * @ingroup Gengrid
4183  */
4184 EINA_DEPRECATED EAPI void                          elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4185
4186 /**
4187  * Get whether a given gengrid item is disabled or not.
4188  *
4189  * @param it The gengrid item
4190  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4191  * (and on errors).
4192  *
4193  * @see elm_gengrid_item_disabled_set() for more details
4194  * @deprecated Use elm_object_item_disabled_get() instead
4195  *
4196  * @ingroup Gengrid
4197  */
4198 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4199
4200 /**
4201  * Remove a gengrid item from its parent, deleting it.
4202  *
4203  * @param it The item to be removed.
4204  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4205  *
4206  * @see elm_gengrid_clear(), to remove all items in a gengrid at
4207  * once.
4208  * @deprecated use elm_object_item_de() instead
4209  *
4210  * @ingroup Gengrid
4211  */
4212 EINA_DEPRECATED EAPI void                          elm_gengrid_item_del(Elm_Object_Item *it);
4213
4214 /**
4215  * Append a filter function for text inserted in the entry
4216  *
4217  * Append the given callback to the list. This functions will be called
4218  * whenever any text is inserted into the entry, with the text to be inserted
4219  * as a parameter. The callback function is free to alter the text in any way
4220  * it wants, but it must remember to free the given pointer and update it.
4221  * If the new text is to be discarded, the function can free it and set its
4222  * text parameter to NULL. This will also prevent any following filters from
4223  * being called.
4224  *
4225  * @param obj The entry object
4226  * @param func The function to use as text filter
4227  * @param data User data to pass to @p func
4228  * @deprecated use elm_entry_markup_filter_append() instead
4229  * @ingroup Entry 
4230  */
4231 EINA_DEPRECATED EAPI void               elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4232
4233 /**
4234  * Prepend a filter function for text inserted in the entry
4235  *
4236  * Prepend the given callback to the list. See elm_entry_text_filter_append()
4237  * for more information
4238  *
4239  * @param obj The entry object
4240  * @param func The function to use as text filter
4241  * @param data User data to pass to @p func
4242  * @deprecated use elm_entry_markup_filter_prepend() instead
4243  * @ingroup Entry
4244  */
4245 EINA_DEPRECATED EAPI void               elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4246
4247 /**
4248  * Remove a filter from the list
4249  *
4250  * Removes the given callback from the filter list. See
4251  * elm_entry_text_filter_append() for more information.
4252  *
4253  * @param obj The entry object
4254  * @param func The filter function to remove
4255  * @param data The user data passed when adding the function
4256  * @deprecated use elm_entry_markup_filter_remove() instead
4257  * @ingroup Entry
4258  */
4259 EINA_DEPRECATED EAPI void               elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);