2 * @brief Get Elementary's rendering engine in use.
4 * @return The rendering engine's name
5 * @note there's no need to free the returned string, here.
7 * This gets the global rendering engine that is applied to all Elementary
10 * @see elm_engine_set()
11 * @deprecated Use elm_engine_get() instead.
13 EINA_DEPRECATED EAPI const char *elm_engine_current_get(void);
16 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
17 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
18 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
19 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
20 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
21 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
22 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
23 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
24 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
25 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
26 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
28 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
29 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
30 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
31 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
32 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
33 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
34 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
35 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
36 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
37 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
40 * Get the widget object's handle which contains a given item
42 * @param it The Elementary object item
43 * @return The widget object
45 * @note This returns the widget object itself that an item belongs to.
46 * @note Every elm_object_item supports this API
47 * @deprecated Use elm_object_item_widget_get() instead
50 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_object_get(const Elm_Object_Item *it);
53 * @defgroup Toggle Toggle
55 * @image html img/widget/toggle/preview-00.png
56 * @image latex img/widget/toggle/preview-00.eps
58 * @brief A toggle is a slider which can be used to toggle between
59 * two values. It has two states: on and off.
61 * This widget is deprecated. Please use elm_check_add() instead using the
65 * obj = elm_check_add(parent);
66 * elm_object_style_set(obj, "toggle");
67 * elm_object_part_text_set(obj, "on", "ON");
68 * elm_object_part_text_set(obj, "off", "OFF");
71 * Signals that you can add callbacks for are:
72 * @li "changed" - Whenever the toggle value has been changed. Is not called
73 * until the toggle is released by the cursor (assuming it
74 * has been triggered by the cursor in the first place).
76 * Default contents parts of the toggle widget that you can use for are:
77 * @li "icon" - An icon of the toggle
79 * Default text parts of the toggle widget that you can use for are:
80 * @li "elm.text" - Label of the toggle
82 * @ref tutorial_toggle show how to use a toggle.
87 * @brief Add a toggle to @p parent.
89 * @param parent The parent object
91 * @return The toggle object
93 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
96 * @brief Sets the label to be displayed with the toggle.
98 * @param obj The toggle object
99 * @param label The label to be displayed
101 * @deprecated use elm_object_text_set() instead.
103 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
106 * @brief Gets the label of the toggle
108 * @param obj toggle object
109 * @return The label of the toggle
111 * @deprecated use elm_object_text_get() instead.
113 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
116 * @brief Set the icon used for the toggle
118 * @param obj The toggle object
119 * @param icon The icon object for the button
121 * Once the icon object is set, a previously set one will be deleted
122 * If you want to keep that old content object, use the
123 * elm_toggle_icon_unset() function.
125 * @deprecated use elm_object_part_content_set() instead.
127 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
130 * @brief Get the icon used for the toggle
132 * @param obj The toggle object
133 * @return The icon object that is being used
135 * Return the icon object which is set for this widget.
137 * @see elm_toggle_icon_set()
139 * @deprecated use elm_object_part_content_get() instead.
141 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
144 * @brief Unset the icon used for the toggle
146 * @param obj The toggle object
147 * @return The icon object that was being used
149 * Unparent and return the icon object which was set for this widget.
151 * @see elm_toggle_icon_set()
153 * @deprecated use elm_object_part_content_unset() instead.
155 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
158 * @brief Sets the labels to be associated with the on and off states of the toggle.
160 * @param obj The toggle object
161 * @param onlabel The label displayed when the toggle is in the "on" state
162 * @param offlabel The label displayed when the toggle is in the "off" state
164 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
167 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
170 * @brief Gets the labels associated with the on and off states of the
173 * @param obj The toggle object
174 * @param onlabel A char** to place the onlabel of @p obj into
175 * @param offlabel A char** to place the offlabel of @p obj into
177 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
180 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
183 * @brief Sets the state of the toggle to @p state.
185 * @param obj The toggle object
186 * @param state The state of @p obj
188 * @deprecated use elm_check_state_set() instead.
190 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
193 * @brief Gets the state of the toggle to @p state.
195 * @param obj The toggle object
196 * @return The state of @p obj
198 * @deprecated use elm_check_state_get() instead.
200 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
203 * @brief Sets the state pointer of the toggle to @p statep.
205 * @param obj The toggle object
206 * @param statep The state pointer of @p obj
208 * @deprecated use elm_check_state_pointer_set() instead.
210 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
216 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
217 EINA_DEPRECATED EAPI void elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
218 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_single_line_get(const Evas_Object *obj);
219 EINA_DEPRECATED EAPI void elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
220 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_password_get(const Evas_Object *obj);
221 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
222 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_entry_get(const Evas_Object *obj);
223 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
224 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_is_empty(const Evas_Object *obj);
225 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_selection_get(const Evas_Object *obj);
226 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
227 EINA_DEPRECATED EAPI void elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
228 EINA_DEPRECATED EAPI void elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
229 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_editable_get(const Evas_Object *obj);
230 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_none(Evas_Object *obj);
231 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_all(Evas_Object *obj);
232 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_next(Evas_Object *obj);
233 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_prev(Evas_Object *obj);
234 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_up(Evas_Object *obj);
235 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_down(Evas_Object *obj);
236 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
237 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
238 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
239 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
240 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
241 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
242 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
243 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
244 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
245 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
246 EINA_DEPRECATED EAPI int elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
247 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_cut(Evas_Object *obj);
248 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_copy(Evas_Object *obj);
249 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_paste(Evas_Object *obj);
250 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
251 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);
252 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
253 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
254 EINA_DEPRECATED EAPI void elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
255 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
256 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
257 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
258 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
259 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
260 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
261 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
262 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
263 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
264 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
265 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);
266 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);
267 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);
268 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
269 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
270 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
271 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
272 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
273 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_save(Evas_Object *obj);
274 EINA_DEPRECATED EAPI void elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
275 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_autosave_get(const Evas_Object *obj);
276 EINA_DEPRECATED EAPI void elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
277 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
280 * Set the text to show in the anchorblock
282 * Sets the text of the anchorblock to @p text. This text can include markup
283 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
284 * of text that will be specially styled and react to click events, ended
285 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
286 * "anchor,clicked" signal that you can attach a callback to with
287 * evas_object_smart_callback_add(). The name of the anchor given in the
288 * event info struct will be the one set in the href attribute, in this
291 * Other markup can be used to style the text in different ways, but it's
292 * up to the style defined in the theme which tags do what.
293 * @deprecated use elm_object_text_set() instead.
295 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
298 * Get the markup text set for the anchorblock
300 * Retrieves the text set on the anchorblock, with markup tags included.
302 * @param obj The anchorblock object
303 * @return The markup text set or @c NULL if nothing was set or an error
305 * @deprecated use elm_object_text_set() instead.
307 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
310 * Set the text to show in the anchorview
312 * Sets the text of the anchorview to @p text. This text can include markup
313 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
314 * text that will be specially styled and react to click events, ended with
315 * either of \</a\> or \</\>. When clicked, the anchor will emit an
316 * "anchor,clicked" signal that you can attach a callback to with
317 * evas_object_smart_callback_add(). The name of the anchor given in the
318 * event info struct will be the one set in the href attribute, in this
321 * Other markup can be used to style the text in different ways, but it's
322 * up to the style defined in the theme which tags do what.
323 * @deprecated use elm_object_text_set() instead.
325 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
328 * Get the markup text set for the anchorview
330 * Retrieves the text set on the anchorview, with markup tags included.
332 * @param obj The anchorview object
333 * @return The markup text set or @c NULL if nothing was set or an error
335 * @deprecated use elm_object_text_set() instead.
337 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
340 * @brief Get the ctxpopup item's disabled/enabled state.
342 * @param it Ctxpopup item to be enabled/disabled
343 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
345 * @see elm_ctxpopup_item_disabled_set()
346 * @deprecated use elm_object_item_disabled_get() instead
350 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
353 * @brief Set the ctxpopup item's state as disabled or enabled.
355 * @param it Ctxpopup item to be enabled/disabled
356 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
358 * When disabled the item is greyed out to indicate it's state.
359 * @deprecated use elm_object_item_disabled_set() instead
363 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
366 * @brief Get the icon object for the given ctxpopup item.
368 * @param it Ctxpopup item
369 * @return icon object or @c NULL, if the item does not have icon or an error
372 * @see elm_ctxpopup_item_append()
373 * @see elm_ctxpopup_item_icon_set()
375 * @deprecated use elm_object_item_part_content_get() instead
379 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
382 * @brief Sets the side icon associated with the ctxpopup item
384 * @param it Ctxpopup item
385 * @param icon Icon object to be set
387 * Once the icon object is set, a previously set one will be deleted.
388 * @warning Setting the same icon for two items will cause the icon to
389 * disappear from the first item.
391 * @see elm_ctxpopup_item_append()
393 * @deprecated use elm_object_item_part_content_set() instead
397 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
400 * @brief Get the label for the given ctxpopup item.
402 * @param it Ctxpopup item
403 * @return label string or @c NULL, if the item does not have label or an
406 * @see elm_ctxpopup_item_append()
407 * @see elm_ctxpopup_item_label_set()
409 * @deprecated use elm_object_item_text_get() instead
413 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
416 * @brief (Re)set the label on the given ctxpopup item.
418 * @param it Ctxpopup item
419 * @param label String to set as label
421 * @deprecated use elm_object_item_text_set() instead
425 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
428 * @brief Set an elm widget as the content of the ctxpopup.
430 * @param obj Ctxpopup object
431 * @param content Content to be swallowed
433 * If the content object is already set, a previous one will be deleted. If
434 * you want to keep that old content object, use the
435 * elm_ctxpopup_content_unset() function.
437 * @warning Ctxpopup can't hold both a item list and a content at the same
438 * time. When a content is set, any previous items will be removed.
440 * @deprecated use elm_object_content_set() instead
444 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
447 * @brief Unset the ctxpopup content
449 * @param obj Ctxpopup object
450 * @return The content that was being used
452 * Unparent and return the content object which was set for this widget.
454 * @deprecated use elm_object_content_unset()
456 * @see elm_ctxpopup_content_set()
458 * @deprecated use elm_object_content_unset() instead
462 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
465 * @brief Delete the given item in a ctxpopup object.
467 * @param it Ctxpopup item to be deleted
469 * @deprecated Use elm_object_item_del() instead
470 * @see elm_ctxpopup_item_append()
474 EINA_DEPRECATED EAPI void elm_ctxpopup_item_del(Elm_Object_Item *it);
477 * Set the label for a given file selector button widget
479 * @param obj The file selector button widget
480 * @param label The text label to be displayed on @p obj
482 * @deprecated use elm_object_text_set() instead.
484 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
487 * Get the label set for a given file selector button widget
489 * @param obj The file selector button widget
490 * @return The button label
492 * @deprecated use elm_object_text_set() instead.
494 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
497 * Set the icon on a given file selector button widget
499 * @param obj The file selector button widget
500 * @param icon The icon object for the button
502 * Once the icon object is set, a previously set one will be
503 * deleted. If you want to keep the latter, use the
504 * elm_fileselector_button_icon_unset() function.
506 * @deprecated Use elm_object_part_content_set() instead
507 * @see elm_fileselector_button_icon_get()
509 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
512 * Get the icon set for a given file selector button widget
514 * @param obj The file selector button widget
515 * @return The icon object currently set on @p obj or @c NULL, if
518 * @deprecated Use elm_object_part_content_get() instead
519 * @see elm_fileselector_button_icon_set()
521 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
524 * Unset the icon used in a given file selector button widget
526 * @param obj The file selector button widget
527 * @return The icon object that was being used on @p obj or @c
530 * Unparent and return the icon object which was set for this
533 * @deprecated Use elm_object_part_content_unset() instead
534 * @see elm_fileselector_button_icon_set()
536 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
539 * Set the label for a given file selector entry widget's button
541 * @param obj The file selector entry widget
542 * @param label The text label to be displayed on @p obj widget's
545 * @deprecated use elm_object_text_set() instead.
547 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
550 * Get the label set for a given file selector entry widget's button
552 * @param obj The file selector entry widget
553 * @return The widget button's label
555 * @deprecated use elm_object_text_set() instead.
557 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
560 * Set the icon on a given file selector entry widget's button
562 * @param obj The file selector entry widget
563 * @param icon The icon object for the entry's button
565 * Once the icon object is set, a previously set one will be
566 * deleted. If you want to keep the latter, use the
567 * elm_fileselector_entry_button_icon_unset() function.
569 * @deprecated Use elm_object_part_content_set() instead
570 * @see elm_fileselector_entry_button_icon_get()
572 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
575 * Get the icon set for a given file selector entry widget's button
577 * @param obj The file selector entry widget
578 * @return The icon object currently set on @p obj widget's button
579 * or @c NULL, if none is
581 * @deprecated Use elm_object_part_content_get() instead
582 * @see elm_fileselector_entry_button_icon_set()
584 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
587 * Unset the icon used in a given file selector entry widget's
590 * @param obj The file selector entry widget
591 * @return The icon object that was being used on @p obj widget's
592 * button or @c NULL, on errors
594 * Unparent and return the icon object which was set for this
597 * @deprecated Use elm_object_part_content_unset() instead
598 * @see elm_fileselector_entry_button_icon_set()
600 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
603 * @brief Sets the content of the hover object and the direction in which it
606 * @param obj The hover object
607 * @param swallow The direction that the object will be displayed
608 * at. Accepted values are "left", "top-left", "top", "top-right",
609 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
611 * @param content The content to place at @p swallow
613 * Once the content object is set for a given direction, a previously
614 * set one (on the same direction) will be deleted. If you want to
615 * keep that old content object, use the elm_object_part_content_unset()
618 * All directions may have contents at the same time, except for
619 * "smart". This is a special placement hint and its use case
620 * depends of the calculations coming from
621 * elm_hover_best_content_location_get(). Its use is for cases when
622 * one desires only one hover content, but with a dynamic special
623 * placement within the hover area. The content's geometry, whenever
624 * it changes, will be used to decide on a best location, not
625 * extrapolating the hover's parent object view to show it in (still
626 * being the hover's target determinant of its medium part -- move and
627 * resize it to simulate finger sizes, for example). If one of the
628 * directions other than "smart" are used, a previously content set
629 * using it will be deleted, and vice-versa.
631 * @deprecated Use elm_object_part_content_set() instead
633 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
636 * @brief Get the content of the hover object, in a given direction.
638 * Return the content object which was set for this widget in the
639 * @p swallow direction.
641 * @param obj The hover object
642 * @param swallow The direction that the object was display at.
643 * @return The content that was being used
645 * @deprecated Use elm_object_part_content_get() instead
646 * @see elm_object_part_content_set()
648 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
651 * @brief Unset the content of the hover object, in a given direction.
653 * Unparent and return the content object set at @p swallow direction.
655 * @param obj The hover object
656 * @param swallow The direction that the object was display at.
657 * @return The content that was being used.
659 * @deprecated Use elm_object_part_content_unset() instead
660 * @see elm_object_part_content_set()
662 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
665 * @brief Set the hoversel button label
667 * @param obj The hoversel object
668 * @param label The label text.
670 * This sets the label of the button that is always visible (before it is
671 * clicked and expanded).
673 * @deprecated elm_object_text_set()
675 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
678 * @brief Get the hoversel button label
680 * @param obj The hoversel object
681 * @return The label text.
683 * @deprecated elm_object_text_get()
685 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
688 * @brief Set the icon of the hoversel button
690 * @param obj The hoversel object
691 * @param icon The icon object
693 * Sets the icon of the button that is always visible (before it is clicked
694 * and expanded). Once the icon object is set, a previously set one will be
695 * deleted, if you want to keep that old content object, use the
696 * elm_hoversel_icon_unset() function.
698 * @see elm_object_content_set() for the button widget
699 * @deprecated Use elm_object_item_part_content_set() instead
701 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
704 * @brief Get the icon of the hoversel button
706 * @param obj The hoversel object
707 * @return The icon object
709 * Get the icon of the button that is always visible (before it is clicked
710 * and expanded). Also see elm_object_content_get() for the button widget.
712 * @see elm_hoversel_icon_set()
713 * @deprecated Use elm_object_item_part_content_get() instead
715 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
718 * @brief Get and unparent the icon of the hoversel button
720 * @param obj The hoversel object
721 * @return The icon object that was being used
723 * Unparent and return the icon of the button that is always visible
724 * (before it is clicked and expanded).
726 * @see elm_hoversel_icon_set()
727 * @see elm_object_content_unset() for the button widget
728 * @deprecated Use elm_object_item_part_content_unset() instead
730 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
733 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
734 * that will be passed to associated function callbacks.
736 * @param it The item to get the data from
737 * @return The data pointer set with elm_hoversel_item_add()
739 * @see elm_hoversel_item_add()
740 * @deprecated Use elm_object_item_data_get() instead
742 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
745 * @brief This returns the label text of the given hoversel item.
747 * @param it The item to get the label
748 * @return The label text of the hoversel item
750 * @see elm_hoversel_item_add()
751 * @deprecated Use elm_object_item_text_get() instead
753 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
756 * @brief Set the function to be called when an item from the hoversel is
759 * @param it The item to set the callback on
760 * @param func The function called
762 * That function will receive these parameters:
763 * @li void * item data
764 * @li Evas_Object * hoversel object
765 * @li Elm_Object_Item * hoversel item
767 * @see elm_hoversel_item_add()
768 * @deprecated Use elm_object_item_del_cb_set() instead
770 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
773 * @brief Delete an item from the hoversel
775 * @param it The item to delete
777 * This deletes the item from the hoversel (should not be called while the
778 * hoversel is active; use elm_hoversel_expanded_get() to check first).
780 * @deprecated Use elm_object_item_del() instead
781 * @see elm_hoversel_item_add()
783 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
786 * Set actionslider labels.
788 * @param obj The actionslider object
789 * @param left_label The label to be set on the left.
790 * @param center_label The label to be set on the center.
791 * @param right_label The label to be set on the right.
792 * @deprecated use elm_object_text_set() instead.
794 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
797 * Get actionslider labels.
799 * @param obj The actionslider object
800 * @param left_label A char** to place the left_label of @p obj into.
801 * @param center_label A char** to place the center_label of @p obj into.
802 * @param right_label A char** to place the right_label of @p obj into.
803 * @deprecated use elm_object_text_set() instead.
805 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
808 * Set the label used on the indicator.
810 * @param obj The actionslider object
811 * @param label The label to be set on the indicator.
812 * @deprecated use elm_object_text_set() instead.
814 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
817 * Get the label used on the indicator object.
819 * @param obj The actionslider object
820 * @return The indicator label
821 * @deprecated use elm_object_text_get() instead.
823 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
826 * Set the overlay object used for the background object.
828 * @param obj The bg object
829 * @param overlay The overlay object
831 * This provides a way for elm_bg to have an 'overlay' that will be on top
832 * of the bg. Once the over object is set, a previously set one will be
833 * deleted, even if you set the new one to NULL. If you want to keep that
834 * old content object, use the elm_bg_overlay_unset() function.
836 * @deprecated use elm_object_part_content_set() instead
841 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
844 * Get the overlay object used for the background object.
846 * @param obj The bg object
847 * @return The content that is being used
849 * Return the content object which is set for this widget
851 * @deprecated use elm_object_part_content_get() instead
855 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
858 * Get the overlay object used for the background object.
860 * @param obj The bg object
861 * @return The content that was being used
863 * Unparent and return the overlay object which was set for this widget
865 * @deprecated use elm_object_part_content_unset() instead
869 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
873 * Set the label of the bubble
875 * @param obj The bubble object
876 * @param label The string to set in the label
878 * This function sets the title of the bubble. Where this appears depends on
879 * the selected corner.
880 * @deprecated use elm_object_text_set() instead.
882 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
885 * Get the label of the bubble
887 * @param obj The bubble object
888 * @return The string of set in the label
890 * This function gets the title of the bubble.
891 * @deprecated use elm_object_text_get() instead.
893 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
896 * Set the info of the bubble
898 * @param obj The bubble object
899 * @param info The given info about the bubble
901 * This function sets the info of the bubble. Where this appears depends on
902 * the selected corner.
903 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
905 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
908 * Get the info of the bubble
910 * @param obj The bubble object
912 * @return The "info" string of the bubble
914 * This function gets the info text.
915 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
917 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
920 * Set the content to be shown in the bubble
922 * Once the content object is set, a previously set one will be deleted.
923 * If you want to keep the old content object, use the
924 * elm_bubble_content_unset() function.
926 * @param obj The bubble object
927 * @param content The given content of the bubble
929 * This function sets the content shown on the middle of the bubble.
931 * @deprecated use elm_object_content_set() instead
934 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
937 * Get the content shown in the bubble
939 * Return the content object which is set for this widget.
941 * @param obj The bubble object
942 * @return The content that is being used
944 * @deprecated use elm_object_content_get() instead
947 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
950 * Unset the content shown in the bubble
952 * Unparent and return the content object which was set for this widget.
954 * @param obj The bubble object
955 * @return The content that was being used
957 * @deprecated use elm_object_content_unset() instead
960 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
963 * Set the icon of the bubble
965 * Once the icon object is set, a previously set one will be deleted.
966 * If you want to keep the old content object, use the
967 * elm_icon_content_unset() function.
969 * @param obj The bubble object
970 * @param icon The given icon for the bubble
972 * @deprecated use elm_object_part_content_set() instead
975 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
978 * Get the icon of the bubble
980 * @param obj The bubble object
981 * @return The icon for the bubble
983 * This function gets the icon shown on the top left of bubble.
985 * @deprecated use elm_object_part_content_get() instead
988 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
991 * Unset the icon of the bubble
993 * Unparent and return the icon object which was set for this widget.
995 * @param obj The bubble object
996 * @return The icon that was being used
998 * @deprecated use elm_object_part_content_unset() instead
1001 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
1005 * Set the label used in the button
1007 * The passed @p label can be NULL to clean any existing text in it and
1008 * leave the button as an icon only object.
1010 * @param obj The button object
1011 * @param label The text will be written on the button
1012 * @deprecated use elm_object_text_set() instead.
1014 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
1017 * Get the label set for the button
1019 * The string returned is an internal pointer and should not be freed or
1020 * altered. It will also become invalid when the button is destroyed.
1021 * The string returned, if not NULL, is a stringshare, so if you need to
1022 * keep it around even after the button is destroyed, you can use
1023 * eina_stringshare_ref().
1025 * @param obj The button object
1026 * @return The text set to the label, or NULL if nothing is set
1027 * @deprecated use elm_object_text_set() instead.
1029 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
1032 * Set the icon used for the button
1034 * Setting a new icon will delete any other that was previously set, making
1035 * any reference to them invalid. If you need to maintain the previous
1036 * object alive, unset it first with elm_button_icon_unset().
1038 * @param obj The button object
1039 * @param icon The icon object for the button
1040 * @deprecated use elm_object_part_content_set() instead.
1042 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
1045 * Get the icon used for the button
1047 * Return the icon object which is set for this widget. If the button is
1048 * destroyed or another icon is set, the returned object will be deleted
1049 * and any reference to it will be invalid.
1051 * @param obj The button object
1052 * @return The icon object that is being used
1054 * @deprecated use elm_object_part_content_get() instead
1056 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
1059 * Remove the icon set without deleting it and return the object
1061 * This function drops the reference the button holds of the icon object
1062 * and returns this last object. It is used in case you want to remove any
1063 * icon, or set another one, without deleting the actual object. The button
1064 * will be left without an icon set.
1066 * @param obj The button object
1067 * @return The icon object that was being used
1068 * @deprecated use elm_object_part_content_unset() instead.
1070 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
1073 * Set a day text color to the same that represents Saturdays.
1075 * @param obj The calendar object.
1076 * @param pos The text position. Position is the cell counter, from left
1077 * to right, up to down. It starts on 0 and ends on 41.
1079 * @deprecated use elm_calendar_mark_add() instead like:
1082 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
1083 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1086 * @see elm_calendar_mark_add()
1090 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
1093 * Set a day text color to the same that represents Sundays.
1095 * @param obj The calendar object.
1096 * @param pos The text position. Position is the cell counter, from left
1097 * to right, up to down. It starts on 0 and ends on 41.
1099 * @deprecated use elm_calendar_mark_add() instead like:
1102 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
1103 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
1106 * @see elm_calendar_mark_add()
1110 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
1113 * Set a day text color to the same that represents Weekdays.
1115 * @param obj The calendar object
1116 * @param pos The text position. Position is the cell counter, from left
1117 * to right, up to down. It starts on 0 and ends on 41.
1119 * @deprecated use elm_calendar_mark_add() instead like:
1122 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1124 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1125 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1126 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1127 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1128 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1129 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1130 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1131 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1132 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1135 * @see elm_calendar_mark_add()
1139 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1143 * @brief Set the text label of the check object
1145 * @param obj The check object
1146 * @param label The text label string in UTF-8
1148 * @deprecated use elm_object_text_set() instead.
1150 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1153 * @brief Get the text label of the check object
1155 * @param obj The check object
1156 * @return The text label string in UTF-8
1158 * @deprecated use elm_object_text_get() instead.
1160 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1163 * @brief Set the icon object of the check object
1165 * @param obj The check object
1166 * @param icon The icon object
1168 * Once the icon object is set, a previously set one will be deleted.
1169 * If you want to keep that old content object, use the
1170 * elm_object_content_unset() function.
1172 * @deprecated use elm_object_part_content_set() instead.
1175 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1178 * @brief Get the icon object of the check object
1180 * @param obj The check object
1181 * @return The icon object
1183 * @deprecated use elm_object_part_content_get() instead.
1186 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1189 * @brief Unset the icon used for the check object
1191 * @param obj The check object
1192 * @return The icon object that was being used
1194 * Unparent and return the icon object which was set for this widget.
1196 * @deprecated use elm_object_part_content_unset() instead.
1199 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1202 * @brief Set the text label of the check object
1204 * @param obj The check object
1205 * @param label The text label string in UTF-8
1207 * @deprecated use elm_object_text_set() instead.
1209 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1212 * @brief Get the text label of the check object
1214 * @param obj The check object
1215 * @return The text label string in UTF-8
1217 * @deprecated use elm_object_text_get() instead.
1219 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1222 * @brief Set the icon object of the check object
1224 * @param obj The check object
1225 * @param icon The icon object
1227 * Once the icon object is set, a previously set one will be deleted.
1228 * If you want to keep that old content object, use the
1229 * elm_object_content_unset() function.
1231 * @deprecated use elm_object_part_content_set() instead.
1234 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1237 * @brief Get the icon object of the check object
1239 * @param obj The check object
1240 * @return The icon object
1242 * @deprecated use elm_object_part_content_get() instead.
1245 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1248 * @brief Unset the icon used for the check object
1250 * @param obj The check object
1251 * @return The icon object that was being used
1253 * Unparent and return the icon object which was set for this widget.
1255 * @deprecated use elm_object_part_content_unset() instead.
1258 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1260 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1261 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1265 * Set the content of the conformant widget.
1267 * @param obj The conformant object.
1268 * @param content The content to be displayed by the conformant.
1270 * Content will be sized and positioned considering the space required
1271 * to display a virtual keyboard. So it won't fill all the conformant
1272 * size. This way is possible to be sure that content won't resize
1273 * or be re-positioned after the keyboard is displayed.
1275 * Once the content object is set, a previously set one will be deleted.
1276 * If you want to keep that old content object, use the
1277 * elm_object_content_unset() function.
1279 * @see elm_object_content_unset()
1280 * @see elm_object_content_get()
1282 * @deprecated use elm_object_content_set() instead
1284 * @ingroup Conformant
1286 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1289 * Get the content of the conformant widget.
1291 * @param obj The conformant object.
1292 * @return The content that is being used.
1294 * Return the content object which is set for this widget.
1295 * It won't be unparent from conformant. For that, use
1296 * elm_object_content_unset().
1298 * @see elm_object_content_set().
1299 * @see elm_object_content_unset()
1301 * @deprecated use elm_object_content_get() instead
1303 * @ingroup Conformant
1305 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1308 * Unset the content of the conformant widget.
1310 * @param obj The conformant object.
1311 * @return The content that was being used.
1313 * Unparent and return the content object which was set for this widget.
1315 * @see elm_object_content_set().
1317 * @deprecated use elm_object_content_unset() instead
1319 * @ingroup Conformant
1321 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1324 * Get the side labels max length.
1326 * @deprecated use elm_diskselector_side_label_length_get() instead:
1328 * @param obj The diskselector object.
1329 * @return The max length defined for side labels, or 0 if not a valid
1332 * @ingroup Diskselector
1334 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1337 * Set the side labels max length.
1339 * @deprecated use elm_diskselector_side_label_length_set() instead:
1341 * @param obj The diskselector object.
1342 * @param len The max length defined for side labels.
1344 * @ingroup Diskselector
1346 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1349 * Get the data associated to the item.
1351 * @param it The diskselector item
1352 * @return The data associated to @p it
1354 * The return value is a pointer to data associated to @p item when it was
1355 * created, with function elm_diskselector_item_append(). If no data
1356 * was passed as argument, it will return @c NULL.
1358 * @see elm_diskselector_item_append()
1359 * @deprecated Use elm_object_item_data_get()
1361 * @ingroup Diskselector
1363 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1366 * Set the icon associated to the item.
1368 * @param it The diskselector item
1369 * @param icon The icon object to associate with @p it
1371 * The icon object to use at left side of the item. An
1372 * icon can be any Evas object, but usually it is an icon created
1373 * with elm_icon_add().
1375 * Once the icon object is set, a previously set one will be deleted.
1376 * @warning Setting the same icon for two items will cause the icon to
1377 * disappear from the first item.
1379 * If an icon was passed as argument on item creation, with function
1380 * elm_diskselector_item_append(), it will be already
1381 * associated to the item.
1383 * @see elm_diskselector_item_append()
1384 * @see elm_diskselector_item_icon_get()
1386 * @deprecated Use elm_object_item_part_content_set() instead
1387 * @ingroup Diskselector
1389 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1392 * Get the icon associated to the item.
1394 * @param item The diskselector item
1395 * @return The icon associated to @p it
1397 * The return value is a pointer to the icon associated to @p item when it was
1398 * created, with function elm_diskselector_item_append(), or later
1399 * with function elm_diskselector_item_icon_set. If no icon
1400 * was passed as argument, it will return @c NULL.
1402 * @see elm_diskselector_item_append()
1403 * @see elm_diskselector_item_icon_set()
1405 * @deprecated Use elm_object_item_part_content_set() instead
1406 * @ingroup Diskselector
1408 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1411 * Set the label of item.
1413 * @param it The item of diskselector.
1414 * @param label The label of item.
1416 * The label to be displayed by the item.
1418 * If no icon is set, label will be centered on item position, otherwise
1419 * the icon will be placed at left of the label, that will be shifted
1422 * An item with label "January" would be displayed on side position as
1423 * "Jan" if max length is set to 3 with function
1424 * elm_diskselector_side_label_length_set(), or "Janu", if this property
1427 * When this @p item is selected, the entire label will be displayed,
1428 * except for width restrictions.
1429 * In this case label will be cropped and "..." will be concatenated,
1430 * but only for display purposes. It will keep the entire string, so
1431 * if diskselector is resized the remaining characters will be displayed.
1433 * If a label was passed as argument on item creation, with function
1434 * elm_diskselector_item_append(), it will be already
1435 * displayed by the item.
1437 * @see elm_diskselector_side_label_length_set()
1438 * @see elm_diskselector_item_label_get()
1439 * @see elm_diskselector_item_append()
1441 * @deprecated Use elm_object_item_text_set() instead
1442 * @ingroup Diskselector
1444 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1447 * Get the label of item.
1449 * @param it The item of diskselector.
1450 * @return The label of item.
1452 * The return value is a pointer to the label associated to @p item when it was
1453 * created, with function elm_diskselector_item_append(), or later
1454 * with function elm_diskselector_item_label_set. If no label
1455 * was passed as argument, it will return @c NULL.
1457 * @see elm_diskselector_item_label_set() for more details.
1458 * @see elm_diskselector_item_append()
1459 * @use elm_object_item_text_get()
1461 * @ingroup Diskselector
1463 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1466 * Set the function called when a diskselector item is freed.
1468 * @param it The item to set the callback on
1469 * @param func The function called
1471 * If there is a @p func, then it will be called prior item's memory release.
1472 * That will be called with the following arguments:
1474 * @li item's Evas object;
1477 * This way, a data associated to a diskselector item could be properly
1479 * @deprecated Use elm_object_item_del_cb_set() instead
1481 * @ingroup Diskselector
1483 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1486 * Delete them item from the diskselector.
1488 * @param it The item of diskselector to be deleted.
1490 * If deleting all diskselector items is required, elm_diskselector_clear()
1491 * should be used instead of getting items list and deleting each one.
1493 * @deprecated Use elm_object_item_del() instead
1494 * @see elm_diskselector_clear()
1495 * @see elm_diskselector_item_append()
1497 * @ingroup Diskselector
1499 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1502 * Set the text to be shown in the diskselector item.
1504 * @param it Target item
1505 * @param text The text to set in the content
1507 * Setup the text as tooltip to object. The item can have only one tooltip,
1508 * so any previous tooltip data is removed.
1510 * @deprecated Use elm_object_item_tooltip_text_set() instead
1511 * @see elm_object_tooltip_text_set() for more details.
1513 * @ingroup Diskselector
1515 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1518 * Set the content to be shown in the tooltip item.
1520 * Setup the tooltip to item. The item can have only one tooltip,
1521 * so any previous tooltip data is removed. @p func(with @p data) will
1522 * be called every time that need show the tooltip and it should
1523 * return a valid Evas_Object. This object is then managed fully by
1524 * tooltip system and is deleted when the tooltip is gone.
1526 * @param it the diskselector item being attached a tooltip.
1527 * @param func the function used to create the tooltip contents.
1528 * @param data what to provide to @a func as callback data/context.
1529 * @param del_cb called when data is not needed anymore, either when
1530 * another callback replaces @p func, the tooltip is unset with
1531 * elm_diskselector_item_tooltip_unset() or the owner @a item
1532 * dies. This callback receives as the first parameter the
1533 * given @a data, and @c event_info is the item.
1535 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1536 * @see elm_object_tooltip_content_cb_set() for more details.
1538 * @ingroup Diskselector
1540 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);
1543 * Unset tooltip from item.
1545 * @param it diskselector item to remove previously set tooltip.
1547 * Remove tooltip from item. The callback provided as del_cb to
1548 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1549 * it is not used anymore.
1551 * @deprecated Use elm_object_item_tooltip_unset() instead
1552 * @see elm_object_tooltip_unset() for more details.
1553 * @see elm_diskselector_item_tooltip_content_cb_set()
1555 * @ingroup Diskselector
1557 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1560 * Sets a different style for this item tooltip.
1562 * @note before you set a style you should define a tooltip with
1563 * elm_diskselector_item_tooltip_content_cb_set() or
1564 * elm_diskselector_item_tooltip_text_set()
1566 * @param it diskselector item with tooltip already set.
1567 * @param style the theme style to use (default, transparent, ...)
1569 * @deprecated Use elm_object_item_tooltip_style_set() instead
1570 * @see elm_object_tooltip_style_set() for more details.
1572 * @ingroup Diskselector
1574 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1577 * Get the style for this item tooltip.
1579 * @param it diskselector item with tooltip already set.
1580 * @return style the theme style in use, defaults to "default". If the
1581 * object does not have a tooltip set, then NULL is returned.
1583 * @deprecated Use elm_object_item_tooltip_style_get() instead
1584 * @see elm_object_tooltip_style_get() for more details.
1585 * @see elm_diskselector_item_tooltip_style_set()
1587 * @ingroup Diskselector
1589 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1592 * Set the cursor to be shown when mouse is over the diskselector item
1594 * @param it Target item
1595 * @param cursor the cursor name to be used.
1597 * @see elm_object_cursor_set() for more details.
1598 * @deprecated Use elm_object_item_cursor_set() instead
1600 * @ingroup Diskselector
1602 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1605 * Get the cursor to be shown when mouse is over the diskselector item
1607 * @param it diskselector item with cursor already set.
1608 * @return the cursor name.
1610 * @see elm_object_cursor_get() for more details.
1611 * @see elm_diskselector_cursor_set()
1612 * @deprecated Use elm_object_item_cursor_get() instead
1614 * @ingroup Diskselector
1616 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1619 * Unset the cursor to be shown when mouse is over the diskselector item
1621 * @param it Target item
1623 * @see elm_object_cursor_unset() for more details.
1624 * @see elm_diskselector_cursor_set()
1625 * @deprecated use elm_object_item_cursor_unset() instead
1627 * @ingroup Diskselector
1629 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1632 * Sets a different style for this item cursor.
1634 * @note before you set a style you should define a cursor with
1635 * elm_diskselector_item_cursor_set()
1637 * @param it diskselector item with cursor already set.
1638 * @param style the theme style to use (default, transparent, ...)
1640 * @see elm_object_cursor_style_set() for more details.
1641 * @deprecated Use elm_object_item_cursor_style_set() instead
1643 * @ingroup Diskselector
1645 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1648 * Get the style for this item cursor.
1650 * @param it diskselector item with cursor already set.
1651 * @return style the theme style in use, defaults to "default". If the
1652 * object does not have a cursor set, then @c NULL is returned.
1654 * @see elm_object_cursor_style_get() for more details.
1655 * @see elm_diskselector_item_cursor_style_set()
1656 * @deprecated Use elm_object_item_cursor_style_get() instead
1658 * @ingroup Diskselector
1660 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1663 * Set if the cursor set should be searched on the theme or should use
1664 * the provided by the engine, only.
1666 * @note before you set if should look on theme you should define a cursor
1667 * with elm_diskselector_item_cursor_set().
1668 * By default it will only look for cursors provided by the engine.
1670 * @param it widget item with cursor already set.
1671 * @param engine_only boolean to define if cursors set with
1672 * elm_diskselector_item_cursor_set() should be searched only
1673 * between cursors provided by the engine or searched on widget's
1676 * @see elm_object_cursor_engine_only_set() for more details.
1677 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1679 * @ingroup Diskselector
1681 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1684 * Get the cursor engine only usage for this item cursor.
1686 * @param it widget item with cursor already set.
1687 * @return engine_only boolean to define it cursors should be looked only
1688 * between the provided by the engine or searched on widget's theme as well.
1689 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1691 * @see elm_object_cursor_engine_only_get() for more details.
1692 * @see elm_diskselector_item_cursor_engine_only_set()
1693 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1695 * @ingroup Diskselector
1697 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1699 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1700 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1703 * Get the label of a given flip selector widget's item.
1705 * @param it The item to get label from
1706 * @return The text label of @p item or @c NULL, on errors
1708 * @see elm_object_item_text_set()
1710 * @deprecated see elm_object_item_text_get() instead
1711 * @ingroup Flipselector
1713 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1716 * Set the label of a given flip selector widget's item.
1718 * @param it The item to set label on
1719 * @param label The text label string, in UTF-8 encoding
1721 * @see elm_object_item_text_get()
1723 * @deprecated see elm_object_item_text_set() instead
1724 * @ingroup Flipselector
1726 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1729 * Delete a given item from a flip selector widget.
1731 * @param it The item to delete
1733 * @deprecated Use elm_object_item_del() instead
1734 * @ingroup Flipselector
1736 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1739 * Make a given Elementary object the focused one.
1741 * @param obj The Elementary object to make focused.
1743 * @note This object, if it can handle focus, will take the focus
1744 * away from the one who had it previously and will, for now on, be
1745 * the one receiving input events.
1747 * @see elm_object_focus_get()
1748 * @deprecated use elm_object_focus_set() instead.
1752 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1755 * Remove the focus from an Elementary object
1757 * @param obj The Elementary to take focus from
1759 * This removes the focus from @p obj, passing it back to the
1760 * previous element in the focus chain list.
1762 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1763 * @deprecated use elm_object_focus_set() instead.
1767 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1770 * @brief Set the frame label
1772 * @param obj The frame object
1773 * @param label The label of this frame object
1775 * @deprecated use elm_object_text_set() instead.
1777 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1780 * @brief Get the frame label
1782 * @param obj The frame object
1784 * @return The label of this frame object or NULL if unable to get frame
1786 * @deprecated use elm_object_text_get() instead.
1788 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1791 * @brief Set the content of the frame widget
1793 * Once the content object is set, a previously set one will be deleted.
1794 * If you want to keep that old content object, use the
1795 * elm_frame_content_unset() function.
1797 * @param obj The frame object
1798 * @param content The content will be filled in this frame object
1800 * @deprecated use elm_object_content_set() instead.
1802 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1805 * @brief Get the content of the frame widget
1807 * Return the content object which is set for this widget
1809 * @param obj The frame object
1810 * @return The content that is being used
1812 * @deprecated use elm_object_content_get() instead.
1814 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1817 * @brief Unset the content of the frame widget
1819 * Unparent and return the content object which was set for this widget
1821 * @param obj The frame object
1822 * @return The content that was being used
1824 * @deprecated use elm_object_content_unset() instead.
1826 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1828 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1829 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1830 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1832 * This sets the horizontal stretching mode.
1834 * @param obj The genlist object
1835 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1837 * This sets the mode used for sizing items horizontally. Valid modes
1838 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1839 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1840 * the scroller will scroll horizontally. Otherwise items are expanded
1841 * to fill the width of the viewport of the scroller. If it is
1842 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1843 * limited to that size.
1845 * @see elm_genlist_horizontal_get()
1847 * @deprecated use elm_genlist_mode_set()
1850 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1853 * Gets the horizontal stretching mode.
1855 * @param obj The genlist object
1856 * @return The mode to use
1857 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1859 * @see elm_genlist_horizontal_set()
1861 * @deprecated use elm_genlist_mode_get()
1864 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
1867 * Return the data associated to a given genlist item
1869 * @param it The genlist item.
1870 * @return the data associated to this item.
1872 * This returns the @c data value passed on the
1873 * elm_genlist_item_append() and related item addition calls.
1875 * @see elm_genlist_item_append()
1876 * @see elm_genlist_item_data_set()
1878 * @deprecated Use elm_object_item_data_get() instead
1881 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
1884 * Set the data associated to a given genlist item
1886 * @param it The genlist item
1887 * @param data The new data pointer to set on it
1889 * This @b overrides the @c data value passed on the
1890 * elm_genlist_item_append() and related item addition calls. This
1891 * function @b won't call elm_genlist_item_update() automatically,
1892 * so you'd issue it afterwards if you want to hove the item
1893 * updated to reflect the that new data.
1895 * @see elm_genlist_item_data_get()
1897 * @deprecated Use elm_object_item_data_set() instead
1900 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
1903 * Set whether a given genlist item is disabled or not.
1905 * @param it The item
1906 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
1907 * to enable it back.
1909 * A disabled item cannot be selected or unselected. It will also
1910 * change its appearance, to signal the user it's disabled.
1912 * @see elm_genlist_item_disabled_get()
1913 * @deprecated Use elm_object_item_disabled_set() instead
1917 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1920 * Get whether a given genlist item is disabled or not.
1922 * @param it The item
1923 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
1926 * @see elm_genlist_item_disabled_set() for more details
1927 * @deprecated Use elm_object_item_disabled_get() instead
1931 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
1934 * Remove a genlist item from the its parent, deleting it.
1936 * @param it The item to be removed.
1937 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
1939 * @see elm_genlist_clear(), to remove all items in a genlist at
1942 * @deprecated Use elm_object_item_del() instead
1945 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
1948 * Get the genlist object's handle which contains a given genlist
1951 * @param it The item to fetch the container from
1952 * @return The genlist (parent) object
1954 * This returns the genlist object itself that an item belongs to.
1955 * @deprecated Use elm_object_item_widget_get() instead
1959 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
1962 #define ELM_IMAGE_ROTATE_90_CW 1
1963 #define ELM_IMAGE_ROTATE_180_CW 2
1964 #define ELM_IMAGE_ROTATE_90_CCW 3
1967 * Return the data associated with a given index widget item
1969 * @param it The index widget item handle
1970 * @return The data associated with @p it
1971 * @deprecated Use elm_object_item_data_get() instead
1973 * @see elm_index_item_data_set()
1977 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1980 * Set the data associated with a given index widget item
1982 * @param it The index widget item handle
1983 * @param data The new data pointer to set to @p it
1985 * This sets new item data on @p it.
1987 * @warning The old data pointer won't be touched by this function, so
1988 * the user had better to free that old data himself/herself.
1990 * @deprecated Use elm_object_item_data_set() instead
1993 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1996 * Set the function to be called when a given index widget item is freed.
1998 * @param it The item to set the callback on
1999 * @param func The function to call on the item's deletion
2001 * When called, @p func will have both @c data and @c event_info
2002 * arguments with the @p it item's data value and, naturally, the
2003 * @c obj argument with a handle to the parent index widget.
2005 * @deprecated Use elm_object_item_del_cb_set() instead
2008 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2011 * Remove an item from a given index widget, <b>to be referenced by
2012 * it's data value</b>.
2014 * @param obj The index object
2015 * @param item The item to be removed from @p obj
2017 * If a deletion callback is set, via elm_object_item_del_cb_set(),
2018 * that callback function will be called by this one.
2020 * @deprecated Use elm_object_item_del() instead
2023 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
2026 * @brief Set the label on the label object
2028 * @param obj The label object
2029 * @param label The label will be used on the label object
2030 * @deprecated See elm_object_text_set()
2032 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
2035 * @brief Get the label used on the label object
2037 * @param obj The label object
2038 * @return The string inside the label
2039 * @deprecated See elm_object_text_get()
2041 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
2045 * Set the layout content.
2047 * @param obj The layout object
2048 * @param swallow The swallow part name in the edje file
2049 * @param content The child that will be added in this layout object
2051 * Once the content object is set, a previously set one will be deleted.
2052 * If you want to keep that old content object, use the
2053 * elm_object_part_content_unset() function.
2055 * @note In an Edje theme, the part used as a content container is called @c
2056 * SWALLOW. This is why the parameter name is called @p swallow, but it is
2057 * expected to be a part name just like the second parameter of
2058 * elm_layout_box_append().
2060 * @see elm_layout_box_append()
2061 * @see elm_object_part_content_get()
2062 * @see elm_object_part_content_unset()
2064 * @deprecated use elm_object_part_content_set() instead
2068 EINA_DEPRECATED EAPI void elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
2071 * Get the child object in the given content part.
2073 * @param obj The layout object
2074 * @param swallow The SWALLOW part to get its content
2076 * @return The swallowed object or NULL if none or an error occurred
2078 * @deprecated use elm_object_part_content_get() instead
2082 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
2085 * Unset the layout content.
2087 * @param obj The layout object
2088 * @param swallow The swallow part name in the edje file
2089 * @return The content that was being used
2091 * Unparent and return the content object which was set for this part.
2093 * @deprecated use elm_object_part_content_unset() instead
2097 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
2100 * Set the text of the given part
2102 * @param obj The layout object
2103 * @param part The TEXT part where to set the text
2104 * @param text The text to set
2107 * @deprecated use elm_object_part_text_set() instead.
2109 EINA_DEPRECATED EAPI void elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
2112 * Get the text set in the given part
2114 * @param obj The layout object
2115 * @param part The TEXT part to retrieve the text off
2117 * @return The text set in @p part
2120 * @deprecated use elm_object_part_text_get() instead.
2122 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
2125 * @def elm_layout_label_set
2126 * Convenience macro to set the label in a layout that follows the
2127 * Elementary naming convention for its parts.
2130 * @deprecated use elm_object_text_set() instead.
2132 #define elm_layout_label_set(_ly, _txt) \
2133 elm_layout_text_set((_ly), "elm.text", (_txt))
2136 * @def elm_layout_label_get
2137 * Convenience macro to get the label in a layout that follows the
2138 * Elementary naming convention for its parts.
2141 * @deprecated use elm_object_text_set() instead.
2143 #define elm_layout_label_get(_ly) \
2144 elm_layout_text_get((_ly), "elm.text")
2146 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
2150 * Set the content of the mapbuf.
2152 * @param obj The mapbuf object.
2153 * @param content The content that will be filled in this mapbuf object.
2155 * Once the content object is set, a previously set one will be deleted.
2156 * If you want to keep that old content object, use the
2157 * elm_mapbuf_content_unset() function.
2159 * To enable map, elm_mapbuf_enabled_set() should be used.
2161 * @deprecated use elm_object_content_set() instead
2165 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
2168 * Get the content of the mapbuf.
2170 * @param obj The mapbuf object.
2171 * @return The content that is being used.
2173 * Return the content object which is set for this widget.
2175 * @see elm_mapbuf_content_set() for details.
2177 * @deprecated use elm_object_content_get() instead
2181 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
2184 * Unset the content of the mapbuf.
2186 * @param obj The mapbuf object.
2187 * @return The content that was being used.
2189 * Unparent and return the content object which was set for this widget.
2191 * @see elm_mapbuf_content_set() for details.
2193 * @deprecated use elm_object_content_unset() instead
2197 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
2200 * @brief Set the label of a menu item
2202 * @param it The menu item object.
2203 * @param label The label to set for @p item
2205 * @warning Don't use this function on items created with
2206 * elm_menu_item_add_object() or elm_menu_item_separator_add().
2208 * @deprecated Use elm_object_item_text_set() instead
2210 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
2213 * @brief Get the label of a menu item
2215 * @param it The menu item object.
2216 * @return The label of @p item
2217 * @deprecated Use elm_object_item_text_get() instead
2219 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
2222 * @brief Set the content object of a menu item
2224 * @param it The menu item object
2225 * @param The content object or NULL
2226 * @return EINA_TRUE on success, else EINA_FALSE
2228 * Use this function to change the object swallowed by a menu item, deleting
2229 * any previously swallowed object.
2231 * @deprecated Use elm_object_item_content_set() instead
2233 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2236 * @brief Get the content object of a menu item
2238 * @param it The menu item object
2239 * @return The content object or NULL
2240 * @note If @p item was added with elm_menu_item_add_object, this
2241 * function will return the object passed, else it will return the
2244 * @see elm_menu_item_object_content_set()
2246 * @deprecated Use elm_object_item_content_get() instead
2248 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2251 * @brief Set the disabled state of @p item.
2253 * @param it The menu item object.
2254 * @param disabled The enabled/disabled state of the item
2255 * @deprecated Use elm_object_item_disabled_set() instead
2257 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2260 * @brief Get the disabled state of @p item.
2262 * @param it The menu item object.
2263 * @return The enabled/disabled state of the item
2265 * @see elm_menu_item_disabled_set()
2266 * @deprecated Use elm_object_item_disabled_get() instead
2268 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
2271 * @brief Returns the data associated with menu item @p item.
2273 * @param it The item
2274 * @return The data associated with @p item or NULL if none was set.
2276 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2278 * @deprecated Use elm_object_item_data_get() instead
2280 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
2283 * @brief Set the function called when a menu item is deleted.
2285 * @param it The item to set the callback on
2286 * @param func The function called
2288 * @see elm_menu_item_add()
2289 * @see elm_menu_item_del()
2290 * @deprecated Use elm_object_item_del_cb_set() instead
2292 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2295 * @brief Sets the data to be associated with menu item @p item.
2297 * @param it The item
2298 * @param data The data to be associated with @p item
2300 * @deprecated Use elm_object_item_data_set() instead
2302 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2305 * @brief Deletes an item from the menu.
2307 * @param it The item to delete.
2309 * @deprecated Use elm_object_item_del() instead
2310 * @see elm_menu_item_add()
2312 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2315 * @brief Set the content of the notify widget
2317 * @param obj The notify object
2318 * @param content The content will be filled in this notify object
2320 * Once the content object is set, a previously set one will be deleted. If
2321 * you want to keep that old content object, use the
2322 * elm_notify_content_unset() function.
2324 * @deprecated use elm_object_content_set() instead
2327 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2330 * @brief Unset the content of the notify widget
2332 * @param obj The notify object
2333 * @return The content that was being used
2335 * Unparent and return the content object which was set for this widget
2337 * @see elm_notify_content_set()
2338 * @deprecated use elm_object_content_unset() instead
2341 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2344 * @brief Return the content of the notify widget
2346 * @param obj The notify object
2347 * @return The content that is being used
2349 * @see elm_notify_content_set()
2350 * @deprecated use elm_object_content_get() instead
2353 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2356 * Set a label of an object
2358 * @param obj The Elementary object
2359 * @param part The text part name to set (NULL for the default label)
2360 * @param label The new text of the label
2362 * @note Elementary objects may have many labels (e.g. Action Slider)
2363 * @deprecated Use elm_object_part_text_set() instead.
2366 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2369 * Get a label of an object
2371 * @param obj The Elementary object
2372 * @param part The text part name to get (NULL for the default label)
2373 * @return text of the label or NULL for any error
2375 * @note Elementary objects may have many labels (e.g. Action Slider)
2376 * @deprecated Use elm_object_part_text_get() instead.
2379 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2382 * Set a content of an object
2384 * @param obj The Elementary object
2385 * @param part The content part name to set (NULL for the default content)
2386 * @param content The new content of the object
2388 * @note Elementary objects may have many contents
2389 * @deprecated Use elm_object_part_content_set instead.
2392 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2395 * Get a content of an object
2397 * @param obj The Elementary object
2398 * @param part The content part name to get (NULL for the default content)
2399 * @return content of the object or NULL for any error
2401 * @note Elementary objects may have many contents
2402 * @deprecated Use elm_object_part_content_get instead.
2405 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2408 * Unset a content of an object
2410 * @param obj The Elementary object
2411 * @param part The content part name to unset (NULL for the default content)
2413 * @note Elementary objects may have many contents
2414 * @deprecated Use elm_object_part_content_unset instead.
2417 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2420 * Set a content of an object item
2422 * @param it The Elementary object item
2423 * @param part The content part name to set (NULL for the default content)
2424 * @param content The new content of the object item
2426 * @note Elementary object items may have many contents
2427 * @deprecated Use elm_object_item_part_content_set instead.
2430 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2433 * Get a content of an object item
2435 * @param it The Elementary object item
2436 * @param part The content part name to unset (NULL for the default content)
2437 * @return content of the object item or NULL for any error
2439 * @note Elementary object items may have many contents
2440 * @deprecated Use elm_object_item_part_content_get instead.
2443 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2446 * Unset a content of an object item
2448 * @param it The Elementary object item
2449 * @param part The content part name to unset (NULL for the default content)
2451 * @note Elementary object items may have many contents
2452 * @deprecated Use elm_object_item_part_content_unset instead.
2455 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2458 * Get a label of an object item
2460 * @param it The Elementary object item
2461 * @param part The text part name to get (NULL for the default label)
2462 * @return text of the label or NULL for any error
2464 * @note Elementary object items may have many labels
2465 * @deprecated Use elm_object_item_part_text_get instead.
2468 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2471 * Set a label of an object item
2473 * @param it The Elementary object item
2474 * @param part The text part name to set (NULL for the default label)
2475 * @param label The new text of the label
2477 * @note Elementary object items may have many labels
2478 * @deprecated Use elm_object_item_part_text_set instead.
2481 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2484 * @brief Set the content of the panel.
2486 * @param obj The panel object
2487 * @param content The panel content
2489 * Once the content object is set, a previously set one will be deleted.
2490 * If you want to keep that old content object, use the
2491 * elm_panel_content_unset() function.
2493 * @deprecated use elm_object_content_set() instead
2496 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2499 * @brief Get the content of the panel.
2501 * @param obj The panel object
2502 * @return The content that is being used
2504 * Return the content object which is set for this widget.
2506 * @see elm_panel_content_set()
2508 * @deprecated use elm_object_content_get() instead
2511 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2514 * @brief Unset the content of the panel.
2516 * @param obj The panel object
2517 * @return The content that was being used
2519 * Unparent and return the content object which was set for this widget.
2521 * @see elm_panel_content_set()
2523 * @deprecated use elm_object_content_unset() instead
2526 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2529 * Set the left content of the panes widget.
2531 * @param obj The panes object.
2532 * @param content The new left content object.
2534 * Once the content object is set, a previously set one will be deleted.
2535 * If you want to keep that old content object, use the
2536 * elm_panes_content_left_unset() function.
2538 * If panes is displayed vertically, left content will be displayed at
2541 * @see elm_panes_content_left_get()
2542 * @see elm_panes_content_right_set() to set content on the other side.
2544 * @deprecated use elm_object_part_content_set() instead
2548 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2551 * Set the right content of the panes widget.
2553 * @param obj The panes object.
2554 * @param content The new right content object.
2556 * Once the content object is set, a previously set one will be deleted.
2557 * If you want to keep that old content object, use the
2558 * elm_panes_content_right_unset() function.
2560 * If panes is displayed vertically, left content will be displayed at
2563 * @see elm_panes_content_right_get()
2564 * @see elm_panes_content_left_set() to set content on the other side.
2566 * @deprecated use elm_object_part_content_set() instead
2570 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2573 * Get the left content of the panes.
2575 * @param obj The panes object.
2576 * @return The left content object that is being used.
2578 * Return the left content object which is set for this widget.
2580 * @see elm_panes_content_left_set() for details.
2582 * @deprecated use elm_object_part_content_get() instead
2586 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2589 * Get the right content of the panes.
2591 * @param obj The panes object
2592 * @return The right content object that is being used
2594 * Return the right content object which is set for this widget.
2596 * @see elm_panes_content_right_set() for details.
2598 * @deprecated use elm_object_part_content_get() instead
2602 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2605 * Unset the left content used for the panes.
2607 * @param obj The panes object.
2608 * @return The left content object that was being used.
2610 * Unparent and return the left content object which was set for this widget.
2612 * @see elm_panes_content_left_set() for details.
2613 * @see elm_panes_content_left_get().
2615 * @deprecated use elm_object_part_content_unset() instead
2619 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2622 * Unset the right content used for the panes.
2624 * @param obj The panes object.
2625 * @return The right content object that was being used.
2627 * Unparent and return the right content object which was set for this
2630 * @see elm_panes_content_right_set() for details.
2631 * @see elm_panes_content_right_get().
2633 * @deprecated use elm_object_part_content_unset() instead
2637 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2639 * Set the label of a given progress bar widget
2641 * @param obj The progress bar object
2642 * @param label The text label string, in UTF-8
2644 * @ingroup Progressbar
2645 * @deprecated use elm_object_text_set() instead.
2647 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2650 * Get the label of a given progress bar widget
2652 * @param obj The progressbar object
2653 * @return The text label string, in UTF-8
2655 * @ingroup Progressbar
2656 * @deprecated use elm_object_text_set() instead.
2658 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2661 * Set the icon object of a given progress bar widget
2663 * @param obj The progress bar object
2664 * @param icon The icon object
2666 * Use this call to decorate @p obj with an icon next to it.
2668 * @note Once the icon object is set, a previously set one will be
2669 * deleted. If you want to keep that old content object, use the
2670 * elm_progressbar_icon_unset() function.
2672 * @see elm_progressbar_icon_get()
2673 * @deprecated use elm_object_part_content_set() instead.
2675 * @ingroup Progressbar
2677 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2680 * Retrieve the icon object set for a given progress bar widget
2682 * @param obj The progress bar object
2683 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2684 * otherwise (and on errors)
2686 * @see elm_progressbar_icon_set() for more details
2687 * @deprecated use elm_object_part_content_get() instead.
2689 * @ingroup Progressbar
2691 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2694 * Unset an icon set on a given progress bar widget
2696 * @param obj The progress bar object
2697 * @return The icon object that was being used, if any was set, or
2698 * @c NULL, otherwise (and on errors)
2700 * This call will unparent and return the icon object which was set
2701 * for this widget, previously, on success.
2703 * @see elm_progressbar_icon_set() for more details
2704 * @deprecated use elm_object_part_content_unset() instead.
2706 * @ingroup Progressbar
2708 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2711 * @brief Set the text label of the radio object
2713 * @param obj The radio object
2714 * @param label The text label string in UTF-8
2716 * @deprecated use elm_object_text_set() instead.
2718 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
2721 * @brief Get the text label of the radio object
2723 * @param obj The radio object
2724 * @return The text label string in UTF-8
2726 * @deprecated use elm_object_text_set() instead.
2728 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
2731 * @brief Set the icon object of the radio object
2733 * @param obj The radio object
2734 * @param icon The icon object
2736 * Once the icon object is set, a previously set one will be deleted. If you
2737 * want to keep that old content object, use the elm_radio_icon_unset()
2740 * @deprecated use elm_object_part_content_set() instead.
2743 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2746 * @brief Get the icon object of the radio object
2748 * @param obj The radio object
2749 * @return The icon object
2751 * @see elm_radio_icon_set()
2753 * @deprecated use elm_object_part_content_get() instead.
2756 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2759 * @brief Unset the icon used for the radio object
2761 * @param obj The radio object
2762 * @return The icon object that was being used
2764 * Unparent and return the icon object which was set for this widget.
2766 * @see elm_radio_icon_set()
2767 * @deprecated use elm_object_part_content_unset() instead.
2770 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2773 * @brief Set the content of the scroller widget (the object to be scrolled around).
2775 * @param obj The scroller object
2776 * @param content The new content object
2778 * Once the content object is set, a previously set one will be deleted.
2779 * If you want to keep that old content object, use the
2780 * elm_scroller_content_unset() function.
2781 * @deprecated use elm_object_content_set() instead
2783 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2786 * @brief Get the content of the scroller widget
2788 * @param obj The slider object
2789 * @return The content that is being used
2791 * Return the content object which is set for this widget
2793 * @see elm_scroller_content_set()
2794 * @deprecated use elm_object_content_get() instead.
2796 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2799 * @brief Unset the content of the scroller widget
2801 * @param obj The slider object
2802 * @return The content that was being used
2804 * Unparent and return the content object which was set for this widget
2806 * @see elm_scroller_content_set()
2807 * @deprecated use elm_object_content_unset() instead.
2809 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2812 * Set the label of a given slider widget
2814 * @param obj The progress bar object
2815 * @param label The text label string, in UTF-8
2818 * @deprecated use elm_object_text_set() instead.
2820 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
2823 * Get the label of a given slider widget
2825 * @param obj The progressbar object
2826 * @return The text label string, in UTF-8
2829 * @deprecated use elm_object_text_get() instead.
2831 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
2834 * Set the icon object of the slider object.
2836 * @param obj The slider object.
2837 * @param icon The icon object.
2839 * On horizontal mode, icon is placed at left, and on vertical mode,
2842 * @note Once the icon object is set, a previously set one will be deleted.
2843 * If you want to keep that old content object, use the
2844 * elm_slider_icon_unset() function.
2846 * @warning If the object being set does not have minimum size hints set,
2847 * it won't get properly displayed.
2850 * @deprecated use elm_object_part_content_set() instead.
2852 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2855 * Unset an icon set on a given slider widget.
2857 * @param obj The slider object.
2858 * @return The icon object that was being used, if any was set, or
2859 * @c NULL, otherwise (and on errors).
2861 * On horizontal mode, icon is placed at left, and on vertical mode,
2864 * This call will unparent and return the icon object which was set
2865 * for this widget, previously, on success.
2867 * @see elm_slider_icon_set() for more details
2868 * @see elm_slider_icon_get()
2869 * @deprecated use elm_object_part_content_unset() instead.
2873 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2876 * Retrieve the icon object set for a given slider widget.
2878 * @param obj The slider object.
2879 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2880 * otherwise (and on errors).
2882 * On horizontal mode, icon is placed at left, and on vertical mode,
2885 * @see elm_slider_icon_set() for more details
2886 * @see elm_slider_icon_unset()
2888 * @deprecated use elm_object_part_content_get() instead.
2892 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2895 * Set the end object of the slider object.
2897 * @param obj The slider object.
2898 * @param end The end object.
2900 * On horizontal mode, end is placed at left, and on vertical mode,
2903 * @note Once the icon object is set, a previously set one will be deleted.
2904 * If you want to keep that old content object, use the
2905 * elm_slider_end_unset() function.
2907 * @warning If the object being set does not have minimum size hints set,
2908 * it won't get properly displayed.
2910 * @deprecated use elm_object_part_content_set() instead.
2914 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2917 * Unset an end object set on a given slider widget.
2919 * @param obj The slider object.
2920 * @return The end object that was being used, if any was set, or
2921 * @c NULL, otherwise (and on errors).
2923 * On horizontal mode, end is placed at left, and on vertical mode,
2926 * This call will unparent and return the icon object which was set
2927 * for this widget, previously, on success.
2929 * @see elm_slider_end_set() for more details.
2930 * @see elm_slider_end_get()
2932 * @deprecated use elm_object_part_content_unset() instead
2937 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2940 * Retrieve the end object set for a given slider widget.
2942 * @param obj The slider object.
2943 * @return The end object's handle, if @p obj had one set, or @c NULL,
2944 * otherwise (and on errors).
2946 * On horizontal mode, icon is placed at right, and on vertical mode,
2949 * @see elm_slider_end_set() for more details.
2950 * @see elm_slider_end_unset()
2953 * @deprecated use elm_object_part_content_get() instead
2958 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2961 * Return the data associated with a given slideshow item
2963 * @param it The slideshow item
2964 * @return Returns the data associated to this item
2966 * @deprecated use elm_object_item_data_get() instead
2967 * @ingroup Slideshow
2969 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2972 * Delete a given item from a slideshow widget.
2974 * @param it The slideshow item
2976 * @deprecated Use elm_object_item_de() instead
2977 * @ingroup Slideshow
2979 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
2982 * Get the toolbar object from an item.
2984 * @param it The item.
2985 * @return The toolbar object.
2987 * This returns the toolbar object itself that an item belongs to.
2989 * @deprecated use elm_object_item_object_get() instead.
2992 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2995 * Get the label of item.
2997 * @param it The item of toolbar.
2998 * @return The label of item.
3000 * The return value is a pointer to the label associated to @p item when
3001 * it was created, with function elm_toolbar_item_append() or similar,
3003 * with function elm_toolbar_item_label_set. If no label
3004 * was passed as argument, it will return @c NULL.
3006 * @see elm_toolbar_item_label_set() for more details.
3007 * @see elm_toolbar_item_append()
3009 * @deprecated use elm_object_item_text_get() instead.
3012 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
3015 * Set the label of item.
3017 * @param it The item of toolbar.
3018 * @param text The label of item.
3020 * The label to be displayed by the item.
3021 * Label will be placed at icons bottom (if set).
3023 * If a label was passed as argument on item creation, with function
3024 * elm_toolbar_item_append() or similar, it will be already
3025 * displayed by the item.
3027 * @see elm_toolbar_item_label_get()
3028 * @see elm_toolbar_item_append()
3030 * @deprecated use elm_object_item_text_set() instead
3033 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
3036 * Return the data associated with a given toolbar widget item.
3038 * @param it The toolbar widget item handle.
3039 * @return The data associated with @p item.
3041 * @see elm_toolbar_item_data_set()
3043 * @deprecated use elm_object_item_data_get() instead.
3046 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
3049 * Set the data associated with a given toolbar widget item.
3051 * @param it The toolbar widget item handle
3052 * @param data The new data pointer to set to @p item.
3054 * This sets new item data on @p item.
3056 * @warning The old data pointer won't be touched by this function, so
3057 * the user had better to free that old data himself/herself.
3059 * @deprecated use elm_object_item_data_set() instead.
3062 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
3065 * Get a value whether toolbar item is disabled or not.
3067 * @param it The item.
3068 * @return The disabled state.
3070 * @see elm_toolbar_item_disabled_set() for more details.
3072 * @deprecated use elm_object_item_disabled_get() instead.
3075 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
3078 * Sets the disabled/enabled state of a toolbar item.
3080 * @param it The item.
3081 * @param disabled The disabled state.
3083 * A disabled item cannot be selected or unselected. It will also
3084 * change its appearance (generally greyed out). This sets the
3085 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3088 * @deprecated use elm_object_item_disabled_set() instead.
3091 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3094 * Change a toolbar's orientation
3095 * @param obj The toolbar object
3096 * @param vertical If @c EINA_TRUE, the toolbar is vertical
3097 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
3099 * @deprecated use elm_toolbar_horizontal_set() instead.
3101 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
3104 * Get a toolbar's orientation
3105 * @param obj The toolbar object
3106 * @return If @c EINA_TRUE, the toolbar is vertical
3107 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
3109 * @deprecated use elm_toolbar_horizontal_get() instead.
3111 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
3114 * Set the function called when a toolbar item is freed.
3116 * @param it The item to set the callback on.
3117 * @param func The function called.
3119 * If there is a @p func, then it will be called prior item's memory release.
3120 * That will be called with the following arguments:
3122 * @li item's Evas object;
3125 * This way, a data associated to a toolbar item could be properly freed.
3127 * @deprecated Use elm_object_item_del_cb_set() instead
3130 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3133 * Delete them item from the toolbar.
3135 * @param it The item of toolbar to be deleted.
3137 * @deprecated Use elm_object_item_del() instead
3138 * @see elm_toolbar_item_append()
3142 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
3145 * Set the text to be shown in a given toolbar item's tooltips.
3147 * @param it toolbar item.
3148 * @param text The text to set in the content.
3150 * Setup the text as tooltip to object. The item can have only one tooltip,
3151 * so any previous tooltip data - set with this function or
3152 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
3154 * @deprecated Use elm_object_item_tooltip_text_set() instead
3155 * @see elm_object_tooltip_text_set() for more details.
3159 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3162 * Set the content to be shown in the tooltip item.
3164 * Setup the tooltip to item. The item can have only one tooltip,
3165 * so any previous tooltip data is removed. @p func(with @p data) will
3166 * be called every time that need show the tooltip and it should
3167 * return a valid Evas_Object. This object is then managed fully by
3168 * tooltip system and is deleted when the tooltip is gone.
3170 * @param it the toolbar item being attached a tooltip.
3171 * @param func the function used to create the tooltip contents.
3172 * @param data what to provide to @a func as callback data/context.
3173 * @param del_cb called when data is not needed anymore, either when
3174 * another callback replaces @a func, the tooltip is unset with
3175 * elm_toolbar_item_tooltip_unset() or the owner @a item
3176 * dies. This callback receives as the first parameter the
3177 * given @a data, and @c event_info is the item.
3179 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3180 * @see elm_object_tooltip_content_cb_set() for more details.
3184 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);
3187 * Unset tooltip from item.
3189 * @param it toolbar item to remove previously set tooltip.
3191 * Remove tooltip from item. The callback provided as del_cb to
3192 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3193 * it is not used anymore.
3195 * @deprecated Use elm_object_item_tooltip_unset() instead
3196 * @see elm_object_tooltip_unset() for more details.
3197 * @see elm_toolbar_item_tooltip_content_cb_set()
3201 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3204 * Sets a different style for this item tooltip.
3206 * @note before you set a style you should define a tooltip with
3207 * elm_toolbar_item_tooltip_content_cb_set() or
3208 * elm_toolbar_item_tooltip_text_set()
3210 * @param it toolbar item with tooltip already set.
3211 * @param style the theme style to use (default, transparent, ...)
3213 * @deprecated Use elm_object_item_tooltip_style_set() instead
3214 * @see elm_object_tooltip_style_set() for more details.
3218 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3221 * Get the style for this item tooltip.
3223 * @param it toolbar item with tooltip already set.
3224 * @return style the theme style in use, defaults to "default". If the
3225 * object does not have a tooltip set, then NULL is returned.
3227 * @deprecated Use elm_object_item_style_get() instead
3228 * @see elm_object_tooltip_style_get() for more details.
3229 * @see elm_toolbar_item_tooltip_style_set()
3233 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3236 * Set the type of mouse pointer/cursor decoration to be shown,
3237 * when the mouse pointer is over the given toolbar widget item
3239 * @param it toolbar item to customize cursor on
3240 * @param cursor the cursor type's name
3242 * This function works analogously as elm_object_cursor_set(), but
3243 * here the cursor's changing area is restricted to the item's
3244 * area, and not the whole widget's. Note that that item cursors
3245 * have precedence over widget cursors, so that a mouse over an
3246 * item with custom cursor set will always show @b that cursor.
3248 * If this function is called twice for an object, a previously set
3249 * cursor will be unset on the second call.
3251 * @see elm_object_cursor_set()
3252 * @see elm_toolbar_item_cursor_get()
3253 * @see elm_toolbar_item_cursor_unset()
3255 * @deprecated use elm_object_item_cursor_set() instead
3259 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3262 * Get the type of mouse pointer/cursor decoration set to be shown,
3263 * when the mouse pointer is over the given toolbar widget item
3265 * @param it toolbar item with custom cursor set
3266 * @return the cursor type's name or @c NULL, if no custom cursors
3267 * were set to @p item (and on errors)
3269 * @see elm_object_cursor_get()
3270 * @see elm_toolbar_item_cursor_set()
3271 * @see elm_toolbar_item_cursor_unset()
3273 * @deprecated Use elm_object_item_cursor_get() instead
3277 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3280 * Unset any custom mouse pointer/cursor decoration set to be
3281 * shown, when the mouse pointer is over the given toolbar widget
3282 * item, thus making it show the @b default cursor again.
3284 * @param it a toolbar item
3286 * Use this call to undo any custom settings on this item's cursor
3287 * decoration, bringing it back to defaults (no custom style set).
3289 * @see elm_object_cursor_unset()
3290 * @see elm_toolbar_item_cursor_set()
3292 * @deprecated Use elm_object_item_cursor_unset() instead
3296 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3299 * Set a different @b style for a given custom cursor set for a
3302 * @param it toolbar item with custom cursor set
3303 * @param style the <b>theme style</b> to use (e.g. @c "default",
3304 * @c "transparent", etc)
3306 * This function only makes sense when one is using custom mouse
3307 * cursor decorations <b>defined in a theme file</b>, which can have,
3308 * given a cursor name/type, <b>alternate styles</b> on it. It
3309 * works analogously as elm_object_cursor_style_set(), but here
3310 * applies only to toolbar item objects.
3312 * @warning Before you set a cursor style you should have defined a
3313 * custom cursor previously on the item, with
3314 * elm_toolbar_item_cursor_set()
3316 * @see elm_toolbar_item_cursor_engine_only_set()
3317 * @see elm_toolbar_item_cursor_style_get()
3319 * @deprecated Use elm_object_item_cursor_style_set() instead
3323 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3326 * Get the current @b style set for a given toolbar item's custom
3329 * @param it toolbar item with custom cursor set.
3330 * @return style the cursor style in use. If the object does not
3331 * have a cursor set, then @c NULL is returned.
3333 * @see elm_toolbar_item_cursor_style_set() for more details
3335 * @deprecated Use elm_object_item_cursor_style_get() instead
3339 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3342 * Set if the (custom)cursor for a given toolbar item should be
3343 * searched in its theme, also, or should only rely on the
3346 * @param it item with custom (custom) cursor already set on
3347 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3348 * only on those provided by the rendering engine, @c EINA_FALSE to
3349 * have them searched on the widget's theme, as well.
3351 * @note This call is of use only if you've set a custom cursor
3352 * for toolbar items, with elm_toolbar_item_cursor_set().
3354 * @note By default, cursors will only be looked for between those
3355 * provided by the rendering engine.
3357 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3361 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3364 * Get if the (custom) cursor for a given toolbar item is being
3365 * searched in its theme, also, or is only relying on the rendering
3368 * @param it a toolbar item
3369 * @return @c EINA_TRUE, if cursors are being looked for only on
3370 * those provided by the rendering engine, @c EINA_FALSE if they
3371 * are being searched on the widget's theme, as well.
3373 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3375 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3379 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3382 * @brief Link a Elm_Payer with an Elm_Video object.
3384 * @param player the Elm_Player object.
3385 * @param video The Elm_Video object.
3387 * This mean that action on the player widget will affect the
3388 * video object and the state of the video will be reflected in
3389 * the player itself.
3391 * @see elm_player_add()
3392 * @see elm_video_add()
3393 * @deprecated use elm_object_part_content_set() instead
3397 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3400 * Set the label of item.
3402 * @param it The item of segment control.
3403 * @param text The label of item.
3405 * The label to be displayed by the item.
3406 * Label will be at right of the icon (if set).
3408 * If a label was passed as argument on item creation, with function
3409 * elm_control_segment_item_add(), it will be already
3410 * displayed by the item.
3412 * @see elm_segment_control_item_label_get()
3413 * @see elm_segment_control_item_add()
3414 * @deprecated Use elm_object_item_text_set() instead
3416 * @ingroup SegmentControl
3418 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3422 * Set the icon associated to the item.
3424 * @param it The segment control item.
3425 * @param icon The icon object to associate with @p it.
3427 * The icon object to use at left side of the item. An
3428 * icon can be any Evas object, but usually it is an icon created
3429 * with elm_icon_add().
3431 * Once the icon object is set, a previously set one will be deleted.
3432 * @warning Setting the same icon for two items will cause the icon to
3433 * disappear from the first item.
3435 * If an icon was passed as argument on item creation, with function
3436 * elm_segment_control_item_add(), it will be already
3437 * associated to the item.
3439 * @see elm_segment_control_item_add()
3440 * @see elm_segment_control_item_icon_get()
3441 * @deprecated Use elm_object_item_part_content_set() instead
3443 * @ingroup SegmentControl
3445 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3448 * Remove a segment control item from its parent, deleting it.
3450 * @param it The item to be removed.
3452 * Items can be added with elm_segment_control_item_add() or
3453 * elm_segment_control_item_insert_at().
3455 * @deprecated Use elm_object_item_del() instead
3456 * @ingroup SegmentControl
3458 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3463 * @param obj The multibuttonentry object
3464 * @return The label, or NULL if none
3466 * @deprecated Use elm_object_text_get() instead
3469 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3474 * @param obj The multibuttonentry object
3475 * @param label The text label string
3477 * @deprecated Use elm_object_text_set() instead
3480 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3483 * Get the label of a given item
3485 * @param it The item
3486 * @return The label of a given item, or NULL if none
3488 * @deprecated Use elm_object_item_text_get() instead
3491 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3494 * Set the label of a given item
3496 * @param it The item
3497 * @param str The text label string
3499 * @deprecated Use elm_object_item_text_set() instead
3501 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3504 * Delete a given item
3506 * @param it The item
3508 * @deprecated Use elm_object_item_del() instead
3511 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3514 * @brief Delete the given item instantly.
3516 * @param it The naviframe item
3518 * This just deletes the given item from the naviframe item list instantly.
3519 * So this would not emit any signals for view transitions but just change
3520 * the current view if the given item is a top one.
3522 * @deprecated Use elm_object_item_del() instead
3523 * @ingroup Naviframe
3525 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3530 * Sets the disabled/enabled state of a list item.
3532 * @param it The item.
3533 * @param disabled The disabled state.
3535 * A disabled item cannot be selected or unselected. It will also
3536 * change its appearance (generally greyed out). This sets the
3537 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3540 * @deprecated Use elm_object_item_disabled_set() instead
3544 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3547 * Get a value whether list item is disabled or not.
3549 * @param it The item.
3550 * @return The disabled state.
3552 * @see elm_list_item_disabled_set() for more details.
3554 * @deprecated Use elm_object_item_disabled_get() instead
3558 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3561 * Set the function called when a list item is freed.
3563 * @param it The item to set the callback on
3564 * @param func The function called
3566 * If there is a @p func, then it will be called prior item's memory release.
3567 * That will be called with the following arguments:
3569 * @li item's Evas object;
3572 * This way, a data associated to a list item could be properly freed.
3574 * @deprecated Please use elm_object_item_del_cb_set() instead.
3578 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3581 * Get the data associated to the item.
3583 * @param it The list item
3584 * @return The data associated to @p item
3586 * The return value is a pointer to data associated to @p item when it was
3587 * created, with function elm_list_item_append() or similar. If no data
3588 * was passed as argument, it will return @c NULL.
3590 * @see elm_list_item_append()
3592 * @deprecated Please use elm_object_item_data_get() instead.
3596 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
3599 * Get the left side icon associated to the item.
3601 * @param it The list item
3602 * @return The left side icon associated to @p item
3604 * The return value is a pointer to the icon associated to @p item when
3606 * created, with function elm_list_item_append() or similar, or later
3607 * with function elm_list_item_icon_set(). If no icon
3608 * was passed as argument, it will return @c NULL.
3610 * @see elm_list_item_append()
3611 * @see elm_list_item_icon_set()
3613 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3616 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
3619 * Set the left side icon associated to the item.
3621 * @param it The list item
3622 * @param icon The left side icon object to associate with @p item
3624 * The icon object to use at left side of the item. An
3625 * icon can be any Evas object, but usually it is an icon created
3626 * with elm_icon_add().
3628 * Once the icon object is set, a previously set one will be deleted.
3629 * @warning Setting the same icon for two items will cause the icon to
3630 * disappear from the first item.
3632 * If an icon was passed as argument on item creation, with function
3633 * elm_list_item_append() or similar, it will be already
3634 * associated to the item.
3636 * @see elm_list_item_append()
3637 * @see elm_list_item_icon_get()
3639 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3642 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3645 * Get the right side icon associated to the item.
3647 * @param it The list item
3648 * @return The right side icon associated to @p item
3650 * The return value is a pointer to the icon associated to @p item when
3652 * created, with function elm_list_item_append() or similar, or later
3653 * with function elm_list_item_icon_set(). If no icon
3654 * was passed as argument, it will return @c NULL.
3656 * @see elm_list_item_append()
3657 * @see elm_list_item_icon_set()
3659 * @deprecated Please use elm_object_item_part_content_get(item, "end");
3662 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
3665 * Set the right side icon associated to the item.
3667 * @param it The list item
3668 * @param end The right side icon object to associate with @p item
3670 * The icon object to use at right side of the item. An
3671 * icon can be any Evas object, but usually it is an icon created
3672 * with elm_icon_add().
3674 * Once the icon object is set, a previously set one will be deleted.
3675 * @warning Setting the same icon for two items will cause the icon to
3676 * disappear from the first item.
3678 * If an icon was passed as argument on item creation, with function
3679 * elm_list_item_append() or similar, it will be already
3680 * associated to the item.
3682 * @see elm_list_item_append()
3683 * @see elm_list_item_end_get()
3685 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3688 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3691 * Get the label of item.
3693 * @param it The item of list.
3694 * @return The label of item.
3696 * The return value is a pointer to the label associated to @p item when
3697 * it was created, with function elm_list_item_append(), or later
3698 * with function elm_list_item_label_set. If no label
3699 * was passed as argument, it will return @c NULL.
3701 * @see elm_list_item_label_set() for more details.
3702 * @see elm_list_item_append()
3704 * @deprecated Please use elm_object_item_text_get(item);
3707 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
3710 * Set the label of item.
3712 * @param it The item of list.
3713 * @param text The label of item.
3715 * The label to be displayed by the item.
3716 * Label will be placed between left and right side icons (if set).
3718 * If a label was passed as argument on item creation, with function
3719 * elm_list_item_append() or similar, it will be already
3720 * displayed by the item.
3722 * @see elm_list_item_label_get()
3723 * @see elm_list_item_append()
3725 * @deprecated Please use elm_object_item_text_set(item, text);
3728 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3731 * Set the text to be shown in a given list item's tooltips.
3733 * @param it Target item.
3734 * @param text The text to set in the content.
3736 * Setup the text as tooltip to object. The item can have only one tooltip,
3737 * so any previous tooltip data - set with this function or
3738 * elm_list_item_tooltip_content_cb_set() - is removed.
3740 * @deprecated Use elm_object_item_tooltip_text_set() instead
3741 * @see elm_object_tooltip_text_set() for more details.
3745 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3748 * @brief Disable size restrictions on an object's tooltip
3749 * @param it The tooltip's anchor object
3750 * @param disable If EINA_TRUE, size restrictions are disabled
3751 * @return EINA_FALSE on failure, EINA_TRUE on success
3753 * This function allows a tooltip to expand beyond its parent window's canvas.
3754 * It will instead be limited only by the size of the display.
3756 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3759 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3762 * @brief Retrieve size restriction state of an object's tooltip
3763 * @param obj The tooltip's anchor object
3764 * @return If EINA_TRUE, size restrictions are disabled
3766 * This function returns whether a tooltip is allowed to expand beyond
3767 * its parent window's canvas.
3768 * It will instead be limited only by the size of the display.
3770 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3773 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3776 * Set the content to be shown in the tooltip item.
3778 * Setup the tooltip to item. The item can have only one tooltip,
3779 * so any previous tooltip data is removed. @p func(with @p data) will
3780 * be called every time that need show the tooltip and it should
3781 * return a valid Evas_Object. This object is then managed fully by
3782 * tooltip system and is deleted when the tooltip is gone.
3784 * @param it the list item being attached a tooltip.
3785 * @param func the function used to create the tooltip contents.
3786 * @param data what to provide to @a func as callback data/context.
3787 * @param del_cb called when data is not needed anymore, either when
3788 * another callback replaces @a func, the tooltip is unset with
3789 * elm_list_item_tooltip_unset() or the owner @a item
3790 * dies. This callback receives as the first parameter the
3791 * given @a data, and @c event_info is the item.
3793 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3795 * @see elm_object_tooltip_content_cb_set() for more details.
3799 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);
3802 * Unset tooltip from item.
3804 * @param it list item to remove previously set tooltip.
3806 * Remove tooltip from item. The callback provided as del_cb to
3807 * elm_list_item_tooltip_content_cb_set() will be called to notify
3808 * it is not used anymore.
3810 * @deprecated Use elm_object_item_tooltip_unset() instead
3811 * @see elm_object_tooltip_unset() for more details.
3812 * @see elm_list_item_tooltip_content_cb_set()
3816 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
3819 * Sets a different style for this item tooltip.
3821 * @note before you set a style you should define a tooltip with
3822 * elm_list_item_tooltip_content_cb_set() or
3823 * elm_list_item_tooltip_text_set()
3825 * @param it list item with tooltip already set.
3826 * @param style the theme style to use (default, transparent, ...)
3829 * @deprecated Use elm_object_item_tooltip_style_set() instead
3830 * @see elm_object_tooltip_style_set() for more details.
3834 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3837 * Get the style for this item tooltip.
3839 * @param item list item with tooltip already set.
3840 * @return style the theme style in use, defaults to "default". If the
3841 * object does not have a tooltip set, then NULL is returned.
3843 * @deprecated Use elm_object_item_tooltip_style_get() instead
3845 * @see elm_object_tooltip_style_get() for more details.
3846 * @see elm_list_item_tooltip_style_set()
3850 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
3853 * Set the type of mouse pointer/cursor decoration to be shown,
3854 * when the mouse pointer is over the given list widget item
3856 * @param it list item to customize cursor on
3857 * @param cursor the cursor type's name
3859 * This function works analogously as elm_object_cursor_set(), but
3860 * here the cursor's changing area is restricted to the item's
3861 * area, and not the whole widget's. Note that that item cursors
3862 * have precedence over widget cursors, so that a mouse over an
3863 * item with custom cursor set will always show @b that cursor.
3865 * If this function is called twice for an object, a previously set
3866 * cursor will be unset on the second call.
3868 * @see elm_object_cursor_set()
3869 * @see elm_list_item_cursor_get()
3870 * @see elm_list_item_cursor_unset()
3872 * @deprecated Please use elm_object_item_cursor_set() instead
3875 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3878 * Get the type of mouse pointer/cursor decoration set to be shown,
3879 * when the mouse pointer is over the given list widget item
3881 * @param it list item with custom cursor set
3882 * @return the cursor type's name or @c NULL, if no custom cursors
3883 * were set to @p item (and on errors)
3885 * @see elm_object_cursor_get()
3886 * @see elm_list_item_cursor_set()
3887 * @see elm_list_item_cursor_unset()
3889 * @deprecated Please use elm_object_item_cursor_get() instead
3892 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
3895 * Unset any custom mouse pointer/cursor decoration set to be
3896 * shown, when the mouse pointer is over the given list widget
3897 * item, thus making it show the @b default cursor again.
3899 * @param it a list item
3901 * Use this call to undo any custom settings on this item's cursor
3902 * decoration, bringing it back to defaults (no custom style set).
3904 * @see elm_object_cursor_unset()
3905 * @see elm_list_item_cursor_set()
3907 * @deprecated Please use elm_list_item_cursor_unset() instead
3910 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
3913 * Set a different @b style for a given custom cursor set for a
3916 * @param it list item with custom cursor set
3917 * @param style the <b>theme style</b> to use (e.g. @c "default",
3918 * @c "transparent", etc)
3920 * This function only makes sense when one is using custom mouse
3921 * cursor decorations <b>defined in a theme file</b>, which can have,
3922 * given a cursor name/type, <b>alternate styles</b> on it. It
3923 * works analogously as elm_object_cursor_style_set(), but here
3924 * applies only to list item objects.
3926 * @warning Before you set a cursor style you should have defined a
3927 * custom cursor previously on the item, with
3928 * elm_list_item_cursor_set()
3930 * @see elm_list_item_cursor_engine_only_set()
3931 * @see elm_list_item_cursor_style_get()
3933 * @deprecated Please use elm_list_item_cursor_style_set() instead
3936 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3939 * Get the current @b style set for a given list item's custom
3942 * @param it list item with custom cursor set.
3943 * @return style the cursor style in use. If the object does not
3944 * have a cursor set, then @c NULL is returned.
3946 * @see elm_list_item_cursor_style_set() for more details
3948 * @deprecated Please use elm_list_item_cursor_style_get() instead
3951 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
3954 * Set if the (custom)cursor for a given list item should be
3955 * searched in its theme, also, or should only rely on the
3958 * @param it item with custom (custom) cursor already set on
3959 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3960 * only on those provided by the rendering engine, @c EINA_FALSE to
3961 * have them searched on the widget's theme, as well.
3963 * @note This call is of use only if you've set a custom cursor
3964 * for list items, with elm_list_item_cursor_set().
3966 * @note By default, cursors will only be looked for between those
3967 * provided by the rendering engine.
3969 * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
3972 EINA_DEPRECATED EAPI void elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3975 * Get if the (custom) cursor for a given list item is being
3976 * searched in its theme, also, or is only relying on the rendering
3979 * @param it a list item
3980 * @return @c EINA_TRUE, if cursors are being looked for only on
3981 * those provided by the rendering engine, @c EINA_FALSE if they
3982 * are being searched on the widget's theme, as well.
3984 * @see elm_list_item_cursor_engine_only_set(), for more details
3986 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
3989 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
3992 * Delete the item from the list.
3994 * @param it The item of list to be deleted.
3996 * If deleting all list items is required, elm_list_clear()
3997 * should be used instead of getting items list and deleting each one.
3999 * @see elm_list_clear()
4000 * @see elm_list_item_append()
4001 * @see elm_widget_item_del_cb_set()
4002 * @deprecated Use elm_object_item_del() instead
4006 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
4009 * Set the shrink state of toolbar @p obj.
4011 * @param obj The toolbar object.
4012 * @param shrink_mode Toolbar's items display behavior.
4014 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
4015 * but will enforce a minimum size so all the items will fit, won't scroll
4016 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
4017 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
4018 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
4020 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
4023 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
4026 * Get the shrink mode of toolbar @p obj.
4028 * @param obj The toolbar object.
4029 * @return Toolbar's items display behavior.
4031 * @see elm_toolbar_shrink_mode_set() for details.
4033 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
4036 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
4039 * This sets a widget to be displayed to the left of a scrolled entry.
4041 * @param obj The scrolled entry object
4042 * @param icon The widget to display on the left side of the scrolled
4045 * @note A previously set widget will be destroyed.
4046 * @note If the object being set does not have minimum size hints set,
4047 * it won't get properly displayed.
4049 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
4050 * @see elm_entry_end_set()
4052 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
4055 * Gets the leftmost widget of the scrolled entry. This object is
4056 * owned by the scrolled entry and should not be modified.
4058 * @param obj The scrolled entry object
4059 * @return the left widget inside the scroller
4061 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
4063 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
4066 * Unset the leftmost widget of the scrolled entry, unparenting and
4069 * @param obj The scrolled entry object
4070 * @return the previously set icon sub-object of this entry, on
4073 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
4074 * @see elm_entry_icon_set()
4076 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
4079 * This sets a widget to be displayed to the end of a scrolled entry.
4081 * @param obj The scrolled entry object
4082 * @param end The widget to display on the right side of the scrolled
4085 * @note A previously set widget will be destroyed.
4086 * @note If the object being set does not have minimum size hints set,
4087 * it won't get properly displayed.
4089 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
4090 * @see elm_entry_icon_set
4092 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
4095 * Gets the endmost widget of the scrolled entry. This object is owned
4096 * by the scrolled entry and should not be modified.
4098 * @param obj The scrolled entry object
4099 * @return the right widget inside the scroller
4101 * @deprecated Use elm_object_part_content_get(entry, "end") instead
4103 EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
4106 * Unset the endmost widget of the scrolled entry, unparenting and
4109 * @param obj The scrolled entry object
4110 * @return the previously set icon sub-object of this entry, on
4113 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
4114 * @see elm_entry_icon_set()
4116 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
4119 * Convert a pixel coordinate into a rotated pixel coordinate.
4121 * @param obj The map object.
4122 * @param x horizontal coordinate of the point to rotate.
4123 * @param y vertical coordinate of the point to rotate.
4124 * @param cx rotation's center horizontal position.
4125 * @param cy rotation's center vertical position.
4126 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
4127 * @param xx Pointer where to store rotated x.
4128 * @param yy Pointer where to store rotated y.
4131 * @deprecated Rotation is not needed to know. Use elm_map_canvas_to_geo_convert() instead
4133 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);
4136 * Get the gengrid object's handle which contains a given gengrid item
4138 * @param it The item to fetch the container from
4139 * @return The gengrid (parent) object
4141 * This returns the gengrid object itself that an item belongs to.
4143 * @deprecated Use elm_object_item_widget_get() instead
4146 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4149 * Return the data associated to a given gengrid item
4151 * @param it The gengrid item.
4152 * @return the data associated with this item.
4154 * This returns the @c data value passed on the
4155 * elm_gengrid_item_append() and related item addition calls.
4157 * @see elm_gengrid_item_append()
4158 * @see elm_gengrid_item_data_set()
4159 * @deprecated Use elm_object_item_data_get() instead
4162 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4165 * Set the data associated with a given gengrid item
4167 * @param it The gengrid item
4168 * @param data The data pointer to set on it
4170 * This @b overrides the @c data value passed on the
4171 * elm_gengrid_item_append() and related item addition calls. This
4172 * function @b won't call elm_gengrid_item_update() automatically,
4173 * so you'd issue it afterwards if you want to have the item
4174 * updated to reflect the new data.
4176 * @see elm_gengrid_item_data_get()
4177 * @see elm_gengrid_item_update()
4178 * @deprecated Use elm_object_item_data_set() instead
4182 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4185 * Set whether a given gengrid item is disabled or not.
4187 * @param it The gengrid item
4188 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4189 * to enable it back.
4191 * A disabled item cannot be selected or unselected. It will also
4192 * change its appearance, to signal the user it's disabled.
4194 * @see elm_gengrid_item_disabled_get()
4195 * @deprecated Use elm_object_item_disabled_set() instead
4199 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4202 * Get whether a given gengrid item is disabled or not.
4204 * @param it The gengrid item
4205 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4208 * @see elm_gengrid_item_disabled_set() for more details
4209 * @deprecated Use elm_object_item_disabled_get() instead
4213 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4216 * Remove a gengrid item from its parent, deleting it.
4218 * @param it The item to be removed.
4219 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4221 * @see elm_gengrid_clear(), to remove all items in a gengrid at
4223 * @deprecated use elm_object_item_de() instead
4227 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
4230 * Append a filter function for text inserted in the entry
4232 * Append the given callback to the list. This functions will be called
4233 * whenever any text is inserted into the entry, with the text to be inserted
4234 * as a parameter. The callback function is free to alter the text in any way
4235 * it wants, but it must remember to free the given pointer and update it.
4236 * If the new text is to be discarded, the function can free it and set its
4237 * text parameter to NULL. This will also prevent any following filters from
4240 * @param obj The entry object
4241 * @param func The function to use as text filter
4242 * @param data User data to pass to @p func
4243 * @deprecated use elm_entry_markup_filter_append() instead
4246 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4249 * Prepend a filter function for text inserted in the entry
4251 * Prepend the given callback to the list. See elm_entry_text_filter_append()
4252 * for more information
4254 * @param obj The entry object
4255 * @param func The function to use as text filter
4256 * @param data User data to pass to @p func
4257 * @deprecated use elm_entry_markup_filter_prepend() instead
4260 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4263 * Remove a filter from the list
4265 * Removes the given callback from the filter list. See
4266 * elm_entry_text_filter_append() for more information.
4268 * @param obj The entry object
4269 * @param func The filter function to remove
4270 * @param data The user data passed when adding the function
4271 * @deprecated use elm_entry_markup_filter_remove() instead
4274 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);