2 * @image html img/widget/toggle/preview-00.png
3 * @image latex img/widget/toggle/preview-00.eps
5 * @brief A toggle is a slider which can be used to toggle between
6 * two values. It has two states: on and off.
8 * This widget is deprecated. Please use elm_check_add() instead using the
12 * obj = elm_check_add(parent);
13 * elm_object_style_set(obj, "toggle");
14 * elm_object_part_text_set(obj, "on", "ON");
15 * elm_object_part_text_set(obj, "off", "OFF");
18 * Signals that you can add callbacks for are:
19 * @li "changed" - Whenever the toggle value has been changed. Is not called
20 * until the toggle is released by the cursor (assuming it
21 * has been triggered by the cursor in the first place).
23 * Default content parts of the toggle widget that you can use for are:
24 * @li "icon" - An icon of the toggle
26 * Default text parts of the toggle widget that you can use for are:
27 * @li "elm.text" - Label of the toggle
29 * @ref tutorial_toggle show how to use a toggle.
34 * @brief Add a toggle to @p parent.
36 * @param parent The parent object
38 * @return The toggle object
40 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
43 * @brief Sets the label to be displayed with the toggle.
45 * @param obj The toggle object
46 * @param label The label to be displayed
48 * @deprecated use elm_object_text_set() instead.
50 EINA_DEPRECATED EAPI void elm_toggle_label_set(Evas_Object *obj, const char *label);
53 * @brief Gets the label of the toggle
55 * @param obj toggle object
56 * @return The label of the toggle
58 * @deprecated use elm_object_text_get() instead.
60 EINA_DEPRECATED EAPI const char *elm_toggle_label_get(const Evas_Object *obj);
63 * @brief Set the icon used for the toggle
65 * @param obj The toggle object
66 * @param icon The icon object for the button
68 * Once the icon object is set, a previously set one will be deleted
69 * If you want to keep that old content object, use the
70 * elm_toggle_icon_unset() function.
72 * @deprecated use elm_object_part_content_set() instead.
74 EINA_DEPRECATED EAPI void elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
77 * @brief Get the icon used for the toggle
79 * @param obj The toggle object
80 * @return The icon object that is being used
82 * Return the icon object which is set for this widget.
84 * @deprecated use elm_object_part_content_get() instead.
86 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
89 * @brief Unset the icon used for the toggle
91 * @param obj The toggle object
92 * @return The icon object that was being used
94 * Unparent and return the icon object which was set for this widget.
96 * @deprecated use elm_object_part_content_unset() instead.
98 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
101 * @brief Sets the labels to be associated with the on and off states of the toggle.
103 * @param obj The toggle object
104 * @param onlabel The label displayed when the toggle is in the "on" state
105 * @param offlabel The label displayed when the toggle is in the "off" state
107 * @deprecated use elm_object_part_text_set() for "on" and "off" parts
110 EINA_DEPRECATED EAPI void elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
113 * @brief Gets the labels associated with the on and off states of the
116 * @param obj The toggle object
117 * @param onlabel A char** to place the onlabel of @p obj into
118 * @param offlabel A char** to place the offlabel of @p obj into
120 * @deprecated use elm_object_part_text_get() for "on" and "off" parts
123 EINA_DEPRECATED EAPI void elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
126 * @brief Sets the state of the toggle to @p state.
128 * @param obj The toggle object
129 * @param state The state of @p obj
131 * @deprecated use elm_check_state_set() instead.
133 EINA_DEPRECATED EAPI void elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
136 * @brief Gets the state of the toggle to @p state.
138 * @param obj The toggle object
139 * @return The state of @p obj
141 * @deprecated use elm_check_state_get() instead.
143 EINA_DEPRECATED EAPI Eina_Bool elm_toggle_state_get(const Evas_Object *obj);
146 * @brief Sets the state pointer of the toggle to @p statep.
148 * @param obj The toggle object
149 * @param statep The state pointer of @p obj
151 * @deprecated use elm_check_state_pointer_set() instead.
153 EINA_DEPRECATED EAPI void elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
159 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
160 EINA_DEPRECATED EAPI void elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
161 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_single_line_get(const Evas_Object *obj);
162 EINA_DEPRECATED EAPI void elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
163 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_password_get(const Evas_Object *obj);
164 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
165 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_entry_get(const Evas_Object *obj);
166 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
167 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_is_empty(const Evas_Object *obj);
168 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_selection_get(const Evas_Object *obj);
169 EINA_DEPRECATED EAPI void elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
170 EINA_DEPRECATED EAPI void elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
171 EINA_DEPRECATED EAPI void elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
172 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_editable_get(const Evas_Object *obj);
173 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_none(Evas_Object *obj);
174 EINA_DEPRECATED EAPI void elm_scrolled_entry_select_all(Evas_Object *obj);
175 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_next(Evas_Object *obj);
176 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_prev(Evas_Object *obj);
177 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_up(Evas_Object *obj);
178 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_down(Evas_Object *obj);
179 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
180 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
181 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
182 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
183 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
184 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
185 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
186 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
187 EINA_DEPRECATED EAPI const char *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
188 EINA_DEPRECATED EAPI void elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
189 EINA_DEPRECATED EAPI int elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
190 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_cut(Evas_Object *obj);
191 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_copy(Evas_Object *obj);
192 EINA_DEPRECATED EAPI void elm_scrolled_entry_selection_paste(Evas_Object *obj);
193 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
194 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);
195 EINA_DEPRECATED EAPI void elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
196 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
197 EINA_DEPRECATED EAPI void elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
198 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
199 EINA_DEPRECATED EAPI void elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
200 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
201 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
202 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
203 EINA_DEPRECATED EAPI void elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
204 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
205 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
206 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
207 EINA_DEPRECATED EAPI void elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
208 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);
209 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);
210 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);
211 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
212 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
213 EINA_DEPRECATED EAPI void elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
214 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
215 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
216 EINA_DEPRECATED EAPI void elm_scrolled_entry_file_save(Evas_Object *obj);
217 EINA_DEPRECATED EAPI void elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
218 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_autosave_get(const Evas_Object *obj);
219 EINA_DEPRECATED EAPI void elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
220 EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
223 * @brief Sets the content of the hover object and the direction in which it
226 * @param obj The hover object
227 * @param swallow The direction that the object will be displayed
228 * at. Accepted values are "left", "top-left", "top", "top-right",
229 * "right", "bottom-right", "bottom", "bottom-left", "middle" and
231 * @param content The content to place at @p swallow
233 * Once the content object is set for a given direction, a previously
234 * set one (on the same direction) will be deleted. If you want to
235 * keep that old content object, use the elm_object_part_content_unset()
238 * All directions may have contents at the same time, except for
239 * "smart". This is a special placement hint and its use case
240 * depends of the calculations coming from
241 * elm_hover_best_content_location_get(). Its use is for cases when
242 * one desires only one hover content, but with a dynamic special
243 * placement within the hover area. The content's geometry, whenever
244 * it changes, will be used to decide on a best location, not
245 * extrapolating the hover's parent object view to show it in (still
246 * being the hover's target determinant of its medium part -- move and
247 * resize it to simulate finger sizes, for example). If one of the
248 * directions other than "smart" are used, a previously content set
249 * using it will be deleted, and vice-versa.
251 * @deprecated Use elm_object_part_content_set() instead
253 EINA_DEPRECATED EAPI void elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
256 * @brief Get the content of the hover object, in a given direction.
258 * Return the content object which was set for this widget in the
259 * @p swallow direction.
261 * @param obj The hover object
262 * @param swallow The direction that the object was display at.
263 * @return The content that was being used
265 * @deprecated Use elm_object_part_content_get() instead
266 * @see elm_object_part_content_set()
268 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
271 * @brief Unset the content of the hover object, in a given direction.
273 * Unparent and return the content object set at @p swallow direction.
275 * @param obj The hover object
276 * @param swallow The direction that the object was display at.
277 * @return The content that was being used.
279 * @deprecated Use elm_object_part_content_unset() instead
280 * @see elm_object_part_content_set()
282 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
285 * @brief Set the hoversel button label
287 * @param obj The hoversel object
288 * @param label The label text.
290 * This sets the label of the button that is always visible (before it is
291 * clicked and expanded).
293 * @deprecated elm_object_text_set()
295 EINA_DEPRECATED EAPI void elm_hoversel_label_set(Evas_Object *obj, const char *label);
298 * @brief Get the hoversel button label
300 * @param obj The hoversel object
301 * @return The label text.
303 * @deprecated elm_object_text_get()
305 EINA_DEPRECATED EAPI const char *elm_hoversel_label_get(const Evas_Object *obj);
308 * @brief Set the icon of the hoversel button
310 * @param obj The hoversel object
311 * @param icon The icon object
313 * Sets the icon of the button that is always visible (before it is clicked
314 * and expanded). Once the icon object is set, a previously set one will be
315 * deleted, if you want to keep that old content object, use the
316 * elm_hoversel_icon_unset() function.
318 * @see elm_object_content_set() for the button widget
319 * @deprecated Use elm_object_item_part_content_set() instead
321 EINA_DEPRECATED EAPI void elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
324 * @brief Get the icon of the hoversel button
326 * @param obj The hoversel object
327 * @return The icon object
329 * Get the icon of the button that is always visible (before it is clicked
330 * and expanded). Also see elm_object_content_get() for the button widget.
332 * @see elm_hoversel_icon_set()
333 * @deprecated Use elm_object_item_part_content_get() instead
335 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
338 * @brief Get and unparent the icon of the hoversel button
340 * @param obj The hoversel object
341 * @return The icon object that was being used
343 * Unparent and return the icon of the button that is always visible
344 * (before it is clicked and expanded).
346 * @see elm_hoversel_icon_set()
347 * @see elm_object_content_unset() for the button widget
348 * @deprecated Use elm_object_item_part_content_unset() instead
350 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
353 * @brief This returns the data pointer supplied with elm_hoversel_item_add()
354 * that will be passed to associated function callbacks.
356 * @param it The item to get the data from
357 * @return The data pointer set with elm_hoversel_item_add()
359 * @see elm_hoversel_item_add()
360 * @deprecated Use elm_object_item_data_get() instead
362 EINA_DEPRECATED EAPI void *elm_hoversel_item_data_get(const Elm_Object_Item *it);
365 * @brief This returns the label text of the given hoversel item.
367 * @param it The item to get the label
368 * @return The label text of the hoversel item
370 * @see elm_hoversel_item_add()
371 * @deprecated Use elm_object_item_text_get() instead
373 EINA_DEPRECATED EAPI const char *elm_hoversel_item_label_get(const Elm_Object_Item *it);
376 * @brief Set the function to be called when an item from the hoversel is
379 * @param it The item to set the callback on
380 * @param func The function called
382 * That function will receive these parameters:
383 * @li void * item data
384 * @li Evas_Object * hoversel object
385 * @li Elm_Object_Item * hoversel item
387 * @see elm_hoversel_item_add()
388 * @deprecated Use elm_object_item_del_cb_set() instead
390 EINA_DEPRECATED EAPI void elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
393 * @brief Delete an item from the hoversel
395 * @param it The item to delete
397 * This deletes the item from the hoversel (should not be called while the
398 * hoversel is active; use elm_hoversel_expanded_get() to check first).
400 * @deprecated Use elm_object_item_del() instead
401 * @see elm_hoversel_item_add()
403 EINA_DEPRECATED EAPI void elm_hoversel_item_del(Elm_Object_Item *it);
406 * Set actionslider labels.
408 * @param obj The actionslider object
409 * @param left_label The label to be set on the left.
410 * @param center_label The label to be set on the center.
411 * @param right_label The label to be set on the right.
412 * @deprecated use elm_object_text_set() instead.
414 EINA_DEPRECATED EAPI void elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
417 * Get actionslider labels.
419 * @param obj The actionslider object
420 * @param left_label A char** to place the left_label of @p obj into.
421 * @param center_label A char** to place the center_label of @p obj into.
422 * @param right_label A char** to place the right_label of @p obj into.
423 * @deprecated use elm_object_text_set() instead.
425 EINA_DEPRECATED EAPI void elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
428 * Set the label used on the indicator.
430 * @param obj The actionslider object
431 * @param label The label to be set on the indicator.
432 * @deprecated use elm_object_text_set() instead.
434 EINA_DEPRECATED EAPI void elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
437 * Get the label used on the indicator object.
439 * @param obj The actionslider object
440 * @return The indicator label
441 * @deprecated use elm_object_text_get() instead.
443 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
446 * Set the overlay object used for the background object.
448 * @param obj The bg object
449 * @param overlay The overlay object
451 * This provides a way for elm_bg to have an 'overlay' that will be on top
452 * of the bg. Once the over object is set, a previously set one will be
453 * deleted, even if you set the new one to NULL. If you want to keep that
454 * old content object, use the elm_bg_overlay_unset() function.
456 * @deprecated use elm_object_part_content_set() instead
460 EINA_DEPRECATED EAPI void elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
463 * Get the overlay object used for the background object.
465 * @param obj The bg object
466 * @return The content that is being used
468 * Return the content object which is set for this widget
470 * @deprecated use elm_object_part_content_get() instead
473 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
476 * Get the overlay object used for the background object.
478 * @param obj The bg object
479 * @return The content that was being used
481 * Unparent and return the overlay object which was set for this widget
483 * @deprecated use elm_object_part_content_unset() instead
486 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
490 * Set the label of the bubble
492 * @param obj The bubble object
493 * @param label The string to set in the label
495 * This function sets the title of the bubble. Where this appears depends on
496 * the selected corner.
497 * @deprecated use elm_object_text_set() instead.
499 EINA_DEPRECATED EAPI void elm_bubble_label_set(Evas_Object *obj, const char *label);
502 * Get the label of the bubble
504 * @param obj The bubble object
505 * @return The string of set in the label
507 * This function gets the title of the bubble.
508 * @deprecated use elm_object_text_get() instead.
510 EINA_DEPRECATED EAPI const char *elm_bubble_label_get(const Evas_Object *obj);
513 * Set the info of the bubble
515 * @param obj The bubble object
516 * @param info The given info about the bubble
518 * This function sets the info of the bubble. Where this appears depends on
519 * the selected corner.
520 * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
522 EINA_DEPRECATED EAPI void elm_bubble_info_set(Evas_Object *obj, const char *info);
525 * Get the info of the bubble
527 * @param obj The bubble object
529 * @return The "info" string of the bubble
531 * This function gets the info text.
532 * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
534 EINA_DEPRECATED EAPI const char *elm_bubble_info_get(const Evas_Object *obj);
537 * Set the content to be shown in the bubble
539 * Once the content object is set, a previously set one will be deleted.
540 * If you want to keep the old content object, use the
541 * elm_bubble_content_unset() function.
543 * @param obj The bubble object
544 * @param content The given content of the bubble
546 * This function sets the content shown on the middle of the bubble.
548 * @deprecated use elm_object_content_set() instead
551 EINA_DEPRECATED EAPI void elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
554 * Get the content shown in the bubble
556 * Return the content object which is set for this widget.
558 * @param obj The bubble object
559 * @return The content that is being used
561 * @deprecated use elm_object_content_get() instead
564 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
567 * Unset the content shown in the bubble
569 * Unparent and return the content object which was set for this widget.
571 * @param obj The bubble object
572 * @return The content that was being used
574 * @deprecated use elm_object_content_unset() instead
577 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
580 * Set the icon of the bubble
582 * Once the icon object is set, a previously set one will be deleted.
583 * If you want to keep the old content object, use the
584 * elm_icon_content_unset() function.
586 * @param obj The bubble object
587 * @param icon The given icon for the bubble
589 * @deprecated use elm_object_part_content_set() instead
592 EINA_DEPRECATED EAPI void elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
595 * Get the icon of the bubble
597 * @param obj The bubble object
598 * @return The icon for the bubble
600 * This function gets the icon shown on the top left of bubble.
602 * @deprecated use elm_object_part_content_get() instead
605 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
608 * Unset the icon of the bubble
610 * Unparent and return the icon object which was set for this widget.
612 * @param obj The bubble object
613 * @return The icon that was being used
615 * @deprecated use elm_object_part_content_unset() instead
618 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
622 * Set the label used in the button
624 * The passed @p label can be NULL to clean any existing text in it and
625 * leave the button as an icon only object.
627 * @param obj The button object
628 * @param label The text will be written on the button
629 * @deprecated use elm_object_text_set() instead.
631 EINA_DEPRECATED EAPI void elm_button_label_set(Evas_Object *obj, const char *label);
634 * Get the label set for the button
636 * The string returned is an internal pointer and should not be freed or
637 * altered. It will also become invalid when the button is destroyed.
638 * The string returned, if not NULL, is a stringshare, so if you need to
639 * keep it around even after the button is destroyed, you can use
640 * eina_stringshare_ref().
642 * @param obj The button object
643 * @return The text set to the label, or NULL if nothing is set
644 * @deprecated use elm_object_text_set() instead.
646 EINA_DEPRECATED EAPI const char *elm_button_label_get(const Evas_Object *obj);
649 * Set the icon used for the button
651 * Setting a new icon will delete any other that was previously set, making
652 * any reference to them invalid. If you need to maintain the previous
653 * object alive, unset it first with elm_button_icon_unset().
655 * @param obj The button object
656 * @param icon The icon object for the button
657 * @deprecated use elm_object_part_content_set() instead.
659 EINA_DEPRECATED EAPI void elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
662 * Get the icon used for the button
664 * Return the icon object which is set for this widget. If the button is
665 * destroyed or another icon is set, the returned object will be deleted
666 * and any reference to it will be invalid.
668 * @param obj The button object
669 * @return The icon object that is being used
671 * @deprecated use elm_object_part_content_get() instead
673 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
676 * Remove the icon set without deleting it and return the object
678 * This function drops the reference the button holds of the icon object
679 * and returns this last object. It is used in case you want to remove any
680 * icon, or set another one, without deleting the actual object. The button
681 * will be left without an icon set.
683 * @param obj The button object
684 * @return The icon object that was being used
685 * @deprecated use elm_object_part_content_unset() instead.
687 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
690 * Set a day text color to the same that represents Saturdays.
692 * @param obj The calendar object.
693 * @param pos The text position. Position is the cell counter, from left
694 * to right, up to down. It starts on 0 and ends on 41.
696 * @deprecated use elm_calendar_mark_add() instead like:
699 * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
700 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
703 * @see elm_calendar_mark_add()
706 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
709 * Set a day text color to the same that represents Sundays.
711 * @param obj The calendar object.
712 * @param pos The text position. Position is the cell counter, from left
713 * to right, up to down. It starts on 0 and ends on 41.
715 * @deprecated use elm_calendar_mark_add() instead like:
718 * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
719 * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
722 * @see elm_calendar_mark_add()
725 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
728 * Set a day text color to the same that represents Weekdays.
730 * @param obj The calendar object
731 * @param pos The text position. Position is the cell counter, from left
732 * to right, up to down. It starts on 0 and ends on 41.
734 * @deprecated use elm_calendar_mark_add() instead like:
737 * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
739 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
740 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
741 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
742 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
743 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
744 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
745 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
746 * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
747 * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
750 * @see elm_calendar_mark_add()
753 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
757 * @brief Set the text label of the check object
759 * @param obj The check object
760 * @param label The text label string in UTF-8
762 * @deprecated use elm_object_text_set() instead.
764 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
767 * @brief Get the text label of the check object
769 * @param obj The check object
770 * @return The text label string in UTF-8
772 * @deprecated use elm_object_text_get() instead.
774 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
777 * @brief Set the icon object of the check object
779 * @param obj The check object
780 * @param icon The icon object
782 * Once the icon object is set, a previously set one will be deleted.
783 * If you want to keep that old content object, use the
784 * elm_object_content_unset() function.
786 * @deprecated use elm_object_part_content_set() instead.
789 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
792 * @brief Get the icon object of the check object
794 * @param obj The check object
795 * @return The icon object
797 * @deprecated use elm_object_part_content_get() instead.
800 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
803 * @brief Unset the icon used for the check object
805 * @param obj The check object
806 * @return The icon object that was being used
808 * Unparent and return the icon object which was set for this widget.
810 * @deprecated use elm_object_part_content_unset() instead.
813 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
816 * @brief Set the text label of the check object
818 * @param obj The check object
819 * @param label The text label string in UTF-8
821 * @deprecated use elm_object_text_set() instead.
823 EINA_DEPRECATED EAPI void elm_check_label_set(Evas_Object *obj, const char *label);
826 * @brief Get the text label of the check object
828 * @param obj The check object
829 * @return The text label string in UTF-8
831 * @deprecated use elm_object_text_get() instead.
833 EINA_DEPRECATED EAPI const char *elm_check_label_get(const Evas_Object *obj);
836 * @brief Set the icon object of the check object
838 * @param obj The check object
839 * @param icon The icon object
841 * Once the icon object is set, a previously set one will be deleted.
842 * If you want to keep that old content object, use the
843 * elm_object_content_unset() function.
845 * @deprecated use elm_object_part_content_set() instead.
848 EINA_DEPRECATED EAPI void elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
851 * @brief Get the icon object of the check object
853 * @param obj The check object
854 * @return The icon object
856 * @deprecated use elm_object_part_content_get() instead.
859 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
862 * @brief Unset the icon used for the check object
864 * @param obj The check object
865 * @return The icon object that was being used
867 * Unparent and return the icon object which was set for this widget.
869 * @deprecated use elm_object_part_content_unset() instead.
872 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
874 EINA_DEPRECATED EAPI void elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
875 EINA_DEPRECATED EAPI void elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
879 * Set the content of the conformant widget.
881 * @param obj The conformant object.
882 * @param content The content to be displayed by the conformant.
884 * Content will be sized and positioned considering the space required
885 * to display a virtual keyboard. So it won't fill all the conformant
886 * size. This way is possible to be sure that content won't resize
887 * or be re-positioned after the keyboard is displayed.
889 * Once the content object is set, a previously set one will be deleted.
890 * If you want to keep that old content object, use the
891 * elm_object_content_unset() function.
893 * @see elm_object_content_unset()
894 * @see elm_object_content_get()
896 * @deprecated use elm_object_content_set() instead
899 EINA_DEPRECATED EAPI void elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
902 * Get the content of the conformant widget.
904 * @param obj The conformant object.
905 * @return The content that is being used.
907 * Return the content object which is set for this widget.
908 * It won't be unparent from conformant. For that, use
909 * elm_object_content_unset().
911 * @see elm_object_content_set().
912 * @see elm_object_content_unset()
914 * @deprecated use elm_object_content_get() instead
917 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
920 * Unset the content of the conformant widget.
922 * @param obj The conformant object.
923 * @return The content that was being used.
925 * Unparent and return the content object which was set for this widget.
927 * @see elm_object_content_set().
929 * @deprecated use elm_object_content_unset() instead
932 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
935 * Get the side labels max length.
937 * @deprecated use elm_diskselector_side_text_max_length_get() instead:
939 * @param obj The diskselector object.
940 * @return The max length defined for side labels, or 0 if not a valid
944 EINA_DEPRECATED EAPI int elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
947 * Set the side labels max length.
949 * @deprecated use elm_diskselector_side_text_max_length_set() instead:
951 * @param obj The diskselector object.
952 * @param len The max length defined for side labels.
955 EINA_DEPRECATED EAPI void elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
958 * Get the data associated to the item.
960 * @param it The diskselector item
961 * @return The data associated to @p it
963 * The return value is a pointer to data associated to @p item when it was
964 * created, with function elm_diskselector_item_append(). If no data
965 * was passed as argument, it will return @c NULL.
967 * @see elm_diskselector_item_append()
968 * @deprecated Use elm_object_item_data_get()
971 EINA_DEPRECATED EAPI void *elm_diskselector_item_data_get(const Elm_Object_Item *it);
974 * Set the icon associated to the item.
976 * @param it The diskselector item
977 * @param icon The icon object to associate with @p it
979 * The icon object to use at left side of the item. An
980 * icon can be any Evas object, but usually it is an icon created
981 * with elm_icon_add().
983 * Once the icon object is set, a previously set one will be deleted.
984 * @warning Setting the same icon for two items will cause the icon to
985 * disappear from the first item.
987 * If an icon was passed as argument on item creation, with function
988 * elm_diskselector_item_append(), it will be already
989 * associated to the item.
991 * @see elm_diskselector_item_append()
992 * @see elm_diskselector_item_icon_get()
994 * @deprecated Use elm_object_item_part_content_set() instead
996 EINA_DEPRECATED EAPI void elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
999 * Get the icon associated to the item.
1001 * @param it The diskselector item
1002 * @return The icon associated to @p it
1004 * The return value is a pointer to the icon associated to @p item when it was
1005 * created, with function elm_diskselector_item_append(), or later
1006 * with function elm_diskselector_item_icon_set. If no icon
1007 * was passed as argument, it will return @c NULL.
1009 * @see elm_diskselector_item_append()
1010 * @see elm_diskselector_item_icon_set()
1012 * @deprecated Use elm_object_item_part_content_set() instead
1014 EAPI Evas_Object *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1017 * Set the label of item.
1019 * @param it The item of diskselector.
1020 * @param label The label of item.
1022 * The label to be displayed by the item.
1024 * If no icon is set, label will be centered on item position, otherwise
1025 * the icon will be placed at left of the label, that will be shifted
1028 * An item with label "January" would be displayed on side position as
1029 * "Jan" if max length is set to 3 with function
1030 * elm_diskselector_side_text_max_length_set(), or "Janu", if this property
1033 * When this @p item is selected, the entire label will be displayed,
1034 * except for width restrictions.
1035 * In this case label will be cropped and "..." will be concatenated,
1036 * but only for display purposes. It will keep the entire string, so
1037 * if diskselector is resized the remaining characters will be displayed.
1039 * If a label was passed as argument on item creation, with function
1040 * elm_diskselector_item_append(), it will be already
1041 * displayed by the item.
1043 * @see elm_diskselector_side_text_max_length_set()
1044 * @see elm_diskselector_item_label_get()
1045 * @see elm_diskselector_item_append()
1047 * @deprecated Use elm_object_item_text_set() instead
1049 EINA_DEPRECATED EAPI void elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1052 * Get the label of item.
1054 * @param it The item of diskselector.
1055 * @return The label of item.
1057 * The return value is a pointer to the label associated to @p item when it was
1058 * created, with function elm_diskselector_item_append(), or later
1059 * with function elm_diskselector_item_label_set. If no label
1060 * was passed as argument, it will return @c NULL.
1062 * @see elm_diskselector_item_label_set() for more details.
1063 * @see elm_diskselector_item_append()
1064 * @deprecated Use elm_object_item_text_get() instead
1067 EINA_DEPRECATED EAPI const char *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1070 * Set the function called when a diskselector item is freed.
1072 * @param it The item to set the callback on
1073 * @param func The function called
1075 * If there is a @p func, then it will be called prior item's memory release.
1076 * That will be called with the following arguments:
1078 * @li item's Evas object;
1081 * This way, a data associated to a diskselector item could be properly
1083 * @deprecated Use elm_object_item_del_cb_set() instead
1086 EINA_DEPRECATED EAPI void elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1089 * Delete them item from the diskselector.
1091 * @param it The item of diskselector to be deleted.
1093 * If deleting all diskselector items is required, elm_diskselector_clear()
1094 * should be used instead of getting items list and deleting each one.
1096 * @deprecated Use elm_object_item_del() instead
1097 * @see elm_diskselector_clear()
1098 * @see elm_diskselector_item_append()
1101 EINA_DEPRECATED EAPI void elm_diskselector_item_del(Elm_Object_Item *it);
1104 * Set the text to be shown in the diskselector item.
1106 * @param it Target item
1107 * @param text The text to set in the content
1109 * Setup the text as tooltip to object. The item can have only one tooltip,
1110 * so any previous tooltip data is removed.
1112 * @deprecated Use elm_object_item_tooltip_text_set() instead
1113 * @see elm_object_tooltip_text_set() for more details.
1116 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1119 * Set the content to be shown in the tooltip item.
1121 * Setup the tooltip to item. The item can have only one tooltip,
1122 * so any previous tooltip data is removed. @p func(with @p data) will
1123 * be called every time that need show the tooltip and it should
1124 * return a valid Evas_Object. This object is then managed fully by
1125 * tooltip system and is deleted when the tooltip is gone.
1127 * @param it the diskselector item being attached a tooltip.
1128 * @param func the function used to create the tooltip contents.
1129 * @param data what to provide to @a func as callback data/context.
1130 * @param del_cb called when data is not needed anymore, either when
1131 * another callback replaces @p func, the tooltip is unset with
1132 * elm_diskselector_item_tooltip_unset() or the owner @a item
1133 * dies. This callback receives as the first parameter the
1134 * given @a data, and @c event_info is the item.
1136 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1137 * @see elm_object_tooltip_content_cb_set() for more details.
1140 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
1143 * Unset tooltip from item.
1145 * @param it diskselector item to remove previously set tooltip.
1147 * Remove tooltip from item. The callback provided as del_cb to
1148 * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1149 * it is not used anymore.
1151 * @deprecated Use elm_object_item_tooltip_unset() instead
1152 * @see elm_object_tooltip_unset() for more details.
1153 * @see elm_diskselector_item_tooltip_content_cb_set()
1156 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1159 * Sets a different style for this item tooltip.
1161 * @note before you set a style you should define a tooltip with
1162 * elm_diskselector_item_tooltip_content_cb_set() or
1163 * elm_diskselector_item_tooltip_text_set()
1165 * @param it diskselector item with tooltip already set.
1166 * @param style the theme style to use (default, transparent, ...)
1168 * @deprecated Use elm_object_item_tooltip_style_set() instead
1169 * @see elm_object_tooltip_style_set() for more details.
1172 EINA_DEPRECATED EAPI void elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1175 * Get the style for this item tooltip.
1177 * @param it diskselector item with tooltip already set.
1178 * @return style the theme style in use, defaults to "default". If the
1179 * object does not have a tooltip set, then NULL is returned.
1181 * @deprecated Use elm_object_item_tooltip_style_get() instead
1182 * @see elm_object_tooltip_style_get() for more details.
1183 * @see elm_diskselector_item_tooltip_style_set()
1186 EINA_DEPRECATED EAPI const char *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1189 * Set the cursor to be shown when mouse is over the diskselector item
1191 * @param it Target item
1192 * @param cursor the cursor name to be used.
1194 * @see elm_object_cursor_set() for more details.
1195 * @deprecated Use elm_object_item_cursor_set() instead
1198 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1201 * Get the cursor to be shown when mouse is over the diskselector item
1203 * @param it diskselector item with cursor already set.
1204 * @return the cursor name.
1206 * @see elm_object_cursor_get() for more details.
1207 * @see elm_diskselector_item_cursor_set()
1208 * @deprecated Use elm_object_item_cursor_get() instead
1211 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1214 * Unset the cursor to be shown when mouse is over the diskselector item
1216 * @param it Target item
1218 * @see elm_object_cursor_unset() for more details.
1219 * @see elm_diskselector_item_cursor_set()
1220 * @deprecated use elm_object_item_cursor_unset() instead
1223 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1226 * Sets a different style for this item cursor.
1228 * @note before you set a style you should define a cursor with
1229 * elm_diskselector_item_cursor_set()
1231 * @param it diskselector item with cursor already set.
1232 * @param style the theme style to use (default, transparent, ...)
1234 * @see elm_object_cursor_style_set() for more details.
1235 * @deprecated Use elm_object_item_cursor_style_set() instead
1238 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1241 * Get the style for this item cursor.
1243 * @param it diskselector item with cursor already set.
1244 * @return style the theme style in use, defaults to "default". If the
1245 * object does not have a cursor set, then @c NULL is returned.
1247 * @see elm_object_cursor_style_get() for more details.
1248 * @see elm_diskselector_item_cursor_style_set()
1249 * @deprecated Use elm_object_item_cursor_style_get() instead
1252 EINA_DEPRECATED EAPI const char *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1255 * Set if the cursor set should be searched on the theme or should use
1256 * the provided by the engine, only.
1258 * @note before you set if should look on theme you should define a cursor
1259 * with elm_diskselector_item_cursor_set().
1260 * By default it will only look for cursors provided by the engine.
1262 * @param it widget item with cursor already set.
1263 * @param engine_only boolean to define if cursors set with
1264 * elm_diskselector_item_cursor_set() should be searched only
1265 * between cursors provided by the engine or searched on widget's
1268 * @see elm_object_cursor_engine_only_set() for more details.
1269 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1272 EINA_DEPRECATED EAPI void elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1275 * Get the cursor engine only usage for this item cursor.
1277 * @param it widget item with cursor already set.
1278 * @return engine_only boolean to define it cursors should be looked only
1279 * between the provided by the engine or searched on widget's theme as well.
1280 * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1282 * @see elm_object_cursor_engine_only_get() for more details.
1283 * @see elm_diskselector_item_cursor_engine_only_set()
1284 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1287 EINA_DEPRECATED EAPI Eina_Bool elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1289 EINA_DEPRECATED EAPI void elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1290 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1293 * Get the label of a given flip selector widget's item.
1295 * @param it The item to get label from
1296 * @return The text label of @p item or @c NULL, on errors
1298 * @see elm_object_item_text_set()
1300 * @deprecated see elm_object_item_text_get() instead
1302 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1305 * Set the label of a given flip selector widget's item.
1307 * @param it The item to set label on
1308 * @param label The text label string, in UTF-8 encoding
1310 * @see elm_object_item_text_get()
1312 * @deprecated see elm_object_item_text_set() instead
1314 EINA_DEPRECATED EAPI void elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1317 * Delete a given item from a flip selector widget.
1319 * @param it The item to delete
1321 * @deprecated Use elm_object_item_del() instead
1323 EINA_DEPRECATED EAPI void elm_flipselector_item_del(Elm_Object_Item *it);
1326 * Set the interval on time updates for a user mouse button hold
1327 * on a flip selector widget.
1329 * @param obj The flip selector object
1330 * @param interval The (first) interval value in seconds
1332 * This interval value is @b decreased while the user holds the
1333 * mouse pointer either flipping up or flipping down a given flip
1336 * This helps the user to get to a given item distant from the
1337 * current one easier/faster, as it will start to flip quicker and
1338 * quicker on mouse button holds.
1340 * The calculation for the next flip interval value, starting from
1341 * the one set with this call, is the previous interval divided by
1342 * 1.05, so it decreases a little bit.
1344 * The default starting interval value for automatic flips is
1347 * @see elm_flipselector_interval_get()
1348 * @deprecated Use elm_flipselector_first_interval_set()
1351 EINA_DEPRECATED EAPI void elm_flipselector_interval_set(Evas_Object *obj, double interval);
1354 * Get the interval on time updates for an user mouse button hold
1355 * on a flip selector widget.
1357 * @param obj The flip selector object
1358 * @return The (first) interval value, in seconds, set on it
1360 * @see elm_flipselector_interval_set() for more details
1361 * @deprecated Use elm_flipselector_first_interval_get()
1364 EINA_DEPRECATED EAPI double elm_flipselector_interval_get(const Evas_Object *obj);
1367 * Make a given Elementary object the focused one.
1369 * @param obj The Elementary object to make focused.
1371 * @note This object, if it can handle focus, will take the focus
1372 * away from the one who had it previously and will, for now on, be
1373 * the one receiving input events.
1375 * @see elm_object_focus_get()
1376 * @deprecated use elm_object_focus_set() instead.
1379 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1382 * Give focus to next object in object tree.
1384 * Give focus to next object in focus chain of one object sub-tree.
1385 * If the last object of chain already have focus, the focus will go to the
1386 * first object of chain.
1388 * @param obj The object root of sub-tree
1389 * @param dir Direction to cycle the focus
1391 * @deprecated Use elm_object_focus_next() instead
1393 EINA_DEPRECATED EAPI void elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
1396 * Remove the focus from an Elementary object
1398 * @param obj The Elementary to take focus from
1400 * This removes the focus from @p obj, passing it back to the
1401 * previous element in the focus chain list.
1403 * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1404 * @deprecated use elm_object_focus_set() instead.
1407 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1410 * Give focus to near object in one direction.
1412 * Give focus to near object in direction of one object.
1413 * If none focusable object in given direction, the focus will not change.
1415 * @param obj The reference object
1416 * @param x Horizontal component of direction to focus
1417 * @param y Vertical component of direction to focus
1419 * @deprecated Support it later.
1421 EINA_DEPRECATED EAPI void elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1424 * @brief Set the frame label
1426 * @param obj The frame object
1427 * @param label The label of this frame object
1429 * @deprecated use elm_object_text_set() instead.
1431 EINA_DEPRECATED EAPI void elm_frame_label_set(Evas_Object *obj, const char *label);
1434 * @brief Get the frame label
1436 * @param obj The frame object
1438 * @return The label of this frame object or NULL if unable to get frame
1440 * @deprecated use elm_object_text_get() instead.
1442 EINA_DEPRECATED EAPI const char *elm_frame_label_get(const Evas_Object *obj);
1445 * @brief Set the content of the frame widget
1447 * Once the content object is set, a previously set one will be deleted.
1448 * If you want to keep that old content object, use the
1449 * elm_frame_content_unset() function.
1451 * @param obj The frame object
1452 * @param content The content will be filled in this frame object
1454 * @deprecated use elm_object_content_set() instead.
1456 EINA_DEPRECATED EAPI void elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1459 * @brief Get the content of the frame widget
1461 * Return the content object which is set for this widget
1463 * @param obj The frame object
1464 * @return The content that is being used
1466 * @deprecated use elm_object_content_get() instead.
1468 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1471 * @brief Unset the content of the frame widget
1473 * Unparent and return the content object which was set for this widget
1475 * @param obj The frame object
1476 * @return The content that was being used
1478 * @deprecated use elm_object_content_unset() instead.
1480 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1482 EINA_DEPRECATED EAPI void elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1483 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1484 EINA_DEPRECATED EAPI void elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1486 * This sets the horizontal stretching mode.
1488 * @param obj The genlist object
1489 * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1491 * This sets the mode used for sizing items horizontally. Valid modes
1492 * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1493 * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1494 * the scroller will scroll horizontally. Otherwise items are expanded
1495 * to fill the width of the viewport of the scroller. If it is
1496 * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1497 * limited to that size.
1499 * @see elm_genlist_horizontal_get()
1501 * @deprecated use elm_genlist_mode_set()
1503 EINA_DEPRECATED EAPI void elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1506 * Gets the horizontal stretching mode.
1508 * @param obj The genlist object
1509 * @return The mode to use
1510 * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1512 * @see elm_genlist_horizontal_set()
1514 * @deprecated use elm_genlist_mode_get()
1516 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_get(const Evas_Object *obj);
1519 * Return the data associated to a given genlist item
1521 * @param it The genlist item.
1522 * @return the data associated to this item.
1524 * This returns the @c data value passed on the
1525 * elm_genlist_item_append() and related item addition calls.
1527 * @see elm_genlist_item_append()
1528 * @see elm_genlist_item_data_set()
1530 * @deprecated Use elm_object_item_data_get() instead
1532 EINA_DEPRECATED EAPI void *elm_genlist_item_data_get(const Elm_Object_Item *it);
1535 * Set the data associated to a given genlist item
1537 * @param it The genlist item
1538 * @param data The new data pointer to set on it
1540 * This @b overrides the @c data value passed on the
1541 * elm_genlist_item_append() and related item addition calls. This
1542 * function @b won't call elm_genlist_item_update() automatically,
1543 * so you'd issue it afterwards if you want to hove the item
1544 * updated to reflect the that new data.
1546 * @see elm_genlist_item_data_get()
1548 * @deprecated Use elm_object_item_data_set() instead
1550 EINA_DEPRECATED EAPI void elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
1553 * Set whether a given genlist item is disabled or not.
1555 * @param it The item
1556 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
1557 * to enable it back.
1559 * A disabled item cannot be selected or unselected. It will also
1560 * change its appearance, to signal the user it's disabled.
1562 * @see elm_genlist_item_disabled_get()
1563 * @deprecated Use elm_object_item_disabled_set() instead
1566 EINA_DEPRECATED EAPI void elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1569 * Get whether a given genlist item is disabled or not.
1571 * @param it The item
1572 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
1575 * @see elm_genlist_item_disabled_set() for more details
1576 * @deprecated Use elm_object_item_disabled_get() instead
1579 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_disabled_get(const Elm_Object_Item *it);
1582 * Remove a genlist item from the its parent, deleting it.
1584 * @param it The item to be removed.
1585 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
1587 * @see elm_genlist_clear(), to remove all items in a genlist at
1590 * @deprecated Use elm_object_item_del() instead
1592 EINA_DEPRECATED EAPI void elm_genlist_item_del(Elm_Object_Item *it);
1595 * Get the genlist object's handle which contains a given genlist
1598 * @param it The item to fetch the container from
1599 * @return The genlist (parent) object
1601 * This returns the genlist object itself that an item belongs to.
1602 * @deprecated Use elm_object_item_widget_get() instead
1605 EINA_DEPRECATED EAPI Evas_Object *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
1608 * Get the mode item style of items in the genlist
1609 * @param obj The genlist object
1610 * @return The mode item style string, or NULL if none is specified
1612 * This is a constant string and simply defines the name of the
1613 * style that will be used for mode animations. It can be
1614 * @c NULL if you don't plan to use Genlist mode. See
1615 * elm_genlist_item_mode_set() for more info.
1618 EINA_DEPRECATED EAPI const char *elm_genlist_mode_item_style_get(const Evas_Object *obj);
1621 * Set the mode item style of items in the genlist
1622 * @param obj The genlist object
1623 * @param style The mode item style string, or NULL if none is desired
1625 * This is a constant string and simply defines the name of the
1626 * style that will be used for mode animations. It can be
1627 * @c NULL if you don't plan to use Genlist mode. See
1628 * elm_genlist_item_mode_set() for more info.
1631 EINA_DEPRECATED EAPI void elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
1634 * Get the real Evas object created to implement the view of a
1635 * given genlist item
1637 * @param it The genlist item.
1638 * @return the Evas object implementing this item's view.
1640 * This returns the actual Evas object used to implement the
1641 * specified genlist item's view. This may be @c NULL, as it may
1642 * not have been created or may have been deleted, at any time, by
1643 * the genlist. <b>Do not modify this object</b> (move, resize,
1644 * show, hide, etc.), as the genlist is controlling it. This
1645 * function is for querying, emitting custom signals or hooking
1646 * lower level callbacks for events on that object. Do not delete
1647 * this object under any circumstances.
1649 * @see elm_object_item_data_get()
1650 * @deprecated No more support
1653 EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it);
1656 * Get the Item's Flags
1658 * @param it The genlist item
1659 * @return The item type.
1661 * This function returns the item's type. Normally the item's type.
1662 * If it failed, return value is ELM_GENLIST_ITEM_MAX
1664 * @deprecated Use elm_genlist_item_type_get() instead
1666 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(const Elm_Object_Item *it);
1669 * Tells genlist to "orphan" contents fetched by the item class
1671 * @param it The item
1673 * This instructs genlist to release references to contents in the item,
1674 * meaning that they will no longer be managed by genlist and are
1675 * floating "orphans" that can be re-used elsewhere if the user wants
1678 * @deprecated Use elm_genlist_item_all_contents_unset() instead
1680 EINA_DEPRECATED EAPI void elm_genlist_item_contents_orphan(Elm_Object_Item *it);
1682 #define ELM_IMAGE_ROTATE_90_CW 1
1683 #define ELM_IMAGE_ROTATE_180_CW 2
1684 #define ELM_IMAGE_ROTATE_90_CCW 3
1687 * Return the data associated with a given index widget item
1689 * @param item The index widget item handle
1690 * @return The data associated with @p it
1691 * @deprecated Use elm_object_item_data_get() instead
1693 * @see elm_index_item_data_set()
1696 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1699 * Set the data associated with a given index widget item
1701 * @param it The index widget item handle
1702 * @param data The new data pointer to set to @p it
1704 * This sets new item data on @p it.
1706 * @warning The old data pointer won't be touched by this function, so
1707 * the user had better to free that old data himself/herself.
1709 * @deprecated Use elm_object_item_data_set() instead
1711 EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1714 * Set the function to be called when a given index widget item is freed.
1716 * @param it The item to set the callback on
1717 * @param func The function to call on the item's deletion
1719 * When called, @p func will have both @c data and @c event_info
1720 * arguments with the @p it item's data value and, naturally, the
1721 * @c obj argument with a handle to the parent index widget.
1723 * @deprecated Use elm_object_item_del_cb_set() instead
1725 EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1728 * Remove an item from a given index widget, <b>to be referenced by
1729 * it's data value</b>.
1731 * @param obj The index object
1732 * @param item The item to be removed from @p obj
1734 * If a deletion callback is set, via elm_object_item_del_cb_set(),
1735 * that callback function will be called by this one.
1737 * @deprecated Use elm_object_item_del() instead
1739 EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
1742 * @brief Set the label on the label object
1744 * @param obj The label object
1745 * @param label The label will be used on the label object
1746 * @deprecated See elm_object_text_set()
1748 EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label);
1751 * @brief Get the label used on the label object
1753 * @param obj The label object
1754 * @return The string inside the label
1755 * @deprecated See elm_object_text_get()
1757 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
1761 * Set the layout content.
1763 * @param obj The layout object
1764 * @param swallow The swallow part name in the edje file
1765 * @param content The child that will be added in this layout object
1766 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
1768 * Once the content object is set, a previously set one will be deleted.
1769 * If you want to keep that old content object, use the
1770 * elm_object_part_content_unset() function.
1772 * @note In an Edje theme, the part used as a content container is called @c
1773 * SWALLOW. This is why the parameter name is called @p swallow, but it is
1774 * expected to be a part name just like the second parameter of
1775 * elm_layout_box_append().
1777 * @see elm_layout_box_append()
1778 * @see elm_object_part_content_get()
1779 * @see elm_object_part_content_unset()
1781 * @deprecated use elm_object_part_content_set() instead
1784 EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
1787 * Get the child object in the given content part.
1789 * @param obj The layout object
1790 * @param swallow The SWALLOW part to get its content
1792 * @return The swallowed object or NULL if none or an error occurred
1794 * @deprecated use elm_object_part_content_get() instead
1797 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
1800 * Unset the layout content.
1802 * @param obj The layout object
1803 * @param swallow The swallow part name in the edje file
1804 * @return The content that was being used
1806 * Unparent and return the content object which was set for this part.
1808 * @deprecated use elm_object_part_content_unset() instead
1811 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
1814 * Set the text of the given part
1816 * @param obj The layout object
1817 * @param part The TEXT part where to set the text
1818 * @param text The text to set
1819 * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
1821 * @deprecated use elm_object_part_text_set() instead.
1823 EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
1826 * Get the text set in the given part
1828 * @param obj The layout object
1829 * @param part The TEXT part to retrieve the text off
1831 * @return The text set in @p part
1833 * @deprecated use elm_object_part_text_get() instead.
1835 EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part);
1838 * @def elm_layout_label_set
1839 * Convenience macro to set the label in a layout that follows the
1840 * Elementary naming convention for its parts.
1842 * @deprecated use elm_object_text_set() instead.
1844 #define elm_layout_label_set(_ly, _txt) \
1845 elm_layout_text_set((_ly), "elm.text", (_txt))
1848 * @def elm_layout_label_get
1849 * Convenience macro to get the label in a layout that follows the
1850 * Elementary naming convention for its parts.
1852 * @deprecated use elm_object_text_set() instead.
1854 #define elm_layout_label_get(_ly) \
1855 elm_layout_text_get((_ly), "elm.text")
1857 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
1861 * Set the content of the mapbuf.
1863 * @param obj The mapbuf object.
1864 * @param content The content that will be filled in this mapbuf object.
1866 * Once the content object is set, a previously set one will be deleted.
1867 * If you want to keep that old content object, use the
1868 * elm_mapbuf_content_unset() function.
1870 * To enable map, elm_mapbuf_enabled_set() should be used.
1872 * @deprecated use elm_object_content_set() instead
1875 EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
1878 * Get the content of the mapbuf.
1880 * @param obj The mapbuf object.
1881 * @return The content that is being used.
1883 * Return the content object which is set for this widget.
1885 * @see elm_mapbuf_content_set() for details.
1887 * @deprecated use elm_object_content_get() instead
1890 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
1893 * Unset the content of the mapbuf.
1895 * @param obj The mapbuf object.
1896 * @return The content that was being used.
1898 * Unparent and return the content object which was set for this widget.
1900 * @see elm_mapbuf_content_set() for details.
1902 * @deprecated use elm_object_content_unset() instead
1905 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
1908 * @brief Set the label of a menu item
1910 * @param it The menu item object.
1911 * @param label The label to set for @p item
1913 * @warning Don't use this function on items created with
1914 * elm_menu_item_add_object() or elm_menu_item_separator_add().
1916 * @deprecated Use elm_object_item_text_set() instead
1918 EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
1921 * @brief Get the label of a menu item
1923 * @param it The menu item object.
1924 * @return The label of @p item
1925 * @deprecated Use elm_object_item_text_get() instead
1927 EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it);
1930 * @brief Set the content object of a menu item
1932 * @param it The menu item object
1933 * @param The content object or NULL
1934 * @return EINA_TRUE on success, else EINA_FALSE
1936 * Use this function to change the object swallowed by a menu item, deleting
1937 * any previously swallowed object.
1939 * @deprecated Use elm_object_item_content_set() instead
1941 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
1944 * @brief Get the content object of a menu item
1946 * @param it The menu item object
1947 * @return The content object or NULL
1948 * @note If @p item was added with elm_menu_item_add_object, this
1949 * function will return the object passed, else it will return the
1952 * @see elm_menu_item_object_content_set()
1954 * @deprecated Use elm_object_item_content_get() instead
1956 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
1959 * @brief Set the disabled state of @p item.
1961 * @param it The menu item object.
1962 * @param disabled The enabled/disabled state of the item
1963 * @deprecated Use elm_object_item_disabled_set() instead
1965 EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1968 * @brief Get the disabled state of @p item.
1970 * @param it The menu item object.
1971 * @return The enabled/disabled state of the item
1973 * @see elm_menu_item_disabled_set()
1974 * @deprecated Use elm_object_item_disabled_get() instead
1976 EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it);
1979 * @brief Returns the data associated with menu item @p item.
1981 * @param it The item
1982 * @return The data associated with @p item or NULL if none was set.
1984 * This is the data set with elm_menu_add() or elm_menu_item_data_set().
1986 * @deprecated Use elm_object_item_data_get() instead
1988 EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it);
1991 * @brief Set the function called when a menu item is deleted.
1993 * @param it The item to set the callback on
1994 * @param func The function called
1996 * @see elm_menu_item_add()
1997 * @see elm_menu_item_del()
1998 * @deprecated Use elm_object_item_del_cb_set() instead
2000 EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2003 * @brief Sets the data to be associated with menu item @p item.
2005 * @param it The item
2006 * @param data The data to be associated with @p item
2008 * @deprecated Use elm_object_item_data_set() instead
2010 EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2013 * @brief Deletes an item from the menu.
2015 * @param it The item to delete.
2017 * @deprecated Use elm_object_item_del() instead
2018 * @see elm_menu_item_add()
2020 EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it);
2023 * @brief @brief Return a menu item's owner menu
2025 * @param it The menu item
2026 * @return The menu object owning @p item, or NULL on failure
2028 * Use this function to get the menu object owning an item.
2029 * @deprecated Use elm_object_item_widget_get() instead
2031 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it);
2034 * @brief Set the icon of a menu item to the standard icon with name @p icon
2036 * @param it The menu item object.
2037 * @param icon The icon object to set for the content of @p item
2039 * @deprecated elm_menu_item_icon_name_set() instead
2040 * Once this icon is set, any previously set icon will be deleted.
2042 EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2045 * @brief Get the string representation from the icon of a menu item
2047 * @param it The menu item object.
2048 * @return The string representation of @p item's icon or NULL
2050 * @deprecated elm_menu_item_icon_name_get() instead
2051 * @see elm_menu_item_icon_name_set()
2053 EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2056 * @brief Set the content of the notify widget
2058 * @param obj The notify object
2059 * @param content The content will be filled in this notify object
2061 * Once the content object is set, a previously set one will be deleted. If
2062 * you want to keep that old content object, use the
2063 * elm_notify_content_unset() function.
2065 * @deprecated use elm_object_content_set() instead
2068 EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2071 * @brief Unset the content of the notify widget
2073 * @param obj The notify object
2074 * @return The content that was being used
2076 * Unparent and return the content object which was set for this widget
2078 * @see elm_notify_content_set()
2079 * @deprecated use elm_object_content_unset() instead
2082 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2085 * @brief Return the content of the notify widget
2087 * @param obj The notify object
2088 * @return The content that is being used
2090 * @see elm_notify_content_set()
2091 * @deprecated use elm_object_content_get() instead
2094 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2097 * Set a label of an object
2099 * @param obj The Elementary object
2100 * @param part The text part name to set (NULL for the default label)
2101 * @param label The new text of the label
2103 * @note Elementary objects may have many labels (e.g. Action Slider)
2104 * @deprecated Use elm_object_part_text_set() instead.
2106 EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2109 * Get a label of an object
2111 * @param obj The Elementary object
2112 * @param part The text part name to get (NULL for the default label)
2113 * @return text of the label or NULL for any error
2115 * @note Elementary objects may have many labels (e.g. Action Slider)
2116 * @deprecated Use elm_object_part_text_get() instead.
2118 EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2121 * Set a content of an object
2123 * @param obj The Elementary object
2124 * @param part The content part name to set (NULL for the default content)
2125 * @param content The new content of the object
2127 * @note Elementary objects may have many contents
2128 * @deprecated Use elm_object_part_content_set instead.
2130 EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2133 * Get a content of an object
2135 * @param obj The Elementary object
2136 * @param part The content part name to get (NULL for the default content)
2137 * @return content of the object or NULL for any error
2139 * @note Elementary objects may have many contents
2140 * @deprecated Use elm_object_part_content_get instead.
2142 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2145 * Unset a content of an object
2147 * @param obj The Elementary object
2148 * @param part The content part name to unset (NULL for the default content)
2150 * @note Elementary objects may have many contents
2151 * @deprecated Use elm_object_part_content_unset instead.
2153 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2156 * Set a content of an object item
2158 * @param it The Elementary object item
2159 * @param part The content part name to set (NULL for the default content)
2160 * @param content The new content of the object item
2162 * @note Elementary object items may have many contents
2163 * @deprecated Use elm_object_item_part_content_set instead.
2165 EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2168 * Get a content of an object item
2170 * @param it The Elementary object item
2171 * @param part The content part name to unset (NULL for the default content)
2172 * @return content of the object item or NULL for any error
2174 * @note Elementary object items may have many contents
2175 * @deprecated Use elm_object_item_part_content_get instead.
2177 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2180 * Unset a content of an object item
2182 * @param it The Elementary object item
2183 * @param part The content part name to unset (NULL for the default content)
2185 * @note Elementary object items may have many contents
2186 * @deprecated Use elm_object_item_part_content_unset instead.
2188 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2191 * Get a label of an object item
2193 * @param it The Elementary object item
2194 * @param part The text part name to get (NULL for the default label)
2195 * @return text of the label or NULL for any error
2197 * @note Elementary object items may have many labels
2198 * @deprecated Use elm_object_item_part_text_get instead.
2200 EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2203 * Set a label of an object item
2205 * @param it The Elementary object item
2206 * @param part The text part name to set (NULL for the default label)
2207 * @param label The new text of the label
2209 * @note Elementary object items may have many labels
2210 * @deprecated Use elm_object_item_part_text_set instead.
2212 EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2215 * @brief Set the content of the panel.
2217 * @param obj The panel object
2218 * @param content The panel content
2220 * Once the content object is set, a previously set one will be deleted.
2221 * If you want to keep that old content object, use the
2222 * elm_panel_content_unset() function.
2224 * @deprecated use elm_object_content_set() instead
2227 EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2230 * @brief Get the content of the panel.
2232 * @param obj The panel object
2233 * @return The content that is being used
2235 * Return the content object which is set for this widget.
2237 * @see elm_panel_content_set()
2239 * @deprecated use elm_object_content_get() instead
2242 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2245 * @brief Unset the content of the panel.
2247 * @param obj The panel object
2248 * @return The content that was being used
2250 * Unparent and return the content object which was set for this widget.
2252 * @see elm_panel_content_set()
2254 * @deprecated use elm_object_content_unset() instead
2257 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2260 * Set the left content of the panes widget.
2262 * @param obj The panes object.
2263 * @param content The new left content object.
2265 * Once the content object is set, a previously set one will be deleted.
2266 * If you want to keep that old content object, use the
2267 * elm_panes_content_left_unset() function.
2269 * If panes is displayed vertically, left content will be displayed at
2272 * @see elm_panes_content_left_get()
2273 * @see elm_panes_content_right_set() to set content on the other side.
2275 * @deprecated use elm_object_part_content_set() instead
2278 EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2281 * Set the right content of the panes widget.
2283 * @param obj The panes object.
2284 * @param content The new right content object.
2286 * Once the content object is set, a previously set one will be deleted.
2287 * If you want to keep that old content object, use the
2288 * elm_panes_content_right_unset() function.
2290 * If panes is displayed vertically, left content will be displayed at
2293 * @see elm_panes_content_right_get()
2294 * @see elm_panes_content_left_set() to set content on the other side.
2296 * @deprecated use elm_object_part_content_set() instead
2299 EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2302 * Get the left content of the panes.
2304 * @param obj The panes object.
2305 * @return The left content object that is being used.
2307 * Return the left content object which is set for this widget.
2309 * @see elm_panes_content_left_set() for details.
2311 * @deprecated use elm_object_part_content_get() instead
2314 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2317 * Get the right content of the panes.
2319 * @param obj The panes object
2320 * @return The right content object that is being used
2322 * Return the right content object which is set for this widget.
2324 * @see elm_panes_content_right_set() for details.
2326 * @deprecated use elm_object_part_content_get() instead
2329 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2332 * Unset the left content used for the panes.
2334 * @param obj The panes object.
2335 * @return The left content object that was being used.
2337 * Unparent and return the left content object which was set for this widget.
2339 * @see elm_panes_content_left_set() for details.
2340 * @see elm_panes_content_left_get().
2342 * @deprecated use elm_object_part_content_unset() instead
2345 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2348 * Unset the right content used for the panes.
2350 * @param obj The panes object.
2351 * @return The right content object that was being used.
2353 * Unparent and return the right content object which was set for this
2356 * @see elm_panes_content_right_set() for details.
2357 * @see elm_panes_content_right_get().
2359 * @deprecated use elm_object_part_content_unset() instead
2362 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2364 * Set the label of a given progress bar widget
2366 * @param obj The progress bar object
2367 * @param label The text label string, in UTF-8
2369 * @deprecated use elm_object_text_set() instead.
2371 EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label);
2374 * Get the label of a given progress bar widget
2376 * @param obj The progressbar object
2377 * @return The text label string, in UTF-8
2379 * @deprecated use elm_object_text_set() instead.
2381 EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj);
2384 * Set the icon object of a given progress bar widget
2386 * @param obj The progress bar object
2387 * @param icon The icon object
2389 * Use this call to decorate @p obj with an icon next to it.
2391 * @note Once the icon object is set, a previously set one will be
2392 * deleted. If you want to keep that old content object, use the
2393 * elm_progressbar_icon_unset() function.
2395 * @see elm_progressbar_icon_get()
2396 * @deprecated use elm_object_part_content_set() instead.
2399 EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2402 * Retrieve the icon object set for a given progress bar widget
2404 * @param obj The progress bar object
2405 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2406 * otherwise (and on errors)
2408 * @see elm_progressbar_icon_set() for more details
2409 * @deprecated use elm_object_part_content_get() instead.
2412 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2415 * Unset an icon set on a given progress bar widget
2417 * @param obj The progress bar object
2418 * @return The icon object that was being used, if any was set, or
2419 * @c NULL, otherwise (and on errors)
2421 * This call will unparent and return the icon object which was set
2422 * for this widget, previously, on success.
2424 * @see elm_progressbar_icon_set() for more details
2425 * @deprecated use elm_object_part_content_unset() instead.
2428 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2431 * @brief Set the text label of the radio object
2433 * @param obj The radio object
2434 * @param label The text label string in UTF-8
2436 * @deprecated use elm_object_text_set() instead.
2438 EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label);
2441 * @brief Get the text label of the radio object
2443 * @param obj The radio object
2444 * @return The text label string in UTF-8
2446 * @deprecated use elm_object_text_set() instead.
2448 EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj);
2451 * @brief Set the icon object of the radio object
2453 * @param obj The radio object
2454 * @param icon The icon object
2456 * Once the icon object is set, a previously set one will be deleted. If you
2457 * want to keep that old content object, use the elm_radio_icon_unset()
2460 * @deprecated use elm_object_part_content_set() instead.
2463 EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2466 * @brief Get the icon object of the radio object
2468 * @param obj The radio object
2469 * @return The icon object
2471 * @see elm_radio_icon_set()
2473 * @deprecated use elm_object_part_content_get() instead.
2476 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2479 * @brief Unset the icon used for the radio object
2481 * @param obj The radio object
2482 * @return The icon object that was being used
2484 * Unparent and return the icon object which was set for this widget.
2486 * @see elm_radio_icon_set()
2487 * @deprecated use elm_object_part_content_unset() instead.
2490 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2493 * @brief Set the content of the scroller widget (the object to be scrolled around).
2495 * @param obj The scroller object
2496 * @param content The new content object
2498 * Once the content object is set, a previously set one will be deleted.
2499 * If you want to keep that old content object, use the
2500 * elm_scroller_content_unset() function.
2501 * @deprecated use elm_object_content_set() instead
2503 EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2506 * @brief Get the content of the scroller widget
2508 * @param obj The slider object
2509 * @return The content that is being used
2511 * Return the content object which is set for this widget
2513 * @see elm_scroller_content_set()
2514 * @deprecated use elm_object_content_get() instead.
2516 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2519 * @brief Unset the content of the scroller widget
2521 * @param obj The slider object
2522 * @return The content that was being used
2524 * Unparent and return the content object which was set for this widget
2526 * @see elm_scroller_content_set()
2527 * @deprecated use elm_object_content_unset() instead.
2529 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2532 * Set the label of a given slider widget
2534 * @param obj The progress bar object
2535 * @param label The text label string, in UTF-8
2537 * @deprecated use elm_object_text_set() instead.
2539 EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label);
2542 * Get the label of a given slider widget
2544 * @param obj The progressbar object
2545 * @return The text label string, in UTF-8
2547 * @deprecated use elm_object_text_get() instead.
2549 EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj);
2552 * Set the icon object of the slider object.
2554 * @param obj The slider object.
2555 * @param icon The icon object.
2557 * On horizontal mode, icon is placed at left, and on vertical mode,
2560 * @note Once the icon object is set, a previously set one will be deleted.
2561 * If you want to keep that old content object, use the
2562 * elm_slider_icon_unset() function.
2564 * @warning If the object being set does not have minimum size hints set,
2565 * it won't get properly displayed.
2567 * @deprecated use elm_object_part_content_set() instead.
2569 EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2572 * Unset an icon set on a given slider widget.
2574 * @param obj The slider object.
2575 * @return The icon object that was being used, if any was set, or
2576 * @c NULL, otherwise (and on errors).
2578 * On horizontal mode, icon is placed at left, and on vertical mode,
2581 * This call will unparent and return the icon object which was set
2582 * for this widget, previously, on success.
2584 * @see elm_slider_icon_set() for more details
2585 * @see elm_slider_icon_get()
2586 * @deprecated use elm_object_part_content_unset() instead.
2589 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2592 * Retrieve the icon object set for a given slider widget.
2594 * @param obj The slider object.
2595 * @return The icon object's handle, if @p obj had one set, or @c NULL,
2596 * otherwise (and on errors).
2598 * On horizontal mode, icon is placed at left, and on vertical mode,
2601 * @see elm_slider_icon_set() for more details
2602 * @see elm_slider_icon_unset()
2604 * @deprecated use elm_object_part_content_get() instead.
2607 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2610 * Set the end object of the slider object.
2612 * @param obj The slider object.
2613 * @param end The end object.
2615 * On horizontal mode, end is placed at left, and on vertical mode,
2618 * @note Once the icon object is set, a previously set one will be deleted.
2619 * If you want to keep that old content object, use the
2620 * elm_slider_end_unset() function.
2622 * @warning If the object being set does not have minimum size hints set,
2623 * it won't get properly displayed.
2625 * @deprecated use elm_object_part_content_set() instead.
2628 EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2631 * Unset an end object set on a given slider widget.
2633 * @param obj The slider object.
2634 * @return The end object that was being used, if any was set, or
2635 * @c NULL, otherwise (and on errors).
2637 * On horizontal mode, end is placed at left, and on vertical mode,
2640 * This call will unparent and return the icon object which was set
2641 * for this widget, previously, on success.
2643 * @see elm_slider_end_set() for more details.
2644 * @see elm_slider_end_get()
2646 * @deprecated use elm_object_part_content_unset() instead
2650 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2653 * Retrieve the end object set for a given slider widget.
2655 * @param obj The slider object.
2656 * @return The end object's handle, if @p obj had one set, or @c NULL,
2657 * otherwise (and on errors).
2659 * On horizontal mode, icon is placed at right, and on vertical mode,
2662 * @see elm_slider_end_set() for more details.
2663 * @see elm_slider_end_unset()
2666 * @deprecated use elm_object_part_content_get() instead
2670 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2673 * Return the data associated with a given slideshow item
2675 * @param it The slideshow item
2676 * @return Returns the data associated to this item
2678 * @deprecated use elm_object_item_data_get() instead
2680 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2683 * Delete a given item from a slideshow widget.
2685 * @param it The slideshow item
2687 * @deprecated Use elm_object_item_de() instead
2689 EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it);
2692 * Display a given slideshow widget's item, programmatically.
2694 * @param it The item to display on @p obj's viewport
2696 * The change between the current item and @p item will use the
2697 * transition @p obj is set to use (@see
2698 * elm_slideshow_transition_set()).
2700 * @deprecated use elm_slideshow_item_show() instead
2702 EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it);
2705 * Get the toolbar object from an item.
2707 * @param it The item.
2708 * @return The toolbar object.
2710 * This returns the toolbar object itself that an item belongs to.
2712 * @deprecated use elm_object_item_object_get() instead.
2714 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2717 * Get the label of item.
2719 * @param it The item of toolbar.
2720 * @return The label of item.
2722 * The return value is a pointer to the label associated to @p item when
2723 * it was created, with function elm_toolbar_item_append() or similar,
2725 * with function elm_toolbar_item_label_set. If no label
2726 * was passed as argument, it will return @c NULL.
2728 * @see elm_toolbar_item_label_set() for more details.
2729 * @see elm_toolbar_item_append()
2731 * @deprecated use elm_object_item_text_get() instead.
2733 EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it);
2736 * Set the label of item.
2738 * @param it The item of toolbar.
2739 * @param label The label of item.
2741 * The label to be displayed by the item.
2742 * Label will be placed at icons bottom (if set).
2744 * If a label was passed as argument on item creation, with function
2745 * elm_toolbar_item_append() or similar, it will be already
2746 * displayed by the item.
2748 * @see elm_toolbar_item_label_get()
2749 * @see elm_toolbar_item_append()
2751 * @deprecated use elm_object_item_text_set() instead
2753 EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
2756 * Return the data associated with a given toolbar widget item.
2758 * @param it The toolbar widget item handle.
2759 * @return The data associated with @p item.
2761 * @see elm_toolbar_item_data_set()
2763 * @deprecated use elm_object_item_data_get() instead.
2765 EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it);
2768 * Set the data associated with a given toolbar widget item.
2770 * @param it The toolbar widget item handle
2771 * @param data The new data pointer to set to @p item.
2773 * This sets new item data on @p item.
2775 * @warning The old data pointer won't be touched by this function, so
2776 * the user had better to free that old data himself/herself.
2778 * @deprecated use elm_object_item_data_set() instead.
2780 EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
2783 * Get a value whether toolbar item is disabled or not.
2785 * @param it The item.
2786 * @return The disabled state.
2788 * @see elm_toolbar_item_disabled_set() for more details.
2790 * @deprecated use elm_object_item_disabled_get() instead.
2792 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
2795 * Sets the disabled/enabled state of a toolbar item.
2797 * @param it The item.
2798 * @param disabled The disabled state.
2800 * A disabled item cannot be selected or unselected. It will also
2801 * change its appearance (generally greyed out). This sets the
2802 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
2805 * @deprecated use elm_object_item_disabled_set() instead.
2807 EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2810 * Change a toolbar's orientation
2811 * @param obj The toolbar object
2812 * @param vertical If @c EINA_TRUE, the toolbar is vertical
2813 * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
2814 * @deprecated use elm_toolbar_horizontal_set() instead.
2816 EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
2819 * Get a toolbar's orientation
2820 * @param obj The toolbar object
2821 * @return If @c EINA_TRUE, the toolbar is vertical
2822 * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
2823 * @deprecated use elm_toolbar_horizontal_get() instead.
2825 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj);
2828 * Set the function called when a toolbar item is freed.
2830 * @param it The item to set the callback on.
2831 * @param func The function called.
2833 * If there is a @p func, then it will be called prior item's memory release.
2834 * That will be called with the following arguments:
2836 * @li item's Evas object;
2839 * This way, a data associated to a toolbar item could be properly freed.
2841 * @deprecated Use elm_object_item_del_cb_set() instead
2843 EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2846 * Delete them item from the toolbar.
2848 * @param it The item of toolbar to be deleted.
2850 * @deprecated Use elm_object_item_del() instead
2851 * @see elm_toolbar_item_append()
2854 EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it);
2857 * Set the text to be shown in a given toolbar item's tooltips.
2859 * @param it toolbar item.
2860 * @param text The text to set in the content.
2862 * Setup the text as tooltip to object. The item can have only one tooltip,
2863 * so any previous tooltip data - set with this function or
2864 * elm_toolbar_item_tooltip_content_cb_set() - is removed.
2866 * @deprecated Use elm_object_item_tooltip_text_set() instead
2867 * @see elm_object_tooltip_text_set() for more details.
2870 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
2873 * Set the content to be shown in the tooltip item.
2875 * Setup the tooltip to item. The item can have only one tooltip,
2876 * so any previous tooltip data is removed. @p func(with @p data) will
2877 * be called every time that need show the tooltip and it should
2878 * return a valid Evas_Object. This object is then managed fully by
2879 * tooltip system and is deleted when the tooltip is gone.
2881 * @param it the toolbar item being attached a tooltip.
2882 * @param func the function used to create the tooltip contents.
2883 * @param data what to provide to @a func as callback data/context.
2884 * @param del_cb called when data is not needed anymore, either when
2885 * another callback replaces @a func, the tooltip is unset with
2886 * elm_toolbar_item_tooltip_unset() or the owner @a item
2887 * dies. This callback receives as the first parameter the
2888 * given @a data, and @c event_info is the item.
2890 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
2891 * @see elm_object_tooltip_content_cb_set() for more details.
2894 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
2897 * Unset tooltip from item.
2899 * @param it toolbar item to remove previously set tooltip.
2901 * Remove tooltip from item. The callback provided as del_cb to
2902 * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
2903 * it is not used anymore.
2905 * @deprecated Use elm_object_item_tooltip_unset() instead
2906 * @see elm_object_tooltip_unset() for more details.
2907 * @see elm_toolbar_item_tooltip_content_cb_set()
2910 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
2913 * Sets a different style for this item tooltip.
2915 * @note before you set a style you should define a tooltip with
2916 * elm_toolbar_item_tooltip_content_cb_set() or
2917 * elm_toolbar_item_tooltip_text_set()
2919 * @param it toolbar item with tooltip already set.
2920 * @param style the theme style to use (default, transparent, ...)
2922 * @deprecated Use elm_object_item_tooltip_style_set() instead
2923 * @see elm_object_tooltip_style_set() for more details.
2926 EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
2929 * Get the style for this item tooltip.
2931 * @param it toolbar item with tooltip already set.
2932 * @return style the theme style in use, defaults to "default". If the
2933 * object does not have a tooltip set, then NULL is returned.
2935 * @deprecated Use elm_object_item_style_get() instead
2936 * @see elm_object_tooltip_style_get() for more details.
2937 * @see elm_toolbar_item_tooltip_style_set()
2940 EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
2943 * Set the type of mouse pointer/cursor decoration to be shown,
2944 * when the mouse pointer is over the given toolbar widget item
2946 * @param it toolbar item to customize cursor on
2947 * @param cursor the cursor type's name
2949 * This function works analogously as elm_object_cursor_set(), but
2950 * here the cursor's changing area is restricted to the item's
2951 * area, and not the whole widget's. Note that that item cursors
2952 * have precedence over widget cursors, so that a mouse over an
2953 * item with custom cursor set will always show @b that cursor.
2955 * If this function is called twice for an object, a previously set
2956 * cursor will be unset on the second call.
2958 * @see elm_object_cursor_set()
2959 * @see elm_toolbar_item_cursor_get()
2960 * @see elm_toolbar_item_cursor_unset()
2962 * @deprecated use elm_object_item_cursor_set() instead
2965 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
2968 * Get the type of mouse pointer/cursor decoration set to be shown,
2969 * when the mouse pointer is over the given toolbar widget item
2971 * @param it toolbar item with custom cursor set
2972 * @return the cursor type's name or @c NULL, if no custom cursors
2973 * were set to @p item (and on errors)
2975 * @see elm_object_cursor_get()
2976 * @see elm_toolbar_item_cursor_set()
2977 * @see elm_toolbar_item_cursor_unset()
2979 * @deprecated Use elm_object_item_cursor_get() instead
2982 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
2985 * Unset any custom mouse pointer/cursor decoration set to be
2986 * shown, when the mouse pointer is over the given toolbar widget
2987 * item, thus making it show the @b default cursor again.
2989 * @param it a toolbar item
2991 * Use this call to undo any custom settings on this item's cursor
2992 * decoration, bringing it back to defaults (no custom style set).
2994 * @see elm_object_cursor_unset()
2995 * @see elm_toolbar_item_cursor_set()
2997 * @deprecated Use elm_object_item_cursor_unset() instead
3000 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3003 * Set a different @b style for a given custom cursor set for a
3006 * @param it toolbar item with custom cursor set
3007 * @param style the <b>theme style</b> to use (e.g. @c "default",
3008 * @c "transparent", etc)
3010 * This function only makes sense when one is using custom mouse
3011 * cursor decorations <b>defined in a theme file</b>, which can have,
3012 * given a cursor name/type, <b>alternate styles</b> on it. It
3013 * works analogously as elm_object_cursor_style_set(), but here
3014 * applies only to toolbar item objects.
3016 * @warning Before you set a cursor style you should have defined a
3017 * custom cursor previously on the item, with
3018 * elm_toolbar_item_cursor_set()
3020 * @see elm_toolbar_item_cursor_engine_only_set()
3021 * @see elm_toolbar_item_cursor_style_get()
3023 * @deprecated Use elm_object_item_cursor_style_set() instead
3026 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3029 * Get the current @b style set for a given toolbar item's custom
3032 * @param it toolbar item with custom cursor set.
3033 * @return style the cursor style in use. If the object does not
3034 * have a cursor set, then @c NULL is returned.
3036 * @see elm_toolbar_item_cursor_style_set() for more details
3038 * @deprecated Use elm_object_item_cursor_style_get() instead
3041 EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3044 * Set if the (custom)cursor for a given toolbar item should be
3045 * searched in its theme, also, or should only rely on the
3048 * @param it item with custom (custom) cursor already set on
3049 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3050 * only on those provided by the rendering engine, @c EINA_FALSE to
3051 * have them searched on the widget's theme, as well.
3053 * @note This call is of use only if you've set a custom cursor
3054 * for toolbar items, with elm_toolbar_item_cursor_set().
3056 * @note By default, cursors will only be looked for between those
3057 * provided by the rendering engine.
3059 * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3062 EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3065 * Get if the (custom) cursor for a given toolbar item is being
3066 * searched in its theme, also, or is only relying on the rendering
3069 * @param it a toolbar item
3070 * @return @c EINA_TRUE, if cursors are being looked for only on
3071 * those provided by the rendering engine, @c EINA_FALSE if they
3072 * are being searched on the widget's theme, as well.
3074 * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3076 * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3079 EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3082 * @brief Link a Elm_Payer with an Elm_Video object.
3084 * @param player the Elm_Player object.
3085 * @param video The Elm_Video object.
3087 * This mean that action on the player widget will affect the
3088 * video object and the state of the video will be reflected in
3089 * the player itself.
3091 * @see elm_player_add()
3092 * @see elm_video_add()
3093 * @deprecated use elm_object_part_content_set() instead
3096 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3099 * Set the label of item.
3101 * @param it The item of segment control.
3102 * @param label The label of item.
3104 * The label to be displayed by the item.
3105 * Label will be at right of the icon (if set).
3107 * If a label was passed as argument on item creation, with function
3108 * elm_control_segment_item_add(), it will be already
3109 * displayed by the item.
3111 * @see elm_segment_control_item_label_get()
3112 * @see elm_segment_control_item_add()
3113 * @deprecated Use elm_object_item_text_set() instead
3116 EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3120 * Set the icon associated to the item.
3122 * @param it The segment control item.
3123 * @param icon The icon object to associate with @p it.
3125 * The icon object to use at left side of the item. An
3126 * icon can be any Evas object, but usually it is an icon created
3127 * with elm_icon_add().
3129 * Once the icon object is set, a previously set one will be deleted.
3130 * @warning Setting the same icon for two items will cause the icon to
3131 * disappear from the first item.
3133 * If an icon was passed as argument on item creation, with function
3134 * elm_segment_control_item_add(), it will be already
3135 * associated to the item.
3137 * @see elm_segment_control_item_add()
3138 * @see elm_segment_control_item_icon_get()
3139 * @deprecated Use elm_object_item_part_content_set() instead
3142 EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3145 * Remove a segment control item from its parent, deleting it.
3147 * @param it The item to be removed.
3149 * Items can be added with elm_segment_control_item_add() or
3150 * elm_segment_control_item_insert_at().
3152 * @deprecated Use elm_object_item_del() instead
3154 EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it);
3159 * @param obj The multibuttonentry object
3160 * @return The label, or NULL if none
3162 * @deprecated Use elm_object_text_get() instead
3165 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj);
3170 * @param obj The multibuttonentry object
3171 * @param label The text label string
3173 * @deprecated Use elm_object_text_set() instead
3176 EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3179 * Get the label of a given item
3181 * @param it The item
3182 * @return The label of a given item, or NULL if none
3184 * @deprecated Use elm_object_item_text_get() instead
3187 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3190 * Set the label of a given item
3192 * @param it The item
3193 * @param str The text label string
3195 * @deprecated Use elm_object_item_text_set() instead
3197 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3200 * Delete a given item
3202 * @param it The item
3204 * @deprecated Use elm_object_item_del() instead
3207 EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it);
3210 * @brief Delete the given item instantly.
3212 * @param it The naviframe item
3214 * This just deletes the given item from the naviframe item list instantly.
3215 * So this would not emit any signals for view transitions but just change
3216 * the current view if the given item is a top one.
3218 * @deprecated Use elm_object_item_del() instead
3220 EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it);
3225 * Sets the disabled/enabled state of a list item.
3227 * @param it The item.
3228 * @param disabled The disabled state.
3230 * A disabled item cannot be selected or unselected. It will also
3231 * change its appearance (generally greyed out). This sets the
3232 * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3235 * @deprecated Use elm_object_item_disabled_set() instead
3238 EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3241 * Get a value whether list item is disabled or not.
3243 * @param it The item.
3244 * @return The disabled state.
3246 * @see elm_list_item_disabled_set() for more details.
3248 * @deprecated Use elm_object_item_disabled_get() instead
3251 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it);
3254 * Set the function called when a list item is freed.
3256 * @param it The item to set the callback on
3257 * @param func The function called
3259 * If there is a @p func, then it will be called prior item's memory release.
3260 * That will be called with the following arguments:
3262 * @li item's Evas object;
3265 * This way, a data associated to a list item could be properly freed.
3267 * @deprecated Please use elm_object_item_del_cb_set() instead.
3270 EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3273 * Get the data associated to the item.
3275 * @param it The list item
3276 * @return The data associated to @p item
3278 * The return value is a pointer to data associated to @p item when it was
3279 * created, with function elm_list_item_append() or similar. If no data
3280 * was passed as argument, it will return @c NULL.
3282 * @see elm_list_item_append()
3284 * @deprecated Please use elm_object_item_data_get() instead.
3287 EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it);
3290 * Get the left side icon associated to the item.
3292 * @param it The list item
3293 * @return The left side icon associated to @p item
3295 * The return value is a pointer to the icon associated to @p item when
3297 * created, with function elm_list_item_append() or similar, or later
3298 * with function elm_list_item_icon_set(). If no icon
3299 * was passed as argument, it will return @c NULL.
3301 * @see elm_list_item_append()
3302 * @see elm_list_item_icon_set()
3304 * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3306 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it);
3309 * Set the left side icon associated to the item.
3311 * @param it The list item
3312 * @param icon The left side icon object to associate with @p item
3314 * The icon object to use at left side of the item. An
3315 * icon can be any Evas object, but usually it is an icon created
3316 * with elm_icon_add().
3318 * Once the icon object is set, a previously set one will be deleted.
3319 * @warning Setting the same icon for two items will cause the icon to
3320 * disappear from the first item.
3322 * If an icon was passed as argument on item creation, with function
3323 * elm_list_item_append() or similar, it will be already
3324 * associated to the item.
3326 * @see elm_list_item_append()
3327 * @see elm_list_item_icon_get()
3329 * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3331 EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3334 * Get the right side icon associated to the item.
3336 * @param it The list item
3337 * @return The right side icon associated to @p item
3339 * The return value is a pointer to the icon associated to @p item when
3341 * created, with function elm_list_item_append() or similar, or later
3342 * with function elm_list_item_icon_set(). If no icon
3343 * was passed as argument, it will return @c NULL.
3345 * @see elm_list_item_append()
3346 * @see elm_list_item_icon_set()
3348 * @deprecated Please use elm_object_item_part_content_get(item, "end");
3350 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it);
3353 * Set the right side icon associated to the item.
3355 * @param it The list item
3356 * @param end The right side icon object to associate with @p item
3358 * The icon object to use at right side of the item. An
3359 * icon can be any Evas object, but usually it is an icon created
3360 * with elm_icon_add().
3362 * Once the icon object is set, a previously set one will be deleted.
3363 * @warning Setting the same icon for two items will cause the icon to
3364 * disappear from the first item.
3366 * If an icon was passed as argument on item creation, with function
3367 * elm_list_item_append() or similar, it will be already
3368 * associated to the item.
3370 * @see elm_list_item_append()
3371 * @see elm_list_item_end_get()
3373 * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3375 EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3378 * Get the label of item.
3380 * @param it The item of list.
3381 * @return The label of item.
3383 * The return value is a pointer to the label associated to @p item when
3384 * it was created, with function elm_list_item_append(), or later
3385 * with function elm_list_item_label_set. If no label
3386 * was passed as argument, it will return @c NULL.
3388 * @see elm_list_item_label_set() for more details.
3389 * @see elm_list_item_append()
3391 * @deprecated Please use elm_object_item_text_get(item);
3393 EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it);
3396 * Set the label of item.
3398 * @param it The item of list.
3399 * @param text The label of item.
3401 * The label to be displayed by the item.
3402 * Label will be placed between left and right side icons (if set).
3404 * If a label was passed as argument on item creation, with function
3405 * elm_list_item_append() or similar, it will be already
3406 * displayed by the item.
3408 * @see elm_list_item_label_get()
3409 * @see elm_list_item_append()
3411 * @deprecated Please use elm_object_item_text_set(item, text);
3413 EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3416 * Set the text to be shown in a given list item's tooltips.
3418 * @param it Target item.
3419 * @param text The text to set in the content.
3421 * Setup the text as tooltip to object. The item can have only one tooltip,
3422 * so any previous tooltip data - set with this function or
3423 * elm_list_item_tooltip_content_cb_set() - is removed.
3425 * @deprecated Use elm_object_item_tooltip_text_set() instead
3426 * @see elm_object_tooltip_text_set() for more details.
3429 EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3432 * @brief Disable size restrictions on an object's tooltip
3433 * @param it The tooltip's anchor object
3434 * @param disable If EINA_TRUE, size restrictions are disabled
3435 * @return EINA_FALSE on failure, EINA_TRUE on success
3437 * This function allows a tooltip to expand beyond its parent window's canvas.
3438 * It will instead be limited only by the size of the display.
3440 * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3443 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3446 * @brief Retrieve size restriction state of an object's tooltip
3447 * @param obj The tooltip's anchor object
3448 * @return If EINA_TRUE, size restrictions are disabled
3450 * This function returns whether a tooltip is allowed to expand beyond
3451 * its parent window's canvas.
3452 * It will instead be limited only by the size of the display.
3454 * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3457 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3460 * Set the content to be shown in the tooltip item.
3462 * Setup the tooltip to item. The item can have only one tooltip,
3463 * so any previous tooltip data is removed. @p func(with @p data) will
3464 * be called every time that need show the tooltip and it should
3465 * return a valid Evas_Object. This object is then managed fully by
3466 * tooltip system and is deleted when the tooltip is gone.
3468 * @param it the list item being attached a tooltip.
3469 * @param func the function used to create the tooltip contents.
3470 * @param data what to provide to @a func as callback data/context.
3471 * @param del_cb called when data is not needed anymore, either when
3472 * another callback replaces @a func, the tooltip is unset with
3473 * elm_list_item_tooltip_unset() or the owner @a item
3474 * dies. This callback receives as the first parameter the
3475 * given @a data, and @c event_info is the item.
3477 * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3479 * @see elm_object_tooltip_content_cb_set() for more details.
3482 EINA_DEPRECATED EAPI void elm_list_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
3485 * Unset tooltip from item.
3487 * @param it list item to remove previously set tooltip.
3489 * Remove tooltip from item. The callback provided as del_cb to
3490 * elm_list_item_tooltip_content_cb_set() will be called to notify
3491 * it is not used anymore.
3493 * @deprecated Use elm_object_item_tooltip_unset() instead
3494 * @see elm_object_tooltip_unset() for more details.
3495 * @see elm_list_item_tooltip_content_cb_set()
3498 EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it);
3501 * Sets a different style for this item tooltip.
3503 * @note before you set a style you should define a tooltip with
3504 * elm_list_item_tooltip_content_cb_set() or
3505 * elm_list_item_tooltip_text_set()
3507 * @param it list item with tooltip already set.
3508 * @param style the theme style to use (default, transparent, ...)
3511 * @deprecated Use elm_object_item_tooltip_style_set() instead
3512 * @see elm_object_tooltip_style_set() for more details.
3515 EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3518 * Get the style for this item tooltip.
3520 * @param it list item with tooltip already set.
3521 * @return style the theme style in use, defaults to "default". If the
3522 * object does not have a tooltip set, then NULL is returned.
3524 * @deprecated Use elm_object_item_tooltip_style_get() instead
3526 * @see elm_object_tooltip_style_get() for more details.
3527 * @see elm_list_item_tooltip_style_set()
3530 EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
3533 * Set the type of mouse pointer/cursor decoration to be shown,
3534 * when the mouse pointer is over the given list widget item
3536 * @param it list item to customize cursor on
3537 * @param cursor the cursor type's name
3539 * This function works analogously as elm_object_cursor_set(), but
3540 * here the cursor's changing area is restricted to the item's
3541 * area, and not the whole widget's. Note that that item cursors
3542 * have precedence over widget cursors, so that a mouse over an
3543 * item with custom cursor set will always show @b that cursor.
3545 * If this function is called twice for an object, a previously set
3546 * cursor will be unset on the second call.
3548 * @see elm_object_cursor_set()
3549 * @see elm_list_item_cursor_get()
3550 * @see elm_list_item_cursor_unset()
3552 * @deprecated Please use elm_object_item_cursor_set() instead
3554 EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3557 * Get the type of mouse pointer/cursor decoration set to be shown,
3558 * when the mouse pointer is over the given list widget item
3560 * @param it list item with custom cursor set
3561 * @return the cursor type's name or @c NULL, if no custom cursors
3562 * were set to @p item (and on errors)
3564 * @see elm_object_cursor_get()
3565 * @see elm_list_item_cursor_set()
3566 * @see elm_list_item_cursor_unset()
3568 * @deprecated Please use elm_object_item_cursor_get() instead
3570 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it);
3573 * Unset any custom mouse pointer/cursor decoration set to be
3574 * shown, when the mouse pointer is over the given list widget
3575 * item, thus making it show the @b default cursor again.
3577 * @param it a list item
3579 * Use this call to undo any custom settings on this item's cursor
3580 * decoration, bringing it back to defaults (no custom style set).
3582 * @see elm_object_cursor_unset()
3583 * @see elm_list_item_cursor_set()
3585 * @deprecated Please use elm_list_item_cursor_unset() instead
3587 EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it);
3590 * Set a different @b style for a given custom cursor set for a
3593 * @param it list item with custom cursor set
3594 * @param style the <b>theme style</b> to use (e.g. @c "default",
3595 * @c "transparent", etc)
3597 * This function only makes sense when one is using custom mouse
3598 * cursor decorations <b>defined in a theme file</b>, which can have,
3599 * given a cursor name/type, <b>alternate styles</b> on it. It
3600 * works analogously as elm_object_cursor_style_set(), but here
3601 * applies only to list item objects.
3603 * @warning Before you set a cursor style you should have defined a
3604 * custom cursor previously on the item, with
3605 * elm_list_item_cursor_set()
3607 * @see elm_list_item_cursor_engine_only_set()
3608 * @see elm_list_item_cursor_style_get()
3610 * @deprecated Please use elm_list_item_cursor_style_set() instead
3612 EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3615 * Get the current @b style set for a given list item's custom
3618 * @param it list item with custom cursor set.
3619 * @return style the cursor style in use. If the object does not
3620 * have a cursor set, then @c NULL is returned.
3622 * @see elm_list_item_cursor_style_set() for more details
3624 * @deprecated Please use elm_list_item_cursor_style_get() instead
3626 EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
3629 * Set if the (custom)cursor for a given list item should be
3630 * searched in its theme, also, or should only rely on the
3633 * @param it item with custom (custom) cursor already set on
3634 * @param engine_only Use @c EINA_TRUE to have cursors looked for
3635 * only on those provided by the rendering engine, @c EINA_FALSE to
3636 * have them searched on the widget's theme, as well.
3638 * @note This call is of use only if you've set a custom cursor
3639 * for list items, with elm_list_item_cursor_set().
3641 * @note By default, cursors will only be looked for between those
3642 * provided by the rendering engine.
3644 * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
3646 EINA_DEPRECATED EAPI void elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3649 * Get if the (custom) cursor for a given list item is being
3650 * searched in its theme, also, or is only relying on the rendering
3653 * @param it a list item
3654 * @return @c EINA_TRUE, if cursors are being looked for only on
3655 * those provided by the rendering engine, @c EINA_FALSE if they
3656 * are being searched on the widget's theme, as well.
3658 * @see elm_list_item_cursor_engine_only_set(), for more details
3660 * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
3662 EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
3665 * Delete the item from the list.
3667 * @param it The item of list to be deleted.
3669 * If deleting all list items is required, elm_list_clear()
3670 * should be used instead of getting items list and deleting each one.
3672 * @see elm_list_clear()
3673 * @see elm_list_item_append()
3674 * @see elm_widget_item_del_cb_set()
3675 * @deprecated Use elm_object_item_del() instead
3678 EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it);
3681 * Set the shrink state of toolbar @p obj.
3683 * @param obj The toolbar object.
3684 * @param shrink_mode Toolbar's items display behavior.
3686 * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
3687 * but will enforce a minimum size so all the items will fit, won't scroll
3688 * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
3689 * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
3690 * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
3692 * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
3694 EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
3697 * Get the shrink mode of toolbar @p obj.
3699 * @param obj The toolbar object.
3700 * @return Toolbar's items display behavior.
3702 * @see elm_toolbar_shrink_mode_set() for details.
3704 * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
3706 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj);
3709 * This sets a widget to be displayed to the left of a scrolled entry.
3711 * @param obj The scrolled entry object
3712 * @param icon The widget to display on the left side of the scrolled
3715 * @note A previously set widget will be destroyed.
3716 * @note If the object being set does not have minimum size hints set,
3717 * it won't get properly displayed.
3719 * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
3720 * @see elm_entry_end_set()
3722 EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
3725 * Gets the leftmost widget of the scrolled entry. This object is
3726 * owned by the scrolled entry and should not be modified.
3728 * @param obj The scrolled entry object
3729 * @return the left widget inside the scroller
3731 * @deprecated Use elm_object_part_content_get(entry, "icon") instead
3733 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj);
3736 * Unset the leftmost widget of the scrolled entry, unparenting and
3739 * @param obj The scrolled entry object
3740 * @return the previously set icon sub-object of this entry, on
3743 * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
3744 * @see elm_entry_icon_set()
3746 EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj);
3749 * This sets a widget to be displayed to the end of a scrolled entry.
3751 * @param obj The scrolled entry object
3752 * @param end The widget to display on the right side of the scrolled
3755 * @note A previously set widget will be destroyed.
3756 * @note If the object being set does not have minimum size hints set,
3757 * it won't get properly displayed.
3759 * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
3760 * @see elm_entry_icon_set
3762 EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
3765 * Gets the endmost widget of the scrolled entry. This object is owned
3766 * by the scrolled entry and should not be modified.
3768 * @param obj The scrolled entry object
3769 * @return the right widget inside the scroller
3771 * @deprecated Use elm_object_part_content_get(entry, "end") instead
3773 EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj);
3776 * Unset the endmost widget of the scrolled entry, unparenting and
3779 * @param obj The scrolled entry object
3780 * @return the previously set icon sub-object of this entry, on
3783 * @deprecated Use elm_object_part_content_unset(entry, "end") instead
3784 * @see elm_entry_icon_set()
3786 EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj);
3789 * Set route service to be used. By default used source is
3790 * #ELM_MAP_ROUTE_SOURCE_YOURS.
3792 * @see elm_map_route_source_set()
3793 * @see elm_map_route_source_get()
3798 ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
3799 ELM_MAP_ROUTE_SOURCE_MONAV, /**< MoNav offers exact routing without heuristic assumptions. Its routing core is based on Contraction Hierarchies. It's not working with Map yet. */
3800 ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
3801 ELM_MAP_ROUTE_SOURCE_LAST
3802 } Elm_Map_Route_Sources;
3805 * Convert a pixel coordinate into a rotated pixel coordinate.
3807 * @param obj The map object.
3808 * @param x horizontal coordinate of the point to rotate.
3809 * @param y vertical coordinate of the point to rotate.
3810 * @param cx rotation's center horizontal position.
3811 * @param cy rotation's center vertical position.
3812 * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
3813 * @param xx Pointer where to store rotated x.
3814 * @param yy Pointer where to store rotated y.
3816 * @deprecated Use elm_map_canvas_to_geo_convert() instead
3818 EINA_DEPRECATED EAPI void elm_map_utils_rotate_coord(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, const Evas_Coord cx, const Evas_Coord cy, const double degree, Evas_Coord *xx, Evas_Coord *yy);
3821 * Convert a pixel coordinate (x,y) into a geographic coordinate
3822 * (longitude, latitude).
3824 * @param obj The map object.
3825 * @param x the coordinate.
3826 * @param y the coordinate.
3827 * @param size the size in pixels of the map.
3828 * The map is a square and generally his size is : pow(2.0, zoom)*256.
3829 * @param lon Pointer to store the longitude that correspond to x.
3830 * @param lat Pointer to store the latitude that correspond to y.
3832 * @note Origin pixel point is the top left corner of the viewport.
3833 * Map zoom and size are taken on account.
3835 * @see elm_map_utils_convert_geo_into_coord() if you need the inverse.
3837 * @deprecated Use elm_map_canvas_to_geo_convert() instead
3839 EINA_DEPRECATED EAPI void elm_map_utils_convert_coord_into_geo(const Evas_Object *obj, int x, int y, int size, double *lon, double *lat);
3842 * Convert a geographic coordinate (longitude, latitude) into a pixel
3843 * coordinate (x, y).
3845 * @param obj The map object.
3846 * @param lon the longitude.
3847 * @param lat the latitude.
3848 * @param size the size in pixels of the map. The map is a square
3849 * and generally his size is : pow(2.0, zoom)*256.
3850 * @param x Pointer to store the horizontal pixel coordinate that
3851 * correspond to the longitude.
3852 * @param y Pointer to store the vertical pixel coordinate that
3853 * correspond to the latitude.
3855 * @note Origin pixel point is the top left corner of the viewport.
3856 * Map zoom and size are taken on account.
3858 * @see elm_map_utils_convert_coord_into_geo() if you need the inverse.
3860 * @deprecatedUse Use elm_map_canvas_to_geo_convert() instead
3862 EINA_DEPRECATED EAPI void elm_map_utils_convert_geo_into_coord(const Evas_Object *obj, double lon, double lat, int size, int *x, int *y);
3865 * Get the information of downloading status.
3867 * @param obj The map object.
3868 * @param try_num Pointer to store number of tiles being downloaded.
3869 * @param finish_num Pointer to store number of tiles successfully
3872 * This gets the current downloading status for the map object, the number
3873 * of tiles being downloaded and the number of tiles already downloaded.
3875 * @deprecatedUse Use elm_map_tile_load_status_get() instead
3877 EINA_DEPRECATED EAPI void elm_map_utils_downloading_status_get(const Evas_Object *obj, int *try_num, int *finish_num);
3880 * Convert a geographic coordinate (longitude, latitude) into a name
3883 * @param obj The map object.
3884 * @param lon the longitude.
3885 * @param lat the latitude.
3886 * @return name A #Elm_Map_Name handle for this coordinate.
3888 * To get the string for this address, elm_map_name_address_get()
3891 * @see elm_map_utils_convert_name_into_coord() if you need the inverse.
3892 * @deprecatedUse Use elm_map_name_add() instead
3895 EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_coord_into_name(const Evas_Object *obj, double lon, double lat);
3898 * Convert a name (address) into a geographic coordinate
3899 * (longitude, latitude).
3901 * @param obj The map object.
3902 * @param address The address.
3903 * @return name A #Elm_Map_Name handle for this address.
3905 * To get the longitude and latitude, elm_map_name_region_get()
3908 * @see elm_map_utils_convert_coord_into_name() if you need the inverse.
3909 * @deprecatedUse Use elm_map_name_geo_request() instead
3912 EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_name_into_coord(const Evas_Object *obj, char *address);
3915 * Convert canvas coordinates into a geographic coordinate
3916 * (longitude, latitude).
3918 * @param obj The map object.
3919 * @param x horizontal coordinate of the point to convert.
3920 * @param y vertical coordinate of the point to convert.
3921 * @param lon A pointer to the longitude.
3922 * @param lat A pointer to the latitude.
3924 * This gets longitude and latitude from canvas x, y coordinates. The canvas
3925 * coordinates mean x, y coordinate from current viewport.
3927 * see elm_map_rotate_get()
3928 * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
3931 EAPI void elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat);
3934 * Get the current geographic coordinates of the map.
3936 * @param obj The map object.
3937 * @param lon Pointer to store longitude.
3938 * @param lat Pointer to store latitude.
3940 * This gets the current center coordinates of the map object. It can be
3941 * set by elm_map_region_bring_in() and elm_map_region_show().
3943 * @see elm_map_region_bring_in()
3944 * @see elm_map_region_show()
3946 * @deprecated Use elm_map_region_get() instead
3948 EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
3951 * Animatedly bring in given coordinates to the center of the map.
3953 * @param obj The map object.
3954 * @param lon Longitude to center at.
3955 * @param lat Latitude to center at.
3957 * This causes map to jump to the given @p lat and @p lon coordinates
3958 * and show it (by scrolling) in the center of the viewport, if it is not
3959 * already centered. This will use animation to do so and take a period
3960 * of time to complete.
3962 * @see elm_map_region_show() for a function to avoid animation.
3963 * @see elm_map_region_get()
3965 * @deprecated Use elm_map_region_bring_in() instead
3967 EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
3970 * Show the given coordinates at the center of the map, @b immediately.
3972 * @param obj The map object.
3973 * @param lon Longitude to center at.
3974 * @param lat Latitude to center at.
3976 * This causes map to @b redraw its viewport's contents to the
3977 * region containing the given @p lat and @p lon, that will be moved to the
3978 * center of the map.
3980 * @see elm_map_region_bring_in() for a function to move with animation.
3981 * @see elm_map_region_get()
3983 * @deprecated Use elm_map_region_show() instead
3985 EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
3988 * Set the minimum zoom of the source.
3990 * @param obj The map object.
3991 * @param zoom New minimum zoom value to be used.
3993 * By default, it's 0.
3995 * @deprecated Use elm_map_zoom_min_set() instead
3997 EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4000 * Get the minimum zoom of the source.
4002 * @param obj The map object.
4003 * @return Returns the minimum zoom of the source.
4005 * @see elm_map_zoom_min_set() for details.
4007 * @deprecated Use elm_map_zoom_min_get() instead
4009 EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj);
4012 * Set the maximum zoom of the source.
4014 * @param obj The map object.
4015 * @param zoom New maximum zoom value to be used.
4017 * By default, it's 18.
4019 * @deprecated Use elm_map_zoom_max_set() instead
4021 EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4024 * Get the maximum zoom of the source.
4026 * @param obj The map object.
4027 * @return Returns the maximum zoom of the source.
4029 * @see elm_map_zoom_min_set() for details.
4031 * @deprecated Use elm_map_zoom_max_get() instead
4033 EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj);
4037 * Get the list of available sources.
4039 * @param obj The map object.
4040 * @return The source names list.
4042 * It will provide a list with all available sources, that can be set as
4043 * current source with elm_map_source_name_set(), or get with
4044 * elm_map_source_name_get().
4046 * Available sources:
4052 * @see elm_map_source_name_set() for more details.
4053 * @see elm_map_source_name_get()
4054 * @deprecated Use elm_map_sources_get() instead
4057 EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj);
4060 * Set the source of the map.
4062 * @param obj The map object.
4063 * @param source_name The source to be used.
4065 * Map widget retrieves images that composes the map from a web service.
4066 * This web service can be set with this method.
4068 * A different service can return a different maps with different
4069 * information and it can use different zoom values.
4071 * The @p source_name need to match one of the names provided by
4072 * elm_map_source_names_get().
4074 * The current source can be get using elm_map_source_name_get().
4076 * @see elm_map_source_names_get()
4077 * @see elm_map_source_name_get()
4078 * @deprecated Use elm_map_source_set() instead
4081 EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name);
4084 * Get the name of currently used source.
4086 * @param obj The map object.
4087 * @return Returns the name of the source in use.
4089 * @see elm_map_source_name_set() for more details.
4090 * @deprecated Use elm_map_source_get() instead
4093 EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj);
4096 * Set the source of the route service to be used by the map.
4098 * @param obj The map object.
4099 * @param source The route service to be used, being it one of
4100 * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4101 * and #ELM_MAP_ROUTE_SOURCE_ORS.
4103 * Each one has its own algorithm, so the route retrieved may
4104 * differ depending on the source route. Now, only the default is working.
4106 * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4107 * http://www.yournavigation.org/.
4109 * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4110 * assumptions. Its routing core is based on Contraction Hierarchies.
4112 * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4114 * @see elm_map_route_source_get().
4115 * @deprecated Use elm_map_source_set() instead
4118 EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4121 * Get the current route source.
4123 * @param obj The map object.
4124 * @return The source of the route service used by the map.
4126 * @see elm_map_route_source_set() for details.
4127 * @deprecated Use elm_map_source_get() instead
4130 EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4133 * Add a new marker to the map object.
4135 * @param obj The map object.
4136 * @param lon The longitude of the marker.
4137 * @param lat The latitude of the marker.
4138 * @param clas The class, to use when marker @b isn't grouped to others.
4139 * @param clas_group The class group, to use when marker is grouped to others
4140 * @param data The data passed to the callbacks.
4142 * @return The created marker or @c NULL upon failure.
4144 * A marker will be created and shown in a specific point of the map, defined
4145 * by @p lon and @p lat.
4147 * It will be displayed using style defined by @p class when this marker
4148 * is displayed alone (not grouped). A new class can be created with
4149 * elm_map_marker_class_new().
4151 * If the marker is grouped to other markers, it will be displayed with
4152 * style defined by @p class_group. Markers with the same group are grouped
4153 * if they are close. A new group class can be created with
4154 * elm_map_marker_group_class_new().
4156 * Markers created with this method can be deleted with
4157 * elm_map_marker_remove().
4159 * A marker can have associated content to be displayed by a bubble,
4160 * when a user click over it, as well as an icon. These objects will
4161 * be fetch using class' callback functions.
4163 * @see elm_map_marker_class_new()
4164 * @see elm_map_marker_group_class_new()
4165 * @see elm_map_marker_remove()
4167 * @deprecated Use Elm_Map_Overlay instead
4169 EINA_DEPRECATED EAPI Elm_Map_Marker *elm_map_marker_add(Evas_Object *obj, double lon, double lat, Elm_Map_Marker_Class *clas, Elm_Map_Group_Class *clas_group, void *data);
4172 * Set the maximum numbers of markers' content to be displayed in a group.
4174 * @param obj The map object.
4175 * @param max The maximum numbers of items displayed in a bubble.
4177 * A bubble will be displayed when the user clicks over the group,
4178 * and will place the content of markers that belong to this group
4181 * A group can have a long list of markers, consequently the creation
4182 * of the content of the bubble can be very slow.
4184 * In order to avoid this, a maximum number of items is displayed
4187 * By default this number is 30.
4189 * Marker with the same group class are grouped if they are close.
4191 * @see elm_map_marker_add()
4193 * @deprecated Use Elm_Map_Overlay instead
4195 EINA_DEPRECATED EAPI void elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4198 * Remove a marker from the map.
4200 * @param marker The marker to remove.
4202 * @see elm_map_marker_add()
4204 * @deprecated Use Elm_Map_Overlay instead
4206 EINA_DEPRECATED EAPI void elm_map_marker_remove(Elm_Map_Marker *marker);
4209 * Get the current coordinates of the marker.
4211 * @param marker marker.
4212 * @param lat Pointer to store the marker's latitude.
4213 * @param lon Pointer to store the marker's longitude.
4215 * These values are set when adding markers, with function
4216 * elm_map_marker_add().
4218 * @see elm_map_marker_add()
4220 * @deprecated Use Elm_Map_Overlay instead
4222 EINA_DEPRECATED EAPI void elm_map_marker_region_get(const Elm_Map_Marker *marker, double *lon, double *lat);
4225 * Animatedly bring in given marker to the center of the map.
4227 * @param marker The marker to center at.
4229 * This causes map to jump to the given @p marker's coordinates
4230 * and show it (by scrolling) in the center of the viewport, if it is not
4231 * already centered. This will use animation to do so and take a period
4232 * of time to complete.
4234 * @see elm_map_marker_show() for a function to avoid animation.
4235 * @see elm_map_marker_region_get()
4237 * @deprecated Use Elm_Map_Overlay instead
4239 EINA_DEPRECATED EAPI void elm_map_marker_bring_in(Elm_Map_Marker *marker);
4242 * Show the given marker at the center of the map, @b immediately.
4244 * @param marker The marker to center at.
4246 * This causes map to @b redraw its viewport's contents to the
4247 * region containing the given @p marker's coordinates, that will be
4248 * moved to the center of the map.
4250 * @see elm_map_marker_bring_in() for a function to move with animation.
4251 * @see elm_map_markers_list_show() if more than one marker need to be
4253 * @see elm_map_marker_region_get()
4255 * @deprecated Use Elm_Map_Overlay instead
4257 EINA_DEPRECATED EAPI void elm_map_marker_show(Elm_Map_Marker *marker);
4260 * Move and zoom the map to display a list of markers.
4262 * @param markers A list of #Elm_Map_Marker handles.
4264 * The map will be centered on the center point of the markers in the list.
4265 * Then the map will be zoomed in order to fit the markers using the maximum
4266 * zoom which allows display of all the markers.
4268 * @warning All the markers should belong to the same map object.
4270 * @see elm_map_marker_show() to show a single marker.
4271 * @see elm_map_marker_bring_in()
4273 * @deprecated Use Elm_Map_Overlay instead
4275 EINA_DEPRECATED EAPI void elm_map_markers_list_show(Eina_List *markers);
4278 * Set to show markers during zoom level changes or not.
4280 * @param obj The map object.
4281 * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4284 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4287 * The default is off.
4289 * This will stop zooming using animation, changing zoom levels will
4290 * change instantly. This will stop any existing animations that are running.
4292 * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4295 * The default is off.
4297 * Enabling it will force the map to stop displaying the markers during
4298 * zoom level changes. Set to on if you have a large number of markers.
4300 * @see elm_map_paused_markers_get()
4302 * @deprecated Use Elm_Map_Overlay instead
4304 EINA_DEPRECATED EAPI void elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4307 * Get a value whether markers will be displayed on zoom level changes or not
4309 * @param obj The map object.
4310 * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4311 * indicates it will.
4313 * This gets the current markers paused state for the map object.
4315 * @see elm_map_paused_markers_set() for details.
4317 * @deprecated Use Elm_Map_Overlay instead
4319 EINA_DEPRECATED EAPI Eina_Bool elm_map_paused_markers_get(const Evas_Object *obj);
4322 * Get the Evas object returned by the Elm_Map_Marker_Get_Func callback
4324 * @param marker The marker which content should be returned.
4325 * @return Return the evas object if it exists, else @c NULL.
4327 * To set callback function #Elm_Map_Marker_Get_Func for the marker class,
4328 * elm_map_marker_class_get_cb_set() should be used.
4330 * This content is what will be inside the bubble that will be displayed
4331 * when an user clicks over the marker.
4333 * This returns the actual Evas object used to be placed inside
4334 * the bubble. This may be @c NULL, as it may
4335 * not have been created or may have been deleted, at any time, by
4336 * the map. <b>Do not modify this object</b> (move, resize,
4337 * show, hide, etc.), as the map is controlling it. This
4338 * function is for querying, emitting custom signals or hooking
4339 * lower level callbacks for events on that object. Do not delete
4340 * this object under any circumstances.
4342 * @deprecated Use Elm_Map_Overlay instead
4344 EINA_DEPRECATED EAPI Evas_Object *elm_map_marker_object_get(const Elm_Map_Marker *marker);
4349 * @param marker The marker to be updated.
4351 * If a content is set to this marker, it will call function to delete it,
4352 * #Elm_Map_Marker_Del_Func, and then will fetch the content again with
4353 * #Elm_Map_Marker_Get_Func.
4355 * These functions are set for the marker class with
4356 * elm_map_marker_class_get_cb_set() and elm_map_marker_class_del_cb_set().
4358 * @deprecated Use Elm_Map_Overlay instead
4360 EINA_DEPRECATED EAPI void elm_map_marker_update(Elm_Map_Marker *marker);
4363 * Close all the bubbles opened by the user.
4365 * @param obj The map object.
4367 * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4368 * when the user clicks on a marker.
4370 * This functions is set for the marker class with
4371 * elm_map_marker_class_get_cb_set().
4373 * @deprecated Use Elm_Map_Overlay instead
4375 EINA_DEPRECATED EAPI void elm_map_bubbles_close(Evas_Object *obj);
4378 * Create a new group class.
4380 * @param obj The map object.
4381 * @return Returns the new group class.
4383 * Each marker must be associated to a group class. Markers in the same
4384 * group are grouped if they are close.
4386 * The group class defines the style of the marker when a marker is grouped
4387 * to others markers. When it is alone, another class will be used.
4389 * A group class will need to be provided when creating a marker with
4390 * elm_map_marker_add().
4392 * Some properties and functions can be set by class, as:
4393 * - style, with elm_map_group_class_style_set()
4394 * - data - to be associated to the group class. It can be set using
4395 * elm_map_group_class_data_set().
4396 * - min zoom to display markers, set with
4397 * elm_map_group_class_zoom_displayed_set().
4398 * - max zoom to group markers, set using
4399 * elm_map_group_class_zoom_grouped_set().
4400 * - visibility - set if markers will be visible or not, set with
4401 * elm_map_group_class_hide_set().
4402 * - #Elm_Map_Group_Icon_Get_Func - used to fetch icon for markers group classes.
4403 * It can be set using elm_map_group_class_icon_cb_set().
4405 * @see elm_map_marker_add()
4406 * @see elm_map_group_class_style_set()
4407 * @see elm_map_group_class_data_set()
4408 * @see elm_map_group_class_zoom_displayed_set()
4409 * @see elm_map_group_class_zoom_grouped_set()
4410 * @see elm_map_group_class_hide_set()
4411 * @see elm_map_group_class_icon_cb_set()
4413 * @deprecated Use Elm_Map_Overlay instead
4415 EINA_DEPRECATED EAPI Elm_Map_Group_Class *elm_map_group_class_new(Evas_Object *obj);
4418 * Set the marker's style of a group class.
4420 * @param clas The group class.
4421 * @param style The style to be used by markers.
4423 * Each marker must be associated to a group class, and will use the style
4424 * defined by such class when grouped to other markers.
4426 * The following styles are provided by default theme:
4427 * @li @c radio - blue circle
4428 * @li @c radio2 - green circle
4431 * @see elm_map_group_class_new() for more details.
4432 * @see elm_map_marker_add()
4434 * @deprecated Use Elm_Map_Overlay instead
4436 EINA_DEPRECATED EAPI void elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4439 * Set the icon callback function of a group class.
4441 * @param clas The group class.
4442 * @param icon_get The callback function that will return the icon.
4444 * Each marker must be associated to a group class, and it can display a
4445 * custom icon. The function @p icon_get must return this icon.
4447 * @see elm_map_group_class_new() for more details.
4448 * @see elm_map_marker_add()
4450 * @deprecated Use Elm_Map_Overlay instead
4452 EINA_DEPRECATED EAPI void elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4455 * Set the data associated to the group class.
4457 * @param clas The group class.
4458 * @param data The new user data.
4460 * This data will be passed for callback functions, like icon get callback,
4461 * that can be set with elm_map_group_class_icon_cb_set().
4463 * If a data was previously set, the object will lose the pointer for it,
4464 * so if needs to be freed, you must do it yourself.
4466 * @see elm_map_group_class_new() for more details.
4467 * @see elm_map_group_class_icon_cb_set()
4468 * @see elm_map_marker_add()
4470 * @deprecated Use Elm_Map_Overlay instead
4472 EINA_DEPRECATED EAPI void elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4475 * Set the minimum zoom from where the markers are displayed.
4477 * @param clas The group class.
4478 * @param zoom The minimum zoom.
4480 * Markers only will be displayed when the map is displayed at @p zoom
4483 * @see elm_map_group_class_new() for more details.
4484 * @see elm_map_marker_add()
4486 * @deprecated Use Elm_Map_Overlay instead
4488 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4491 * Set the zoom from where the markers are no more grouped.
4493 * @param clas The group class.
4494 * @param zoom The maximum zoom.
4496 * Markers only will be grouped when the map is displayed at
4497 * less than @p zoom.
4499 * @see elm_map_group_class_new() for more details.
4500 * @see elm_map_marker_add()
4502 * @deprecated Use Elm_Map_Overlay instead
4504 EINA_DEPRECATED EAPI void elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4507 * Set if the markers associated to the group class @p clas are hidden or not.
4509 * @param clas The group class.
4510 * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4513 * @param obj The map object.
4514 * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4517 * @deprecated Use Elm_Map_Overlay instead
4519 EINA_DEPRECATED EAPI void elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4522 * Create a new marker class.
4524 * @param obj The map object.
4525 * @return Returns the new group class.
4527 * Each marker must be associated to a class.
4529 * The marker class defines the style of the marker when a marker is
4530 * displayed alone, i.e., not grouped to to others markers. When grouped
4531 * it will use group class style.
4533 * A marker class will need to be provided when creating a marker with
4534 * elm_map_marker_add().
4536 * Some properties and functions can be set by class, as:
4537 * - style, with elm_map_marker_class_style_set()
4538 * - #Elm_Map_Marker_Icon_Get_Func - used to fetch icon for markers classes.
4539 * It can be set using elm_map_marker_class_icon_cb_set().
4540 * - #Elm_Map_Marker_Get_Func - used to fetch bubble content for marker classes.
4541 * Set using elm_map_marker_class_get_cb_set().
4542 * - #Elm_Map_Marker_Del_Func - used to delete bubble content for marker classes.
4543 * Set using elm_map_marker_class_del_cb_set().
4545 * @see elm_map_marker_add()
4546 * @see elm_map_marker_class_style_set()
4547 * @see elm_map_marker_class_icon_cb_set()
4548 * @see elm_map_marker_class_get_cb_set()
4549 * @see elm_map_marker_class_del_cb_set()
4551 * @deprecated Use Elm_Map_Overlay instead
4553 EINA_DEPRECATED EAPI Elm_Map_Marker_Class *elm_map_marker_class_new(Evas_Object *obj);
4556 * Set the marker's style of a marker class.
4558 * @param clas The marker class.
4559 * @param style The style to be used by markers.
4561 * Each marker must be associated to a marker class, and will use the style
4562 * defined by such class when alone, i.e., @b not grouped to other markers.
4564 * The following styles are provided by default theme:
4569 * @see elm_map_marker_class_new() for more details.
4570 * @see elm_map_marker_add()
4572 * @deprecated Use Elm_Map_Overlay instead
4574 EINA_DEPRECATED EAPI void elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4577 * Set the icon callback function of a marker class.
4579 * @param clas The marker class.
4580 * @param icon_get The callback function that will return the icon.
4582 * Each marker must be associated to a marker class, and it can display a
4583 * custom icon. The function @p icon_get must return this icon.
4585 * @see elm_map_marker_class_new() for more details.
4586 * @see elm_map_marker_add()
4588 * @deprecated Use Elm_Map_Overlay instead
4590 EINA_DEPRECATED EAPI void elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4593 * Set the bubble content callback function of a marker class.
4595 * @param clas The marker class.
4596 * @param get The callback function that will return the content.
4598 * Each marker must be associated to a marker class, and it can display a
4599 * a content on a bubble that opens when the user click over the marker.
4600 * The function @p get must return this content object.
4602 * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4605 * @see elm_map_marker_class_new() for more details.
4606 * @see elm_map_marker_class_del_cb_set()
4607 * @see elm_map_marker_add()
4609 * @deprecated Use Elm_Map_Overlay instead
4611 EINA_DEPRECATED EAPI void elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4614 * Set the callback function used to delete bubble content of a marker class.
4616 * @param clas The marker class.
4617 * @param del The callback function that will delete the content.
4619 * Each marker must be associated to a marker class, and it can display a
4620 * a content on a bubble that opens when the user click over the marker.
4621 * The function to return such content can be set with
4622 * elm_map_marker_class_get_cb_set().
4624 * If this content must be freed, a callback function need to be
4625 * set for that task with this function.
4627 * If this callback is defined it will have to delete (or not) the
4628 * object inside, but if the callback is not defined the object will be
4629 * destroyed with evas_object_del().
4631 * @see elm_map_marker_class_new() for more details.
4632 * @see elm_map_marker_class_get_cb_set()
4633 * @see elm_map_marker_add()
4635 * @deprecated Use Elm_Map_Overlay instead
4637 EINA_DEPRECATED EAPI void elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4640 * Set the route color.
4642 * @param route The route object.
4643 * @param r Red channel value, from 0 to 255.
4644 * @param g Green channel value, from 0 to 255.
4645 * @param b Blue channel value, from 0 to 255.
4646 * @param a Alpha channel value, from 0 to 255.
4648 * It uses an additive color model, so each color channel represents
4649 * how much of each primary colors must to be used. 0 represents
4650 * absence of this color, so if all of the three are set to 0,
4651 * the color will be black.
4653 * These component values should be integers in the range 0 to 255,
4654 * (single 8-bit byte).
4656 * This sets the color used for the route. By default, it is set to
4657 * solid red (r = 255, g = 0, b = 0, a = 255).
4659 * For alpha channel, 0 represents completely transparent, and 255, opaque.
4661 * @see elm_map_route_color_get()
4662 * @deprecated Use elm_map_overlay_color_set() instead
4665 EINA_DEPRECATED EAPI void elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4668 * Get the route color.
4670 * @param route The route object.
4671 * @param r Pointer to store the red channel value.
4672 * @param g Pointer to store the green channel value.
4673 * @param b Pointer to store the blue channel value.
4674 * @param a Pointer to store the alpha channel value.
4676 * @see elm_map_route_color_set() for details.
4677 * @deprecated Use elm_map_overlay_color_get() instead
4680 EINA_DEPRECATED EAPI void elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4683 * Remove a route from the map.
4685 * @param route The route to remove.
4687 * @see elm_map_route_add()
4688 * @deprecated Use elm_map_route_del() instead
4691 EINA_DEPRECATED EAPI void elm_map_route_remove(Elm_Map_Route *route);
4694 * Remove a name from the map.
4696 * @param name The name to remove.
4698 * Basically the struct handled by @p name will be freed, so conversions
4699 * between address and coordinates will be lost.
4701 * @see elm_map_utils_convert_name_into_coord()
4702 * @see elm_map_utils_convert_coord_into_name()
4703 * @deprecated Use elm_map_name_del() instead
4706 EINA_DEPRECATED EAPI void elm_map_name_remove(Elm_Map_Name *name);
4709 * Get the gengrid object's handle which contains a given gengrid item
4711 * @param it The item to fetch the container from
4712 * @return The gengrid (parent) object
4714 * This returns the gengrid object itself that an item belongs to.
4716 * @deprecated Use elm_object_item_widget_get() instead
4718 EINA_DEPRECATED EAPI Evas_Object *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4721 * Return the data associated to a given gengrid item
4723 * @param it The gengrid item.
4724 * @return the data associated with this item.
4726 * This returns the @c data value passed on the
4727 * elm_gengrid_item_append() and related item addition calls.
4729 * @see elm_gengrid_item_append()
4730 * @see elm_gengrid_item_data_set()
4731 * @deprecated Use elm_object_item_data_get() instead
4733 EINA_DEPRECATED EAPI void *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4736 * Set the data associated with a given gengrid item
4738 * @param it The gengrid item
4739 * @param data The data pointer to set on it
4741 * This @b overrides the @c data value passed on the
4742 * elm_gengrid_item_append() and related item addition calls. This
4743 * function @b won't call elm_gengrid_item_update() automatically,
4744 * so you'd issue it afterwards if you want to have the item
4745 * updated to reflect the new data.
4747 * @see elm_gengrid_item_data_get()
4748 * @see elm_gengrid_item_update()
4749 * @deprecated Use elm_object_item_data_set() instead
4752 EINA_DEPRECATED EAPI void elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4755 * Set whether a given gengrid item is disabled or not.
4757 * @param it The gengrid item
4758 * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4759 * to enable it back.
4761 * A disabled item cannot be selected or unselected. It will also
4762 * change its appearance, to signal the user it's disabled.
4764 * @see elm_gengrid_item_disabled_get()
4765 * @deprecated Use elm_object_item_disabled_set() instead
4768 EINA_DEPRECATED EAPI void elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4771 * Get whether a given gengrid item is disabled or not.
4773 * @param it The gengrid item
4774 * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4777 * @see elm_gengrid_item_disabled_set() for more details
4778 * @deprecated Use elm_object_item_disabled_get() instead
4781 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4784 * Remove a gengrid item from its parent, deleting it.
4786 * @param it The item to be removed.
4787 * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4789 * @see elm_gengrid_clear(), to remove all items in a gengrid at
4791 * @deprecated use elm_object_item_de() instead
4794 EINA_DEPRECATED EAPI void elm_gengrid_item_del(Elm_Object_Item *it);
4797 * Update the item class of a gengrid item.
4799 * This sets another class of the item, changing the way that it is
4800 * displayed. After changing the item class, elm_gengrid_item_update() is
4801 * called on the item @p it.
4803 * @param it The gengrid item
4804 * @param gic The gengrid item class describing the function pointers and the item style.
4806 * @deprecated Use elm_gengrid_item_item_class_update instead
4808 EINA_DEPRECATED EAPI void elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
4811 * Insert an item in a gengrid widget using a user-defined sort function.
4813 * @param obj The gengrid object.
4814 * @param gic The item class for the item.
4815 * @param data The item data.
4816 * @param comp User defined comparison function that defines the sort order
4817 * based on Elm_Gen_Item.
4818 * @param func Convenience function called when the item is selected.
4819 * @param func_data Data to be passed to @p func.
4820 * @return A handle to the item added or @c NULL, on errors.
4822 * This inserts an item in the gengrid based on user defined comparison function.
4824 * @see elm_gengrid_item_append()
4825 * @see elm_gengrid_item_prepend()
4826 * @see elm_gengrid_item_insert_after()
4827 * @see elm_object_item_del()
4828 * @see elm_gengrid_item_sorted_insert()
4830 * @deprecated Use elm_gengrid_item_sorted_insert() instead
4832 EINA_DEPRECATED EAPI Elm_Object_Item *elm_gengrid_item_direct_sorted_insert(Evas_Object *obj, const Elm_Gengrid_Item_Class *gic, const void *data, Eina_Compare_Cb comp, Evas_Smart_Cb func, const void *func_data);
4835 * Append a filter function for text inserted in the entry
4837 * Append the given callback to the list. This functions will be called
4838 * whenever any text is inserted into the entry, with the text to be inserted
4839 * as a parameter. The callback function is free to alter the text in any way
4840 * it wants, but it must remember to free the given pointer and update it.
4841 * If the new text is to be discarded, the function can free it and set its
4842 * text parameter to NULL. This will also prevent any following filters from
4845 * @param obj The entry object
4846 * @param func The function to use as text filter
4847 * @param data User data to pass to @p func
4848 * @deprecated use elm_entry_markup_filter_append() instead
4850 EINA_DEPRECATED EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4853 * Prepend a filter function for text inserted in the entry
4855 * Prepend the given callback to the list. See elm_entry_text_filter_append()
4856 * for more information
4858 * @param obj The entry object
4859 * @param func The function to use as text filter
4860 * @param data User data to pass to @p func
4861 * @deprecated use elm_entry_markup_filter_prepend() instead
4863 EINA_DEPRECATED EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4866 * Remove a filter from the list
4868 * Removes the given callback from the filter list. See
4869 * elm_entry_text_filter_append() for more information.
4871 * @param obj The entry object
4872 * @param func The filter function to remove
4873 * @param data The user data passed when adding the function
4874 * @deprecated use elm_entry_markup_filter_remove() instead
4876 EINA_DEPRECATED EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4879 * @brief Set the front content of the flip widget.
4881 * @param obj The flip object
4882 * @param content The new front content object
4884 * Once the content object is set, a previously set one will be deleted.
4885 * If you want to keep that old content object, use the
4886 * elm_flip_content_front_unset() function.
4888 * @deprecated Use elm_object_part_content_set(flip, "front") instead
4890 EINA_DEPRECATED EAPI void elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
4893 * @brief Set the back content of the flip widget.
4895 * @param obj The flip object
4896 * @param content The new back content object
4898 * Once the content object is set, a previously set one will be deleted.
4899 * If you want to keep that old content object, use the
4900 * elm_flip_content_back_unset() function.
4902 * @deprecated Use elm_object_part_content_set(flip, "back") instead
4904 EINA_DEPRECATED EAPI void elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
4907 * @brief Get the front content used for the flip
4909 * @param obj The flip object
4910 * @return The front content object that is being used
4912 * Return the front content object which is set for this widget.
4914 * @deprecated Use elm_object_part_content_get(flip, "front") instead
4916 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_get(const Evas_Object *obj);
4919 * @brief Get the back content used for the flip
4921 * @param obj The flip object
4922 * @return The back content object that is being used
4924 * Return the back content object which is set for this widget.
4926 * @deprecated Use elm_object_part_content_get(flip, "back") instead
4928 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_get(const Evas_Object *obj);
4931 * @brief Unset the front content used for the flip
4933 * @param obj The flip object
4934 * @return The front content object that was being used
4936 * Unparent and return the front content object which was set for this widget.
4938 * @deprecated Use elm_object_part_content_unset(flip, "front") instead
4940 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_front_unset(Evas_Object *obj);
4943 * @brief Unset the back content used for the flip
4945 * @param obj The flip object
4946 * @return The back content object that was being used
4948 * Unparent and return the back content object which was set for this widget.
4950 * @deprecated Use elm_object_part_content_unset(flip, "back") instead
4952 EINA_DEPRECATED EAPI Evas_Object *elm_flip_content_back_unset(Evas_Object *obj);
4955 * @brief Get flip front visibility state
4957 * @param obj The flip object
4958 * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
4961 * @deprecated Use elm_flip_front_visible_get() instead
4963 EINA_DEPRECATED EAPI Eina_Bool elm_flip_front_get(const Evas_Object *obj);
4966 * Add a new pager to the parent
4968 * @param parent The parent object
4969 * @return The new object or NULL if it cannot be created
4971 * @deprecated Use naviframe instead
4973 EINA_DEPRECATED EAPI Evas_Object *elm_pager_add(Evas_Object *parent);
4976 * @brief Push an object to the top of the pager stack (and show it).
4978 * @param obj The pager object
4979 * @param content The object to push
4981 * The object pushed becomes a child of the pager, it will be controlled and
4982 * deleted when the pager is deleted.
4984 * @note If the content is already in the stack use
4985 * elm_pager_content_promote().
4986 * @warning Using this function on @p content already in the stack results in
4987 * undefined behavior.
4988 * @deprecated Use naviframe instead
4990 EINA_DEPRECATED EAPI void elm_pager_content_push(Evas_Object *obj, Evas_Object *content);
4993 * @brief Pop the object that is on top of the stack
4995 * @param obj The pager object
4997 * This pops the object that is on the top(visible) of the pager, makes it
4998 * disappear, then deletes the object. The object that was underneath it on
4999 * the stack will become visible.
5000 * @deprecated Use naviframe instead
5002 EINA_DEPRECATED EAPI void elm_pager_content_pop(Evas_Object *obj);
5005 * @brief Moves an object already in the pager stack to the top of the stack.
5007 * @param obj The pager object
5008 * @param content The object to promote
5010 * This will take the @p content and move it to the top of the stack as
5011 * if it had been pushed there.
5013 * @note If the content isn't already in the stack use
5014 * elm_pager_content_push().
5015 * @warning Using this function on @p content not already in the stack
5016 * results in undefined behavior.
5017 * @deprecated Use naviframe instead
5019 EINA_DEPRECATED EAPI void elm_pager_content_promote(Evas_Object *obj, Evas_Object *content);
5022 * @brief Return the object at the bottom of the pager stack
5024 * @param obj The pager object
5025 * @return The bottom object or NULL if none
5026 * @deprecated Use naviframe instead
5028 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_bottom_get(const Evas_Object *obj);
5031 * @brief Return the object at the top of the pager stack
5033 * @param obj The pager object
5034 * @return The top object or NULL if none
5035 * @deprecated Use naviframe instead
5037 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_top_get(const Evas_Object *obj);
5040 * @brief Set the default item style.
5042 * Default item style will be used with items who's style is NULL
5044 * @param obj The pager object
5045 * @param style The style
5046 * @deprecated Use naviframe instead
5048 EINA_DEPRECATED EAPI void elm_pager_item_style_default_set(Evas_Object *obj, const char *style);
5051 * @brief Get the default item style
5053 * @param obj The pager object
5054 * @return the default item style
5056 * @see elm_pager_item_style_default_set()
5057 * @deprecated Use naviframe instead
5059 EINA_DEPRECATED EAPI const char *elm_pager_item_style_default_get(const Evas_Object *obj);
5062 * @brief Set the font size on the label object.
5064 * @param obj The label object
5065 * @param size font size
5067 * @warning NEVER use this. It is for hyper-special cases only. use styles
5068 * instead. e.g. "default", "marker", "slide_long" etc.
5069 * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
5071 EINA_DEPRECATED EAPI void elm_label_fontsize_set(Evas_Object *obj, int fontsize);
5074 * @brief Set the text color on the label object
5076 * @param obj The label object
5077 * @param r Red property background color of The label object
5078 * @param g Green property background color of The label object
5079 * @param b Blue property background color of The label object
5080 * @param a Alpha property background color of The label object
5082 * @warning NEVER use this. It is for hyper-special cases only. use styles
5083 * instead. e.g. "default", "marker", "slide_long" etc.
5084 * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
5086 EINA_DEPRECATED EAPI void elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5089 * @brief Set the text align on the label object
5091 * @param obj The label object
5092 * @param align align mode ("left", "center", "right")
5094 * @warning NEVER use this. It is for hyper-special cases only. use styles
5095 * instead. e.g. "default", "marker", "slide_long" etc.
5096 * @deprecated Use <align> tag instead. about <align> tag - Either "auto" (meaning according to text direction), "left", "right", "center", "middle", a value between 0.0 and 1.0, or a value between 0% to 100%.
5098 EINA_DEPRECATED EAPI void elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
5101 * @brief Set background color of the label
5103 * @param obj The label object
5104 * @param r Red property background color of The label object
5105 * @param g Green property background color of The label object
5106 * @param b Blue property background color of The label object
5107 * @param a Alpha property background alpha of The label object
5109 * @warning NEVER use this. It is for hyper-special cases only. use styles
5110 * instead. e.g. "default", "marker", "slide_long" etc.
5111 * @deprecated Just make colored background by yourself.
5113 EINA_DEPRECATED EAPI void elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5116 * @brief Set wrap height of the label
5118 * @param obj The label object
5119 * @param h The wrap height in pixels at a minimum where words need to wrap
5121 * This function sets the maximum height size hint of the label.
5123 * @warning This is only relevant if the label is inside a container.
5124 * @deprecated This function should not be used because of wrong concept.
5126 EAPI void elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
5129 * @brief get wrap width of the label
5131 * @param obj The label object
5132 * @return The wrap height in pixels at a minimum where words need to wrap
5133 * @deprecated This function should not be used because of wrong concept.
5135 EAPI Evas_Coord elm_label_wrap_height_get(const Evas_Object *obj);
5138 * @brief Flush all caches.
5140 * Frees all data that was in cache and is not currently being used to reduce
5141 * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
5142 * to calling all of the following functions:
5143 * @li edje_file_cache_flush()
5144 * @li edje_collection_cache_flush()
5145 * @li eet_clearcache()
5146 * @li evas_image_cache_flush()
5147 * @li evas_font_cache_flush()
5148 * @li evas_render_dump()
5149 * @note Evas caches are flushed for every canvas associated with a window.
5150 * @deprecated Use elm_cache_all_flush() instead.
5152 EINA_DEPRECATED EAPI void elm_all_flush(void);
5156 * @brief Define the uri that will be the video source.
5158 * @param video The video object to define the file for.
5159 * @param uri The uri to target.
5161 * This function will define an uri as a source for the video of the
5162 * Elm_Video object. URI could be remote source of video, like http:// or local
5163 * like for example WebCam who are most of the time v4l2:// (but that depend an
5164 * you should use Emotion API to request and list the available Webcam on your
5166 * @deprecated Use elm_video_file_set() instead.
5169 EINA_DEPRECATED EAPI void elm_video_uri_set(Evas_Object *video, const char *uri);
5172 * @brief Get the region of the image that is currently shown
5175 * @param x A pointer to the X-coordinate of region
5176 * @param y A pointer to the Y-coordinate of region
5177 * @param w A pointer to the width
5178 * @param h A pointer to the height
5180 * @deprecated Use elm_photocam_image_region_get() instead.
5182 EINA_DEPRECATED EAPI void elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
5185 * @brief Set the gesture state for photocam.
5187 * @param obj The photocam object
5188 * @param gesture The gesture state to set
5190 * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
5191 * photocam. The default is off. This will start multi touch zooming.
5193 * @deprecated Use elm_photocam_gesture_enabled_set() instead.
5195 EINA_DEPRECATED EAPI void elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
5198 * @brief Get the gesture state for photocam.
5200 * @param obj The photocam object
5201 * @return The current gesture state
5203 * This gets the current gesture state for the photocam object.
5205 * @deprecated Use elm_photocam_gesture_enabled_get() instead.
5207 EINA_DEPRECATED EAPI Eina_Bool elm_photocam_gesture_get(const Evas_Object *obj);
5208 /* No documentation for these API before.
5210 * @deprecated Use elm_route_latitude_min_max_get()
5211 * elm_route_longitude_min_max_get()
5214 EINA_DEPRECATED EAPI double elm_route_lon_min_get(Evas_Object *obj);
5215 EINA_DEPRECATED EAPI double elm_route_lat_min_get(Evas_Object *obj);
5216 EINA_DEPRECATED EAPI double elm_route_lon_max_get(Evas_Object *obj);
5217 EINA_DEPRECATED EAPI double elm_route_lat_max_get(Evas_Object *obj);
5221 * Get the duration after which tooltip will be shown.
5223 * @return Duration after which tooltip will be shown.
5224 * @deprecated Use elm_config_tooltip_delay_get(void);
5226 EINA_DEPRECATED EAPI double elm_tooltip_delay_get(void);
5229 * Set the duration after which tooltip will be shown.
5231 * @return EINA_TRUE if value is set.
5232 * @deprecated Use elm_config_tooltip_delay_set(double delay);
5234 EINA_DEPRECATED EAPI Eina_Bool elm_tooltip_delay_set(double delay);
5237 * Set the corner of the bubble
5239 * @param obj The bubble object.
5240 * @param corner The given corner for the bubble.
5242 * @deprecated Use elm_bubble_pos_set()
5245 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
5248 * Get the corner of the bubble
5250 * @param obj The bubble object.
5251 * @return The given corner for the bubble.
5253 * @deprecated Use elm_bubble_pos_get()
5255 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
5258 * Enable or disable day selection
5260 * @param obj The calendar object.
5261 * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
5264 * @deprecated Use elm_calendar_day_selection_disabled_set()
5266 EINA_DEPRECATED EAPI void elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
5269 * Get a value whether day selection is enabled or not.
5271 * @param obj The calendar object.
5272 * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
5273 * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
5275 * @deprecated elm_calendar_day_selection_disabled_get()
5277 EINA_DEPRECATED EAPI Eina_Bool elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
5280 * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
5282 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
5285 * Get the configured font cache size
5287 * This gets the globally configured font cache size, in bytes.
5289 * @return The font cache size
5290 * @deprecated elm_cache_font_cache_size_get(void);
5292 EINA_DEPRECATED EAPI int elm_font_cache_get(void);
5295 * Set the configured font cache size
5297 * This sets the globally configured font cache size, in bytes
5299 * @param size The font cache size
5300 * @deprecated elm_cache_font_cache_size_set(int size);
5302 EINA_DEPRECATED EAPI void elm_font_cache_set(int size);
5305 * Get the configured image cache size
5307 * This gets the globally configured image cache size, in bytes
5309 * @return The image cache size
5311 EINA_DEPRECATED EAPI int elm_image_cache_get(void);
5312 EAPI int elm_cache_image_cache_size_get(void);
5315 * Set the configured image cache size
5317 * This sets the globally configured image cache size, in bytes
5319 * @param size The image cache size
5320 * @deprecated Use elm_cache_image_cache_size_set(int size);
5322 EINA_DEPRECATED EAPI void elm_image_cache_set(int size);
5326 * Get the configured edje file cache size.
5328 * This gets the globally configured edje file cache size, in number
5331 * @return The edje file cache size
5332 * @deprecated Use elm_cache_edje_file_cache_size_get(void);
5334 EINA_DEPRECATED EAPI int elm_edje_file_cache_get(void);
5337 * Set the configured edje file cache size
5339 * This sets the globally configured edje file cache size, in number
5342 * @param size The edje file cache size
5343 * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
5345 EINA_DEPRECATED EAPI void elm_edje_file_cache_set(int size);
5348 * Get the configured edje collections (groups) cache size.
5350 * This gets the globally configured edje collections cache size, in
5351 * number of collections.
5353 * @return The edje collections cache size
5354 * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
5356 EINA_DEPRECATED EAPI int elm_edje_collection_cache_get(void);
5359 * Set the configured edje collections (groups) cache size
5361 * This sets the globally configured edje collections cache size, in
5362 * number of collections.
5364 * @param size The edje collections cache size
5365 * @deprecated elm_cache_edje_collection_cache_size_set(int size);
5367 EINA_DEPRECATED EAPI void elm_edje_collection_cache_set(int size);
5370 * Gets whether browsing history is enabled for the given object
5372 * @param obj The web object
5374 * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
5376 * @deprecated Use elm_web_history_enabled_get()
5378 EINA_DEPRECATED EAPI Eina_Bool elm_web_history_enable_get(const Evas_Object *obj);
5381 * Enables or disables the browsing history
5383 * @param obj The web object
5384 * @param enable Whether to enable or disable the browsing history
5386 * @deprecated Use elm_web_history_enabled_set()
5389 EINA_DEPRECATED EAPI void elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
5392 * @brief Add an object swallowed in an item at the end of the given menu
5395 * @param obj The menu object.
5396 * @param parent The parent menu item (optional)
5397 * @param subobj The object to swallow
5398 * @param func Function called when the user select the item.
5399 * @param data Data sent by the callback.
5400 * @return Returns the new item.
5402 * Add an evas object as an item to the menu.
5403 * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
5405 EINA_DEPRECATED EAPI Elm_Object_Item *elm_menu_item_add_object(Evas_Object *obj, Elm_Object_Item *parent, Evas_Object *subobj, Evas_Smart_Cb func, const void *data);
5408 * @brief Sets whether events should be passed to by a click outside
5411 * @param obj The notify object
5412 * @param repeat EINA_TRUE Events are repeats, else no
5414 * When true if the user clicks outside the window the events will be caught
5415 * by the others widgets, else the events are blocked.
5417 * @note The default value is EINA_TRUE.
5418 * @deprecated Please use elm_notify_allow_events_set() instead
5420 EINA_DEPRECATED EAPI void elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
5423 * @brief Return true if events are repeat below the notify object
5424 * @param obj the notify object
5426 * @see elm_notify_repeat_events_set()
5427 * @deprecated Please use elm_notify_allow_events_get() instead
5429 EINA_DEPRECATED EAPI Eina_Bool elm_notify_repeat_events_get(const Evas_Object *obj);
5432 * Set if the cursor set should be searched on the theme or should use
5433 * the provided by the engine, only.
5435 * @param obj an object with cursor already set.
5436 * @param engine_only boolean to define if cursors should be looked only
5437 * between the provided by the engine or searched on widget's theme as well.
5439 * @deprecated Use elm_object_cursor_theme_search_enabled_set()
5441 EINA_DEPRECATED EAPI void elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5444 * Get the cursor engine only usage for this object cursor.
5446 * @param obj an object with cursor already set.
5447 * @return engine_only boolean to define it cursors should be
5448 * looked only between the provided by the engine or searched on
5449 * widget's theme as well. If the object does not have a cursor
5450 * set, then EINA_FALSE is returned.
5452 * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5454 EINA_DEPRECATED EAPI Eina_Bool elm_object_cursor_engine_only_get(const Evas_Object *obj);
5457 * Go to a given items level on a index widget
5459 * @param obj The index object
5460 * @param level The index level (one of @c 0 or @c 1)
5462 * @deprecated please use "elm_index_level_go" instead.
5464 EINA_DEPRECATED EAPI void elm_index_item_go(Evas_Object *obj, int level);
5467 * Enable or disable auto hiding feature for a given index widget.
5469 * @param obj The index object
5470 * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5472 * @see elm_index_active_get()
5474 * @deprecated please use "elm_index_autohide_disabled_set" instead.
5476 EINA_DEPRECATED EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5479 * Get whether auto hiding feature is enabled or not for a given index widget.
5481 * @param obj The index object
5482 * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5484 * @see elm_index_active_set() for more details
5486 * @deprecated please use "elm_index_autohide_disabled_get" instead.
5488 EINA_DEPRECATED EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
5491 * Append a new item, on a given index widget, <b>after the item
5492 * having @p relative as data</b>.
5494 * @param obj The index object.
5495 * @param letter Letter under which the item should be indexed
5496 * @param item The item data to set for the index's item
5497 * @param relative The index item to be the predecessor of this new one
5498 * @return A handle to the item added or @c NULL, on errors
5500 * Despite the most common usage of the @p letter argument is for
5501 * single char strings, one could use arbitrary strings as index
5504 * @c item will be the pointer returned back on @c "changed", @c
5505 * "delay,changed" and @c "selected" smart events.
5507 * @note If @p relative is @c NULL this function will behave as
5508 * elm_index_item_append().
5510 * @deprecated please use "elm_index_item_insert_after" instead.
5512 EAPI Elm_Object_Item *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5515 * Prepend a new item, on a given index widget, <b>after the item
5516 * having @p relative as data</b>.
5518 * @param obj The index object.
5519 * @param letter Letter under which the item should be indexed
5520 * @param item The item data to set for the index's item
5521 * @param relative The index item to be the successor of this new one
5522 * @return A handle to the item added or @c NULL, on errors
5524 * Despite the most common usage of the @p letter argument is for
5525 * single char strings, one could use arbitrary strings as index
5528 * @c item will be the pointer returned back on @c "changed", @c
5529 * "delay,changed" and @c "selected" smart events.
5531 * @note If @p relative is @c NULL this function will behave as
5532 * elm_index_item_prepend().
5534 * @deprecated please use "elm_index_item_insert_before" instead.
5536 EAPI Elm_Object_Item *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5539 * Set the transparency state of a window.
5541 * Use elm_win_alpha_set() instead.
5543 * @param obj The window object
5544 * @param transparent If true, the window is transparent
5546 * @see elm_win_alpha_set()
5547 * @deprecated Please use elm_win_alpha_set()
5549 EINA_DEPRECATED EAPI void elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5552 * Get the transparency state of a window.
5554 * @param obj The window object
5555 * @return If true, the window is transparent
5557 * @see elm_win_transparent_set()
5558 * @deprecated Please use elm_win_alpha_get()
5560 EINA_DEPRECATED EAPI Eina_Bool elm_win_transparent_get(const Evas_Object *obj);
5563 * Set the theme for all elementary using applications on the current display
5565 * @param theme The name of the theme to use. Format same as the ELM_THEME
5566 * environment variable.
5567 * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5569 EINA_DEPRECATED EAPI void elm_theme_all_set(const char *theme);
5572 * Returns the Evas_Object that represents the content area.
5574 * @param obj The conformant object.
5575 * @return The content area of the widget.
5578 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_area_get(const Evas_Object *obj);
5581 * Set if the object is (up/down) resizable.
5583 * @param obj The image object
5584 * @param scale_up A bool to set if the object is resizable up. Default is
5586 * @param scale_down A bool to set if the object is resizable down. Default
5589 * This function limits the image resize ability. If @p scale_up is set to
5590 * @c EINA_FALSE, the object can't have its height or width resized to a value
5591 * higher than the original image size. Same is valid for @p scale_down.
5593 * @see elm_image_scale_get()
5594 * @deprecated Please use elm_image_resizable_set()
5597 EINA_DEPRECATED EAPI void elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5600 * Get if the object is (up/down) resizable.
5602 * @param obj The image object
5603 * @param scale_up A bool to set if the object is resizable up
5604 * @param scale_down A bool to set if the object is resizable down
5606 * @see elm_image_scale_set()
5607 * @deprecated Please use elm_image_resizable_get()
5610 EINA_DEPRECATED EAPI void elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5613 * Set if the object is (up/down) resizable.
5615 * @param obj The icon object
5616 * @param scale_up A bool to set if the object is resizable up. Default is
5618 * @param scale_down A bool to set if the object is resizable down. Default
5621 * This function limits the icon object resize ability. If @p scale_up is set to
5622 * @c EINA_FALSE, the object can't have its height or width resized to a value
5623 * higher than the original icon size. Same is valid for @p scale_down.
5625 * @see elm_icon_scale_get()
5626 * @deprecated Please use elm_icon_resizable_set()
5629 EINA_DEPRECATED EAPI void elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5632 * Get if the object is (up/down) resizable.
5634 * @param obj The icon object
5635 * @param scale_up A bool to set if the object is resizable up
5636 * @param scale_down A bool to set if the object is resizable down
5638 * @see elm_icon_scale_set()
5639 * @deprecated Please use elm_icon_resizable_get()
5642 EINA_DEPRECATED EAPI void elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5645 * Enable or disable preloading of the icon
5647 * @param obj The icon object
5648 * @param disable If EINA_TRUE, preloading will be disabled
5649 * @deprecated Use elm_icon_preload_disabled_set() instead
5651 EINA_DEPRECATED EAPI void elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5654 * Returns the last selected item, for a given index widget.
5656 * @param obj The index object.
5657 * @return The last item @b selected on @p obj (or @c NULL, on errors).
5658 * @deprecated Please use elm_index_selected_item_get() instead.
5662 EINA_DEPRECATED EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
5665 * Get the value of shrink_mode state.
5667 * @deprecated elm_multibuttonentry_expanded_get()
5669 EINA_DEPRECATED EAPI int elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5672 * Set/Unset the multibuttonentry to shrink mode state of single line
5674 * @deprecated elm_multibuttonentry_expanded_set()
5676 EINA_DEPRECATED EAPI void elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5679 * Get the guide text
5681 * @param obj The multibuttonentry object
5682 * @return The guide text, or NULL if none
5684 * @deprecated Please use elm_object_part_text_get(obj, "guide");
5686 EINA_DEPRECATED EAPI const char *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5689 * Set the guide text
5691 * @param obj The multibuttonentry object
5692 * @param guidetext The guide text string
5694 * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5696 EINA_DEPRECATED EAPI void elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5699 * Make the elementary object and its children to be unfocusable
5702 * @param obj The Elementary object to operate on
5703 * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5704 * @c EINA_FALSE for focusable.
5706 * This sets whether the object @p obj and its children objects
5707 * are able to take focus or not. If the tree is set as unfocusable,
5708 * newest focused object which is not in this tree will get focus.
5709 * This API can be helpful for an object to be deleted.
5710 * When an object will be deleted soon, it and its children may not
5711 * want to get focus (by focus reverting or by other focus controls).
5712 * Then, just use this API before deleting.
5714 * @see elm_object_tree_unfocusable_get()
5716 * @deprecated Please use elm_object_tree_unfocusable_set()
5718 EINA_DEPRECATED EAPI void elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5721 * Get whether an Elementary object and its children are unfocusable or not.
5723 * @param obj The Elementary object to get the information from
5724 * @return @c EINA_TRUE, if the tree is unfocussable,
5725 * @c EINA_FALSE if not (and on errors).
5727 * @see elm_object_tree_unfocusable_set()
5729 * @deprecated Please use elm_object_tree_unfocusable_get()
5731 EINA_DEPRECATED EAPI Eina_Bool elm_object_tree_unfocusable_get(const Evas_Object *obj);
5734 * Animatedly bring in, to the visible are of a genlist, a given
5737 * @deprecated elm_genlist_item_bring_in()
5739 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5742 * Animatedly bring in, to the visible are of a genlist, a given
5745 * @deprecated elm_genlist_item_bring_in()
5747 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5750 * Show the portion of a genlist's internal list containing a given
5751 * item, immediately.
5753 * @param it The item to display
5755 * @deprecated elm_genlist_item_show()
5758 EINA_DEPRECATED EAPI void elm_genlist_item_top_show(Elm_Object_Item *it);
5761 * Show the portion of a genlist's internal list containing a given
5762 * item, immediately.
5764 * @param it The item to display
5766 * @deprecated elm_genlist_item_show()
5769 EINA_DEPRECATED EAPI void elm_genlist_item_middle_show(Elm_Object_Item *it);
5772 * Enable or disable round mode.
5774 * @param obj The diskselector object.
5775 * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
5778 * Disabled by default. If round mode is enabled the items list will
5779 * work like a circle list, so when the user reaches the last item,
5780 * the first one will popup.
5782 * @see elm_diskselector_round_enabled_get()
5784 * @deprecated elm_diskselector_round_enabled_set()
5786 EINA_DEPRECATED EAPI void elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
5789 * Set the always select mode.
5791 * @param obj The genlist object
5792 * @param always_select The always select mode (@c EINA_TRUE = on, @c
5793 * EINA_FALSE = off). Default is @c EINA_FALSE.
5795 * Items will only call their selection func and callback when first
5796 * becoming selected. Any further clicks will do nothing, unless you
5797 * enable always select with elm_genlist_always_select_mode_set().
5798 * This means that, even if selected, every click will make the selected
5799 * callbacks be called.
5801 * @see elm_genlist_always_select_mode_get()
5804 EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5808 * Get the always select mode.
5810 * @param obj The genlist object
5811 * @return The always select mode
5812 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
5814 * @see elm_genlist_always_select_mode_set()
5817 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj);
5820 * Enable/disable the no select mode.
5822 * @param obj The genlist object
5823 * @param no_select The no select mode
5824 * (EINA_TRUE = on, EINA_FALSE = off)
5826 * This will turn off the ability to select items entirely and they
5827 * will neither appear selected nor call selected callback functions.
5829 * @see elm_genlist_no_select_mode_get()
5832 EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5835 * Gets whether the no select mode is enabled.
5837 * @param obj The genlist object
5838 * @return The no select mode
5839 * (@c EINA_TRUE = on, @c EINA_FALSE = off)
5841 * @see elm_genlist_no_select_mode_set()
5844 EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj);
5847 * Set whether items on a given gengrid widget are to get their
5848 * selection callbacks issued for @b every subsequent selection
5849 * click on them or just for the first click.
5851 * @param obj The gengrid object
5852 * @param always_select @c EINA_TRUE to make items "always
5853 * selected", @c EINA_FALSE, otherwise
5855 * By default, grid items will only call their selection callback
5856 * function when firstly getting selected, any subsequent further
5857 * clicks will do nothing. With this call, you make those
5858 * subsequent clicks also to issue the selection callbacks.
5860 * @note <b>Double clicks</b> will @b always be reported on items.
5862 * @see elm_gengrid_always_select_mode_get()
5865 EINA_DEPRECATED EAPI void elm_gengrid_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select);
5868 * Get whether items on a given gengrid widget have their selection
5869 * callbacks issued for @b every subsequent selection click on them
5870 * or just for the first click.
5872 * @param obj The gengrid object.
5873 * @return @c EINA_TRUE if the gengrid items are "always selected",
5874 * @c EINA_FALSE, otherwise
5876 * @see elm_gengrid_always_select_mode_set() for more details
5879 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_always_select_mode_get(const Evas_Object *obj);
5882 * Set whether items on a given gengrid widget can be selected or not.
5884 * @param obj The gengrid object
5885 * @param no_select @c EINA_TRUE to make items selectable,
5886 * @c EINA_FALSE otherwise
5888 * This will make items in @p obj selectable or not. In the latter
5889 * case, any user interaction on the gengrid items will neither make
5890 * them appear selected nor them call their selection callback
5893 * @see elm_gengrid_no_select_mode_get()
5896 EINA_DEPRECATED EAPI void elm_gengrid_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select);
5899 * Get whether items on a given gengrid widget can be selected or
5902 * @param obj The gengrid object
5903 * @return @c EINA_TRUE, if items are selectable, @c EINA_FALSE
5906 * @see elm_gengrid_no_select_mode_set() for more details
5909 EINA_DEPRECATED EAPI Eina_Bool elm_gengrid_no_select_mode_get(const Evas_Object *obj);
5912 * Get the side labels max length.
5914 * @see elm_diskselector_side_text_max_length_set() for details.
5916 * @param obj The diskselector object.
5917 * @return The max length defined for side labels, or 0 if not a valid
5920 * @deprecated elm_diskselector_side_text_max_length_get()
5922 EINA_DEPRECATED EAPI int elm_diskselector_side_label_length_get(const Evas_Object *obj);
5925 * Set the side labels max length.
5927 * @param obj The diskselector object.
5928 * @param len The max length defined for side labels.
5930 * Length is the number of characters of items' label that will be
5931 * visible when it's set on side positions. It will just crop
5932 * the string after defined size. E.g.:
5934 * An item with label "January" would be displayed on side position as
5935 * "Jan" if max length is set to 3, or "Janu", if this property
5938 * When it's selected, the entire label will be displayed, except for
5939 * width restrictions. In this case label will be cropped and "..."
5940 * will be concatenated.
5942 * Default side label max length is 3.
5944 * This property will be applied over all items, included before or
5945 * later this function call.
5947 * @deprecated elm_diskselector_side_text_max_length_set()
5949 EINA_DEPRECATED EAPI void elm_diskselector_side_label_length_set(Evas_Object *obj, int len);