1 EINA_DEPRECATED EAPI void elm_gen_clear(Evas_Object *obj);
2 EINA_DEPRECATED EAPI void elm_gen_item_selected_set(Elm_Gen_Item *it, Eina_Bool selected);
3 EINA_DEPRECATED EAPI Eina_Bool elm_gen_item_selected_get(const Elm_Gen_Item *it);
4 EINA_DEPRECATED EAPI void elm_gen_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5 EINA_DEPRECATED EAPI Eina_Bool elm_gen_always_select_mode_get(const Evas_Object *obj);
6 EINA_DEPRECATED EAPI void elm_gen_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
7 EINA_DEPRECATED EAPI Eina_Bool elm_gen_no_select_mode_get(const Evas_Object *obj);
8 EINA_DEPRECATED EAPI void elm_gen_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
9 EINA_DEPRECATED EAPI void elm_gen_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
10 EINA_DEPRECATED EAPI void elm_gen_page_relative_set(Evas_Object *obj, double h_pagerel, double v_pagerel);
11 EINA_DEPRECATED EAPI void elm_gen_page_relative_get(const Evas_Object *obj, double *h_pagerel, double *v_pagerel);
13 EINA_DEPRECATED EAPI void elm_gen_page_size_set(Evas_Object *obj, Evas_Coord h_pagesize, Evas_Coord v_pagesize);
14 EINA_DEPRECATED EAPI void elm_gen_current_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
15 EINA_DEPRECATED EAPI void elm_gen_last_page_get(const Evas_Object *obj, int *h_pagenumber, int *v_pagenumber);
16 EINA_DEPRECATED EAPI void elm_gen_page_show(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
17 EINA_DEPRECATED EAPI void elm_gen_page_bring_in(const Evas_Object *obj, int h_pagenumber, int v_pagenumber);
18 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_first_item_get(const Evas_Object *obj);
19 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_last_item_get(const Evas_Object *obj);
20 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_next_get(const Elm_Gen_Item *it);
21 EINA_DEPRECATED EAPI Elm_Gen_Item *elm_gen_item_prev_get(const Elm_Gen_Item *it);
22 EINA_DEPRECATED EAPI Evas_Object *elm_gen_item_widget_get(const Elm_Gen_Item *it);
25 * @defgroup Toggle Toggle
27 * @image html img/widget/toggle/preview-00.png
28 * @image latex img/widget/toggle/preview-00.eps
30 * @brief A toggle is a slider which can be used to toggle between
31 * two values. It has two states: on and off.
33 * This widget is deprecated. Please use elm_check_add() instead using the
37 * obj = elm_check_add(parent);
38 * elm_object_style_set(obj, "toggle");
39 * elm_object_part_text_set(obj, "on", "ON");
40 * elm_object_part_text_set(obj, "off", "OFF");
43 * Signals that you can add callbacks for are:
44 * @li "changed" - Whenever the toggle value has been changed. Is not called
45 * until the toggle is released by the cursor (assuming it
46 * has been triggered by the cursor in the first place).
48 * Default contents parts of the toggle widget that you can use for are:
49 * @li "icon" - An icon of the toggle
51 * Default text parts of the toggle widget that you can use for are:
52 * @li "elm.text" - Label of the toggle
54 * @ref tutorial_toggle show how to use a toggle.
59 * @brief Add a toggle to @p parent.
61 * @param parent The parent object
63 * @return The toggle object
65 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
68 * @brief Sets the label to be displayed with the toggle.
70 * @param obj The toggle object
71 * @param label The label to be displayed
73 * @deprecated use elm_object_text_set() instead.
75 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
78 * @brief Gets the label of the toggle
80 * @param obj toggle object
81 * @return The label of the toggle
83 * @deprecated use elm_object_text_get() instead.
85 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
88 * @brief Set the icon used for the toggle
90 * @param obj The toggle object
91 * @param icon The icon object for the button
93 * Once the icon object is set, a previously set one will be deleted
94 * If you want to keep that old content object, use the
95 * elm_toggle_icon_unset() function.
97 * @deprecated use elm_object_part_content_set() instead.
99 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
102 * @brief Get the icon used for the toggle
104 * @param obj The toggle object
105 * @return The icon object that is being used
107 * Return the icon object which is set for this widget.
109 * @see elm_toggle_icon_set()
111 * @deprecated use elm_object_part_content_get() instead.
113 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
116 * @brief Unset the icon used for the toggle
118 * @param obj The toggle object
119 * @return The icon object that was being used
121 * Unparent and return the icon object which was set for this widget.
123 * @see elm_toggle_icon_set()
125 * @deprecated use elm_object_part_content_unset() instead.
127 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
130 * @brief Sets the labels to be associated with the on and off states of the toggle.
132 * @param obj The toggle object
133 * @param onlabel The label displayed when the toggle is in the "on" state
134 * @param offlabel The label displayed when the toggle is in the "off" state
136 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
139 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
142 * @brief Gets the labels associated with the on and off states of the
145 * @param obj The toggle object
146 * @param onlabel A char** to place the onlabel of @p obj into
147 * @param offlabel A char** to place the offlabel of @p obj into
149 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
152 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
155 * @brief Sets the state of the toggle to @p state.
157 * @param obj The toggle object
158 * @param state The state of @p obj
160 * @deprecated use elm_check_state_set() instead.
162 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
165 * @brief Gets the state of the toggle to @p state.
167 * @param obj The toggle object
168 * @return The state of @p obj
170 * @deprecated use elm_check_state_get() instead.
172 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
175 * @brief Sets the state pointer of the toggle to @p statep.
177 * @param obj The toggle object
178 * @param statep The state pointer of @p obj
180 * @deprecated use elm_check_state_pointer_set() instead.
182 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
188 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
189 EINA_DEPRECATED EAPI void elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
190 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_single_line_get(const Evas_Object *obj);
191 EINA_DEPRECATED EAPI void elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
192 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_password_get(const Evas_Object *obj);
193 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
194 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_entry_get(const Evas_Object *obj);
195 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
196 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_is_empty(const Evas_Object *obj);
197 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_selection_get(const Evas_Object *obj);
198 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
199 EINA_DEPRECATED EAPI void elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
200 EINA_DEPRECATED EAPI void elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
201 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_editable_get(const Evas_Object *obj);
202 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_none(Evas_Object *obj);
203 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_all(Evas_Object *obj);
204 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_next(Evas_Object *obj);
205 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_prev(Evas_Object *obj);
206 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_up(Evas_Object *obj);
207 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_down(Evas_Object *obj);
208 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
209 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
210 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
211 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
212 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
213 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
214 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
215 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
216 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
217 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
218 EINA_DEPRECATED EAPI int elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
219 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_cut(Evas_Object *obj);
220 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_copy(Evas_Object *obj);
221 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_paste(Evas_Object *obj);
222 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
223 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);
224 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
225 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
226 EINA_DEPRECATED EAPI void elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
227 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
228 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
229 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
230 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
231 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
232 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
233 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
234 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
235 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
236 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
237 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);
238 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);
239 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);
240 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
241 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
242 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
243 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
244 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
245 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_save(Evas_Object *obj);
246 EINA_DEPRECATED EAPI void elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
247 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_autosave_get(const Evas_Object *obj);
248 EINA_DEPRECATED EAPI void elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
249 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
252 * Set the text to show in the anchorblock
254 * Sets the text of the anchorblock to @p text. This text can include markup
255 * format tags, including <c>\<a href=anchorname\></a></c> to begin a segment
256 * of text that will be specially styled and react to click events, ended
257 * with either of \</a\> or \</\>. When clicked, the anchor will emit an
258 * "anchor,clicked" signal that you can attach a callback to with
259 * evas_object_smart_callback_add(). The name of the anchor given in the
260 * event info struct will be the one set in the href attribute, in this
263 * Other markup can be used to style the text in different ways, but it's
264 * up to the style defined in the theme which tags do what.
265 * @deprecated use elm_object_text_set() instead.
267 EINA_DEPRECATED EAPI void elm_anchorblock_text_set(Evas_Object *obj, const char *text);
270 * Get the markup text set for the anchorblock
272 * Retrieves the text set on the anchorblock, with markup tags included.
274 * @param obj The anchorblock object
275 * @return The markup text set or @c NULL if nothing was set or an error
277 * @deprecated use elm_object_text_set() instead.
279 EINA_DEPRECATED EAPI const char *elm_anchorblock_text_get(const Evas_Object *obj);
282 * Set the text to show in the anchorview
284 * Sets the text of the anchorview to @p text. This text can include markup
285 * format tags, including <c>\<a href=anchorname\></c> to begin a segment of
286 * text that will be specially styled and react to click events, ended with
287 * either of \</a\> or \</\>. When clicked, the anchor will emit an
288 * "anchor,clicked" signal that you can attach a callback to with
289 * evas_object_smart_callback_add(). The name of the anchor given in the
290 * event info struct will be the one set in the href attribute, in this
293 * Other markup can be used to style the text in different ways, but it's
294 * up to the style defined in the theme which tags do what.
295 * @deprecated use elm_object_text_set() instead.
297 EINA_DEPRECATED EAPI void elm_anchorview_text_set(Evas_Object *obj, const char *text);
300 * Get the markup text set for the anchorview
302 * Retrieves the text set on the anchorview, with markup tags included.
304 * @param obj The anchorview object
305 * @return The markup text set or @c NULL if nothing was set or an error
307 * @deprecated use elm_object_text_set() instead.
309 EINA_DEPRECATED EAPI const char *elm_anchorview_text_get(const Evas_Object *obj);
312 * @brief Get the ctxpopup item's disabled/enabled state.
314 * @param it Ctxpopup item to be enabled/disabled
315 * @return disabled @c EINA_TRUE, if disabled, @c EINA_FALSE otherwise
317 * @see elm_ctxpopup_item_disabled_set()
318 * @deprecated use elm_object_item_disabled_get() instead
322 EINA_DEPRECATED EAPI Eina_Bool elm_ctxpopup_item_disabled_get(const Elm_Object_Item *it);
325 * @brief Set the ctxpopup item's state as disabled or enabled.
327 * @param it Ctxpopup item to be enabled/disabled
328 * @param disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
330 * When disabled the item is greyed out to indicate it's state.
331 * @deprecated use elm_object_item_disabled_set() instead
335 EINA_DEPRECATED EAPI void elm_ctxpopup_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
338 * @brief Get the icon object for the given ctxpopup item.
340 * @param it Ctxpopup item
341 * @return icon object or @c NULL, if the item does not have icon or an error
344 * @see elm_ctxpopup_item_append()
345 * @see elm_ctxpopup_item_icon_set()
347 * @deprecated use elm_object_item_part_content_get() instead
351 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_item_icon_get(const Elm_Object_Item *it);
354 * @brief Sets the side icon associated with the ctxpopup item
356 * @param it Ctxpopup item
357 * @param icon Icon object to be set
359 * Once the icon object is set, a previously set one will be deleted.
360 * @warning Setting the same icon for two items will cause the icon to
361 * dissapear from the first item.
363 * @see elm_ctxpopup_item_append()
365 * @deprecated use elm_object_item_part_content_set() instead
369 EINA_DEPRECATED EAPI void elm_ctxpopup_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
372 * @brief Get the label for the given ctxpopup item.
374 * @param it Ctxpopup item
375 * @return label string or @c NULL, if the item does not have label or an
378 * @see elm_ctxpopup_item_append()
379 * @see elm_ctxpopup_item_label_set()
381 * @deprecated use elm_object_item_text_get() instead
385 EINA_DEPRECATED EAPI const char *elm_ctxpopup_item_label_get(const Elm_Object_Item *it);
388 * @brief (Re)set the label on the given ctxpopup item.
390 * @param it Ctxpopup item
391 * @param label String to set as label
393 * @deprecated use elm_object_item_text_set() instead
397 EINA_DEPRECATED EAPI void elm_ctxpopup_item_label_set(Elm_Object_Item *it, const char *label);
400 * @brief Set an elm widget as the content of the ctxpopup.
402 * @param obj Ctxpopup object
403 * @param content Content to be swallowed
405 * If the content object is already set, a previous one will bedeleted. If
406 * you want to keep that old content object, use the
407 * elm_ctxpopup_content_unset() function.
409 * @warning Ctxpopup can't hold both a item list and a content at the same
410 * time. When a content is set, any previous items will be removed.
412 * @deprecated use elm_object_content_set() instead
416 EINA_DEPRECATED EAPI void elm_ctxpopup_content_set(Evas_Object *obj, Evas_Object *content);
419 * @brief Unset the ctxpopup content
421 * @param obj Ctxpopup object
422 * @return The content that was being used
424 * Unparent and return the content object which was set for this widget.
426 * @deprecated use elm_object_content_unset()
428 * @see elm_ctxpopup_content_set()
430 * @deprecated use elm_object_content_unset() instead
434 EINA_DEPRECATED EAPI Evas_Object *elm_ctxpopup_content_unset(Evas_Object *obj);
437 * Set the label for a given file selector button widget
439 * @param obj The file selector button widget
440 * @param label The text label to be displayed on @p obj
442 * @deprecated use elm_object_text_set() instead.
444 EINA_DEPRECATED EAPI void elm_fileselector_button_label_set(Evas_Object *obj, const char *label);
447 * Get the label set for a given file selector button widget
449 * @param obj The file selector button widget
450 * @return The button label
452 * @deprecated use elm_object_text_set() instead.
454 EINA_DEPRECATED EAPI const char *elm_fileselector_button_label_get(const Evas_Object *obj);
457 * Set the icon on a given file selector button widget
459 * @param obj The file selector button widget
460 * @param icon The icon object for the button
462 * Once the icon object is set, a previously set one will be
463 * deleted. If you want to keep the latter, use the
464 * elm_fileselector_button_icon_unset() function.
466 * @deprecated Use elm_object_part_content_set() instead
467 * @see elm_fileselector_button_icon_get()
469 EINA_DEPRECATED EAPI void elm_fileselector_button_icon_set(Evas_Object *obj, Evas_Object *icon);
472 * Get the icon set for a given file selector button widget
474 * @param obj The file selector button widget
475 * @return The icon object currently set on @p obj or @c NULL, if
478 * @deprecated Use elm_object_part_content_get() instead
479 * @see elm_fileselector_button_icon_set()
481 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_get(const Evas_Object *obj);
484 * Unset the icon used in a given file selector button widget
486 * @param obj The file selector button widget
487 * @return The icon object that was being used on @p obj or @c
490 * Unparent and return the icon object which was set for this
493 * @deprecated Use elm_object_part_content_unset() instead
494 * @see elm_fileselector_button_icon_set()
496 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_button_icon_unset(Evas_Object *obj);
499 * Set the label for a given file selector entry widget's button
501 * @param obj The file selector entry widget
502 * @param label The text label to be displayed on @p obj widget's
505 * @deprecated use elm_object_text_set() instead.
507 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_label_set(Evas_Object *obj, const char *label);
510 * Get the label set for a given file selector entry widget's button
512 * @param obj The file selector entry widget
513 * @return The widget button's label
515 * @deprecated use elm_object_text_set() instead.
517 EINA_DEPRECATED EAPI const char *elm_fileselector_entry_button_label_get(const Evas_Object *obj);
520 * Set the icon on a given file selector entry widget's button
522 * @param obj The file selector entry widget
523 * @param icon The icon object for the entry's button
525 * Once the icon object is set, a previously set one will be
526 * deleted. If you want to keep the latter, use the
527 * elm_fileselector_entry_button_icon_unset() function.
529 * @deprecated Use elm_object_part_content_set() instead
530 * @see elm_fileselector_entry_button_icon_get()
532 EINA_DEPRECATED EAPI void elm_fileselector_entry_button_icon_set(Evas_Object *obj, Evas_Object *icon);
535 * Get the icon set for a given file selector entry widget's button
537 * @param obj The file selector entry widget
538 * @return The icon object currently set on @p obj widget's button
539 * or @c NULL, if none is
541 * @deprecated Use elm_object_part_content_get() instead
542 * @see elm_fileselector_entry_button_icon_set()
544 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_get(const Evas_Object *obj);
547 * Unset the icon used in a given file selector entry widget's
550 * @param obj The file selector entry widget
551 * @return The icon object that was being used on @p obj widget's
552 * button or @c NULL, on errors
554 * Unparent and return the icon object which was set for this
557 * @deprecated Use elm_object_part_content_unset() instead
558 * @see elm_fileselector_entry_button_icon_set()
560 EINA_DEPRECATED EAPI Evas_Object *elm_fileselector_entry_button_icon_unset(Evas_Object *obj);
563 * @brief Set the hoversel button label
565 * @param obj The hoversel object
566 * @param label The label text.
568 * This sets the label of the button that is always visible (before it is
569 * clicked and expanded).
571 * @deprecated elm_object_text_set()
573 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
576 * @brief Get the hoversel button label
578 * @param obj The hoversel object
579 * @return The label text.
581 * @deprecated elm_object_text_get()
583 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
586 * @brief Set the icon of the hoversel button
588 * @param obj The hoversel object
589 * @param icon The icon object
591 * Sets the icon of the button that is always visible (before it is clicked
592 * and expanded). Once the icon object is set, a previously set one will be
593 * deleted, if you want to keep that old content object, use the
594 * elm_hoversel_icon_unset() function.
596 * @see elm_object_content_set() for the button widget
597 * @deprecated Use elm_object_item_part_content_set() instead
599 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
602 * @brief Get the icon of the hoversel button
604 * @param obj The hoversel object
605 * @return The icon object
607 * Get the icon of the button that is always visible (before it is clicked
608 * and expanded). Also see elm_object_content_get() for the button widget.
610 * @see elm_hoversel_icon_set()
611 * @deprecated Use elm_object_item_part_content_get() instead
613 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
616 * @brief Get and unparent the icon of the hoversel button
618 * @param obj The hoversel object
619 * @return The icon object that was being used
621 * Unparent and return the icon of the button that is always visible
622 * (before it is clicked and expanded).
624 * @see elm_hoversel_icon_set()
625 * @see elm_object_content_unset() for the button widget
626 * @deprecated Use elm_object_item_part_content_unset() instead
628 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
631 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
632 * that will be passed to associated function callbacks.
634 * @param it The item to get the data from
635 * @return The data pointer set with elm_hoversel_item_add()
637 * @see elm_hoversel_item_add()
638 * @deprecated Use elm_object_item_data_get() instead
640 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
643 * @brief This returns the label text of the given hoversel item.
645 * @param it The item to get the label
646 * @return The label text of the hoversel item
648 * @see elm_hoversel_item_add()
649 * @deprecated Use elm_object_item_text_get() instead
651 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
654 * @brief Set the function to be called when an item from the hoversel is
657 * @param it The item to set the callback on
658 * @param func The function called
660 * That function will receive these parameters:
661 * @li void * item data
662 * @li Evas_Object * hoversel object
663 * @li Elm_Object_Item * hoversel item
665 * @see elm_hoversel_item_add()
666 * @deprecated Use elm_object_item_del_cb_set() instead
668 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
671 * Set actionslider labels.
673 * @param obj The actionslider object
674 * @param left_label The label to be set on the left.
675 * @param center_label The label to be set on the center.
676 * @param right_label The label to be set on the right.
677 * @deprecated use elm_object_text_set() instead.
679 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
682 * Get actionslider labels.
684 * @param obj The actionslider object
685 * @param left_label A char** to place the left_label of @p obj into.
686 * @param center_label A char** to place the center_label of @p obj into.
687 * @param right_label A char** to place the right_label of @p obj into.
688 * @deprecated use elm_object_text_set() instead.
690 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
693 * Set the label used on the indicator.
695 * @param obj The actionslider object
696 * @param label The label to be set on the indicator.
697 * @deprecated use elm_object_text_set() instead.
699 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
702 * Get the label used on the indicator object.
704 * @param obj The actionslider object
705 * @return The indicator label
706 * @deprecated use elm_object_text_get() instead.
708 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
711 * Set the overlay object used for the background object.
713 * @param obj The bg object
714 * @param overlay The overlay object
716 * This provides a way for elm_bg to have an 'overlay' that will be on top
717 * of the bg. Once the over object is set, a previously set one will be
718 * deleted, even if you set the new one to NULL. If you want to keep that
719 * old content object, use the elm_bg_overlay_unset() function.
721 * @deprecated use elm_object_part_content_set() instead
726 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
729 * Get the overlay object used for the background object.
731 * @param obj The bg object
732 * @return The content that is being used
734 * Return the content object which is set for this widget
736 * @deprecated use elm_object_part_content_get() instead
740 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
743 * Get the overlay object used for the background object.
745 * @param obj The bg object
746 * @return The content that was being used
748 * Unparent and return the overlay object which was set for this widget
750 * @deprecated use elm_object_part_content_unset() instead
754 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
758 * Set the label of the bubble
760 * @param obj The bubble object
761 * @param label The string to set in the label
763 * This function sets the title of the bubble. Where this appears depends on
764 * the selected corner.
765 * @deprecated use elm_object_text_set() instead.
767 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
770 * Get the label of the bubble
772 * @param obj The bubble object
773 * @return The string of set in the label
775 * This function gets the title of the bubble.
776 * @deprecated use elm_object_text_get() instead.
778 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
781 * Set the info of the bubble
783 * @param obj The bubble object
784 * @param info The given info about the bubble
786 * This function sets the info of the bubble. Where this appears depends on
787 * the selected corner.
788 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
790 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
793 * Get the info of the bubble
795 * @param obj The bubble object
797 * @return The "info" string of the bubble
799 * This function gets the info text.
800 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
802 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
805 * Set the content to be shown in the bubble
807 * Once the content object is set, a previously set one will be deleted.
808 * If you want to keep the old content object, use the
809 * elm_bubble_content_unset() function.
811 * @param obj The bubble object
812 * @param content The given content of the bubble
814 * This function sets the content shown on the middle of the bubble.
816 * @deprecated use elm_object_content_set() instead
819 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
822 * Get the content shown in the bubble
824 * Return the content object which is set for this widget.
826 * @param obj The bubble object
827 * @return The content that is being used
829 * @deprecated use elm_object_content_get() instead
832 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
835 * Unset the content shown in the bubble
837 * Unparent and return the content object which was set for this widget.
839 * @param obj The bubble object
840 * @return The content that was being used
842 * @deprecated use elm_object_content_unset() instead
845 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
848 * Set the icon of the bubble
850 * Once the icon object is set, a previously set one will be deleted.
851 * If you want to keep the old content object, use the
852 * elm_icon_content_unset() function.
854 * @param obj The bubble object
855 * @param icon The given icon for the bubble
857 * @deprecated use elm_object_part_content_set() instead
860 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
863 * Get the icon of the bubble
865 * @param obj The bubble object
866 * @return The icon for the bubble
868 * This function gets the icon shown on the top left of bubble.
870 * @deprecated use elm_object_part_content_get() instead
873 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
876 * Unset the icon of the bubble
878 * Unparent and return the icon object which was set for this widget.
880 * @param obj The bubble object
881 * @return The icon that was being used
883 * @deprecated use elm_object_part_content_unset() instead
886 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
890 * Set the label used in the button
892 * The passed @p label can be NULL to clean any existing text in it and
893 * leave the button as an icon only object.
895 * @param obj The button object
896 * @param label The text will be written on the button
897 * @deprecated use elm_object_text_set() instead.
899 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
902 * Get the label set for the button
904 * The string returned is an internal pointer and should not be freed or
905 * altered. It will also become invalid when the button is destroyed.
906 * The string returned, if not NULL, is a stringshare, so if you need to
907 * keep it around even after the button is destroyed, you can use
908 * eina_stringshare_ref().
910 * @param obj The button object
911 * @return The text set to the label, or NULL if nothing is set
912 * @deprecated use elm_object_text_set() instead.
914 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
917 * Set the icon used for the button
919 * Setting a new icon will delete any other that was previously set, making
920 * any reference to them invalid. If you need to maintain the previous
921 * object alive, unset it first with elm_button_icon_unset().
923 * @param obj The button object
924 * @param icon The icon object for the button
925 * @deprecated use elm_object_part_content_set() instead.
927 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
930 * Get the icon used for the button
932 * Return the icon object which is set for this widget. If the button is
933 * destroyed or another icon is set, the returned object will be deleted
934 * and any reference to it will be invalid.
936 * @param obj The button object
937 * @return The icon object that is being used
939 * @deprecated use elm_object_part_content_get() instead
941 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
944 * Remove the icon set without deleting it and return the object
946 * This function drops the reference the button holds of the icon object
947 * and returns this last object. It is used in case you want to remove any
948 * icon, or set another one, without deleting the actual object. The button
949 * will be left without an icon set.
951 * @param obj The button object
952 * @return The icon object that was being used
953 * @deprecated use elm_object_part_content_unset() instead.
955 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
958 * Set a day text color to the same that represents Saturdays.
960 * @param obj The calendar object.
961 * @param pos The text position. Position is the cell counter, from left
962 * to right, up to down. It starts on 0 and ends on 41.
964 * @deprecated use elm_calendar_mark_add() instead like:
967 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
968 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
971 * @see elm_calendar_mark_add()
975 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
978 * Set a day text color to the same that represents Sundays.
980 * @param obj The calendar object.
981 * @param pos The text position. Position is the cell counter, from left
982 * to right, up to down. It starts on 0 and ends on 41.
984 * @deprecated use elm_calendar_mark_add() instead like:
987 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
988 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
991 * @see elm_calendar_mark_add()
995 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
998 * Set a day text color to the same that represents Weekdays.
1000 * @param obj The calendar object
1001 * @param pos The text position. Position is the cell counter, from left
1002 * to right, up to down. It starts on 0 and ends on 41.
1004 * @deprecated use elm_calendar_mark_add() instead like:
1007 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
1009 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
1010 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1011 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
1012 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1013 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
1014 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1015 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
1016 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
1017 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
1020 * @see elm_calendar_mark_add()
1024 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
1028 * @brief Set the text label of the check object
1030 * @param obj The check object
1031 * @param label The text label string in UTF-8
1033 * @deprecated use elm_object_text_set() instead.
1035 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1038 * @brief Get the text label of the check object
1040 * @param obj The check object
1041 * @return The text label string in UTF-8
1043 * @deprecated use elm_object_text_get() instead.
1045 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1048 * @brief Set the icon object of the check object
1050 * @param obj The check object
1051 * @param icon The icon object
1053 * Once the icon object is set, a previously set one will be deleted.
1054 * If you want to keep that old content object, use the
1055 * elm_object_content_unset() function.
1057 * @deprecated use elm_object_part_content_set() instead.
1060 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1063 * @brief Get the icon object of the check object
1065 * @param obj The check object
1066 * @return The icon object
1068 * @deprecated use elm_object_part_content_get() instead.
1071 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1074 * @brief Unset the icon used for the check object
1076 * @param obj The check object
1077 * @return The icon object that was being used
1079 * Unparent and return the icon object which was set for this widget.
1081 * @deprecated use elm_object_part_content_unset() instead.
1084 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1087 * @brief Set the text label of the check object
1089 * @param obj The check object
1090 * @param label The text label string in UTF-8
1092 * @deprecated use elm_object_text_set() instead.
1094 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
1097 * @brief Get the text label of the check object
1099 * @param obj The check object
1100 * @return The text label string in UTF-8
1102 * @deprecated use elm_object_text_get() instead.
1104 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
1107 * @brief Set the icon object of the check object
1109 * @param obj The check object
1110 * @param icon The icon object
1112 * Once the icon object is set, a previously set one will be deleted.
1113 * If you want to keep that old content object, use the
1114 * elm_object_content_unset() function.
1116 * @deprecated use elm_object_part_content_set() instead.
1119 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
1122 * @brief Get the icon object of the check object
1124 * @param obj The check object
1125 * @return The icon object
1127 * @deprecated use elm_object_part_content_get() instead.
1130 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
1133 * @brief Unset the icon used for the check object
1135 * @param obj The check object
1136 * @return The icon object that was being used
1138 * Unparent and return the icon object which was set for this widget.
1140 * @deprecated use elm_object_part_content_unset() instead.
1143 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
1145 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
1146 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
1150 * Set the content of the conformant widget.
1152 * @param obj The conformant object.
1153 * @param content The content to be displayed by the conformant.
1155 * Content will be sized and positioned considering the space required
1156 * to display a virtual keyboard. So it won't fill all the conformant
1157 * size. This way is possible to be sure that content won't resize
1158 * or be re-positioned after the keyboard is displayed.
1160 * Once the content object is set, a previously set one will be deleted.
1161 * If you want to keep that old content object, use the
1162 * elm_object_content_unset() function.
1164 * @see elm_object_content_unset()
1165 * @see elm_object_content_get()
1167 * @deprecated use elm_object_content_set() instead
1169 * @ingroup Conformant
1171 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
1174 * Get the content of the conformant widget.
1176 * @param obj The conformant object.
1177 * @return The content that is being used.
1179 * Return the content object which is set for this widget.
1180 * It won't be unparent from conformant. For that, use
1181 * elm_object_content_unset().
1183 * @see elm_object_content_set().
1184 * @see elm_object_content_unset()
1186 * @deprecated use elm_object_content_get() instead
1188 * @ingroup Conformant
1190 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
1193 * Unset the content of the conformant widget.
1195 * @param obj The conformant object.
1196 * @return The content that was being used.
1198 * Unparent and return the content object which was set for this widget.
1200 * @see elm_object_content_set().
1202 * @deprecated use elm_object_content_unset() instead
1204 * @ingroup Conformant
1206 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
1209 * Get the side labels max length.
1211 * @deprecated use elm_diskselector_side_label_length_get() instead:
1213 * @param obj The diskselector object.
1214 * @return The max length defined for side labels, or 0 if not a valid
1217 * @ingroup Diskselector
1219 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
1222 * Set the side labels max length.
1224 * @deprecated use elm_diskselector_side_label_length_set() instead:
1226 * @param obj The diskselector object.
1227 * @param len The max length defined for side labels.
1229 * @ingroup Diskselector
1231 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
1234 * Get the data associated to the item.
1236 * @param it The diskselector item
1237 * @return The data associated to @p it
1239 * The return value is a pointer to data associated to @p item when it was
1240 * created, with function elm_diskselector_item_append(). If no data
1241 * was passed as argument, it will return @c NULL.
1243 * @see elm_diskselector_item_append()
1244 * @deprecated Use elm_object_item_data_get()
1246 * @ingroup Diskselector
1248 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
1251 * Set the icon associated to the item.
1253 * @param it The diskselector item
1254 * @param icon The icon object to associate with @p it
1256 * The icon object to use at left side of the item. An
1257 * icon can be any Evas object, but usually it is an icon created
1258 * with elm_icon_add().
1260 * Once the icon object is set, a previously set one will be deleted.
1261 * @warning Setting the same icon for two items will cause the icon to
1262 * dissapear from the first item.
1264 * If an icon was passed as argument on item creation, with function
1265 * elm_diskselector_item_append(), it will be already
1266 * associated to the item.
1268 * @see elm_diskselector_item_append()
1269 * @see elm_diskselector_item_icon_get()
1271 * @deprecated Use elm_object_item_part_content_set() instead
1272 * @ingroup Diskselector
1274 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1277 * Get the icon associated to the item.
1279 * @param item The diskselector item
1280 * @return The icon associated to @p it
1282 * The return value is a pointer to the icon associated to @p item when it was
1283 * created, with function elm_diskselector_item_append(), or later
1284 * with function elm_diskselector_item_icon_set. If no icon
1285 * was passed as argument, it will return @c NULL.
1287 * @see elm_diskselector_item_append()
1288 * @see elm_diskselector_item_icon_set()
1290 * @deprecated Use elm_object_item_part_content_set() instead
1291 * @ingroup Diskselector
1293 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1296 * Set the label of item.
1298 * @param it The item of diskselector.
1299 * @param label The label of item.
1301 * The label to be displayed by the item.
1303 * If no icon is set, label will be centered on item position, otherwise
1304 * the icon will be placed at left of the label, that will be shifted
1307 * An item with label "January" would be displayed on side position as
1308 * "Jan" if max length is set to 3 with function
1309 * elm_diskselector_side_label_lenght_set(), or "Janu", if this property
1312 * When this @p item is selected, the entire label will be displayed,
1313 * except for width restrictions.
1314 * In this case label will be cropped and "..." will be concatenated,
1315 * but only for display purposes. It will keep the entire string, so
1316 * if diskselector is resized the remaining characters will be displayed.
1318 * If a label was passed as argument on item creation, with function
1319 * elm_diskselector_item_append(), it will be already
1320 * displayed by the item.
1322 * @see elm_diskselector_side_label_lenght_set()
1323 * @see elm_diskselector_item_label_get()
1324 * @see elm_diskselector_item_append()
1326 * @deprecated Use elm_object_item_text_set() instead
1327 * @ingroup Diskselector
1329 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1332 * Get the label of item.
1334 * @param it The item of diskselector.
1335 * @return The label of item.
1337 * The return value is a pointer to the label associated to @p item when it was
1338 * created, with function elm_diskselector_item_append(), or later
1339 * with function elm_diskselector_item_label_set. If no label
1340 * was passed as argument, it will return @c NULL.
1342 * @see elm_diskselector_item_label_set() for more details.
1343 * @see elm_diskselector_item_append()
1344 * @use elm_object_item_text_get()
1346 * @ingroup Diskselector
1348 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1351 * Set the function called when a diskselector item is freed.
1353 * @param it The item to set the callback on
1354 * @param func The function called
1356 * If there is a @p func, then it will be called prior item's memory release.
1357 * That will be called with the following arguments:
1359 * @li item's Evas object;
1362 * This way, a data associated to a diskselector item could be properly
1364 * @deprecated Use elm_object_item_del_cb_set() instead
1366 * @ingroup Diskselector
1368 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1370 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1371 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1374 * Get the label of a given flip selector widget's item.
1376 * @param it The item to get label from
1377 * @return The text label of @p item or @c NULL, on errors
1379 * @see elm_object_item_text_set()
1381 * @deprecated see elm_object_item_text_get() instead
1382 * @ingroup Flipselector
1384 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1387 * Set the label of a given flip selector widget's item.
1389 * @param it The item to set label on
1390 * @param label The text label string, in UTF-8 encoding
1392 * @see elm_object_item_text_get()
1394 * @deprecated see elm_object_item_text_set() instead
1395 * @ingroup Flipselector
1397 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1400 * Make a given Elementary object the focused one.
1402 * @param obj The Elementary object to make focused.
1404 * @note This object, if it can handle focus, will take the focus
1405 * away from the one who had it previously and will, for now on, be
1406 * the one receiving input events.
1408 * @see elm_object_focus_get()
1409 * @deprecated use elm_object_focus_set() instead.
1413 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1416 * Remove the focus from an Elementary object
1418 * @param obj The Elementary to take focus from
1420 * This removes the focus from @p obj, passing it back to the
1421 * previous element in the focus chain list.
1423 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1424 * @deprecated use elm_object_focus_set() instead.
1428 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1431 * @brief Set the frame label
1433 * @param obj The frame object
1434 * @param label The label of this frame object
1436 * @deprecated use elm_object_text_set() instead.
1438 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1441 * @brief Get the frame label
1443 * @param obj The frame object
1445 * @return The label of this frame objet or NULL if unable to get frame
1447 * @deprecated use elm_object_text_get() instead.
1449 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1452 * @brief Set the content of the frame widget
1454 * Once the content object is set, a previously set one will be deleted.
1455 * If you want to keep that old content object, use the
1456 * elm_frame_content_unset() function.
1458 * @param obj The frame object
1459 * @param content The content will be filled in this frame object
1461 * @deprecated use elm_object_content_set() instead.
1463 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1466 * @brief Get the content of the frame widget
1468 * Return the content object which is set for this widget
1470 * @param obj The frame object
1471 * @return The content that is being used
1473 * @deprecated use elm_object_content_get() instead.
1475 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1478 * @brief Unset the content of the frame widget
1480 * Unparent and return the content object which was set for this widget
1482 * @param obj The frame object
1483 * @return The content that was being used
1485 * @deprecated use elm_object_content_unset() instead.
1487 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1489 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1490 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1491 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Genlist_Item *it);
1493 #define ELM_IMAGE_ROTATE_90_CW 1
1494 #define ELM_IMAGE_ROTATE_180_CW 2
1495 #define ELM_IMAGE_ROTATE_90_CCW 3
1498 * Return the data associated with a given index widget item
1500 * @param it The index widget item handle
1501 * @return The data associated with @p it
1502 * @deprecated Use elm_object_item_data_get() instead
1504 * @see elm_index_item_data_set()
1508 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1511 * Set the data associated with a given index widget item
1513 * @param it The index widget item handle
1514 * @param data The new data pointer to set to @p it
1516 * This sets new item data on @p it.
1518 * @warning The old data pointer won't be touched by this function, so
1519 * the user had better to free that old data himself/herself.
1521 * @deprecated Use elm_object_item_data_set() instead
1524 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1527 * Set the function to be called when a given index widget item is freed.
1529 * @param it The item to set the callback on
1530 * @param func The function to call on the item's deletion
1532 * When called, @p func will have both @c data and @c event_info
1533 * arguments with the @p it item's data value and, naturally, the
1534 * @c obj argument with a handle to the parent index widget.
1536 * @deprecated Use elm_object_item_del_cb_set() instead
1539 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1542 * @brief Set the label on the label object
1544 * @param obj The label object
1545 * @param label The label will be used on the label object
1546 * @deprecated See elm_object_text_set()
1548 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
1551 * @brief Get the label used on the label object
1553 * @param obj The label object
1554 * @return The string inside the label
1555 * @deprecated See elm_object_text_get()
1557 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
1561 * Set the layout content.
1563 * @param obj The layout object
1564 * @param swallow The swallow part name in the edje file
1565 * @param content The child that will be added in this layout object
1567 * Once the content object is set, a previously set one will be deleted.
1568 * If you want to keep that old content object, use the
1569 * elm_object_part_content_unset() function.
1571 * @note In an Edje theme, the part used as a content container is called @c
1572 * SWALLOW. This is why the parameter name is called @p swallow, but it is
1573 * expected to be a part name just like the second parameter of
1574 * elm_layout_box_append().
1576 * @see elm_layout_box_append()
1577 * @see elm_object_part_content_get()
1578 * @see elm_object_part_content_unset()
1580 * @deprecated use elm_object_part_content_set() instead
1584 EINA_DEPRECATED EAPI void elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
1587 * Get the child object in the given content part.
1589 * @param obj The layout object
1590 * @param swallow The SWALLOW part to get its content
1592 * @return The swallowed object or NULL if none or an error occurred
1594 * @deprecated use elm_object_part_content_get() instead
1598 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
1601 * Unset the layout content.
1603 * @param obj The layout object
1604 * @param swallow The swallow part name in the edje file
1605 * @return The content that was being used
1607 * Unparent and return the content object which was set for this part.
1609 * @deprecated use elm_object_part_content_unset() instead
1613 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
1616 * Set the text of the given part
1618 * @param obj The layout object
1619 * @param part The TEXT part where to set the text
1620 * @param text The text to set
1623 * @deprecated use elm_object_part_text_set() instead.
1625 EINA_DEPRECATED EAPI void elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
1628 * Get the text set in the given part
1630 * @param obj The layout object
1631 * @param part The TEXT part to retrieve the text off
1633 * @return The text set in @p part
1636 * @deprecated use elm_object_part_text_get() instead.
1638 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
1641 * @def elm_layout_label_set
1642 * Convienience macro to set the label in a layout that follows the
1643 * Elementary naming convention for its parts.
1646 * @deprecated use elm_object_text_set() instead.
1648 #define elm_layout_label_set(_ly, _txt) \
1649 elm_layout_text_set((_ly), "elm.text", (_txt))
1652 * @def elm_layout_label_get
1653 * Convenience macro to get the label in a layout that follows the
1654 * Elementary naming convention for its parts.
1657 * @deprecated use elm_object_text_set() instead.
1659 #define elm_layout_label_get(_ly) \
1660 elm_layout_text_get((_ly), "elm.text")
1662 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_List_Item *item);
1666 * Set the content of the mapbuf.
1668 * @param obj The mapbuf object.
1669 * @param content The content that will be filled in this mapbuf object.
1671 * Once the content object is set, a previously set one will be deleted.
1672 * If you want to keep that old content object, use the
1673 * elm_mapbuf_content_unset() function.
1675 * To enable map, elm_mapbuf_enabled_set() should be used.
1677 * @deprecated use elm_object_content_set() instead
1681 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
1684 * Get the content of the mapbuf.
1686 * @param obj The mapbuf object.
1687 * @return The content that is being used.
1689 * Return the content object which is set for this widget.
1691 * @see elm_mapbuf_content_set() for details.
1693 * @deprecated use elm_object_content_get() instead
1697 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
1700 * Unset the content of the mapbuf.
1702 * @param obj The mapbuf object.
1703 * @return The content that was being used.
1705 * Unparent and return the content object which was set for this widget.
1707 * @see elm_mapbuf_content_set() for details.
1709 * @deprecated use elm_object_content_unset() instead
1713 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
1716 * @brief Set the label of a menu item
1718 * @param it The menu item object.
1719 * @param label The label to set for @p item
1721 * @warning Don't use this funcion on items created with
1722 * elm_menu_item_add_object() or elm_menu_item_separator_add().
1724 * @deprecated Use elm_object_item_text_set() instead
1726 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
1729 * @brief Get the label of a menu item
1731 * @param it The menu item object.
1732 * @return The label of @p item
1733 * @deprecated Use elm_object_item_text_get() instead
1735 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
1738 * @brief Set the content object of a menu item
1740 * @param it The menu item object
1741 * @param The content object or NULL
1742 * @return EINA_TRUE on success, else EINA_FALSE
1744 * Use this function to change the object swallowed by a menu item, deleting
1745 * any previously swallowed object.
1747 * @deprecated Use elm_object_item_content_set() instead
1749 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
1752 * @brief Get the content object of a menu item
1754 * @param it The menu item object
1755 * @return The content object or NULL
1756 * @note If @p item was added with elm_menu_item_add_object, this
1757 * function will return the object passed, else it will return the
1760 * @see elm_menu_item_object_content_set()
1762 * @deprecated Use elm_object_item_content_get() instead
1764 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
1767 * @brief Set the disabled state of @p item.
1769 * @param it The menu item object.
1770 * @param disabled The enabled/disabled state of the item
1771 * @deprecated Use elm_object_item_disabled_set() instead
1773 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1776 * @brief Get the disabled state of @p item.
1778 * @param it The menu item object.
1779 * @return The enabled/disabled state of the item
1781 * @see elm_menu_item_disabled_set()
1782 * @deprecated Use elm_object_item_disabled_get() instead
1784 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
1787 * @brief Returns the data associated with menu item @p item.
1789 * @param it The item
1790 * @return The data associated with @p item or NULL if none was set.
1792 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
1794 * @deprecated Use elm_object_item_data_get() instead
1796 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
1799 * @brief Set the function called when a menu item is deleted.
1801 * @param it The item to set the callback on
1802 * @param func The function called
1804 * @see elm_menu_item_add()
1805 * @see elm_menu_item_del()
1806 * @deprecated Use elm_object_item_del_cb_set() instead
1808 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1811 * @brief Sets the data to be associated with menu item @p item.
1813 * @param it The item
1814 * @param data The data to be associated with @p item
1816 * @deprecated Use elm_object_item_data_set() instead
1818 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
1821 * @brief Set the content of the notify widget
1823 * @param obj The notify object
1824 * @param content The content will be filled in this notify object
1826 * Once the content object is set, a previously set one will be deleted. If
1827 * you want to keep that old content object, use the
1828 * elm_notify_content_unset() function.
1830 * @deprecated use elm_object_content_set() instead
1833 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
1836 * @brief Unset the content of the notify widget
1838 * @param obj The notify object
1839 * @return The content that was being used
1841 * Unparent and return the content object which was set for this widget
1843 * @see elm_notify_content_set()
1844 * @deprecated use elm_object_content_unset() instead
1847 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
1850 * @brief Return the content of the notify widget
1852 * @param obj The notify object
1853 * @return The content that is being used
1855 * @see elm_notify_content_set()
1856 * @deprecated use elm_object_content_get() instead
1859 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
1862 * Set a label of an object
1864 * @param obj The Elementary object
1865 * @param part The text part name to set (NULL for the default label)
1866 * @param label The new text of the label
1868 * @note Elementary objects may have many labels (e.g. Action Slider)
1869 * @deprecated Use elm_object_part_text_set() instead.
1872 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
1875 * Get a label of an object
1877 * @param obj The Elementary object
1878 * @param part The text part name to get (NULL for the default label)
1879 * @return text of the label or NULL for any error
1881 * @note Elementary objects may have many labels (e.g. Action Slider)
1882 * @deprecated Use elm_object_part_text_get() instead.
1885 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
1888 * Set a content of an object
1890 * @param obj The Elementary object
1891 * @param part The content part name to set (NULL for the default content)
1892 * @param content The new content of the object
1894 * @note Elementary objects may have many contents
1895 * @deprecated Use elm_object_part_content_set instead.
1898 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
1901 * Get a content of an object
1903 * @param obj The Elementary object
1904 * @param part The content part name to get (NULL for the default content)
1905 * @return content of the object or NULL for any error
1907 * @note Elementary objects may have many contents
1908 * @deprecated Use elm_object_part_content_get instead.
1911 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
1914 * Unset a content of an object
1916 * @param obj The Elementary object
1917 * @param part The content part name to unset (NULL for the default content)
1919 * @note Elementary objects may have many contents
1920 * @deprecated Use elm_object_part_content_unset instead.
1923 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
1926 * Set a content of an object item
1928 * @param it The Elementary object item
1929 * @param part The content part name to set (NULL for the default content)
1930 * @param content The new content of the object item
1932 * @note Elementary object items may have many contents
1933 * @deprecated Use elm_object_item_part_content_set instead.
1936 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
1939 * Get a content of an object item
1941 * @param it The Elementary object item
1942 * @param part The content part name to unset (NULL for the default content)
1943 * @return content of the object item or NULL for any error
1945 * @note Elementary object items may have many contents
1946 * @deprecated Use elm_object_item_part_content_get instead.
1949 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
1952 * Unset a content of an object item
1954 * @param it The Elementary object item
1955 * @param part The content part name to unset (NULL for the default content)
1957 * @note Elementary object items may have many contents
1958 * @deprecated Use elm_object_item_part_content_unset instead.
1961 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
1964 * Get a label of an object item
1966 * @param it The Elementary object item
1967 * @param part The text part name to get (NULL for the default label)
1968 * @return text of the label or NULL for any error
1970 * @note Elementary object items may have many labels
1971 * @deprecated Use elm_object_item_part_text_get instead.
1974 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
1977 * Set a label of an object item
1979 * @param it The Elementary object item
1980 * @param part The text part name to set (NULL for the default label)
1981 * @param label The new text of the label
1983 * @note Elementary object items may have many labels
1984 * @deprecated Use elm_object_item_part_text_set instead.
1987 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
1990 * @brief Set the content of the panel.
1992 * @param obj The panel object
1993 * @param content The panel content
1995 * Once the content object is set, a previously set one will be deleted.
1996 * If you want to keep that old content object, use the
1997 * elm_panel_content_unset() function.
1999 * @deprecated use elm_object_content_set() instead
2002 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2005 * @brief Get the content of the panel.
2007 * @param obj The panel object
2008 * @return The content that is being used
2010 * Return the content object which is set for this widget.
2012 * @see elm_panel_content_set()
2014 * @deprecated use elm_object_content_get() instead
2017 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2020 * @brief Unset the content of the panel.
2022 * @param obj The panel object
2023 * @return The content that was being used
2025 * Unparent and return the content object which was set for this widget.
2027 * @see elm_panel_content_set()
2029 * @deprecated use elm_object_content_unset() instead
2032 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2035 * Set the left content of the panes widget.
2037 * @param obj The panes object.
2038 * @param content The new left content object.
2040 * Once the content object is set, a previously set one will be deleted.
2041 * If you want to keep that old content object, use the
2042 * elm_panes_content_left_unset() function.
2044 * If panes is displayed vertically, left content will be displayed at
2047 * @see elm_panes_content_left_get()
2048 * @see elm_panes_content_right_set() to set content on the other side.
2050 * @deprecated use elm_object_part_content_set() instead
2054 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2057 * Set the right content of the panes widget.
2059 * @param obj The panes object.
2060 * @param content The new right content object.
2062 * Once the content object is set, a previously set one will be deleted.
2063 * If you want to keep that old content object, use the
2064 * elm_panes_content_right_unset() function.
2066 * If panes is displayed vertically, left content will be displayed at
2069 * @see elm_panes_content_right_get()
2070 * @see elm_panes_content_left_set() to set content on the other side.
2072 * @deprecated use elm_object_part_content_set() instead
2076 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2079 * Get the left content of the panes.
2081 * @param obj The panes object.
2082 * @return The left content object that is being used.
2084 * Return the left content object which is set for this widget.
2086 * @see elm_panes_content_left_set() for details.
2088 * @deprecated use elm_object_part_content_get() instead
2092 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2095 * Get the right content of the panes.
2097 * @param obj The panes object
2098 * @return The right content object that is being used
2100 * Return the right content object which is set for this widget.
2102 * @see elm_panes_content_right_set() for details.
2104 * @deprecated use elm_object_part_content_get() instead
2108 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2111 * Unset the left content used for the panes.
2113 * @param obj The panes object.
2114 * @return The left content object that was being used.
2116 * Unparent and return the left content object which was set for this widget.
2118 * @see elm_panes_content_left_set() for details.
2119 * @see elm_panes_content_left_get().
2121 * @deprecated use elm_object_part_content_unset() instead
2125 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2128 * Unset the right content used for the panes.
2130 * @param obj The panes object.
2131 * @return The right content object that was being used.
2133 * Unparent and return the right content object which was set for this
2136 * @see elm_panes_content_right_set() for details.
2137 * @see elm_panes_content_right_get().
2139 * @deprecated use elm_object_part_content_unset() instead
2143 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2145 * Set the label of a given progress bar widget
2147 * @param obj The progress bar object
2148 * @param label The text label string, in UTF-8
2150 * @ingroup Progressbar
2151 * @deprecated use elm_object_text_set() instead.
2153 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2156 * Get the label of a given progress bar widget
2158 * @param obj The progressbar object
2159 * @return The text label string, in UTF-8
2161 * @ingroup Progressbar
2162 * @deprecated use elm_object_text_set() instead.
2164 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2167 * Set the icon object of a given progress bar widget
2169 * @param obj The progress bar object
2170 * @param icon The icon object
2172 * Use this call to decorate @p obj with an icon next to it.
2174 * @note Once the icon object is set, a previously set one will be
2175 * deleted. If you want to keep that old content object, use the
2176 * elm_progressbar_icon_unset() function.
2178 * @see elm_progressbar_icon_get()
2179 * @deprecated use elm_object_part_content_set() instead.
2181 * @ingroup Progressbar
2183 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2186 * Retrieve the icon object set for a given progress bar widget
2188 * @param obj The progress bar object
2189 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2190 * otherwise (and on errors)
2192 * @see elm_progressbar_icon_set() for more details
2193 * @deprecated use elm_object_part_content_get() instead.
2195 * @ingroup Progressbar
2197 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2200 * Unset an icon set on a given progress bar widget
2202 * @param obj The progress bar object
2203 * @return The icon object that was being used, if any was set, or
2204 * @c NULL, otherwise (and on errors)
2206 * This call will unparent and return the icon object which was set
2207 * for this widget, previously, on success.
2209 * @see elm_progressbar_icon_set() for more details
2210 * @deprecated use elm_object_part_content_unset() instead.
2212 * @ingroup Progressbar
2214 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2217 * @brief Set the text label of the radio object
2219 * @param obj The radio object
2220 * @param label The text label string in UTF-8
2222 * @deprecated use elm_object_text_set() instead.
2224 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
2227 * @brief Get the text label of the radio object
2229 * @param obj The radio object
2230 * @return The text label string in UTF-8
2232 * @deprecated use elm_object_text_set() instead.
2234 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
2237 * @brief Set the icon object of the radio object
2239 * @param obj The radio object
2240 * @param icon The icon object
2242 * Once the icon object is set, a previously set one will be deleted. If you
2243 * want to keep that old content object, use the elm_radio_icon_unset()
2246 * @deprecated use elm_object_part_content_set() instead.
2249 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2252 * @brief Get the icon object of the radio object
2254 * @param obj The radio object
2255 * @return The icon object
2257 * @see elm_radio_icon_set()
2259 * @deprecated use elm_object_part_content_get() instead.
2262 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2265 * @brief Unset the icon used for the radio object
2267 * @param obj The radio object
2268 * @return The icon object that was being used
2270 * Unparent and return the icon object which was set for this widget.
2272 * @see elm_radio_icon_set()
2273 * @deprecated use elm_object_part_content_unset() instead.
2276 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2279 * @brief Set the content of the scroller widget (the object to be scrolled around).
2281 * @param obj The scroller object
2282 * @param content The new content object
2284 * Once the content object is set, a previously set one will be deleted.
2285 * If you want to keep that old content object, use the
2286 * elm_scroller_content_unset() function.
2287 * @deprecated use elm_object_content_set() instead
2289 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2292 * @brief Get the content of the scroller widget
2294 * @param obj The slider object
2295 * @return The content that is being used
2297 * Return the content object which is set for this widget
2299 * @see elm_scroller_content_set()
2300 * @deprecated use elm_object_content_get() instead.
2302 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2305 * @brief Unset the content of the scroller widget
2307 * @param obj The slider object
2308 * @return The content that was being used
2310 * Unparent and return the content object which was set for this widget
2312 * @see elm_scroller_content_set()
2313 * @deprecated use elm_object_content_unset() instead.
2315 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2318 * Set the label of a given slider widget
2320 * @param obj The progress bar object
2321 * @param label The text label string, in UTF-8
2324 * @deprecated use elm_object_text_set() instead.
2326 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
2329 * Get the label of a given slider widget
2331 * @param obj The progressbar object
2332 * @return The text label string, in UTF-8
2335 * @deprecated use elm_object_text_get() instead.
2337 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
2340 * Set the icon object of the slider object.
2342 * @param obj The slider object.
2343 * @param icon The icon object.
2345 * On horizontal mode, icon is placed at left, and on vertical mode,
2348 * @note Once the icon object is set, a previously set one will be deleted.
2349 * If you want to keep that old content object, use the
2350 * elm_slider_icon_unset() function.
2352 * @warning If the object being set does not have minimum size hints set,
2353 * it won't get properly displayed.
2356 * @deprecated use elm_object_part_content_set() instead.
2358 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2361 * Unset an icon set on a given slider widget.
2363 * @param obj The slider object.
2364 * @return The icon object that was being used, if any was set, or
2365 * @c NULL, otherwise (and on errors).
2367 * On horizontal mode, icon is placed at left, and on vertical mode,
2370 * This call will unparent and return the icon object which was set
2371 * for this widget, previously, on success.
2373 * @see elm_slider_icon_set() for more details
2374 * @see elm_slider_icon_get()
2375 * @deprecated use elm_object_part_content_unset() instead.
2379 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2382 * Retrieve the icon object set for a given slider widget.
2384 * @param obj The slider object.
2385 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2386 * otherwise (and on errors).
2388 * On horizontal mode, icon is placed at left, and on vertical mode,
2391 * @see elm_slider_icon_set() for more details
2392 * @see elm_slider_icon_unset()
2394 * @deprecated use elm_object_part_content_get() instead.
2398 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2401 * Set the end object of the slider object.
2403 * @param obj The slider object.
2404 * @param end The end object.
2406 * On horizontal mode, end is placed at left, and on vertical mode,
2409 * @note Once the icon object is set, a previously set one will be deleted.
2410 * If you want to keep that old content object, use the
2411 * elm_slider_end_unset() function.
2413 * @warning If the object being set does not have minimum size hints set,
2414 * it won't get properly displayed.
2416 * @deprecated use elm_object_part_content_set() instead.
2420 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2423 * Unset an end object set on a given slider widget.
2425 * @param obj The slider object.
2426 * @return The end object that was being used, if any was set, or
2427 * @c NULL, otherwise (and on errors).
2429 * On horizontal mode, end is placed at left, and on vertical mode,
2432 * This call will unparent and return the icon object which was set
2433 * for this widget, previously, on success.
2435 * @see elm_slider_end_set() for more details.
2436 * @see elm_slider_end_get()
2438 * @deprecated use elm_object_part_content_unset() instead
2443 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2446 * Retrieve the end object set for a given slider widget.
2448 * @param obj The slider object.
2449 * @return The end object's handle, if @p obj had one set, or @c NULL,
2450 * otherwise (and on errors).
2452 * On horizontal mode, icon is placed at right, and on vertical mode,
2455 * @see elm_slider_end_set() for more details.
2456 * @see elm_slider_end_unset()
2459 * @deprecated use elm_object_part_content_get() instead
2464 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2467 * Return the data associated with a given slideshow item
2469 * @param it The slideshow item
2470 * @return Returns the data associated to this item
2472 * @deprecated use elm_object_item_data_get() instead
2473 * @ingroup Slideshow
2475 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2478 * Get the toolbar object from an item.
2480 * @param it The item.
2481 * @return The toolbar object.
2483 * This returns the toolbar object itself that an item belongs to.
2485 * @deprecated use elm_object_item_object_get() instead.
2488 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2491 * Get the label of item.
2493 * @param it The item of toolbar.
2494 * @return The label of item.
2496 * The return value is a pointer to the label associated to @p item when
2497 * it was created, with function elm_toolbar_item_append() or similar,
2499 * with function elm_toolbar_item_label_set. If no label
2500 * was passed as argument, it will return @c NULL.
2502 * @see elm_toolbar_item_label_set() for more details.
2503 * @see elm_toolbar_item_append()
2505 * @deprecated use elm_object_item_text_get() instead.
2508 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
2511 * Set the label of item.
2513 * @param it The item of toolbar.
2514 * @param text The label of item.
2516 * The label to be displayed by the item.
2517 * Label will be placed at icons bottom (if set).
2519 * If a label was passed as argument on item creation, with function
2520 * elm_toolbar_item_append() or similar, it will be already
2521 * displayed by the item.
2523 * @see elm_toolbar_item_label_get()
2524 * @see elm_toolbar_item_append()
2526 * @deprecated use elm_object_item_text_set() instead
2529 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
2532 * Return the data associated with a given toolbar widget item.
2534 * @param it The toolbar widget item handle.
2535 * @return The data associated with @p item.
2537 * @see elm_toolbar_item_data_set()
2539 * @deprecated use elm_object_item_data_get() instead.
2542 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
2545 * Set the data associated with a given toolbar widget item.
2547 * @param it The toolbar widget item handle
2548 * @param data The new data pointer to set to @p item.
2550 * This sets new item data on @p item.
2552 * @warning The old data pointer won't be touched by this function, so
2553 * the user had better to free that old data himself/herself.
2555 * @deprecated use elm_object_item_data_set() instead.
2558 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
2561 * Get a value whether toolbar item is disabled or not.
2563 * @param it The item.
2564 * @return The disabled state.
2566 * @see elm_toolbar_item_disabled_set() for more details.
2568 * @deprecated use elm_object_item_disabled_get() instead.
2571 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
2574 * Sets the disabled/enabled state of a toolbar item.
2576 * @param it The item.
2577 * @param disabled The disabled state.
2579 * A disabled item cannot be selected or unselected. It will also
2580 * change its appearance (generally greyed out). This sets the
2581 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
2584 * @deprecated use elm_object_item_disabled_set() instead.
2587 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2590 * Change a toolbar's orientation
2591 * @param obj The toolbar object
2592 * @param vertical If @c EINA_TRUE, the toolbar is vertical
2593 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
2595 * @deprecated use elm_toolbar_horizontal_set() instead.
2597 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
2600 * Get a toolbar's orientation
2601 * @param obj The toolbar object
2602 * @return If @c EINA_TRUE, the toolbar is vertical
2603 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
2605 * @deprecated use elm_toolbar_horizontal_get() instead.
2607 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
2610 * Set the function called when a toolbar item is freed.
2612 * @param it The item to set the callback on.
2613 * @param func The function called.
2615 * If there is a @p func, then it will be called prior item's memory release.
2616 * That will be called with the following arguments:
2618 * @li item's Evas object;
2621 * This way, a data associated to a toolbar item could be properly freed.
2623 * @deprecated Use elm_object_item_del_cb_set() instead
2626 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2629 * @brief Link a Elm_Payer with an Elm_Video object.
2631 * @param player the Elm_Player object.
2632 * @param video The Elm_Video object.
2634 * This mean that action on the player widget will affect the
2635 * video object and the state of the video will be reflected in
2636 * the player itself.
2638 * @see elm_player_add()
2639 * @see elm_video_add()
2640 * @deprecated use elm_object_part_content_set() instead
2644 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
2647 * Set the label of item.
2649 * @param it The item of segment control.
2650 * @param text The label of item.
2652 * The label to be displayed by the item.
2653 * Label will be at right of the icon (if set).
2655 * If a label was passed as argument on item creation, with function
2656 * elm_control_segment_item_add(), it will be already
2657 * displayed by the item.
2659 * @see elm_segment_control_item_label_get()
2660 * @see elm_segment_control_item_add()
2661 * @deprecated Use elm_object_item_text_set() instead
2663 * @ingroup SegmentControl
2665 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
2669 * Set the icon associated to the item.
2671 * @param it The segment control item.
2672 * @param icon The icon object to associate with @p it.
2674 * The icon object to use at left side of the item. An
2675 * icon can be any Evas object, but usually it is an icon created
2676 * with elm_icon_add().
2678 * Once the icon object is set, a previously set one will be deleted.
2679 * @warning Setting the same icon for two items will cause the icon to
2680 * dissapear from the first item.
2682 * If an icon was passed as argument on item creation, with function
2683 * elm_segment_control_item_add(), it will be already
2684 * associated to the item.
2686 * @see elm_segment_control_item_add()
2687 * @see elm_segment_control_item_icon_get()
2688 * @deprecated Use elm_object_item_part_content_set() instead
2690 * @ingroup SegmentControl
2692 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
2697 * @param obj The multibuttonentry object
2698 * @return The label, or NULL if none
2700 * @deprecated Use elm_object_text_get() instead
2703 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
2708 * @param obj The multibuttonentry object
2709 * @param label The text label string
2711 * @deprecated Use elm_object_text_set() instead
2714 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
2717 * Get the label of a given item
2719 * @param it The item
2720 * @return The label of a given item, or NULL if none
2722 * @deprecated Use elm_object_item_text_get() instead
2725 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
2728 * Set the label of a given item
2730 * @param it The item
2731 * @param str The text label string
2733 * @deprecated Use elm_object_item_text_set() instead
2735 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
2738 * Sets the disabled/enabled state of a list item.
2740 * @param it The item.
2741 * @param disabled The disabled state.
2743 * A disabled item cannot be selected or unselected. It will also
2744 * change its appearance (generally greyed out). This sets the
2745 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
2748 * @deprecated Use elm_object_item_disabled_set() instead
2752 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_List_Item *it, Eina_Bool disabled);
2755 * Get a value whether list item is disabled or not.
2757 * @param it The item.
2758 * @return The disabled state.
2760 * @see elm_list_item_disabled_set() for more details.
2762 * @deprecated Use elm_object_item_disabled_get() instead
2766 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_List_Item *it);
2769 * Set the function called when a list item is freed.
2771 * @param item The item to set the callback on
2772 * @param func The function called
2774 * If there is a @p func, then it will be called prior item's memory release.
2775 * That will be called with the following arguments:
2777 * @li item's Evas object;
2780 * This way, a data associated to a list item could be properly freed.
2782 * @deprecated Please use elm_object_item_del_cb_set() instead.
2786 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_List_Item *item, Evas_Smart_Cb func);
2789 * Get the data associated to the item.
2791 * @param item The list item
2792 * @return The data associated to @p item
2794 * The return value is a pointer to data associated to @p item when it was
2795 * created, with function elm_list_item_append() or similar. If no data
2796 * was passed as argument, it will return @c NULL.
2798 * @see elm_list_item_append()
2800 * @deprecated Please use elm_object_item_data_get() instead.
2804 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_List_Item *item);
2807 * Get the left side icon associated to the item.
2809 * @param item The list item
2810 * @return The left side icon associated to @p item
2812 * The return value is a pointer to the icon associated to @p item when
2814 * created, with function elm_list_item_append() or similar, or later
2815 * with function elm_list_item_icon_set(). If no icon
2816 * was passed as argument, it will return @c NULL.
2818 * @see elm_list_item_append()
2819 * @see elm_list_item_icon_set()
2821 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
2824 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_List_Item *item);
2827 * Set the left side icon associated to the item.
2829 * @param item The list item
2830 * @param icon The left side icon object to associate with @p item
2832 * The icon object to use at left side of the item. An
2833 * icon can be any Evas object, but usually it is an icon created
2834 * with elm_icon_add().
2836 * Once the icon object is set, a previously set one will be deleted.
2837 * @warning Setting the same icon for two items will cause the icon to
2838 * dissapear from the first item.
2840 * If an icon was passed as argument on item creation, with function
2841 * elm_list_item_append() or similar, it will be already
2842 * associated to the item.
2844 * @see elm_list_item_append()
2845 * @see elm_list_item_icon_get()
2847 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
2850 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_List_Item *item, Evas_Object *icon);
2853 * Get the right side icon associated to the item.
2855 * @param item The list item
2856 * @return The right side icon associated to @p item
2858 * The return value is a pointer to the icon associated to @p item when
2860 * created, with function elm_list_item_append() or similar, or later
2861 * with function elm_list_item_icon_set(). If no icon
2862 * was passed as argument, it will return @c NULL.
2864 * @see elm_list_item_append()
2865 * @see elm_list_item_icon_set()
2867 * @deprecated Please use elm_object_item_part_content_get(item, "end");
2870 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_List_Item *item);
2873 * Set the right side icon associated to the item.
2875 * @param item The list item
2876 * @param end The right side icon object to associate with @p item
2878 * The icon object to use at right side of the item. An
2879 * icon can be any Evas object, but usually it is an icon created
2880 * with elm_icon_add().
2882 * Once the icon object is set, a previously set one will be deleted.
2883 * @warning Setting the same icon for two items will cause the icon to
2884 * dissapear from the first item.
2886 * If an icon was passed as argument on item creation, with function
2887 * elm_list_item_append() or similar, it will be already
2888 * associated to the item.
2890 * @see elm_list_item_append()
2891 * @see elm_list_item_end_get()
2893 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
2896 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_List_Item *item, Evas_Object *end);
2899 * Get the label of item.
2901 * @param item The item of list.
2902 * @return The label of item.
2904 * The return value is a pointer to the label associated to @p item when
2905 * it was created, with function elm_list_item_append(), or later
2906 * with function elm_list_item_label_set. If no label
2907 * was passed as argument, it will return @c NULL.
2909 * @see elm_list_item_label_set() for more details.
2910 * @see elm_list_item_append()
2912 * @deprecated Please use elm_object_item_text_get(item);
2915 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_List_Item *item);
2918 * Set the label of item.
2920 * @param item The item of list.
2921 * @param text The label of item.
2923 * The label to be displayed by the item.
2924 * Label will be placed between left and right side icons (if set).
2926 * If a label was passed as argument on item creation, with function
2927 * elm_list_item_append() or similar, it will be already
2928 * displayed by the item.
2930 * @see elm_list_item_label_get()
2931 * @see elm_list_item_append()
2933 * @deprecated Please use elm_object_item_text_set(item, text);
2936 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_List_Item *item, const char *text);
2939 * Set the shrink state of toolbar @p obj.
2941 * @param obj The toolbar object.
2942 * @param shrink_mode Toolbar's items display behavior.
2944 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
2945 * but will enforce a minimun size so all the items will fit, won't scroll
2946 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
2947 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
2948 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
2950 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
2953 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
2956 * Get the shrink mode of toolbar @p obj.
2958 * @param obj The toolbar object.
2959 * @return Toolbar's items display behavior.
2961 * @see elm_toolbar_shrink_mode_set() for details.
2963 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
2966 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);