src/lib/elm_deprecated.h

   1 /**
   2  * @defgroup Toggle Toggle
   3  *
   4  * @image html img/widget/toggle/preview-00.png
   5  * @image latex img/widget/toggle/preview-00.eps
   6  *
   7  * @brief A toggle is a slider which can be used to toggle between
   8  * two values.  It has two states: on and off.
   9  *
  10  * This widget is deprecated. Please use elm_check_add() instead using the
  11  * toggle style like:
  12  *
  13  * @code
  14  * obj = elm_check_add(parent);
  15  * elm_object_style_set(obj, "toggle");
  16  * elm_object_part_text_set(obj, "on", "ON");
  17  * elm_object_part_text_set(obj, "off", "OFF");
  18  * @endcode
  19  *
  20  * Signals that you can add callbacks for are:
  21  * @li "changed" - Whenever the toggle value has been changed.  Is not called
  22  *                 until the toggle is released by the cursor (assuming it
  23  *                 has been triggered by the cursor in the first place).
  24  *
  25  * Default content parts of the toggle widget that you can use for are:
  26  * @li "icon" - An icon of the toggle
  27  *
  28  * Default text parts of the toggle widget that you can use for are:
  29  * @li "elm.text" - Label of the toggle
  30  *
  31  * @ref tutorial_toggle show how to use a toggle.
  32  * @{
  33  */
  34
  35 /**
  36  * @brief Add a toggle to @p parent.
  37  *
  38  * @param parent The parent object
  39  *
  40  * @return The toggle object
  41  */
  42 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
  43
  44 /**
  45  * @brief Sets the label to be displayed with the toggle.
  46  *
  47  * @param obj The toggle object
  48  * @param label The label to be displayed
  49  *
  50  * @deprecated use elm_object_text_set() instead.
  51  */
  52 EINA_DEPRECATED EAPI void         elm_toggle_label_set(Evas_Object *obj, const char *label);
  53
  54 /**
  55  * @brief Gets the label of the toggle
  56  *
  57  * @param obj  toggle object
  58  * @return The label of the toggle
  59  *
  60  * @deprecated use elm_object_text_get() instead.
  61  */
  62 EINA_DEPRECATED EAPI const char  *elm_toggle_label_get(const Evas_Object *obj);
  63
  64 /**
  65  * @brief Set the icon used for the toggle
  66  *
  67  * @param obj The toggle object
  68  * @param icon The icon object for the button
  69  *
  70  * Once the icon object is set, a previously set one will be deleted
  71  * If you want to keep that old content object, use the
  72  * elm_toggle_icon_unset() function.
  73  *
  74  * @deprecated use elm_object_part_content_set() instead.
  75  */
  76 EINA_DEPRECATED EAPI void         elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
  77
  78 /**
  79  * @brief Get the icon used for the toggle
  80  *
  81  * @param obj The toggle object
  82  * @return The icon object that is being used
  83  *
  84  * Return the icon object which is set for this widget.
  85  *
  86  * @see elm_toggle_icon_set()
  87  *
  88  * @deprecated use elm_object_part_content_get() instead.
  89  */
  90 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
  91
  92 /**
  93  * @brief Unset the icon used for the toggle
  94  *
  95  * @param obj The toggle object
  96  * @return The icon object that was being used
  97  *
  98  * Unparent and return the icon object which was set for this widget.
  99  *
 100  * @see elm_toggle_icon_set()
 101  *
 102  * @deprecated use elm_object_part_content_unset() instead.
 103  */
 104 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
 105
 106 /**
 107  * @brief Sets the labels to be associated with the on and off states of the toggle.
 108  *
 109  * @param obj The toggle object
 110  * @param onlabel The label displayed when the toggle is in the "on" state
 111  * @param offlabel The label displayed when the toggle is in the "off" state
 112  *
 113  * @deprecated use elm_object_part_text_set() for "on" and "off" parts
 114  * instead.
 115  */
 116 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
 117
 118 /**
 119  * @brief Gets the labels associated with the on and off states of the
 120  * toggle.
 121  *
 122  * @param obj The toggle object
 123  * @param onlabel A char** to place the onlabel of @p obj into
 124  * @param offlabel A char** to place the offlabel of @p obj into
 125  *
 126  * @deprecated use elm_object_part_text_get() for "on" and "off" parts
 127  * instead.
 128  */
 129 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
 130
 131 /**
 132  * @brief Sets the state of the toggle to @p state.
 133  *
 134  * @param obj The toggle object
 135  * @param state The state of @p obj
 136  *
 137  * @deprecated use elm_check_state_set() instead.
 138  */
 139 EINA_DEPRECATED EAPI void         elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
 140
 141 /**
 142  * @brief Gets the state of the toggle to @p state.
 143  *
 144  * @param obj The toggle object
 145  * @return The state of @p obj
 146  *
 147  * @deprecated use elm_check_state_get() instead.
 148  */
 149 EINA_DEPRECATED EAPI Eina_Bool    elm_toggle_state_get(const Evas_Object *obj);
 150
 151 /**
 152  * @brief Sets the state pointer of the toggle to @p statep.
 153  *
 154  * @param obj The toggle object
 155  * @param statep The state pointer of @p obj
 156  *
 157  * @deprecated use elm_check_state_pointer_set() instead.
 158  */
 159 EINA_DEPRECATED EAPI void         elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
 160
 161 /**
 162  * @}
 163  */
 164
 165 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
 166 EINA_DEPRECATED EAPI void         elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
 167 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_single_line_get(const Evas_Object *obj);
 168 EINA_DEPRECATED EAPI void         elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
 169 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_password_get(const Evas_Object *obj);
 170 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
 171 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_entry_get(const Evas_Object *obj);
 172 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
 173 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_is_empty(const Evas_Object *obj);
 174 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_selection_get(const Evas_Object *obj);
 175 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
 176 EINA_DEPRECATED EAPI void         elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
 177 EINA_DEPRECATED EAPI void         elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
 178 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_editable_get(const Evas_Object *obj);
 179 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_none(Evas_Object *obj);
 180 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_all(Evas_Object *obj);
 181 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_next(Evas_Object *obj);
 182 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_prev(Evas_Object *obj);
 183 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_up(Evas_Object *obj);
 184 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_down(Evas_Object *obj);
 185 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
 186 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
 187 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
 188 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
 189 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
 190 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
 191 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
 192 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
 193 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
 194 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
 195 EINA_DEPRECATED EAPI int          elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
 196 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_cut(Evas_Object *obj);
 197 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_copy(Evas_Object *obj);
 198 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_paste(Evas_Object *obj);
 199 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
 200 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);
 201 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
 202 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
 203 EINA_DEPRECATED EAPI void         elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
 204 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
 205 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
 206 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
 207 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
 208 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
 209 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
 210 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
 211 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
 212 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
 213 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
 214 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);
 215 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);
 216 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);
 217 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 218 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 219 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 220 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
 221 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
 222 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_save(Evas_Object *obj);
 223 EINA_DEPRECATED EAPI void         elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
 224 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_autosave_get(const Evas_Object *obj);
 225 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
 226 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
 227
 228 /**
 229  * @brief Sets the content of the hover object and the direction in which it
 230  * will pop out.
 231  *
 232  * @param obj The hover object
 233  * @param swallow The direction that the object will be displayed
 234  * at. Accepted values are "left", "top-left", "top", "top-right",
 235  * "right", "bottom-right", "bottom", "bottom-left", "middle" and
 236  * "smart".
 237  * @param content The content to place at @p swallow
 238  *
 239  * Once the content object is set for a given direction, a previously
 240  * set one (on the same direction) will be deleted. If you want to
 241  * keep that old content object, use the elm_object_part_content_unset()
 242  * function.
 243  *
 244  * All directions may have contents at the same time, except for
 245  * "smart". This is a special placement hint and its use case
 246  * depends of the calculations coming from
 247  * elm_hover_best_content_location_get(). Its use is for cases when
 248  * one desires only one hover content, but with a dynamic special
 249  * placement within the hover area. The content's geometry, whenever
 250  * it changes, will be used to decide on a best location, not
 251  * extrapolating the hover's parent object view to show it in (still
 252  * being the hover's target determinant of its medium part -- move and
 253  * resize it to simulate finger sizes, for example). If one of the
 254  * directions other than "smart" are used, a previously content set
 255  * using it will be deleted, and vice-versa.
 256  *
 257  * @deprecated Use elm_object_part_content_set() instead
 258  */
 259 EINA_DEPRECATED EAPI void         elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
 260
 261 /**
 262  * @brief Get the content of the hover object, in a given direction.
 263  *
 264  * Return the content object which was set for this widget in the
 265  * @p swallow direction.
 266  *
 267  * @param obj The hover object
 268  * @param swallow The direction that the object was display at.
 269  * @return The content that was being used
 270  *
 271  * @deprecated Use elm_object_part_content_get() instead
 272  * @see elm_object_part_content_set()
 273  */
 274 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
 275
 276 /**
 277  * @brief Unset the content of the hover object, in a given direction.
 278  *
 279  * Unparent and return the content object set at @p swallow direction.
 280  *
 281  * @param obj The hover object
 282  * @param swallow The direction that the object was display at.
 283  * @return The content that was being used.
 284  *
 285  * @deprecated Use elm_object_part_content_unset() instead
 286  * @see elm_object_part_content_set()
 287  */
 288 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
 289
 290 /**
 291  * @brief Set the hoversel button label
 292  *
 293  * @param obj The hoversel object
 294  * @param label The label text.
 295  *
 296  * This sets the label of the button that is always visible (before it is
 297  * clicked and expanded).
 298  *
 299  * @deprecated elm_object_text_set()
 300  */
 301 EINA_DEPRECATED EAPI void         elm_hoversel_label_set(Evas_Object *obj, const char *label);
 302
 303 /**
 304  * @brief Get the hoversel button label
 305  *
 306  * @param obj The hoversel object
 307  * @return The label text.
 308  *
 309  * @deprecated elm_object_text_get()
 310  */
 311 EINA_DEPRECATED EAPI const char  *elm_hoversel_label_get(const Evas_Object *obj);
 312
 313 /**
 314  * @brief Set the icon of the hoversel button
 315  *
 316  * @param obj The hoversel object
 317  * @param icon The icon object
 318  *
 319  * Sets the icon of the button that is always visible (before it is clicked
 320  * and expanded).  Once the icon object is set, a previously set one will be
 321  * deleted, if you want to keep that old content object, use the
 322  * elm_hoversel_icon_unset() function.
 323  *
 324  * @see elm_object_content_set() for the button widget
 325  * @deprecated Use elm_object_item_part_content_set() instead
 326  */
 327 EINA_DEPRECATED EAPI void         elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
 328
 329 /**
 330  * @brief Get the icon of the hoversel button
 331  *
 332  * @param obj The hoversel object
 333  * @return The icon object
 334  *
 335  * Get the icon of the button that is always visible (before it is clicked
 336  * and expanded). Also see elm_object_content_get() for the button widget.
 337  *
 338  * @see elm_hoversel_icon_set()
 339  * @deprecated Use elm_object_item_part_content_get() instead
 340  */
 341 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
 342
 343 /**
 344  * @brief Get and unparent the icon of the hoversel button
 345  *
 346  * @param obj The hoversel object
 347  * @return The icon object that was being used
 348  *
 349  * Unparent and return the icon of the button that is always visible
 350  * (before it is clicked and expanded).
 351  *
 352  * @see elm_hoversel_icon_set()
 353  * @see elm_object_content_unset() for the button widget
 354  * @deprecated Use elm_object_item_part_content_unset() instead
 355  */
 356 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
 357
 358 /**
 359  * @brief This returns the data pointer supplied with elm_hoversel_item_add()
 360  * that will be passed to associated function callbacks.
 361  *
 362  * @param it The item to get the data from
 363  * @return The data pointer set with elm_hoversel_item_add()
 364  *
 365  * @see elm_hoversel_item_add()
 366  * @deprecated Use elm_object_item_data_get() instead
 367  */
 368 EINA_DEPRECATED EAPI void        *elm_hoversel_item_data_get(const Elm_Object_Item *it);
 369
 370 /**
 371  * @brief This returns the label text of the given hoversel item.
 372  *
 373  * @param it The item to get the label
 374  * @return The label text of the hoversel item
 375  *
 376  * @see elm_hoversel_item_add()
 377  * @deprecated Use elm_object_item_text_get() instead
 378  */
 379 EINA_DEPRECATED EAPI const char  *elm_hoversel_item_label_get(const Elm_Object_Item *it);
 380
 381 /**
 382  * @brief Set the function to be called when an item from the hoversel is
 383  * freed.
 384  *
 385  * @param it The item to set the callback on
 386  * @param func The function called
 387  *
 388  * That function will receive these parameters:
 389  * @li void * item data
 390  * @li Evas_Object * hoversel object
 391  * @li Elm_Object_Item * hoversel item
 392  *
 393  * @see elm_hoversel_item_add()
 394  * @deprecated Use elm_object_item_del_cb_set() instead
 395  */
 396 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
 397
 398 /**
 399  * @brief Delete an item from the hoversel
 400  *
 401  * @param it The item to delete
 402  *
 403  * This deletes the item from the hoversel (should not be called while the
 404  * hoversel is active; use elm_hoversel_expanded_get() to check first).
 405  *
 406  * @deprecated Use elm_object_item_del() instead
 407  * @see elm_hoversel_item_add()
 408  */
 409 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del(Elm_Object_Item *it);
 410
 411 /**
 412  * Set actionslider labels.
 413  *
 414  * @param obj The actionslider object
 415  * @param left_label The label to be set on the left.
 416  * @param center_label The label to be set on the center.
 417  * @param right_label The label to be set on the right.
 418  * @deprecated use elm_object_text_set() instead.
 419  */
 420 EINA_DEPRECATED EAPI void        elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
 421
 422 /**
 423  * Get actionslider labels.
 424  *
 425  * @param obj The actionslider object
 426  * @param left_label A char** to place the left_label of @p obj into.
 427  * @param center_label A char** to place the center_label of @p obj into.
 428  * @param right_label A char** to place the right_label of @p obj into.
 429  * @deprecated use elm_object_text_set() instead.
 430  */
 431 EINA_DEPRECATED EAPI void        elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
 432
 433 /**
 434  * Set the label used on the indicator.
 435  *
 436  * @param obj The actionslider object
 437  * @param label The label to be set on the indicator.
 438  * @deprecated use elm_object_text_set() instead.
 439  */
 440 EINA_DEPRECATED EAPI void        elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
 441
 442 /**
 443  * Get the label used on the indicator object.
 444  *
 445  * @param obj The actionslider object
 446  * @return The indicator label
 447  * @deprecated use elm_object_text_get() instead.
 448  */
 449 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
 450
 451 /**
 452  * Set the overlay object used for the background object.
 453  *
 454  * @param obj The bg object
 455  * @param overlay The overlay object
 456  *
 457  * This provides a way for elm_bg to have an 'overlay' that will be on top
 458  * of the bg. Once the over object is set, a previously set one will be
 459  * deleted, even if you set the new one to NULL. If you want to keep that
 460  * old content object, use the elm_bg_overlay_unset() function.
 461  *
 462  * @deprecated use elm_object_part_content_set() instead
 463  *
 464  * @ingroup Bg
 465  */
 466
 467 EINA_DEPRECATED EAPI void         elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
 468
 469 /**
 470  * Get the overlay object used for the background object.
 471  *
 472  * @param obj The bg object
 473  * @return The content that is being used
 474  *
 475  * Return the content object which is set for this widget
 476  *
 477  * @deprecated use elm_object_part_content_get() instead
 478  *
 479  * @ingroup Bg
 480  */
 481 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
 482
 483 /**
 484  * Get the overlay object used for the background object.
 485  *
 486  * @param obj The bg object
 487  * @return The content that was being used
 488  *
 489  * Unparent and return the overlay object which was set for this widget
 490  *
 491  * @deprecated use elm_object_part_content_unset() instead
 492  *
 493  * @ingroup Bg
 494  */
 495 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
 496
 497
 498 /**
 499  * Set the label of the bubble
 500  *
 501  * @param obj The bubble object
 502  * @param label The string to set in the label
 503  *
 504  * This function sets the title of the bubble. Where this appears depends on
 505  * the selected corner.
 506  * @deprecated use elm_object_text_set() instead.
 507  */
 508 EINA_DEPRECATED EAPI void         elm_bubble_label_set(Evas_Object *obj, const char *label);
 509
 510 /**
 511  * Get the label of the bubble
 512  *
 513  * @param obj The bubble object
 514  * @return The string of set in the label
 515  *
 516  * This function gets the title of the bubble.
 517  * @deprecated use elm_object_text_get() instead.
 518  */
 519 EINA_DEPRECATED EAPI const char  *elm_bubble_label_get(const Evas_Object *obj);
 520
 521 /**
 522  * Set the info of the bubble
 523  *
 524  * @param obj The bubble object
 525  * @param info The given info about the bubble
 526  *
 527  * This function sets the info of the bubble. Where this appears depends on
 528  * the selected corner.
 529  * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
 530  */
 531 EINA_DEPRECATED EAPI void         elm_bubble_info_set(Evas_Object *obj, const char *info);
 532
 533 /**
 534  * Get the info of the bubble
 535  *
 536  * @param obj The bubble object
 537  *
 538  * @return The "info" string of the bubble
 539  *
 540  * This function gets the info text.
 541  * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
 542  */
 543 EINA_DEPRECATED EAPI const char  *elm_bubble_info_get(const Evas_Object *obj);
 544
 545 /**
 546  * Set the content to be shown in the bubble
 547  *
 548  * Once the content object is set, a previously set one will be deleted.
 549  * If you want to keep the old content object, use the
 550  * elm_bubble_content_unset() function.
 551  *
 552  * @param obj The bubble object
 553  * @param content The given content of the bubble
 554  *
 555  * This function sets the content shown on the middle of the bubble.
 556  *
 557  * @deprecated use elm_object_content_set() instead
 558  *
 559  */
 560 EINA_DEPRECATED EAPI void         elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
 561
 562 /**
 563  * Get the content shown in the bubble
 564  *
 565  * Return the content object which is set for this widget.
 566  *
 567  * @param obj The bubble object
 568  * @return The content that is being used
 569  *
 570  * @deprecated use elm_object_content_get() instead
 571  *
 572  */
 573 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
 574
 575 /**
 576  * Unset the content shown in the bubble
 577  *
 578  * Unparent and return the content object which was set for this widget.
 579  *
 580  * @param obj The bubble object
 581  * @return The content that was being used
 582  *
 583  * @deprecated use elm_object_content_unset() instead
 584  *
 585  */
 586 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
 587
 588 /**
 589  * Set the icon of the bubble
 590  *
 591  * Once the icon object is set, a previously set one will be deleted.
 592  * If you want to keep the old content object, use the
 593  * elm_icon_content_unset() function.
 594  *
 595  * @param obj The bubble object
 596  * @param icon The given icon for the bubble
 597  *
 598  * @deprecated use elm_object_part_content_set() instead
 599  *
 600  */
 601 EINA_DEPRECATED EAPI void         elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
 602
 603 /**
 604  * Get the icon of the bubble
 605  *
 606  * @param obj The bubble object
 607  * @return The icon for the bubble
 608  *
 609  * This function gets the icon shown on the top left of bubble.
 610  *
 611  * @deprecated use elm_object_part_content_get() instead
 612  *
 613  */
 614 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
 615
 616 /**
 617  * Unset the icon of the bubble
 618  *
 619  * Unparent and return the icon object which was set for this widget.
 620  *
 621  * @param obj The bubble object
 622  * @return The icon that was being used
 623  *
 624  * @deprecated use elm_object_part_content_unset() instead
 625  *
 626  */
 627 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
 628
 629
 630 /**
 631  * Set the label used in the button
 632  *
 633  * The passed @p label can be NULL to clean any existing text in it and
 634  * leave the button as an icon only object.
 635  *
 636  * @param obj The button object
 637  * @param label The text will be written on the button
 638  * @deprecated use elm_object_text_set() instead.
 639  */
 640 EINA_DEPRECATED EAPI void         elm_button_label_set(Evas_Object *obj, const char *label);
 641
 642 /**
 643  * Get the label set for the button
 644  *
 645  * The string returned is an internal pointer and should not be freed or
 646  * altered. It will also become invalid when the button is destroyed.
 647  * The string returned, if not NULL, is a stringshare, so if you need to
 648  * keep it around even after the button is destroyed, you can use
 649  * eina_stringshare_ref().
 650  *
 651  * @param obj The button object
 652  * @return The text set to the label, or NULL if nothing is set
 653  * @deprecated use elm_object_text_set() instead.
 654  */
 655 EINA_DEPRECATED EAPI const char  *elm_button_label_get(const Evas_Object *obj);
 656
 657 /**
 658  * Set the icon used for the button
 659  *
 660  * Setting a new icon will delete any other that was previously set, making
 661  * any reference to them invalid. If you need to maintain the previous
 662  * object alive, unset it first with elm_button_icon_unset().
 663  *
 664  * @param obj The button object
 665  * @param icon The icon object for the button
 666  * @deprecated use elm_object_part_content_set() instead.
 667  */
 668 EINA_DEPRECATED EAPI void         elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
 669
 670 /**
 671  * Get the icon used for the button
 672  *
 673  * Return the icon object which is set for this widget. If the button is
 674  * destroyed or another icon is set, the returned object will be deleted
 675  * and any reference to it will be invalid.
 676  *
 677  * @param obj The button object
 678  * @return The icon object that is being used
 679  *
 680  * @deprecated use elm_object_part_content_get() instead
 681  */
 682 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
 683
 684 /**
 685  * Remove the icon set without deleting it and return the object
 686  *
 687  * This function drops the reference the button holds of the icon object
 688  * and returns this last object. It is used in case you want to remove any
 689  * icon, or set another one, without deleting the actual object. The button
 690  * will be left without an icon set.
 691  *
 692  * @param obj The button object
 693  * @return The icon object that was being used
 694  * @deprecated use elm_object_part_content_unset() instead.
 695  */
 696 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
 697
 698 /**
 699  * Set a day text color to the same that represents Saturdays.
 700  *
 701  * @param obj The calendar object.
 702  * @param pos The text position. Position is the cell counter, from left
 703  * to right, up to down. It starts on 0 and ends on 41.
 704  *
 705  * @deprecated use elm_calendar_mark_add() instead like:
 706  *
 707  * @code
 708  * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
 709  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
 710  * @endcode
 711  *
 712  * @see elm_calendar_mark_add()
 713  *
 714  * @ingroup Calendar
 715  */
 716 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
 717
 718 /**
 719  * Set a day text color to the same that represents Sundays.
 720  *
 721  * @param obj The calendar object.
 722  * @param pos The text position. Position is the cell counter, from left
 723  * to right, up to down. It starts on 0 and ends on 41.
 724
 725  * @deprecated use elm_calendar_mark_add() instead like:
 726  *
 727  * @code
 728  * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
 729  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
 730  * @endcode
 731  *
 732  * @see elm_calendar_mark_add()
 733  *
 734  * @ingroup Calendar
 735  */
 736 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
 737
 738 /**
 739  * Set a day text color to the same that represents Weekdays.
 740  *
 741  * @param obj The calendar object
 742  * @param pos The text position. Position is the cell counter, from left
 743  * to right, up to down. It starts on 0 and ends on 41.
 744  *
 745  * @deprecated use elm_calendar_mark_add() instead like:
 746  *
 747  * @code
 748  * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
 749  *
 750  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
 751  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 752  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
 753  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 754  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
 755  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 756  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
 757  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 758  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
 759  * @endcode
 760  *
 761  * @see elm_calendar_mark_add()
 762  *
 763  * @ingroup Calendar
 764  */
 765 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
 766
 767
 768 /**
 769  * @brief Set the text label of the check object
 770  *
 771  * @param obj The check object
 772  * @param label The text label string in UTF-8
 773  *
 774  * @deprecated use elm_object_text_set() instead.
 775  */
 776 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
 777
 778 /**
 779  * @brief Get the text label of the check object
 780  *
 781  * @param obj The check object
 782  * @return The text label string in UTF-8
 783  *
 784  * @deprecated use elm_object_text_get() instead.
 785  */
 786 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
 787
 788 /**
 789  * @brief Set the icon object of the check object
 790  *
 791  * @param obj The check object
 792  * @param icon The icon object
 793  *
 794  * Once the icon object is set, a previously set one will be deleted.
 795  * If you want to keep that old content object, use the
 796  * elm_object_content_unset() function.
 797  *
 798  * @deprecated use elm_object_part_content_set() instead.
 799  *
 800  */
 801 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
 802
 803 /**
 804  * @brief Get the icon object of the check object
 805  *
 806  * @param obj The check object
 807  * @return The icon object
 808  *
 809  * @deprecated use elm_object_part_content_get() instead.
 810  *
 811  */
 812 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
 813
 814 /**
 815  * @brief Unset the icon used for the check object
 816  *
 817  * @param obj The check object
 818  * @return The icon object that was being used
 819  *
 820  * Unparent and return the icon object which was set for this widget.
 821  *
 822  * @deprecated use elm_object_part_content_unset() instead.
 823  *
 824  */
 825 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
 826
 827 /**
 828  * @brief Set the text label of the check object
 829  *
 830  * @param obj The check object
 831  * @param label The text label string in UTF-8
 832  *
 833  * @deprecated use elm_object_text_set() instead.
 834  */
 835 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
 836
 837 /**
 838  * @brief Get the text label of the check object
 839  *
 840  * @param obj The check object
 841  * @return The text label string in UTF-8
 842  *
 843  * @deprecated use elm_object_text_get() instead.
 844  */
 845 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
 846
 847 /**
 848  * @brief Set the icon object of the check object
 849  *
 850  * @param obj The check object
 851  * @param icon The icon object
 852  *
 853  * Once the icon object is set, a previously set one will be deleted.
 854  * If you want to keep that old content object, use the
 855  * elm_object_content_unset() function.
 856  *
 857  * @deprecated use elm_object_part_content_set() instead.
 858  *
 859  */
 860 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
 861
 862 /**
 863  * @brief Get the icon object of the check object
 864  *
 865  * @param obj The check object
 866  * @return The icon object
 867  *
 868  * @deprecated use elm_object_part_content_get() instead.
 869  *
 870  */
 871 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
 872
 873 /**
 874  * @brief Unset the icon used for the check object
 875  *
 876  * @param obj The check object
 877  * @return The icon object that was being used
 878  *
 879  * Unparent and return the icon object which was set for this widget.
 880  *
 881  * @deprecated use elm_object_part_content_unset() instead.
 882  *
 883  */
 884 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
 885
 886 EINA_DEPRECATED EAPI void         elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
 887 EINA_DEPRECATED EAPI void         elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
 888
 889
 890 /**
 891  * Set the content of the conformant widget.
 892  *
 893  * @param obj The conformant object.
 894  * @param content The content to be displayed by the conformant.
 895  *
 896  * Content will be sized and positioned considering the space required
 897  * to display a virtual keyboard. So it won't fill all the conformant
 898  * size. This way is possible to be sure that content won't resize
 899  * or be re-positioned after the keyboard is displayed.
 900  *
 901  * Once the content object is set, a previously set one will be deleted.
 902  * If you want to keep that old content object, use the
 903  * elm_object_content_unset() function.
 904  *
 905  * @see elm_object_content_unset()
 906  * @see elm_object_content_get()
 907  *
 908  * @deprecated use elm_object_content_set() instead
 909  *
 910  * @ingroup Conformant
 911  */
 912 EINA_DEPRECATED EAPI void         elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
 913
 914 /**
 915  * Get the content of the conformant widget.
 916  *
 917  * @param obj The conformant object.
 918  * @return The content that is being used.
 919  *
 920  * Return the content object which is set for this widget.
 921  * It won't be unparent from conformant. For that, use
 922  * elm_object_content_unset().
 923  *
 924  * @see elm_object_content_set().
 925  * @see elm_object_content_unset()
 926  *
 927  * @deprecated use elm_object_content_get() instead
 928  *
 929  * @ingroup Conformant
 930  */
 931 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
 932
 933 /**
 934  * Unset the content of the conformant widget.
 935  *
 936  * @param obj The conformant object.
 937  * @return The content that was being used.
 938  *
 939  * Unparent and return the content object which was set for this widget.
 940  *
 941  * @see elm_object_content_set().
 942  *
 943  * @deprecated use elm_object_content_unset() instead
 944  *
 945  * @ingroup Conformant
 946  */
 947 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
 948
 949 /**
 950  * Get the side labels max length.
 951  *
 952  * @deprecated use elm_diskselector_side_text_max_length_get() instead:
 953  *
 954  * @param obj The diskselector object.
 955  * @return The max length defined for side labels, or 0 if not a valid
 956  * diskselector.
 957  *
 958  * @ingroup Diskselector
 959  */
 960 EINA_DEPRECATED EAPI int    elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
 961
 962 /**
 963  * Set the side labels max length.
 964  *
 965  * @deprecated use elm_diskselector_side_text_max_length_set() instead:
 966  *
 967  * @param obj The diskselector object.
 968  * @param len The max length defined for side labels.
 969  *
 970  * @ingroup Diskselector
 971  */
 972 EINA_DEPRECATED EAPI void   elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
 973
 974 /**
 975  * Get the data associated to the item.
 976  *
 977  * @param it The diskselector item
 978  * @return The data associated to @p it
 979  *
 980  * The return value is a pointer to data associated to @p item when it was
 981  * created, with function elm_diskselector_item_append(). If no data
 982  * was passed as argument, it will return @c NULL.
 983  *
 984  * @see elm_diskselector_item_append()
 985  * @deprecated Use elm_object_item_data_get()
 986  *
 987  * @ingroup Diskselector
 988  */
 989 EINA_DEPRECATED EAPI void                  *elm_diskselector_item_data_get(const Elm_Object_Item *it);
 990
 991 /**
 992  * Set the icon associated to the item.
 993  *
 994  * @param it The diskselector item
 995  * @param icon The icon object to associate with @p it
 996  *
 997  * The icon object to use at left side of the item. An
 998  * icon can be any Evas object, but usually it is an icon created
 999  * with elm_icon_add().
1000  *
1001  * Once the icon object is set, a previously set one will be deleted.
1002  * @warning Setting the same icon for two items will cause the icon to
1003  * disappear from the first item.
1004  *
1005  * If an icon was passed as argument on item creation, with function
1006  * elm_diskselector_item_append(), it will be already
1007  * associated to the item.
1008  *
1009  * @see elm_diskselector_item_append()
1010  * @see elm_diskselector_item_icon_get()
1011  *
1012  * @deprecated Use elm_object_item_part_content_set() instead
1013  * @ingroup Diskselector
1014  */
1015 EINA_DEPRECATED EAPI void                   elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1016
1017 /**
1018  * Get the icon associated to the item.
1019  *
1020  * @param it The diskselector item
1021  * @return The icon associated to @p it
1022  *
1023  * The return value is a pointer to the icon associated to @p item when it was
1024  * created, with function elm_diskselector_item_append(), or later
1025  * with function elm_diskselector_item_icon_set. If no icon
1026  * was passed as argument, it will return @c NULL.
1027  *
1028  * @see elm_diskselector_item_append()
1029  * @see elm_diskselector_item_icon_set()
1030  *
1031  * @deprecated Use elm_object_item_part_content_set() instead
1032  * @ingroup Diskselector
1033  */
1034 EAPI Evas_Object           *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1035
1036 /**
1037  * Set the label of item.
1038  *
1039  * @param it The item of diskselector.
1040  * @param label The label of item.
1041  *
1042  * The label to be displayed by the item.
1043  *
1044  * If no icon is set, label will be centered on item position, otherwise
1045  * the icon will be placed at left of the label, that will be shifted
1046  * to the right.
1047  *
1048  * An item with label "January" would be displayed on side position as
1049  * "Jan" if max length is set to 3 with function
1050  * elm_diskselector_side_text_max_length_set(), or "Janu", if this property
1051  * is set to 4.
1052  *
1053  * When this @p item is selected, the entire label will be displayed,
1054  * except for width restrictions.
1055  * In this case label will be cropped and "..." will be concatenated,
1056  * but only for display purposes. It will keep the entire string, so
1057  * if diskselector is resized the remaining characters will be displayed.
1058  *
1059  * If a label was passed as argument on item creation, with function
1060  * elm_diskselector_item_append(), it will be already
1061  * displayed by the item.
1062  *
1063  * @see elm_diskselector_side_text_max_length_set()
1064  * @see elm_diskselector_item_label_get()
1065  * @see elm_diskselector_item_append()
1066  *
1067  * @deprecated Use elm_object_item_text_set() instead
1068  * @ingroup Diskselector
1069  */
1070 EINA_DEPRECATED EAPI void                   elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1071
1072 /**
1073  * Get the label of item.
1074  *
1075  * @param it The item of diskselector.
1076  * @return The label of item.
1077  *
1078  * The return value is a pointer to the label associated to @p item when it was
1079  * created, with function elm_diskselector_item_append(), or later
1080  * with function elm_diskselector_item_label_set. If no label
1081  * was passed as argument, it will return @c NULL.
1082  *
1083  * @see elm_diskselector_item_label_set() for more details.
1084  * @see elm_diskselector_item_append()
1085  * @deprecated Use elm_object_item_text_get() instead
1086  *
1087  * @ingroup Diskselector
1088  */
1089 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1090
1091 /**
1092  * Set the function called when a diskselector item is freed.
1093  *
1094  * @param it The item to set the callback on
1095  * @param func The function called
1096  *
1097  * If there is a @p func, then it will be called prior item's memory release.
1098  * That will be called with the following arguments:
1099  * @li item's data;
1100  * @li item's Evas object;
1101  * @li item itself;
1102  *
1103  * This way, a data associated to a diskselector item could be properly
1104  * freed.
1105  * @deprecated Use elm_object_item_del_cb_set() instead
1106  *
1107  * @ingroup Diskselector
1108  */
1109 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1110
1111 /**
1112  * Delete them item from the diskselector.
1113  *
1114  * @param it The item of diskselector to be deleted.
1115  *
1116  * If deleting all diskselector items is required, elm_diskselector_clear()
1117  * should be used instead of getting items list and deleting each one.
1118  *
1119  * @deprecated Use elm_object_item_del() instead
1120  * @see elm_diskselector_clear()
1121  * @see elm_diskselector_item_append()
1122  *
1123  * @ingroup Diskselector
1124  */
1125 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del(Elm_Object_Item *it);
1126
1127 /**
1128  * Set the text to be shown in the diskselector item.
1129  *
1130  * @param it Target item
1131  * @param text The text to set in the content
1132  *
1133  * Setup the text as tooltip to object. The item can have only one tooltip,
1134  * so any previous tooltip data is removed.
1135  *
1136  * @deprecated Use elm_object_item_tooltip_text_set() instead
1137  * @see elm_object_tooltip_text_set() for more details.
1138  *
1139  * @ingroup Diskselector
1140  */
1141 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1142
1143 /**
1144  * Set the content to be shown in the tooltip item.
1145  *
1146  * Setup the tooltip to item. The item can have only one tooltip,
1147  * so any previous tooltip data is removed. @p func(with @p data) will
1148  * be called every time that need show the tooltip and it should
1149  * return a valid Evas_Object. This object is then managed fully by
1150  * tooltip system and is deleted when the tooltip is gone.
1151  *
1152  * @param it the diskselector item being attached a tooltip.
1153  * @param func the function used to create the tooltip contents.
1154  * @param data what to provide to @a func as callback data/context.
1155  * @param del_cb called when data is not needed anymore, either when
1156  *        another callback replaces @p func, the tooltip is unset with
1157  *        elm_diskselector_item_tooltip_unset() or the owner @a item
1158  *        dies. This callback receives as the first parameter the
1159  *        given @a data, and @c event_info is the item.
1160  *
1161  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1162  * @see elm_object_tooltip_content_cb_set() for more details.
1163  *
1164  * @ingroup Diskselector
1165  */
1166 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);
1167
1168 /**
1169  * Unset tooltip from item.
1170  *
1171  * @param it diskselector item to remove previously set tooltip.
1172  *
1173  * Remove tooltip from item. The callback provided as del_cb to
1174  * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1175  * it is not used anymore.
1176  *
1177  * @deprecated Use elm_object_item_tooltip_unset() instead
1178  * @see elm_object_tooltip_unset() for more details.
1179  * @see elm_diskselector_item_tooltip_content_cb_set()
1180  *
1181  * @ingroup Diskselector
1182  */
1183 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1184
1185 /**
1186  * Sets a different style for this item tooltip.
1187  *
1188  * @note before you set a style you should define a tooltip with
1189  *       elm_diskselector_item_tooltip_content_cb_set() or
1190  *       elm_diskselector_item_tooltip_text_set()
1191  *
1192  * @param it diskselector item with tooltip already set.
1193  * @param style the theme style to use (default, transparent, ...)
1194  *
1195  * @deprecated Use elm_object_item_tooltip_style_set() instead
1196  * @see elm_object_tooltip_style_set() for more details.
1197  *
1198  * @ingroup Diskselector
1199  */
1200 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1201
1202 /**
1203  * Get the style for this item tooltip.
1204  *
1205  * @param it diskselector item with tooltip already set.
1206  * @return style the theme style in use, defaults to "default". If the
1207  *         object does not have a tooltip set, then NULL is returned.
1208  *
1209  * @deprecated Use elm_object_item_tooltip_style_get() instead
1210  * @see elm_object_tooltip_style_get() for more details.
1211  * @see elm_diskselector_item_tooltip_style_set()
1212  *
1213  * @ingroup Diskselector
1214  */
1215 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1216
1217 /**
1218  * Set the cursor to be shown when mouse is over the diskselector item
1219  *
1220  * @param it Target item
1221  * @param cursor the cursor name to be used.
1222  *
1223  * @see elm_object_cursor_set() for more details.
1224  * @deprecated Use elm_object_item_cursor_set() instead
1225  *
1226  * @ingroup Diskselector
1227  */
1228 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1229
1230 /**
1231  * Get the cursor to be shown when mouse is over the diskselector item
1232  *
1233  * @param it diskselector item with cursor already set.
1234  * @return the cursor name.
1235  *
1236  * @see elm_object_cursor_get() for more details.
1237  * @see elm_diskselector_item_cursor_set()
1238  * @deprecated Use elm_object_item_cursor_get() instead
1239  *
1240  * @ingroup Diskselector
1241  */
1242 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1243
1244 /**
1245  * Unset the cursor to be shown when mouse is over the diskselector item
1246  *
1247  * @param it Target item
1248  *
1249  * @see elm_object_cursor_unset() for more details.
1250  * @see elm_diskselector_item_cursor_set()
1251  * @deprecated use elm_object_item_cursor_unset() instead
1252  *
1253  * @ingroup Diskselector
1254  */
1255 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1256
1257 /**
1258  * Sets a different style for this item cursor.
1259  *
1260  * @note before you set a style you should define a cursor with
1261  *       elm_diskselector_item_cursor_set()
1262  *
1263  * @param it diskselector item with cursor already set.
1264  * @param style the theme style to use (default, transparent, ...)
1265  *
1266  * @see elm_object_cursor_style_set() for more details.
1267  * @deprecated Use elm_object_item_cursor_style_set() instead
1268  *
1269  * @ingroup Diskselector
1270  */
1271 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1272
1273 /**
1274  * Get the style for this item cursor.
1275  *
1276  * @param it diskselector item with cursor already set.
1277  * @return style the theme style in use, defaults to "default". If the
1278  *         object does not have a cursor set, then @c NULL is returned.
1279  *
1280  * @see elm_object_cursor_style_get() for more details.
1281  * @see elm_diskselector_item_cursor_style_set()
1282  * @deprecated Use elm_object_item_cursor_style_get() instead
1283  *
1284  * @ingroup Diskselector
1285  */
1286 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1287
1288 /**
1289  * Set if the cursor set should be searched on the theme or should use
1290  * the provided by the engine, only.
1291  *
1292  * @note before you set if should look on theme you should define a cursor
1293  * with elm_diskselector_item_cursor_set().
1294  * By default it will only look for cursors provided by the engine.
1295  *
1296  * @param it widget item with cursor already set.
1297  * @param engine_only boolean to define if cursors set with
1298  * elm_diskselector_item_cursor_set() should be searched only
1299  * between cursors provided by the engine or searched on widget's
1300  * theme as well.
1301  *
1302  * @see elm_object_cursor_engine_only_set() for more details.
1303  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1304  *
1305  * @ingroup Diskselector
1306  */
1307 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1308
1309 /**
1310  * Get the cursor engine only usage for this item cursor.
1311  *
1312  * @param it widget item with cursor already set.
1313  * @return engine_only boolean to define it cursors should be looked only
1314  * between the provided by the engine or searched on widget's theme as well.
1315  * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1316  *
1317  * @see elm_object_cursor_engine_only_get() for more details.
1318  * @see elm_diskselector_item_cursor_engine_only_set()
1319  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1320  *
1321  * @ingroup Diskselector
1322  */
1323 EINA_DEPRECATED EAPI Eina_Bool              elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1324
1325 EINA_DEPRECATED EAPI void         elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1326 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1327
1328 /**
1329  * Get the label of a given flip selector widget's item.
1330  *
1331  * @param it The item to get label from
1332  * @return The text label of @p item or @c NULL, on errors
1333  *
1334  * @see elm_object_item_text_set()
1335  *
1336  * @deprecated see elm_object_item_text_get() instead
1337  * @ingroup Flipselector
1338  */
1339 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1340
1341 /**
1342  * Set the label of a given flip selector widget's item.
1343  *
1344  * @param it The item to set label on
1345  * @param label The text label string, in UTF-8 encoding
1346  *
1347  * @see elm_object_item_text_get()
1348  *
1349  * @deprecated see elm_object_item_text_set() instead
1350  * @ingroup Flipselector
1351  */
1352 EINA_DEPRECATED EAPI void        elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1353
1354 /**
1355  * Delete a given item from a flip selector widget.
1356  *
1357  * @param it The item to delete
1358  *
1359  * @deprecated Use elm_object_item_del() instead
1360  * @ingroup Flipselector
1361  */
1362 EINA_DEPRECATED EAPI void       elm_flipselector_item_del(Elm_Object_Item *it);
1363
1364 /**
1365  * Set the interval on time updates for a user mouse button hold
1366  * on a flip selector widget.
1367  *
1368  * @param obj The flip selector object
1369  * @param interval The (first) interval value in seconds
1370  *
1371  * This interval value is @b decreased while the user holds the
1372  * mouse pointer either flipping up or flipping down a given flip
1373  * selector.
1374  *
1375  * This helps the user to get to a given item distant from the
1376  * current one easier/faster, as it will start to flip quicker and
1377  * quicker on mouse button holds.
1378  *
1379  * The calculation for the next flip interval value, starting from
1380  * the one set with this call, is the previous interval divided by
1381  * 1.05, so it decreases a little bit.
1382  *
1383  * The default starting interval value for automatic flips is
1384  * @b 0.85 seconds.
1385  *
1386  * @see elm_flipselector_interval_get()
1387  * @deprecated Use elm_flipselector_first_interval_set()
1388  *
1389  * @ingroup Flipselector
1390  */
1391 EINA_DEPRECATED EAPI void                        elm_flipselector_interval_set(Evas_Object *obj, double interval);
1392
1393 /**
1394  * Get the interval on time updates for an user mouse button hold
1395  * on a flip selector widget.
1396  *
1397  * @param obj The flip selector object
1398  * @return The (first) interval value, in seconds, set on it
1399  *
1400  * @see elm_flipselector_interval_set() for more details
1401  * @deprecated Use elm_flipselector_first_interval_get()
1402  *
1403  * @ingroup Flipselector
1404  */
1405 EINA_DEPRECATED EAPI double                      elm_flipselector_interval_get(const Evas_Object *obj);
1406
1407 /**
1408  * Make a given Elementary object the focused one.
1409  *
1410  * @param obj The Elementary object to make focused.
1411  *
1412  * @note This object, if it can handle focus, will take the focus
1413  * away from the one who had it previously and will, for now on, be
1414  * the one receiving input events.
1415  *
1416  * @see elm_object_focus_get()
1417  * @deprecated use elm_object_focus_set() instead.
1418  *
1419  * @ingroup Focus
1420  */
1421 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1422
1423 /**
1424  * Give focus to next object in object tree.
1425  *
1426  * Give focus to next object in focus chain of one object sub-tree.
1427  * If the last object of chain already have focus, the focus will go to the
1428  * first object of chain.
1429  *
1430  * @param obj The object root of sub-tree
1431  * @param dir Direction to cycle the focus
1432  *
1433  * @deprecated Use elm_object_focus_next() instead
1434  * @ingroup Focus
1435  */
1436 EINA_DEPRECATED EAPI void                 elm_object_focus_cycle(Evas_Object *obj, Elm_Focus_Direction dir);
1437
1438 /**
1439  * Remove the focus from an Elementary object
1440  *
1441  * @param obj The Elementary to take focus from
1442  *
1443  * This removes the focus from @p obj, passing it back to the
1444  * previous element in the focus chain list.
1445  *
1446  * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1447  * @deprecated use elm_object_focus_set() instead.
1448  *
1449  * @ingroup Focus
1450  */
1451 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1452
1453 /**
1454  * Give focus to near object in one direction.
1455  *
1456  * Give focus to near object in direction of one object.
1457  * If none focusable object in given direction, the focus will not change.
1458  *
1459  * @param obj The reference object
1460  * @param x Horizontal component of direction to focus
1461  * @param y Vertical component of direction to focus
1462  *
1463  * @deprecated Support it later.
1464  * @ingroup Focus
1465  */
1466 EINA_DEPRECATED EAPI void                 elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1467
1468 /**
1469  * @brief Set the frame label
1470  *
1471  * @param obj The frame object
1472  * @param label The label of this frame object
1473  *
1474  * @deprecated use elm_object_text_set() instead.
1475  */
1476 EINA_DEPRECATED EAPI void         elm_frame_label_set(Evas_Object *obj, const char *label);
1477
1478 /**
1479  * @brief Get the frame label
1480  *
1481  * @param obj The frame object
1482  *
1483  * @return The label of this frame object or NULL if unable to get frame
1484  *
1485  * @deprecated use elm_object_text_get() instead.
1486  */
1487 EINA_DEPRECATED EAPI const char  *elm_frame_label_get(const Evas_Object *obj);
1488
1489 /**
1490  * @brief Set the content of the frame widget
1491  *
1492  * Once the content object is set, a previously set one will be deleted.
1493  * If you want to keep that old content object, use the
1494  * elm_frame_content_unset() function.
1495  *
1496  * @param obj The frame object
1497  * @param content The content will be filled in this frame object
1498  *
1499  * @deprecated use elm_object_content_set() instead.
1500  */
1501 EINA_DEPRECATED EAPI void         elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1502
1503 /**
1504  * @brief Get the content of the frame widget
1505  *
1506  * Return the content object which is set for this widget
1507  *
1508  * @param obj The frame object
1509  * @return The content that is being used
1510  *
1511  * @deprecated use elm_object_content_get() instead.
1512  */
1513 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1514
1515 /**
1516  * @brief Unset the content of the frame widget
1517  *
1518  * Unparent and return the content object which was set for this widget
1519  *
1520  * @param obj The frame object
1521  * @return The content that was being used
1522  *
1523  * @deprecated use elm_object_content_unset() instead.
1524  */
1525 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1526
1527 EINA_DEPRECATED EAPI void          elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1528 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1529 EINA_DEPRECATED EAPI void          elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1530 /**
1531  * This sets the horizontal stretching mode.
1532  *
1533  * @param obj The genlist object
1534  * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1535  *
1536  * This sets the mode used for sizing items horizontally. Valid modes
1537  * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1538  * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1539  * the scroller will scroll horizontally. Otherwise items are expanded
1540  * to fill the width of the viewport of the scroller. If it is
1541  * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1542  * limited to that size.
1543  *
1544  * @see elm_genlist_horizontal_get()
1545  *
1546  * @deprecated use elm_genlist_mode_set()
1547  * @ingroup Genlist
1548  */
1549 EINA_DEPRECATED EAPI void                          elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1550
1551 /**
1552  * Gets the horizontal stretching mode.
1553  *
1554  * @param obj The genlist object
1555  * @return The mode to use
1556  * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1557  *
1558  * @see elm_genlist_horizontal_set()
1559  *
1560  * @deprecated use elm_genlist_mode_get()
1561  * @ingroup Genlist
1562  */
1563 EINA_DEPRECATED EAPI Elm_List_Mode                 elm_genlist_horizontal_get(const Evas_Object *obj);
1564
1565 /**
1566  * Return the data associated to a given genlist item
1567  *
1568  * @param it The genlist item.
1569  * @return the data associated to this item.
1570  *
1571  * This returns the @c data value passed on the
1572  * elm_genlist_item_append() and related item addition calls.
1573  *
1574  * @see elm_genlist_item_append()
1575  * @see elm_genlist_item_data_set()
1576  *
1577  * @deprecated Use elm_object_item_data_get() instead
1578  * @ingroup Genlist
1579  */
1580 EINA_DEPRECATED EAPI void                         *elm_genlist_item_data_get(const Elm_Object_Item *it);
1581
1582 /**
1583  * Set the data associated to a given genlist item
1584  *
1585  * @param it The genlist item
1586  * @param data The new data pointer to set on it
1587  *
1588  * This @b overrides the @c data value passed on the
1589  * elm_genlist_item_append() and related item addition calls. This
1590  * function @b won't call elm_genlist_item_update() automatically,
1591  * so you'd issue it afterwards if you want to hove the item
1592  * updated to reflect the that new data.
1593  *
1594  * @see elm_genlist_item_data_get()
1595  *
1596  * @deprecated Use elm_object_item_data_set() instead
1597  * @ingroup Genlist
1598  */
1599 EINA_DEPRECATED EAPI void                          elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
1600
1601 /**
1602  * Set whether a given genlist item is disabled or not.
1603  *
1604  * @param it The item
1605  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
1606  * to enable it back.
1607  *
1608  * A disabled item cannot be selected or unselected. It will also
1609  * change its appearance, to signal the user it's disabled.
1610  *
1611  * @see elm_genlist_item_disabled_get()
1612  * @deprecated Use elm_object_item_disabled_set() instead
1613  *
1614  * @ingroup Genlist
1615  */
1616 EINA_DEPRECATED EAPI void                          elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1617
1618 /**
1619  * Get whether a given genlist item is disabled or not.
1620  *
1621  * @param it The item
1622  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
1623  * (and on errors).
1624  *
1625  * @see elm_genlist_item_disabled_set() for more details
1626  * @deprecated Use elm_object_item_disabled_get() instead
1627  *
1628  * @ingroup Genlist
1629  */
1630 EINA_DEPRECATED EAPI Eina_Bool                     elm_genlist_item_disabled_get(const Elm_Object_Item *it);
1631
1632 /**
1633  * Remove a genlist item from the its parent, deleting it.
1634  *
1635  * @param it The item to be removed.
1636  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
1637  *
1638  * @see elm_genlist_clear(), to remove all items in a genlist at
1639  * once.
1640  *
1641  * @deprecated Use elm_object_item_del() instead
1642  * @ingroup Genlist
1643  */
1644 EINA_DEPRECATED EAPI void                          elm_genlist_item_del(Elm_Object_Item *it);
1645
1646 /**
1647  * Get the genlist object's handle which contains a given genlist
1648  * item
1649  *
1650  * @param it The item to fetch the container from
1651  * @return The genlist (parent) object
1652  *
1653  * This returns the genlist object itself that an item belongs to.
1654  * @deprecated Use elm_object_item_widget_get() instead
1655  *
1656  * @ingroup Genlist
1657  */
1658 EINA_DEPRECATED EAPI Evas_Object                  *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
1659
1660 /**
1661  * Get the mode item style of items in the genlist
1662  * @param obj The genlist object
1663  * @return The mode item style string, or NULL if none is specified
1664  *
1665  * This is a constant string and simply defines the name of the
1666  * style that will be used for mode animations. It can be
1667  * @c NULL if you don't plan to use Genlist mode. See
1668  * elm_genlist_item_mode_set() for more info.
1669  *
1670  * @ingroup Genlist
1671  */
1672 EINA_DEPRECATED EAPI const char                   *elm_genlist_mode_item_style_get(const Evas_Object *obj);
1673
1674 /**
1675  * Set the mode item style of items in the genlist
1676  * @param obj The genlist object
1677  * @param style The mode item style string, or NULL if none is desired
1678  *
1679  * This is a constant string and simply defines the name of the
1680  * style that will be used for mode animations. It can be
1681  * @c NULL if you don't plan to use Genlist mode. See
1682  * elm_genlist_item_mode_set() for more info.
1683  *
1684  * @ingroup Genlist
1685  */
1686 EINA_DEPRECATED EAPI void                          elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
1687
1688 /**
1689  * Get the real Evas object created to implement the view of a
1690  * given genlist item
1691  *
1692  * @param it The genlist item.
1693  * @return the Evas object implementing this item's view.
1694  *
1695  * This returns the actual Evas object used to implement the
1696  * specified genlist item's view. This may be @c NULL, as it may
1697  * not have been created or may have been deleted, at any time, by
1698  * the genlist. <b>Do not modify this object</b> (move, resize,
1699  * show, hide, etc.), as the genlist is controlling it. This
1700  * function is for querying, emitting custom signals or hooking
1701  * lower level callbacks for events on that object. Do not delete
1702  * this object under any circumstances.
1703  *
1704  * @see elm_object_item_data_get()
1705  * @deprecated No more support
1706  *
1707  * @ingroup Genlist
1708  */
1709 EINA_DEPRECATED EAPI const Evas_Object            *elm_genlist_item_object_get(const Elm_Object_Item *it);
1710
1711 /**
1712  * Get the Item's Flags
1713  *
1714  * @param it The genlist item
1715  * @return The item type.
1716  *
1717  * This function returns the item's type. Normally the item's type.
1718  * If it failed, return value is ELM_GENLIST_ITEM_MAX
1719  *
1720  * @deprecated Use elm_genlist_item_type_get() instead
1721  * @ingroup Genlist
1722  */
1723 EINA_DEPRECATED EAPI Elm_Genlist_Item_Type        elm_genlist_item_flags_get(const Elm_Object_Item *it);
1724
1725 /**
1726  * Tells genlist to "orphan" contents fetched by the item class
1727  *
1728  * @param it The item
1729  *
1730  * This instructs genlist to release references to contents in the item,
1731  * meaning that they will no longer be managed by genlist and are
1732  * floating "orphans" that can be re-used elsewhere if the user wants
1733  * to.
1734  *
1735  * @deprecated Use elm_genlist_item_all_contents_unset() instead
1736  * @ingroup Genlist
1737  */
1738 EINA_DEPRECATED EAPI void                          elm_genlist_item_contents_orphan(Elm_Object_Item *it);
1739
1740 #define ELM_IMAGE_ROTATE_90_CW 1
1741 #define ELM_IMAGE_ROTATE_180_CW 2
1742 #define ELM_IMAGE_ROTATE_90_CCW 3
1743
1744 /**
1745  * Return the data associated with a given index widget item
1746  *
1747  * @param item The index widget item handle
1748  * @return The data associated with @p it
1749  * @deprecated Use elm_object_item_data_get() instead
1750  *
1751  * @see elm_index_item_data_set()
1752  *
1753  * @ingroup Index
1754  */
1755 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1756
1757 /**
1758  * Set the data associated with a given index widget item
1759  *
1760  * @param it The index widget item handle
1761  * @param data The new data pointer to set to @p it
1762  *
1763  * This sets new item data on @p it.
1764  *
1765  * @warning The old data pointer won't be touched by this function, so
1766  * the user had better to free that old data himself/herself.
1767  *
1768  * @deprecated Use elm_object_item_data_set() instead
1769  * @ingroup Index
1770  */
1771 EINA_DEPRECATED EAPI void  elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1772
1773 /**
1774  * Set the function to be called when a given index widget item is freed.
1775  *
1776  * @param it The item to set the callback on
1777  * @param func The function to call on the item's deletion
1778  *
1779  * When called, @p func will have both @c data and @c event_info
1780  * arguments with the @p it item's data value and, naturally, the
1781  * @c obj argument with a handle to the parent index widget.
1782  *
1783  * @deprecated Use elm_object_item_del_cb_set() instead
1784  * @ingroup Index
1785  */
1786 EINA_DEPRECATED EAPI void                  elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1787
1788 /**
1789  * Remove an item from a given index widget, <b>to be referenced by
1790  * it's data value</b>.
1791  *
1792  * @param obj The index object
1793  * @param item The item to be removed from @p obj
1794  *
1795  * If a deletion callback is set, via elm_object_item_del_cb_set(),
1796  * that callback function will be called by this one.
1797  *
1798  * @deprecated Use elm_object_item_del() instead
1799  * @ingroup Index
1800  */
1801 EINA_DEPRECATED EAPI void                  elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
1802
1803 /**
1804 * @brief Set the label on the label object
1805  *
1806  * @param obj The label object
1807  * @param label The label will be used on the label object
1808  * @deprecated See elm_object_text_set()
1809  */
1810 EINA_DEPRECATED EAPI void        elm_label_label_set(Evas_Object *obj, const char *label);
1811
1812 /**
1813  * @brief Get the label used on the label object
1814  *
1815  * @param obj The label object
1816  * @return The string inside the label
1817  * @deprecated See elm_object_text_get()
1818  */
1819 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
1820
1821
1822 /**
1823  * Set the layout content.
1824  *
1825  * @param obj The layout object
1826  * @param swallow The swallow part name in the edje file
1827  * @param content The child that will be added in this layout object
1828  * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
1829  *
1830  * Once the content object is set, a previously set one will be deleted.
1831  * If you want to keep that old content object, use the
1832  * elm_object_part_content_unset() function.
1833  *
1834  * @note In an Edje theme, the part used as a content container is called @c
1835  * SWALLOW. This is why the parameter name is called @p swallow, but it is
1836  * expected to be a part name just like the second parameter of
1837  * elm_layout_box_append().
1838  *
1839  * @see elm_layout_box_append()
1840  * @see elm_object_part_content_get()
1841  * @see elm_object_part_content_unset()
1842  * @see @ref secBox
1843  * @deprecated use elm_object_part_content_set() instead
1844  *
1845  * @ingroup Layout
1846  */
1847 EINA_DEPRECATED EAPI Eina_Bool    elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
1848
1849 /**
1850  * Get the child object in the given content part.
1851  *
1852  * @param obj The layout object
1853  * @param swallow The SWALLOW part to get its content
1854  *
1855  * @return The swallowed object or NULL if none or an error occurred
1856  *
1857  * @deprecated use elm_object_part_content_get() instead
1858  *
1859  * @ingroup Layout
1860  */
1861 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
1862
1863 /**
1864  * Unset the layout content.
1865  *
1866  * @param obj The layout object
1867  * @param swallow The swallow part name in the edje file
1868  * @return The content that was being used
1869  *
1870  * Unparent and return the content object which was set for this part.
1871  *
1872  * @deprecated use elm_object_part_content_unset() instead
1873  *
1874  * @ingroup Layout
1875  */
1876 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
1877
1878 /**
1879  * Set the text of the given part
1880  *
1881  * @param obj The layout object
1882  * @param part The TEXT part where to set the text
1883  * @param text The text to set
1884  * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
1885  *
1886  * @ingroup Layout
1887  * @deprecated use elm_object_part_text_set() instead.
1888  */
1889 EINA_DEPRECATED EAPI Eina_Bool    elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
1890
1891 /**
1892  * Get the text set in the given part
1893  *
1894  * @param obj The layout object
1895  * @param part The TEXT part to retrieve the text off
1896  *
1897  * @return The text set in @p part
1898  *
1899  * @ingroup Layout
1900  * @deprecated use elm_object_part_text_get() instead.
1901  */
1902 EINA_DEPRECATED EAPI const char  *elm_layout_text_get(const Evas_Object *obj, const char *part);
1903
1904 /**
1905  * @def elm_layout_label_set
1906  * Convenience macro to set the label in a layout that follows the
1907  * Elementary naming convention for its parts.
1908  *
1909  * @ingroup Layout
1910  * @deprecated use elm_object_text_set() instead.
1911  */
1912 #define elm_layout_label_set(_ly, _txt) \
1913   elm_layout_text_set((_ly), "elm.text", (_txt))
1914
1915 /**
1916  * @def elm_layout_label_get
1917  * Convenience macro to get the label in a layout that follows the
1918  * Elementary naming convention for its parts.
1919  *
1920  * @ingroup Layout
1921  * @deprecated use elm_object_text_set() instead.
1922  */
1923 #define elm_layout_label_get(_ly) \
1924   elm_layout_text_get((_ly), "elm.text")
1925
1926 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
1927
1928
1929 /**
1930  * Set the content of the mapbuf.
1931  *
1932  * @param obj The mapbuf object.
1933  * @param content The content that will be filled in this mapbuf object.
1934  *
1935  * Once the content object is set, a previously set one will be deleted.
1936  * If you want to keep that old content object, use the
1937  * elm_mapbuf_content_unset() function.
1938  *
1939  * To enable map, elm_mapbuf_enabled_set() should be used.
1940  *
1941  * @deprecated use elm_object_content_set() instead
1942  *
1943  * @ingroup Mapbuf
1944  */
1945 EINA_DEPRECATED EAPI void         elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
1946
1947 /**
1948  * Get the content of the mapbuf.
1949  *
1950  * @param obj The mapbuf object.
1951  * @return The content that is being used.
1952  *
1953  * Return the content object which is set for this widget.
1954  *
1955  * @see elm_mapbuf_content_set() for details.
1956  *
1957  * @deprecated use elm_object_content_get() instead
1958  *
1959  * @ingroup Mapbuf
1960  */
1961 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
1962
1963 /**
1964  * Unset the content of the mapbuf.
1965  *
1966  * @param obj The mapbuf object.
1967  * @return The content that was being used.
1968  *
1969  * Unparent and return the content object which was set for this widget.
1970  *
1971  * @see elm_mapbuf_content_set() for details.
1972  *
1973  * @deprecated use elm_object_content_unset() instead
1974  *
1975  * @ingroup Mapbuf
1976  */
1977 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
1978
1979 /**
1980  * @brief Set the label of a menu item
1981  *
1982  * @param it The menu item object.
1983  * @param label The label to set for @p item
1984  *
1985  * @warning Don't use this function on items created with
1986  * elm_menu_item_add_object() or elm_menu_item_separator_add().
1987  *
1988  * @deprecated Use elm_object_item_text_set() instead
1989  */
1990 EINA_DEPRECATED EAPI void         elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
1991
1992 /**
1993  * @brief Get the label of a menu item
1994  *
1995  * @param it The menu item object.
1996  * @return The label of @p item
1997  * @deprecated Use elm_object_item_text_get() instead
1998  */
1999 EINA_DEPRECATED EAPI const char  *elm_menu_item_label_get(const Elm_Object_Item *it);
2000
2001 /**
2002  * @brief Set the content object of a menu item
2003  *
2004  * @param it The menu item object
2005  * @param The content object or NULL
2006  * @return EINA_TRUE on success, else EINA_FALSE
2007  *
2008  * Use this function to change the object swallowed by a menu item, deleting
2009  * any previously swallowed object.
2010  *
2011  * @deprecated Use elm_object_item_content_set() instead
2012  */
2013 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
2014
2015 /**
2016  * @brief Get the content object of a menu item
2017  *
2018  * @param it The menu item object
2019  * @return The content object or NULL
2020  * @note If @p item was added with elm_menu_item_add_object, this
2021  * function will return the object passed, else it will return the
2022  * icon object.
2023  *
2024  * @see elm_menu_item_object_content_set()
2025  *
2026  * @deprecated Use elm_object_item_content_get() instead
2027  */
2028 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
2029
2030 /**
2031  * @brief Set the disabled state of @p item.
2032  *
2033  * @param it The menu item object.
2034  * @param disabled The enabled/disabled state of the item
2035  * @deprecated Use elm_object_item_disabled_set() instead
2036  */
2037 EINA_DEPRECATED EAPI void         elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2038
2039 /**
2040  * @brief Get the disabled state of @p item.
2041  *
2042  * @param it The menu item object.
2043  * @return The enabled/disabled state of the item
2044  *
2045  * @see elm_menu_item_disabled_set()
2046  * @deprecated Use elm_object_item_disabled_get() instead
2047  */
2048 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_disabled_get(const Elm_Object_Item *it);
2049
2050 /**
2051  * @brief Returns the data associated with menu item @p item.
2052  *
2053  * @param it The item
2054  * @return The data associated with @p item or NULL if none was set.
2055  *
2056  * This is the data set with elm_menu_add() or elm_menu_item_data_set().
2057  *
2058  * @deprecated Use elm_object_item_data_get() instead
2059  */
2060 EINA_DEPRECATED EAPI void        *elm_menu_item_data_get(const Elm_Object_Item *it);
2061
2062 /**
2063  * @brief Set the function called when a menu item is deleted.
2064  *
2065  * @param it The item to set the callback on
2066  * @param func The function called
2067  *
2068  * @see elm_menu_item_add()
2069  * @see elm_menu_item_del()
2070  * @deprecated Use elm_object_item_del_cb_set() instead
2071  */
2072 EINA_DEPRECATED EAPI void                         elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2073
2074 /**
2075  * @brief Sets the data to be associated with menu item @p item.
2076  *
2077  * @param it The item
2078  * @param data The data to be associated with @p item
2079  *
2080  * @deprecated Use elm_object_item_data_set() instead
2081  */
2082 EINA_DEPRECATED EAPI void         elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
2083
2084 /**
2085  * @brief Deletes an item from the menu.
2086  *
2087  * @param it The item to delete.
2088  *
2089  * @deprecated Use elm_object_item_del() instead
2090  * @see elm_menu_item_add()
2091  */
2092 EINA_DEPRECATED EAPI void                         elm_menu_item_del(Elm_Object_Item *it);
2093
2094 /**
2095  * @brief @brief Return a menu item's owner menu
2096  *
2097  * @param it The menu item
2098  * @return The menu object owning @p item, or NULL on failure
2099  *
2100  * Use this function to get the menu object owning an item.
2101  * @deprecated Use elm_object_item_widget_get() instead
2102  */
2103 EINA_DEPRECATED EAPI Evas_Object                 *elm_menu_item_menu_get(const Elm_Object_Item *it);
2104
2105 /**
2106  * @brief Set the icon of a menu item to the standard icon with name @p icon
2107  *
2108  * @param it The menu item object.
2109  * @param icon The icon object to set for the content of @p item
2110  *
2111  * @deprecated elm_menu_item_icon_name_set() instead
2112  * Once this icon is set, any previously set icon will be deleted.
2113  */
2114 EINA_DEPRECATED EAPI void                         elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2115
2116 /**
2117  * @brief Get the string representation from the icon of a menu item
2118  *
2119  * @param it The menu item object.
2120  * @return The string representation of @p item's icon or NULL
2121  *
2122  * @deprecated elm_menu_item_icon_name_get() instead
2123  * @see elm_menu_item_icon_name_set()
2124  */
2125 EINA_DEPRECATED EAPI const char                  *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2126
2127 /**
2128  * @brief Set the content of the notify widget
2129  *
2130  * @param obj The notify object
2131  * @param content The content will be filled in this notify object
2132  *
2133  * Once the content object is set, a previously set one will be deleted. If
2134  * you want to keep that old content object, use the
2135  * elm_notify_content_unset() function.
2136  *
2137  * @deprecated use elm_object_content_set() instead
2138  *
2139  */
2140 EINA_DEPRECATED EAPI void         elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2141
2142 /**
2143  * @brief Unset the content of the notify widget
2144  *
2145  * @param obj The notify object
2146  * @return The content that was being used
2147  *
2148  * Unparent and return the content object which was set for this widget
2149  *
2150  * @see elm_notify_content_set()
2151  * @deprecated use elm_object_content_unset() instead
2152  *
2153  */
2154 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2155
2156 /**
2157  * @brief Return the content of the notify widget
2158  *
2159  * @param obj The notify object
2160  * @return The content that is being used
2161  *
2162  * @see elm_notify_content_set()
2163  * @deprecated use elm_object_content_get() instead
2164  *
2165  */
2166 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2167
2168 /**
2169  * Set a label of an object
2170  *
2171  * @param obj The Elementary object
2172  * @param part The text part name to set (NULL for the default label)
2173  * @param label The new text of the label
2174  *
2175  * @note Elementary objects may have many labels (e.g. Action Slider)
2176  * @deprecated Use elm_object_part_text_set() instead.
2177  * @ingroup General
2178  */
2179 EINA_DEPRECATED EAPI void         elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2180
2181 /**
2182  * Get a label of an object
2183  *
2184  * @param obj The Elementary object
2185  * @param part The text part name to get (NULL for the default label)
2186  * @return text of the label or NULL for any error
2187  *
2188  * @note Elementary objects may have many labels (e.g. Action Slider)
2189  * @deprecated Use elm_object_part_text_get() instead.
2190  * @ingroup General
2191  */
2192 EINA_DEPRECATED EAPI const char  *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2193
2194 /**
2195  * Set a content of an object
2196  *
2197  * @param obj The Elementary object
2198  * @param part The content part name to set (NULL for the default content)
2199  * @param content The new content of the object
2200  *
2201  * @note Elementary objects may have many contents
2202  * @deprecated Use elm_object_part_content_set instead.
2203  * @ingroup General
2204  */
2205 EINA_DEPRECATED EAPI void         elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2206
2207 /**
2208  * Get a content of an object
2209  *
2210  * @param obj The Elementary object
2211  * @param part The content part name to get (NULL for the default content)
2212  * @return content of the object or NULL for any error
2213  *
2214  * @note Elementary objects may have many contents
2215  * @deprecated Use elm_object_part_content_get instead.
2216  * @ingroup General
2217  */
2218 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2219
2220 /**
2221  * Unset a content of an object
2222  *
2223  * @param obj The Elementary object
2224  * @param part The content part name to unset (NULL for the default content)
2225  *
2226  * @note Elementary objects may have many contents
2227  * @deprecated Use elm_object_part_content_unset instead.
2228  * @ingroup General
2229  */
2230 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2231
2232 /**
2233  * Set a content of an object item
2234  *
2235  * @param it The Elementary object item
2236  * @param part The content part name to set (NULL for the default content)
2237  * @param content The new content of the object item
2238  *
2239  * @note Elementary object items may have many contents
2240  * @deprecated Use elm_object_item_part_content_set instead.
2241  * @ingroup General
2242  */
2243 EINA_DEPRECATED EAPI void         elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2244
2245 /**
2246  * Get a content of an object item
2247  *
2248  * @param it The Elementary object item
2249  * @param part The content part name to unset (NULL for the default content)
2250  * @return content of the object item or NULL for any error
2251  *
2252  * @note Elementary object items may have many contents
2253  * @deprecated Use elm_object_item_part_content_get instead.
2254  * @ingroup General
2255  */
2256 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2257
2258 /**
2259  * Unset a content of an object item
2260  *
2261  * @param it The Elementary object item
2262  * @param part The content part name to unset (NULL for the default content)
2263  *
2264  * @note Elementary object items may have many contents
2265  * @deprecated Use elm_object_item_part_content_unset instead.
2266  * @ingroup General
2267  */
2268 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2269
2270 /**
2271  * Get a label of an object item
2272  *
2273  * @param it The Elementary object item
2274  * @param part The text part name to get (NULL for the default label)
2275  * @return text of the label or NULL for any error
2276  *
2277  * @note Elementary object items may have many labels
2278  * @deprecated Use elm_object_item_part_text_get instead.
2279  * @ingroup General
2280  */
2281 EINA_DEPRECATED EAPI const char  *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2282
2283 /**
2284  * Set a label of an object item
2285  *
2286  * @param it The Elementary object item
2287  * @param part The text part name to set (NULL for the default label)
2288  * @param label The new text of the label
2289  *
2290  * @note Elementary object items may have many labels
2291  * @deprecated Use elm_object_item_part_text_set instead.
2292  * @ingroup General
2293  */
2294 EINA_DEPRECATED EAPI void         elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2295
2296 /**
2297  * @brief Set the content of the panel.
2298  *
2299  * @param obj The panel object
2300  * @param content The panel content
2301  *
2302  * Once the content object is set, a previously set one will be deleted.
2303  * If you want to keep that old content object, use the
2304  * elm_panel_content_unset() function.
2305  *
2306  * @deprecated use elm_object_content_set() instead
2307  *
2308  */
2309 EINA_DEPRECATED EAPI void         elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2310
2311 /**
2312  * @brief Get the content of the panel.
2313  *
2314  * @param obj The panel object
2315  * @return The content that is being used
2316  *
2317  * Return the content object which is set for this widget.
2318  *
2319  * @see elm_panel_content_set()
2320  *
2321  * @deprecated use elm_object_content_get() instead
2322  *
2323  */
2324 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2325
2326 /**
2327  * @brief Unset the content of the panel.
2328  *
2329  * @param obj The panel object
2330  * @return The content that was being used
2331  *
2332  * Unparent and return the content object which was set for this widget.
2333  *
2334  * @see elm_panel_content_set()
2335  *
2336  * @deprecated use elm_object_content_unset() instead
2337  *
2338  */
2339 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2340
2341 /**
2342  * Set the left content of the panes widget.
2343  *
2344  * @param obj The panes object.
2345  * @param content The new left content object.
2346  *
2347  * Once the content object is set, a previously set one will be deleted.
2348  * If you want to keep that old content object, use the
2349  * elm_panes_content_left_unset() function.
2350  *
2351  * If panes is displayed vertically, left content will be displayed at
2352  * top.
2353  *
2354  * @see elm_panes_content_left_get()
2355  * @see elm_panes_content_right_set() to set content on the other side.
2356  *
2357  * @deprecated use elm_object_part_content_set() instead
2358  *
2359  * @ingroup Panes
2360  */
2361 EINA_DEPRECATED EAPI void         elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2362
2363 /**
2364  * Set the right content of the panes widget.
2365  *
2366  * @param obj The panes object.
2367  * @param content The new right content object.
2368  *
2369  * Once the content object is set, a previously set one will be deleted.
2370  * If you want to keep that old content object, use the
2371  * elm_panes_content_right_unset() function.
2372  *
2373  * If panes is displayed vertically, left content will be displayed at
2374  * bottom.
2375  *
2376  * @see elm_panes_content_right_get()
2377  * @see elm_panes_content_left_set() to set content on the other side.
2378  *
2379  * @deprecated use elm_object_part_content_set() instead
2380  *
2381  * @ingroup Panes
2382  */
2383 EINA_DEPRECATED EAPI void         elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2384
2385 /**
2386  * Get the left content of the panes.
2387  *
2388  * @param obj The panes object.
2389  * @return The left content object that is being used.
2390  *
2391  * Return the left content object which is set for this widget.
2392  *
2393  * @see elm_panes_content_left_set() for details.
2394  *
2395  * @deprecated use elm_object_part_content_get() instead
2396  *
2397  * @ingroup Panes
2398  */
2399 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2400
2401 /**
2402  * Get the right content of the panes.
2403  *
2404  * @param obj The panes object
2405  * @return The right content object that is being used
2406  *
2407  * Return the right content object which is set for this widget.
2408  *
2409  * @see elm_panes_content_right_set() for details.
2410  *
2411  * @deprecated use elm_object_part_content_get() instead
2412  *
2413  * @ingroup Panes
2414  */
2415 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2416
2417 /**
2418  * Unset the left content used for the panes.
2419  *
2420  * @param obj The panes object.
2421  * @return The left content object that was being used.
2422  *
2423  * Unparent and return the left content object which was set for this widget.
2424  *
2425  * @see elm_panes_content_left_set() for details.
2426  * @see elm_panes_content_left_get().
2427  *
2428  * @deprecated use elm_object_part_content_unset() instead
2429  *
2430  * @ingroup Panes
2431  */
2432 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2433
2434 /**
2435  * Unset the right content used for the panes.
2436  *
2437  * @param obj The panes object.
2438  * @return The right content object that was being used.
2439  *
2440  * Unparent and return the right content object which was set for this
2441  * widget.
2442  *
2443  * @see elm_panes_content_right_set() for details.
2444  * @see elm_panes_content_right_get().
2445  *
2446  * @deprecated use elm_object_part_content_unset() instead
2447  *
2448  * @ingroup Panes
2449  */
2450 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2451 /**
2452  * Set the label of a given progress bar widget
2453  *
2454  * @param obj The progress bar object
2455  * @param label The text label string, in UTF-8
2456  *
2457  * @ingroup Progressbar
2458  * @deprecated use elm_object_text_set() instead.
2459  */
2460 EINA_DEPRECATED EAPI void         elm_progressbar_label_set(Evas_Object *obj, const char *label);
2461
2462 /**
2463  * Get the label of a given progress bar widget
2464  *
2465  * @param obj The progressbar object
2466  * @return The text label string, in UTF-8
2467  *
2468  * @ingroup Progressbar
2469  * @deprecated use elm_object_text_set() instead.
2470  */
2471 EINA_DEPRECATED EAPI const char  *elm_progressbar_label_get(const Evas_Object *obj);
2472
2473 /**
2474  * Set the icon object of a given progress bar widget
2475  *
2476  * @param obj The progress bar object
2477  * @param icon The icon object
2478  *
2479  * Use this call to decorate @p obj with an icon next to it.
2480  *
2481  * @note Once the icon object is set, a previously set one will be
2482  * deleted. If you want to keep that old content object, use the
2483  * elm_progressbar_icon_unset() function.
2484  *
2485  * @see elm_progressbar_icon_get()
2486  * @deprecated use elm_object_part_content_set() instead.
2487  *
2488  * @ingroup Progressbar
2489  */
2490 EINA_DEPRECATED EAPI void         elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon);
2491
2492 /**
2493  * Retrieve the icon object set for a given progress bar widget
2494  *
2495  * @param obj The progress bar object
2496  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2497  * otherwise (and on errors)
2498  *
2499  * @see elm_progressbar_icon_set() for more details
2500  * @deprecated use elm_object_part_content_get() instead.
2501  *
2502  * @ingroup Progressbar
2503  */
2504 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2505
2506 /**
2507  * Unset an icon set on a given progress bar widget
2508  *
2509  * @param obj The progress bar object
2510  * @return The icon object that was being used, if any was set, or
2511  * @c NULL, otherwise (and on errors)
2512  *
2513  * This call will unparent and return the icon object which was set
2514  * for this widget, previously, on success.
2515  *
2516  * @see elm_progressbar_icon_set() for more details
2517  * @deprecated use elm_object_part_content_unset() instead.
2518  *
2519  * @ingroup Progressbar
2520  */
2521 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2522
2523 /**
2524  * @brief Set the text label of the radio object
2525  *
2526  * @param obj The radio object
2527  * @param label The text label string in UTF-8
2528  *
2529  * @deprecated use elm_object_text_set() instead.
2530  */
2531 EINA_DEPRECATED EAPI void         elm_radio_label_set(Evas_Object *obj, const char *label);
2532
2533 /**
2534  * @brief Get the text label of the radio object
2535  *
2536  * @param obj The radio object
2537  * @return The text label string in UTF-8
2538  *
2539  * @deprecated use elm_object_text_set() instead.
2540  */
2541 EINA_DEPRECATED EAPI const char  *elm_radio_label_get(const Evas_Object *obj);
2542
2543 /**
2544  * @brief Set the icon object of the radio object
2545  *
2546  * @param obj The radio object
2547  * @param icon The icon object
2548  *
2549  * Once the icon object is set, a previously set one will be deleted. If you
2550  * want to keep that old content object, use the elm_radio_icon_unset()
2551  * function.
2552  *
2553  * @deprecated use elm_object_part_content_set() instead.
2554  *
2555  */
2556 EINA_DEPRECATED EAPI void         elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2557
2558 /**
2559  * @brief Get the icon object of the radio object
2560  *
2561  * @param obj The radio object
2562  * @return The icon object
2563  *
2564  * @see elm_radio_icon_set()
2565  *
2566  * @deprecated use elm_object_part_content_get() instead.
2567  *
2568  */
2569 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2570
2571 /**
2572  * @brief Unset the icon used for the radio object
2573  *
2574  * @param obj The radio object
2575  * @return The icon object that was being used
2576  *
2577  * Unparent and return the icon object which was set for this widget.
2578  *
2579  * @see elm_radio_icon_set()
2580  * @deprecated use elm_object_part_content_unset() instead.
2581  *
2582  */
2583 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2584
2585 /**
2586  * @brief Set the content of the scroller widget (the object to be scrolled around).
2587  *
2588  * @param obj The scroller object
2589  * @param content The new content object
2590  *
2591  * Once the content object is set, a previously set one will be deleted.
2592  * If you want to keep that old content object, use the
2593  * elm_scroller_content_unset() function.
2594  * @deprecated use elm_object_content_set() instead
2595  */
2596 EINA_DEPRECATED EAPI void         elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2597
2598 /**
2599  * @brief Get the content of the scroller widget
2600  *
2601  * @param obj The slider object
2602  * @return The content that is being used
2603  *
2604  * Return the content object which is set for this widget
2605  *
2606  * @see elm_scroller_content_set()
2607  * @deprecated use elm_object_content_get() instead.
2608  */
2609 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2610
2611 /**
2612  * @brief Unset the content of the scroller widget
2613  *
2614  * @param obj The slider object
2615  * @return The content that was being used
2616  *
2617  * Unparent and return the content object which was set for this widget
2618  *
2619  * @see elm_scroller_content_set()
2620  * @deprecated use elm_object_content_unset() instead.
2621  */
2622 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2623
2624 /**
2625  * Set the label of a given slider widget
2626  *
2627  * @param obj The progress bar object
2628  * @param label The text label string, in UTF-8
2629  *
2630  * @ingroup Slider
2631  * @deprecated use elm_object_text_set() instead.
2632  */
2633 EINA_DEPRECATED EAPI void         elm_slider_label_set(Evas_Object *obj, const char *label);
2634
2635 /**
2636  * Get the label of a given slider widget
2637  *
2638  * @param obj The progressbar object
2639  * @return The text label string, in UTF-8
2640  *
2641  * @ingroup Slider
2642  * @deprecated use elm_object_text_get() instead.
2643  */
2644 EINA_DEPRECATED EAPI const char  *elm_slider_label_get(const Evas_Object *obj);
2645
2646 /**
2647  * Set the icon object of the slider object.
2648  *
2649  * @param obj The slider object.
2650  * @param icon The icon object.
2651  *
2652  * On horizontal mode, icon is placed at left, and on vertical mode,
2653  * placed at top.
2654  *
2655  * @note Once the icon object is set, a previously set one will be deleted.
2656  * If you want to keep that old content object, use the
2657  * elm_slider_icon_unset() function.
2658  *
2659  * @warning If the object being set does not have minimum size hints set,
2660  * it won't get properly displayed.
2661  *
2662  * @ingroup Slider
2663  * @deprecated use elm_object_part_content_set() instead.
2664  */
2665 EINA_DEPRECATED EAPI void         elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2666
2667 /**
2668  * Unset an icon set on a given slider widget.
2669  *
2670  * @param obj The slider object.
2671  * @return The icon object that was being used, if any was set, or
2672  * @c NULL, otherwise (and on errors).
2673  *
2674  * On horizontal mode, icon is placed at left, and on vertical mode,
2675  * placed at top.
2676  *
2677  * This call will unparent and return the icon object which was set
2678  * for this widget, previously, on success.
2679  *
2680  * @see elm_slider_icon_set() for more details
2681  * @see elm_slider_icon_get()
2682  * @deprecated use elm_object_part_content_unset() instead.
2683  *
2684  * @ingroup Slider
2685  */
2686 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2687
2688 /**
2689  * Retrieve the icon object set for a given slider widget.
2690  *
2691  * @param obj The slider object.
2692  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2693  * otherwise (and on errors).
2694  *
2695  * On horizontal mode, icon is placed at left, and on vertical mode,
2696  * placed at top.
2697  *
2698  * @see elm_slider_icon_set() for more details
2699  * @see elm_slider_icon_unset()
2700  *
2701  * @deprecated use elm_object_part_content_get() instead.
2702  *
2703  * @ingroup Slider
2704  */
2705 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2706
2707 /**
2708  * Set the end object of the slider object.
2709  *
2710  * @param obj The slider object.
2711  * @param end The end object.
2712  *
2713  * On horizontal mode, end is placed at left, and on vertical mode,
2714  * placed at bottom.
2715  *
2716  * @note Once the icon object is set, a previously set one will be deleted.
2717  * If you want to keep that old content object, use the
2718  * elm_slider_end_unset() function.
2719  *
2720  * @warning If the object being set does not have minimum size hints set,
2721  * it won't get properly displayed.
2722  *
2723  * @deprecated use elm_object_part_content_set() instead.
2724  *
2725  * @ingroup Slider
2726  */
2727 EINA_DEPRECATED EAPI void         elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2728
2729 /**
2730  * Unset an end object set on a given slider widget.
2731  *
2732  * @param obj The slider object.
2733  * @return The end object that was being used, if any was set, or
2734  * @c NULL, otherwise (and on errors).
2735  *
2736  * On horizontal mode, end is placed at left, and on vertical mode,
2737  * placed at bottom.
2738  *
2739  * This call will unparent and return the icon object which was set
2740  * for this widget, previously, on success.
2741  *
2742  * @see elm_slider_end_set() for more details.
2743  * @see elm_slider_end_get()
2744  *
2745  * @deprecated use elm_object_part_content_unset() instead
2746  * instead.
2747  *
2748  * @ingroup Slider
2749  */
2750 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2751
2752 /**
2753  * Retrieve the end object set for a given slider widget.
2754  *
2755  * @param obj The slider object.
2756  * @return The end object's handle, if @p obj had one set, or @c NULL,
2757  * otherwise (and on errors).
2758  *
2759  * On horizontal mode, icon is placed at right, and on vertical mode,
2760  * placed at bottom.
2761  *
2762  * @see elm_slider_end_set() for more details.
2763  * @see elm_slider_end_unset()
2764  *
2765  *
2766  * @deprecated use elm_object_part_content_get() instead
2767  * instead.
2768  *
2769  * @ingroup Slider
2770  */
2771 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2772
2773 /**
2774  * Return the data associated with a given slideshow item
2775  *
2776  * @param it The slideshow item
2777  * @return Returns the data associated to this item
2778  *
2779  * @deprecated use elm_object_item_data_get() instead
2780  * @ingroup Slideshow
2781  */
2782 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2783
2784 /**
2785  * Delete a given item from a slideshow widget.
2786  *
2787  * @param it The slideshow item
2788  *
2789  * @deprecated Use elm_object_item_de() instead
2790  * @ingroup Slideshow
2791  */
2792 EINA_DEPRECATED EAPI void                  elm_slideshow_item_del(Elm_Object_Item *it);
2793
2794 /**
2795  * Display a given slideshow widget's item, programmatically.
2796  *
2797  * @param it The item to display on @p obj's viewport
2798  *
2799  * The change between the current item and @p item will use the
2800  * transition @p obj is set to use (@see
2801  * elm_slideshow_transition_set()).
2802  *
2803  * @deprecated use elm_slideshow_item_show() instead
2804  * @ingroup Slideshow
2805  */
2806 EINA_DEPRECATED EAPI void                  elm_slideshow_show(Elm_Object_Item *it);
2807
2808 /**
2809  * Get the toolbar object from an item.
2810  *
2811  * @param it The item.
2812  * @return The toolbar object.
2813  *
2814  * This returns the toolbar object itself that an item belongs to.
2815  *
2816  * @deprecated use elm_object_item_object_get() instead.
2817  * @ingroup Toolbar
2818  */
2819 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2820
2821 /**
2822  * Get the label of item.
2823  *
2824  * @param it The item of toolbar.
2825  * @return The label of item.
2826  *
2827  * The return value is a pointer to the label associated to @p item when
2828  * it was created, with function elm_toolbar_item_append() or similar,
2829  * or later,
2830  * with function elm_toolbar_item_label_set. If no label
2831  * was passed as argument, it will return @c NULL.
2832  *
2833  * @see elm_toolbar_item_label_set() for more details.
2834  * @see elm_toolbar_item_append()
2835  *
2836  * @deprecated use elm_object_item_text_get() instead.
2837  * @ingroup Toolbar
2838  */
2839 EINA_DEPRECATED EAPI const char  *elm_toolbar_item_label_get(const Elm_Object_Item *it);
2840
2841 /**
2842  * Set the label of item.
2843  *
2844  * @param it The item of toolbar.
2845  * @param label The label of item.
2846  *
2847  * The label to be displayed by the item.
2848  * Label will be placed at icons bottom (if set).
2849  *
2850  * If a label was passed as argument on item creation, with function
2851  * elm_toolbar_item_append() or similar, it will be already
2852  * displayed by the item.
2853  *
2854  * @see elm_toolbar_item_label_get()
2855  * @see elm_toolbar_item_append()
2856  *
2857  * @deprecated use elm_object_item_text_set() instead
2858  * @ingroup Toolbar
2859  */
2860 EINA_DEPRECATED EAPI void         elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
2861
2862 /**
2863  * Return the data associated with a given toolbar widget item.
2864  *
2865  * @param it The toolbar widget item handle.
2866  * @return The data associated with @p item.
2867  *
2868  * @see elm_toolbar_item_data_set()
2869  *
2870  * @deprecated use elm_object_item_data_get() instead.
2871  * @ingroup Toolbar
2872  */
2873 EINA_DEPRECATED EAPI void        *elm_toolbar_item_data_get(const Elm_Object_Item *it);
2874
2875 /**
2876  * Set the data associated with a given toolbar widget item.
2877  *
2878  * @param it The toolbar widget item handle
2879  * @param data The new data pointer to set to @p item.
2880  *
2881  * This sets new item data on @p item.
2882  *
2883  * @warning The old data pointer won't be touched by this function, so
2884  * the user had better to free that old data himself/herself.
2885  *
2886  * @deprecated use elm_object_item_data_set() instead.
2887  * @ingroup Toolbar
2888  */
2889 EINA_DEPRECATED EAPI void         elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
2890
2891 /**
2892  * Get a value whether toolbar item is disabled or not.
2893  *
2894  * @param it The item.
2895  * @return The disabled state.
2896  *
2897  * @see elm_toolbar_item_disabled_set() for more details.
2898  *
2899  * @deprecated use elm_object_item_disabled_get() instead.
2900  * @ingroup Toolbar
2901  */
2902 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
2903
2904 /**
2905  * Sets the disabled/enabled state of a toolbar item.
2906  *
2907  * @param it The item.
2908  * @param disabled The disabled state.
2909  *
2910  * A disabled item cannot be selected or unselected. It will also
2911  * change its appearance (generally greyed out). This sets the
2912  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
2913  * enabled).
2914  *
2915  * @deprecated use elm_object_item_disabled_set() instead.
2916  * @ingroup Toolbar
2917  */
2918 EINA_DEPRECATED EAPI void         elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2919
2920 /**
2921  * Change a toolbar's orientation
2922  * @param obj The toolbar object
2923  * @param vertical If @c EINA_TRUE, the toolbar is vertical
2924  * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
2925  * @ingroup Toolbar
2926  * @deprecated use elm_toolbar_horizontal_set() instead.
2927  */
2928 EINA_DEPRECATED EAPI void         elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
2929
2930 /**
2931  * Get a toolbar's orientation
2932  * @param obj The toolbar object
2933  * @return If @c EINA_TRUE, the toolbar is vertical
2934  * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
2935  * @ingroup Toolbar
2936  * @deprecated use elm_toolbar_horizontal_get() instead.
2937  */
2938 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_orientation_get(const Evas_Object *obj);
2939
2940 /**
2941  * Set the function called when a toolbar item is freed.
2942  *
2943  * @param it The item to set the callback on.
2944  * @param func The function called.
2945  *
2946  * If there is a @p func, then it will be called prior item's memory release.
2947  * That will be called with the following arguments:
2948  * @li item's data;
2949  * @li item's Evas object;
2950  * @li item itself;
2951  *
2952  * This way, a data associated to a toolbar item could be properly freed.
2953  *
2954  * @deprecated Use elm_object_item_del_cb_set() instead
2955  * @ingroup Toolbar
2956  */
2957 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2958
2959 /**
2960  * Delete them item from the toolbar.
2961  *
2962  * @param it The item of toolbar to be deleted.
2963  *
2964  * @deprecated Use elm_object_item_del() instead
2965  * @see elm_toolbar_item_append()
2966  *
2967  * @ingroup Toolbar
2968  */
2969 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del(Elm_Object_Item *it);
2970
2971 /**
2972  * Set the text to be shown in a given toolbar item's tooltips.
2973  *
2974  * @param it toolbar item.
2975  * @param text The text to set in the content.
2976  *
2977  * Setup the text as tooltip to object. The item can have only one tooltip,
2978  * so any previous tooltip data - set with this function or
2979  * elm_toolbar_item_tooltip_content_cb_set() - is removed.
2980  *
2981  * @deprecated Use elm_object_item_tooltip_text_set() instead
2982  * @see elm_object_tooltip_text_set() for more details.
2983  *
2984  * @ingroup Toolbar
2985  */
2986 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
2987
2988 /**
2989  * Set the content to be shown in the tooltip item.
2990  *
2991  * Setup the tooltip to item. The item can have only one tooltip,
2992  * so any previous tooltip data is removed. @p func(with @p data) will
2993  * be called every time that need show the tooltip and it should
2994  * return a valid Evas_Object. This object is then managed fully by
2995  * tooltip system and is deleted when the tooltip is gone.
2996  *
2997  * @param it the toolbar item being attached a tooltip.
2998  * @param func the function used to create the tooltip contents.
2999  * @param data what to provide to @a func as callback data/context.
3000  * @param del_cb called when data is not needed anymore, either when
3001  *        another callback replaces @a func, the tooltip is unset with
3002  *        elm_toolbar_item_tooltip_unset() or the owner @a item
3003  *        dies. This callback receives as the first parameter the
3004  *        given @a data, and @c event_info is the item.
3005  *
3006  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3007  * @see elm_object_tooltip_content_cb_set() for more details.
3008  *
3009  * @ingroup Toolbar
3010  */
3011 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);
3012
3013 /**
3014  * Unset tooltip from item.
3015  *
3016  * @param it toolbar item to remove previously set tooltip.
3017  *
3018  * Remove tooltip from item. The callback provided as del_cb to
3019  * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
3020  * it is not used anymore.
3021  *
3022  * @deprecated Use elm_object_item_tooltip_unset() instead
3023  * @see elm_object_tooltip_unset() for more details.
3024  * @see elm_toolbar_item_tooltip_content_cb_set()
3025  *
3026  * @ingroup Toolbar
3027  */
3028 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
3029
3030 /**
3031  * Sets a different style for this item tooltip.
3032  *
3033  * @note before you set a style you should define a tooltip with
3034  *       elm_toolbar_item_tooltip_content_cb_set() or
3035  *       elm_toolbar_item_tooltip_text_set()
3036  *
3037  * @param it toolbar item with tooltip already set.
3038  * @param style the theme style to use (default, transparent, ...)
3039  *
3040  * @deprecated Use elm_object_item_tooltip_style_set() instead
3041  * @see elm_object_tooltip_style_set() for more details.
3042  *
3043  * @ingroup Toolbar
3044  */
3045 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3046
3047 /**
3048  * Get the style for this item tooltip.
3049  *
3050  * @param it toolbar item with tooltip already set.
3051  * @return style the theme style in use, defaults to "default". If the
3052  *         object does not have a tooltip set, then NULL is returned.
3053  *
3054  * @deprecated Use elm_object_item_style_get() instead
3055  * @see elm_object_tooltip_style_get() for more details.
3056  * @see elm_toolbar_item_tooltip_style_set()
3057  *
3058  * @ingroup Toolbar
3059  */
3060 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
3061
3062 /**
3063  * Set the type of mouse pointer/cursor decoration to be shown,
3064  * when the mouse pointer is over the given toolbar widget item
3065  *
3066  * @param it toolbar item to customize cursor on
3067  * @param cursor the cursor type's name
3068  *
3069  * This function works analogously as elm_object_cursor_set(), but
3070  * here the cursor's changing area is restricted to the item's
3071  * area, and not the whole widget's. Note that that item cursors
3072  * have precedence over widget cursors, so that a mouse over an
3073  * item with custom cursor set will always show @b that cursor.
3074  *
3075  * If this function is called twice for an object, a previously set
3076  * cursor will be unset on the second call.
3077  *
3078  * @see elm_object_cursor_set()
3079  * @see elm_toolbar_item_cursor_get()
3080  * @see elm_toolbar_item_cursor_unset()
3081  *
3082  * @deprecated use elm_object_item_cursor_set() instead
3083  *
3084  * @ingroup Toolbar
3085  */
3086 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3087
3088 /*
3089  * Get the type of mouse pointer/cursor decoration set to be shown,
3090  * when the mouse pointer is over the given toolbar widget item
3091  *
3092  * @param it toolbar item with custom cursor set
3093  * @return the cursor type's name or @c NULL, if no custom cursors
3094  * were set to @p item (and on errors)
3095  *
3096  * @see elm_object_cursor_get()
3097  * @see elm_toolbar_item_cursor_set()
3098  * @see elm_toolbar_item_cursor_unset()
3099  *
3100  * @deprecated Use elm_object_item_cursor_get() instead
3101  *
3102  * @ingroup Toolbar
3103  */
3104 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3105
3106 /**
3107  * Unset any custom mouse pointer/cursor decoration set to be
3108  * shown, when the mouse pointer is over the given toolbar widget
3109  * item, thus making it show the @b default cursor again.
3110  *
3111  * @param it a toolbar item
3112  *
3113  * Use this call to undo any custom settings on this item's cursor
3114  * decoration, bringing it back to defaults (no custom style set).
3115  *
3116  * @see elm_object_cursor_unset()
3117  * @see elm_toolbar_item_cursor_set()
3118  *
3119  * @deprecated Use elm_object_item_cursor_unset() instead
3120  *
3121  * @ingroup Toolbar
3122  */
3123 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3124
3125 /**
3126  * Set a different @b style for a given custom cursor set for a
3127  * toolbar item.
3128  *
3129  * @param it toolbar item with custom cursor set
3130  * @param style the <b>theme style</b> to use (e.g. @c "default",
3131  * @c "transparent", etc)
3132  *
3133  * This function only makes sense when one is using custom mouse
3134  * cursor decorations <b>defined in a theme file</b>, which can have,
3135  * given a cursor name/type, <b>alternate styles</b> on it. It
3136  * works analogously as elm_object_cursor_style_set(), but here
3137  * applies only to toolbar item objects.
3138  *
3139  * @warning Before you set a cursor style you should have defined a
3140  *       custom cursor previously on the item, with
3141  *       elm_toolbar_item_cursor_set()
3142  *
3143  * @see elm_toolbar_item_cursor_engine_only_set()
3144  * @see elm_toolbar_item_cursor_style_get()
3145  *
3146  * @deprecated Use elm_object_item_cursor_style_set() instead
3147  *
3148  * @ingroup Toolbar
3149  */
3150 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3151
3152 /**
3153  * Get the current @b style set for a given toolbar item's custom
3154  * cursor
3155  *
3156  * @param it toolbar item with custom cursor set.
3157  * @return style the cursor style in use. If the object does not
3158  *         have a cursor set, then @c NULL is returned.
3159  *
3160  * @see elm_toolbar_item_cursor_style_set() for more details
3161  *
3162  * @deprecated Use elm_object_item_cursor_style_get() instead
3163  *
3164  * @ingroup Toolbar
3165  */
3166 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3167
3168 /**
3169  * Set if the (custom)cursor for a given toolbar item should be
3170  * searched in its theme, also, or should only rely on the
3171  * rendering engine.
3172  *
3173  * @param it item with custom (custom) cursor already set on
3174  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3175  * only on those provided by the rendering engine, @c EINA_FALSE to
3176  * have them searched on the widget's theme, as well.
3177  *
3178  * @note This call is of use only if you've set a custom cursor
3179  * for toolbar items, with elm_toolbar_item_cursor_set().
3180  *
3181  * @note By default, cursors will only be looked for between those
3182  * provided by the rendering engine.
3183  *
3184  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3185  *
3186  * @ingroup Toolbar
3187  */
3188 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3189
3190 /**
3191  * Get if the (custom) cursor for a given toolbar item is being
3192  * searched in its theme, also, or is only relying on the rendering
3193  * engine.
3194  *
3195  * @param it a toolbar item
3196  * @return @c EINA_TRUE, if cursors are being looked for only on
3197  * those provided by the rendering engine, @c EINA_FALSE if they
3198  * are being searched on the widget's theme, as well.
3199  *
3200  * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3201  *
3202  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3203  *
3204  * @ingroup Toolbar
3205  */
3206 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3207
3208 /**
3209  * @brief Link a Elm_Payer with an Elm_Video object.
3210  *
3211  * @param player the Elm_Player object.
3212  * @param video The Elm_Video object.
3213  *
3214  * This mean that action on the player widget will affect the
3215  * video object and the state of the video will be reflected in
3216  * the player itself.
3217  *
3218  * @see elm_player_add()
3219  * @see elm_video_add()
3220  * @deprecated use elm_object_part_content_set() instead
3221  *
3222  * @ingroup Video
3223  */
3224 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3225
3226 /**
3227  * Set the label of item.
3228  *
3229  * @param it The item of segment control.
3230  * @param label The label of item.
3231  *
3232  * The label to be displayed by the item.
3233  * Label will be at right of the icon (if set).
3234  *
3235  * If a label was passed as argument on item creation, with function
3236  * elm_control_segment_item_add(), it will be already
3237  * displayed by the item.
3238  *
3239  * @see elm_segment_control_item_label_get()
3240  * @see elm_segment_control_item_add()
3241  * @deprecated Use elm_object_item_text_set() instead
3242  *
3243  * @ingroup SegmentControl
3244  */
3245 EINA_DEPRECATED EAPI void              elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3246
3247
3248 /**
3249  * Set the icon associated to the item.
3250  *
3251  * @param it The segment control item.
3252  * @param icon The icon object to associate with @p it.
3253  *
3254  * The icon object to use at left side of the item. An
3255  * icon can be any Evas object, but usually it is an icon created
3256  * with elm_icon_add().
3257  *
3258  * Once the icon object is set, a previously set one will be deleted.
3259  * @warning Setting the same icon for two items will cause the icon to
3260  * disappear from the first item.
3261  *
3262  * If an icon was passed as argument on item creation, with function
3263  * elm_segment_control_item_add(), it will be already
3264  * associated to the item.
3265  *
3266  * @see elm_segment_control_item_add()
3267  * @see elm_segment_control_item_icon_get()
3268  * @deprecated Use elm_object_item_part_content_set() instead
3269  *
3270  * @ingroup SegmentControl
3271  */
3272 EINA_DEPRECATED EAPI void              elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3273
3274 /**
3275  * Remove a segment control item from its parent, deleting it.
3276  *
3277  * @param it The item to be removed.
3278  *
3279  * Items can be added with elm_segment_control_item_add() or
3280  * elm_segment_control_item_insert_at().
3281  *
3282  * @deprecated Use elm_object_item_del() instead
3283  * @ingroup SegmentControl
3284  */
3285 EINA_DEPRECATED EAPI void              elm_segment_control_item_del(Elm_Object_Item *it);
3286
3287 /**
3288  * Get the label
3289  *
3290  * @param obj The multibuttonentry object
3291  * @return The label, or NULL if none
3292  *
3293  * @deprecated Use elm_object_text_get() instead
3294  *
3295  */
3296 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_label_get(const Evas_Object *obj);
3297
3298 /**
3299  * Set the label
3300  *
3301  * @param obj The multibuttonentry object
3302  * @param label The text label string
3303  *
3304  * @deprecated Use elm_object_text_set() instead
3305  *
3306  */
3307 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3308
3309 /**
3310  * Get the label of a given item
3311  *
3312  * @param it The item
3313  * @return The label of a given item, or NULL if none
3314  *
3315  * @deprecated Use elm_object_item_text_get() instead
3316  *
3317  */
3318 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3319
3320 /**
3321  * Set the label of a given item
3322  *
3323  * @param it The item
3324  * @param str The text label string
3325  *
3326  * @deprecated Use elm_object_item_text_set() instead
3327  */
3328 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3329
3330 /**
3331  * Delete a given item
3332  *
3333  * @param it The item
3334  *
3335  * @deprecated Use elm_object_item_del() instead
3336  *
3337  */
3338 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_del(Elm_Object_Item *it);
3339
3340 /**
3341  * @brief Delete the given item instantly.
3342  *
3343  * @param it The naviframe item
3344  *
3345  * This just deletes the given item from the naviframe item list instantly.
3346  * So this would not emit any signals for view transitions but just change
3347  * the current view if the given item is a top one.
3348  *
3349  * @deprecated Use elm_object_item_del() instead
3350  * @ingroup Naviframe
3351  */
3352 EINA_DEPRECATED EAPI void             elm_naviframe_item_del(Elm_Object_Item *it);
3353
3354
3355
3356 /**
3357  * Sets the disabled/enabled state of a list item.
3358  *
3359  * @param it The item.
3360  * @param disabled The disabled state.
3361  *
3362  * A disabled item cannot be selected or unselected. It will also
3363  * change its appearance (generally greyed out). This sets the
3364  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3365  * enabled).
3366  *
3367  * @deprecated Use elm_object_item_disabled_set() instead
3368  *
3369  * @ingroup List
3370  */
3371 EINA_DEPRECATED EAPI void                         elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3372
3373 /**
3374  * Get a value whether list item is disabled or not.
3375  *
3376  * @param it The item.
3377  * @return The disabled state.
3378  *
3379  * @see elm_list_item_disabled_set() for more details.
3380  *
3381  * @deprecated Use elm_object_item_disabled_get() instead
3382  *
3383  * @ingroup List
3384  */
3385 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_disabled_get(const Elm_Object_Item *it);
3386
3387 /**
3388  * Set the function called when a list item is freed.
3389  *
3390  * @param it The item to set the callback on
3391  * @param func The function called
3392  *
3393  * If there is a @p func, then it will be called prior item's memory release.
3394  * That will be called with the following arguments:
3395  * @li item's data;
3396  * @li item's Evas object;
3397  * @li item itself;
3398  *
3399  * This way, a data associated to a list item could be properly freed.
3400  *
3401  * @deprecated Please use elm_object_item_del_cb_set() instead.
3402  *
3403  * @ingroup List
3404  */
3405 EINA_DEPRECATED EAPI void                         elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3406
3407 /**
3408  * Get the data associated to the item.
3409  *
3410  * @param it The list item
3411  * @return The data associated to @p item
3412  *
3413  * The return value is a pointer to data associated to @p item when it was
3414  * created, with function elm_list_item_append() or similar. If no data
3415  * was passed as argument, it will return @c NULL.
3416  *
3417  * @see elm_list_item_append()
3418  *
3419  * @deprecated Please use elm_object_item_data_get() instead.
3420  *
3421  * @ingroup List
3422  */
3423 EINA_DEPRECATED EAPI void                        *elm_list_item_data_get(const Elm_Object_Item *it);
3424
3425 /**
3426  * Get the left side icon associated to the item.
3427  *
3428  * @param it The list item
3429  * @return The left side icon associated to @p item
3430  *
3431  * The return value is a pointer to the icon associated to @p item when
3432  * it was
3433  * created, with function elm_list_item_append() or similar, or later
3434  * with function elm_list_item_icon_set(). If no icon
3435  * was passed as argument, it will return @c NULL.
3436  *
3437  * @see elm_list_item_append()
3438  * @see elm_list_item_icon_set()
3439  *
3440  * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3441  * @ingroup List
3442  */
3443 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_icon_get(const Elm_Object_Item *it);
3444
3445 /**
3446  * Set the left side icon associated to the item.
3447  *
3448  * @param it The list item
3449  * @param icon The left side icon object to associate with @p item
3450  *
3451  * The icon object to use at left side of the item. An
3452  * icon can be any Evas object, but usually it is an icon created
3453  * with elm_icon_add().
3454  *
3455  * Once the icon object is set, a previously set one will be deleted.
3456  * @warning Setting the same icon for two items will cause the icon to
3457  * disappear from the first item.
3458  *
3459  * If an icon was passed as argument on item creation, with function
3460  * elm_list_item_append() or similar, it will be already
3461  * associated to the item.
3462  *
3463  * @see elm_list_item_append()
3464  * @see elm_list_item_icon_get()
3465  *
3466  * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3467  * @ingroup List
3468  */
3469 EINA_DEPRECATED EAPI void                         elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3470
3471 /**
3472  * Get the right side icon associated to the item.
3473  *
3474  * @param it The list item
3475  * @return The right side icon associated to @p item
3476  *
3477  * The return value is a pointer to the icon associated to @p item when
3478  * it was
3479  * created, with function elm_list_item_append() or similar, or later
3480  * with function elm_list_item_icon_set(). If no icon
3481  * was passed as argument, it will return @c NULL.
3482  *
3483  * @see elm_list_item_append()
3484  * @see elm_list_item_icon_set()
3485  *
3486  * @deprecated Please use elm_object_item_part_content_get(item, "end");
3487  * @ingroup List
3488  */
3489 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_end_get(const Elm_Object_Item *it);
3490
3491 /**
3492  * Set the right side icon associated to the item.
3493  *
3494  * @param it The list item
3495  * @param end The right side icon object to associate with @p item
3496  *
3497  * The icon object to use at right side of the item. An
3498  * icon can be any Evas object, but usually it is an icon created
3499  * with elm_icon_add().
3500  *
3501  * Once the icon object is set, a previously set one will be deleted.
3502  * @warning Setting the same icon for two items will cause the icon to
3503  * disappear from the first item.
3504  *
3505  * If an icon was passed as argument on item creation, with function
3506  * elm_list_item_append() or similar, it will be already
3507  * associated to the item.
3508  *
3509  * @see elm_list_item_append()
3510  * @see elm_list_item_end_get()
3511  *
3512  * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3513  * @ingroup List
3514  */
3515 EINA_DEPRECATED EAPI void                         elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3516
3517 /**
3518  * Get the label of item.
3519  *
3520  * @param it The item of list.
3521  * @return The label of item.
3522  *
3523  * The return value is a pointer to the label associated to @p item when
3524  * it was created, with function elm_list_item_append(), or later
3525  * with function elm_list_item_label_set. If no label
3526  * was passed as argument, it will return @c NULL.
3527  *
3528  * @see elm_list_item_label_set() for more details.
3529  * @see elm_list_item_append()
3530  *
3531  * @deprecated Please use elm_object_item_text_get(item);
3532  * @ingroup List
3533  */
3534 EINA_DEPRECATED EAPI const char                  *elm_list_item_label_get(const Elm_Object_Item *it);
3535
3536 /**
3537  * Set the label of item.
3538  *
3539  * @param it The item of list.
3540  * @param text The label of item.
3541  *
3542  * The label to be displayed by the item.
3543  * Label will be placed between left and right side icons (if set).
3544  *
3545  * If a label was passed as argument on item creation, with function
3546  * elm_list_item_append() or similar, it will be already
3547  * displayed by the item.
3548  *
3549  * @see elm_list_item_label_get()
3550  * @see elm_list_item_append()
3551  *
3552  * @deprecated Please use elm_object_item_text_set(item, text);
3553  * @ingroup List
3554  */
3555 EINA_DEPRECATED EAPI void                         elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3556
3557 /**
3558  * Set the text to be shown in a given list item's tooltips.
3559  *
3560  * @param it Target item.
3561  * @param text The text to set in the content.
3562  *
3563  * Setup the text as tooltip to object. The item can have only one tooltip,
3564  * so any previous tooltip data - set with this function or
3565  * elm_list_item_tooltip_content_cb_set() - is removed.
3566  *
3567  * @deprecated Use elm_object_item_tooltip_text_set() instead
3568  * @see elm_object_tooltip_text_set() for more details.
3569  *
3570  * @ingroup List
3571  */
3572 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3573
3574 /**
3575  * @brief Disable size restrictions on an object's tooltip
3576  * @param it The tooltip's anchor object
3577  * @param disable If EINA_TRUE, size restrictions are disabled
3578  * @return EINA_FALSE on failure, EINA_TRUE on success
3579  *
3580  * This function allows a tooltip to expand beyond its parent window's canvas.
3581  * It will instead be limited only by the size of the display.
3582  *
3583  * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3584  *
3585  */
3586 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3587
3588 /**
3589  * @brief Retrieve size restriction state of an object's tooltip
3590  * @param obj The tooltip's anchor object
3591  * @return If EINA_TRUE, size restrictions are disabled
3592  *
3593  * This function returns whether a tooltip is allowed to expand beyond
3594  * its parent window's canvas.
3595  * It will instead be limited only by the size of the display.
3596  *
3597  * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3598  *
3599  */
3600 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3601
3602 /**
3603  * Set the content to be shown in the tooltip item.
3604  *
3605  * Setup the tooltip to item. The item can have only one tooltip,
3606  * so any previous tooltip data is removed. @p func(with @p data) will
3607  * be called every time that need show the tooltip and it should
3608  * return a valid Evas_Object. This object is then managed fully by
3609  * tooltip system and is deleted when the tooltip is gone.
3610  *
3611  * @param it the list item being attached a tooltip.
3612  * @param func the function used to create the tooltip contents.
3613  * @param data what to provide to @a func as callback data/context.
3614  * @param del_cb called when data is not needed anymore, either when
3615  *        another callback replaces @a func, the tooltip is unset with
3616  *        elm_list_item_tooltip_unset() or the owner @a item
3617  *        dies. This callback receives as the first parameter the
3618  *        given @a data, and @c event_info is the item.
3619  *
3620  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3621  *
3622  * @see elm_object_tooltip_content_cb_set() for more details.
3623  *
3624  * @ingroup List
3625  */
3626 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);
3627
3628 /**
3629  * Unset tooltip from item.
3630  *
3631  * @param it list item to remove previously set tooltip.
3632  *
3633  * Remove tooltip from item. The callback provided as del_cb to
3634  * elm_list_item_tooltip_content_cb_set() will be called to notify
3635  * it is not used anymore.
3636  *
3637  * @deprecated Use elm_object_item_tooltip_unset() instead
3638  * @see elm_object_tooltip_unset() for more details.
3639  * @see elm_list_item_tooltip_content_cb_set()
3640  *
3641  * @ingroup List
3642  */
3643 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_unset(Elm_Object_Item *it);
3644
3645 /**
3646  * Sets a different style for this item tooltip.
3647  *
3648  * @note before you set a style you should define a tooltip with
3649  *       elm_list_item_tooltip_content_cb_set() or
3650  *       elm_list_item_tooltip_text_set()
3651  *
3652  * @param it list item with tooltip already set.
3653  * @param style the theme style to use (default, transparent, ...)
3654  *
3655  *
3656  * @deprecated Use elm_object_item_tooltip_style_set() instead
3657  * @see elm_object_tooltip_style_set() for more details.
3658  *
3659  * @ingroup List
3660  */
3661 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3662
3663 /**
3664  * Get the style for this item tooltip.
3665  *
3666  * @param it list item with tooltip already set.
3667  * @return style the theme style in use, defaults to "default". If the
3668  *         object does not have a tooltip set, then NULL is returned.
3669  *
3670  * @deprecated Use elm_object_item_tooltip_style_get() instead
3671  *
3672  * @see elm_object_tooltip_style_get() for more details.
3673  * @see elm_list_item_tooltip_style_set()
3674  *
3675  * @ingroup List
3676  */
3677 EINA_DEPRECATED EAPI const char                  *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
3678
3679 /**
3680  * Set the type of mouse pointer/cursor decoration to be shown,
3681  * when the mouse pointer is over the given list widget item
3682  *
3683  * @param it list item to customize cursor on
3684  * @param cursor the cursor type's name
3685  *
3686  * This function works analogously as elm_object_cursor_set(), but
3687  * here the cursor's changing area is restricted to the item's
3688  * area, and not the whole widget's. Note that that item cursors
3689  * have precedence over widget cursors, so that a mouse over an
3690  * item with custom cursor set will always show @b that cursor.
3691  *
3692  * If this function is called twice for an object, a previously set
3693  * cursor will be unset on the second call.
3694  *
3695  * @see elm_object_cursor_set()
3696  * @see elm_list_item_cursor_get()
3697  * @see elm_list_item_cursor_unset()
3698  *
3699  * @deprecated Please use elm_object_item_cursor_set() instead
3700  * @ingroup List
3701  */
3702 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3703
3704 /*
3705  * Get the type of mouse pointer/cursor decoration set to be shown,
3706  * when the mouse pointer is over the given list widget item
3707  *
3708  * @param it list item with custom cursor set
3709  * @return the cursor type's name or @c NULL, if no custom cursors
3710  * were set to @p item (and on errors)
3711  *
3712  * @see elm_object_cursor_get()
3713  * @see elm_list_item_cursor_set()
3714  * @see elm_list_item_cursor_unset()
3715  *
3716  * @deprecated Please use elm_object_item_cursor_get() instead
3717  * @ingroup List
3718  */
3719 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_get(const Elm_Object_Item *it);
3720
3721 /**
3722  * Unset any custom mouse pointer/cursor decoration set to be
3723  * shown, when the mouse pointer is over the given list widget
3724  * item, thus making it show the @b default cursor again.
3725  *
3726  * @param it a list item
3727  *
3728  * Use this call to undo any custom settings on this item's cursor
3729  * decoration, bringing it back to defaults (no custom style set).
3730  *
3731  * @see elm_object_cursor_unset()
3732  * @see elm_list_item_cursor_set()
3733  *
3734  * @deprecated Please use elm_list_item_cursor_unset() instead
3735  * @ingroup List
3736  */
3737 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_unset(Elm_Object_Item *it);
3738
3739 /**
3740  * Set a different @b style for a given custom cursor set for a
3741  * list item.
3742  *
3743  * @param it list item with custom cursor set
3744  * @param style the <b>theme style</b> to use (e.g. @c "default",
3745  * @c "transparent", etc)
3746  *
3747  * This function only makes sense when one is using custom mouse
3748  * cursor decorations <b>defined in a theme file</b>, which can have,
3749  * given a cursor name/type, <b>alternate styles</b> on it. It
3750  * works analogously as elm_object_cursor_style_set(), but here
3751  * applies only to list item objects.
3752  *
3753  * @warning Before you set a cursor style you should have defined a
3754  *       custom cursor previously on the item, with
3755  *       elm_list_item_cursor_set()
3756  *
3757  * @see elm_list_item_cursor_engine_only_set()
3758  * @see elm_list_item_cursor_style_get()
3759  *
3760  * @deprecated Please use elm_list_item_cursor_style_set() instead
3761  * @ingroup List
3762  */
3763 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3764
3765 /**
3766  * Get the current @b style set for a given list item's custom
3767  * cursor
3768  *
3769  * @param it list item with custom cursor set.
3770  * @return style the cursor style in use. If the object does not
3771  *         have a cursor set, then @c NULL is returned.
3772  *
3773  * @see elm_list_item_cursor_style_set() for more details
3774  *
3775  * @deprecated Please use elm_list_item_cursor_style_get() instead
3776  * @ingroup List
3777  */
3778 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
3779
3780 /**
3781  * Set if the (custom)cursor for a given list item should be
3782  * searched in its theme, also, or should only rely on the
3783  * rendering engine.
3784  *
3785  * @param it item with custom (custom) cursor already set on
3786  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3787  * only on those provided by the rendering engine, @c EINA_FALSE to
3788  * have them searched on the widget's theme, as well.
3789  *
3790  * @note This call is of use only if you've set a custom cursor
3791  * for list items, with elm_list_item_cursor_set().
3792  *
3793  * @note By default, cursors will only be looked for between those
3794  * provided by the rendering engine.
3795  *
3796  * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
3797  * @ingroup List
3798  */
3799 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3800
3801 /**
3802  * Get if the (custom) cursor for a given list item is being
3803  * searched in its theme, also, or is only relying on the rendering
3804  * engine.
3805  *
3806  * @param it a list item
3807  * @return @c EINA_TRUE, if cursors are being looked for only on
3808  * those provided by the rendering engine, @c EINA_FALSE if they
3809  * are being searched on the widget's theme, as well.
3810  *
3811  * @see elm_list_item_cursor_engine_only_set(), for more details
3812  *
3813  * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
3814  * @ingroup List
3815  */
3816 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
3817
3818 /**
3819  * Delete the item from the list.
3820  *
3821  * @param it The item of list to be deleted.
3822  *
3823  * If deleting all list items is required, elm_list_clear()
3824  * should be used instead of getting items list and deleting each one.
3825  *
3826  * @see elm_list_clear()
3827  * @see elm_list_item_append()
3828  * @see elm_widget_item_del_cb_set()
3829  * @deprecated Use elm_object_item_del() instead
3830  *
3831  * @ingroup List
3832  */
3833 EINA_DEPRECATED EAPI void                         elm_list_item_del(Elm_Object_Item *it);
3834
3835 /**
3836  * Set the shrink state of toolbar @p obj.
3837  *
3838  * @param obj The toolbar object.
3839  * @param shrink_mode Toolbar's items display behavior.
3840  *
3841  * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
3842  * but will enforce a minimum size so all the items will fit, won't scroll
3843  * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
3844  * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
3845  * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
3846  *
3847  * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
3848  * @ingroup Toolbar
3849  */
3850 EINA_DEPRECATED EAPI void                         elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
3851
3852 /**
3853  * Get the shrink mode of toolbar @p obj.
3854  *
3855  * @param obj The toolbar object.
3856  * @return Toolbar's items display behavior.
3857  *
3858  * @see elm_toolbar_shrink_mode_set() for details.
3859  *
3860  * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
3861  * @ingroup Toolbar
3862  */
3863 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode      elm_toolbar_mode_shrink_get(const Evas_Object *obj);
3864
3865 /**
3866  * This sets a widget to be displayed to the left of a scrolled entry.
3867  *
3868  * @param obj The scrolled entry object
3869  * @param icon The widget to display on the left side of the scrolled
3870  * entry.
3871  *
3872  * @note A previously set widget will be destroyed.
3873  * @note If the object being set does not have minimum size hints set,
3874  * it won't get properly displayed.
3875  *
3876  * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
3877  * @see elm_entry_end_set()
3878  */
3879 EINA_DEPRECATED EAPI void               elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
3880
3881 /**
3882  * Gets the leftmost widget of the scrolled entry. This object is
3883  * owned by the scrolled entry and should not be modified.
3884  *
3885  * @param obj The scrolled entry object
3886  * @return the left widget inside the scroller
3887  *
3888  * @deprecated Use elm_object_part_content_get(entry, "icon") instead
3889  */
3890 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_get(const Evas_Object *obj);
3891
3892 /**
3893  * Unset the leftmost widget of the scrolled entry, unparenting and
3894  * returning it.
3895  *
3896  * @param obj The scrolled entry object
3897  * @return the previously set icon sub-object of this entry, on
3898  * success.
3899  *
3900  * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
3901  * @see elm_entry_icon_set()
3902  */
3903 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_unset(Evas_Object *obj);
3904
3905 /**
3906  * This sets a widget to be displayed to the end of a scrolled entry.
3907  *
3908  * @param obj The scrolled entry object
3909  * @param end The widget to display on the right side of the scrolled
3910  * entry.
3911  *
3912  * @note A previously set widget will be destroyed.
3913  * @note If the object being set does not have minimum size hints set,
3914  * it won't get properly displayed.
3915  *
3916  * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
3917  * @see elm_entry_icon_set
3918  */
3919 EINA_DEPRECATED EAPI void               elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
3920
3921 /**
3922  * Gets the endmost widget of the scrolled entry. This object is owned
3923  * by the scrolled entry and should not be modified.
3924  *
3925  * @param obj The scrolled entry object
3926  * @return the right widget inside the scroller
3927  *
3928  * @deprecated Use elm_object_part_content_get(entry, "end") instead
3929  */
3930 EAPI Evas_Object       *elm_entry_end_get(const Evas_Object *obj);
3931
3932 /**
3933  * Unset the endmost widget of the scrolled entry, unparenting and
3934  * returning it.
3935  *
3936  * @param obj The scrolled entry object
3937  * @return the previously set icon sub-object of this entry, on
3938  * success.
3939  *
3940  * @deprecated Use elm_object_part_content_unset(entry, "end") instead
3941  * @see elm_entry_icon_set()
3942  */
3943 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_end_unset(Evas_Object *obj);
3944
3945 /**
3946  * Set route service to be used. By default used source is
3947  * #ELM_MAP_ROUTE_SOURCE_YOURS.
3948  *
3949  * @see elm_map_route_source_set()
3950  * @see elm_map_route_source_get()
3951  *
3952  * @ingroup Map
3953  */
3954 typedef enum
3955 {
3956    ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/
3957    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. */
3958    ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */
3959    ELM_MAP_ROUTE_SOURCE_LAST
3960 } Elm_Map_Route_Sources;
3961
3962 /**
3963  * Convert a pixel coordinate into a rotated pixel coordinate.
3964  *
3965  * @param obj The map object.
3966  * @param x horizontal coordinate of the point to rotate.
3967  * @param y vertical coordinate of the point to rotate.
3968  * @param cx rotation's center horizontal position.
3969  * @param cy rotation's center vertical position.
3970  * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
3971  * @param xx Pointer where to store rotated x.
3972  * @param yy Pointer where to store rotated y.
3973  *
3974  * @ingroup Map
3975  * @deprecated Use elm_map_canvas_to_geo_convert() instead
3976  */
3977 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);
3978
3979 /**
3980  * Convert a pixel coordinate (x,y) into a geographic coordinate
3981  * (longitude, latitude).
3982  *
3983  * @param obj The map object.
3984  * @param x the coordinate.
3985  * @param y the coordinate.
3986  * @param size the size in pixels of the map.
3987  * The map is a square and generally his size is : pow(2.0, zoom)*256.
3988  * @param lon Pointer to store the longitude that correspond to x.
3989  * @param lat Pointer to store the latitude that correspond to y.
3990  *
3991  * @note Origin pixel point is the top left corner of the viewport.
3992  * Map zoom and size are taken on account.
3993  *
3994  * @see elm_map_utils_convert_geo_into_coord() if you need the inverse.
3995  *
3996  * @ingroup Map
3997  * @deprecated Use elm_map_canvas_to_geo_convert() instead
3998  */
3999 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);
4000
4001 /**
4002  * Convert a geographic coordinate (longitude, latitude) into a pixel
4003  * coordinate (x, y).
4004  *
4005  * @param obj The map object.
4006  * @param lon the longitude.
4007  * @param lat the latitude.
4008  * @param size the size in pixels of the map. The map is a square
4009  * and generally his size is : pow(2.0, zoom)*256.
4010  * @param x Pointer to store the horizontal pixel coordinate that
4011  * correspond to the longitude.
4012  * @param y Pointer to store the vertical pixel coordinate that
4013  * correspond to the latitude.
4014  *
4015  * @note Origin pixel point is the top left corner of the viewport.
4016  * Map zoom and size are taken on account.
4017  *
4018  * @see elm_map_utils_convert_coord_into_geo() if you need the inverse.
4019  *
4020  * @ingroup Map
4021  * @deprecatedUse Use elm_map_canvas_to_geo_convert() instead
4022  */
4023 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);
4024
4025 /**
4026  * Get the information of downloading status.
4027  *
4028  * @param obj The map object.
4029  * @param try_num Pointer to store number of tiles being downloaded.
4030  * @param finish_num Pointer to store number of tiles successfully
4031  * downloaded.
4032  *
4033  * This gets the current downloading status for the map object, the number
4034  * of tiles being downloaded and the number of tiles already downloaded.
4035  *
4036  * @ingroup Map
4037  * @deprecatedUse Use elm_map_tile_load_status_get() instead
4038  */
4039 EINA_DEPRECATED EAPI void                  elm_map_utils_downloading_status_get(const Evas_Object *obj, int *try_num, int *finish_num);
4040
4041 /**
4042  * Convert a geographic coordinate (longitude, latitude) into a name
4043  * (address).
4044  *
4045  * @param obj The map object.
4046  * @param lon the longitude.
4047  * @param lat the latitude.
4048  * @return name A #Elm_Map_Name handle for this coordinate.
4049  *
4050  * To get the string for this address, elm_map_name_address_get()
4051  * should be used.
4052  *
4053  * @see elm_map_utils_convert_name_into_coord() if you need the inverse.
4054  * @deprecatedUse Use elm_map_name_add() instead
4055  *
4056  * @ingroup Map
4057  */
4058 EINA_DEPRECATED EAPI Elm_Map_Name         *elm_map_utils_convert_coord_into_name(const Evas_Object *obj, double lon, double lat);
4059
4060 /**
4061  * Convert a name (address) into a geographic coordinate
4062  * (longitude, latitude).
4063  *
4064  * @param obj The map object.
4065  * @param address The address.
4066  * @return name A #Elm_Map_Name handle for this address.
4067  *
4068  * To get the longitude and latitude, elm_map_name_region_get()
4069  * should be used.
4070  *
4071  * @see elm_map_utils_convert_coord_into_name() if you need the inverse.
4072  * @deprecatedUse Use elm_map_name_geo_request() instead
4073  *
4074  * @ingroup Map
4075  */
4076 EINA_DEPRECATED EAPI Elm_Map_Name         *elm_map_utils_convert_name_into_coord(const Evas_Object *obj, char *address);
4077
4078 /**
4079  * Convert canvas coordinates into a geographic coordinate
4080  * (longitude, latitude).
4081  *
4082  * @param obj The map object.
4083  * @param x   horizontal coordinate of the point to convert.
4084  * @param y   vertical coordinate of the point to convert.
4085  * @param lon A pointer to the longitude.
4086  * @param lat A pointer to the latitude.
4087  *
4088  * This gets longitude and latitude from canvas x, y coordinates. The canvas
4089  * coordinates mean x, y coordinate from current viewport.
4090  *
4091  * see elm_map_rotate_get()
4092  * @deprecatedUse Use elm_map_canvas_to_region_convert() instead
4093  *
4094  * @ingroup Map
4095  */
4096 EAPI void                  elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat);
4097
4098 /**
4099  * Get the current geographic coordinates of the map.
4100  *
4101  * @param obj The map object.
4102  * @param lon Pointer to store longitude.
4103  * @param lat Pointer to store latitude.
4104  *
4105  * This gets the current center coordinates of the map object. It can be
4106  * set by elm_map_region_bring_in() and elm_map_region_show().
4107  *
4108  * @see elm_map_region_bring_in()
4109  * @see elm_map_region_show()
4110  *
4111  * @ingroup Map
4112  * @deprecated Use elm_map_region_get() instead
4113  */
4114 EINA_DEPRECATED EAPI void                  elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat);
4115
4116 /**
4117  * Animatedly bring in given coordinates to the center of the map.
4118  *
4119  * @param obj The map object.
4120  * @param lon Longitude to center at.
4121  * @param lat Latitude to center at.
4122  *
4123  * This causes map to jump to the given @p lat and @p lon coordinates
4124  * and show it (by scrolling) in the center of the viewport, if it is not
4125  * already centered. This will use animation to do so and take a period
4126  * of time to complete.
4127  *
4128  * @see elm_map_region_show() for a function to avoid animation.
4129  * @see elm_map_region_get()
4130  *
4131  * @ingroup Map
4132  * @deprecated Use elm_map_region_bring_in() instead
4133  */
4134 EINA_DEPRECATED EAPI void                  elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat);
4135
4136 /**
4137  * Show the given coordinates at the center of the map, @b immediately.
4138  *
4139  * @param obj The map object.
4140  * @param lon Longitude to center at.
4141  * @param lat Latitude to center at.
4142  *
4143  * This causes map to @b redraw its viewport's contents to the
4144  * region containing the given @p lat and @p lon, that will be moved to the
4145  * center of the map.
4146  *
4147  * @see elm_map_region_bring_in() for a function to move with animation.
4148  * @see elm_map_region_get()
4149  *
4150  * @ingroup Map
4151  * @deprecated Use elm_map_region_show() instead
4152  */
4153 EINA_DEPRECATED EAPI void                  elm_map_geo_region_show(Evas_Object *obj, double lon, double lat);
4154
4155 /**
4156  * Set the minimum zoom of the source.
4157  *
4158  * @param obj The map object.
4159  * @param zoom New minimum zoom value to be used.
4160  *
4161  * By default, it's 0.
4162  *
4163  * @ingroup Map
4164  * @deprecated Use elm_map_zoom_min_set() instead
4165  */
4166 EINA_DEPRECATED EAPI void                  elm_map_source_zoom_min_set(Evas_Object *obj, int zoom);
4167
4168 /**
4169  * Get the minimum zoom of the source.
4170  *
4171  * @param obj The map object.
4172  * @return Returns the minimum zoom of the source.
4173  *
4174  * @see elm_map_zoom_min_set() for details.
4175  *
4176  * @ingroup Map
4177  * @deprecated Use elm_map_zoom_min_get() instead
4178  */
4179 EINA_DEPRECATED EAPI int                   elm_map_source_zoom_min_get(const Evas_Object *obj);
4180
4181 /**
4182  * Set the maximum zoom of the source.
4183  *
4184  * @param obj The map object.
4185  * @param zoom New maximum zoom value to be used.
4186  *
4187  * By default, it's 18.
4188  *
4189  * @ingroup Map
4190  * @deprecated Use elm_map_zoom_max_set() instead
4191  */
4192 EINA_DEPRECATED EAPI void                  elm_map_source_zoom_max_set(Evas_Object *obj, int zoom);
4193
4194 /**
4195  * Get the maximum zoom of the source.
4196  *
4197  * @param obj The map object.
4198  * @return Returns the maximum zoom of the source.
4199  *
4200  * @see elm_map_zoom_min_set() for details.
4201  *
4202  * @ingroup Map
4203  * @deprecated Use elm_map_zoom_max_get() instead
4204  */
4205 EINA_DEPRECATED EAPI int                   elm_map_source_zoom_max_get(const Evas_Object *obj);
4206
4207
4208 /**
4209  * Get the list of available sources.
4210  *
4211  * @param obj The map object.
4212  * @return The source names list.
4213  *
4214  * It will provide a list with all available sources, that can be set as
4215  * current source with elm_map_source_name_set(), or get with
4216  * elm_map_source_name_get().
4217  *
4218  * Available sources:
4219  * @li "Mapnik"
4220  * @li "Osmarender"
4221  * @li "CycleMap"
4222  * @li "Maplint"
4223  *
4224  * @see elm_map_source_name_set() for more details.
4225  * @see elm_map_source_name_get()
4226  * @deprecated Use elm_map_sources_get() instead
4227  *
4228  * @ingroup Map
4229  */
4230 EINA_DEPRECATED EAPI const char          **elm_map_source_names_get(const Evas_Object *obj);
4231
4232 /**
4233  * Set the source of the map.
4234  *
4235  * @param obj The map object.
4236  * @param source_name The source to be used.
4237  *
4238  * Map widget retrieves images that composes the map from a web service.
4239  * This web service can be set with this method.
4240  *
4241  * A different service can return a different maps with different
4242  * information and it can use different zoom values.
4243  *
4244  * The @p source_name need to match one of the names provided by
4245  * elm_map_source_names_get().
4246  *
4247  * The current source can be get using elm_map_source_name_get().
4248  *
4249  * @see elm_map_source_names_get()
4250  * @see elm_map_source_name_get()
4251  * @deprecated Use elm_map_source_set() instead
4252  *
4253  * @ingroup Map
4254  */
4255 EINA_DEPRECATED EAPI void                  elm_map_source_name_set(Evas_Object *obj, const char *source_name);
4256
4257 /**
4258  * Get the name of currently used source.
4259  *
4260  * @param obj The map object.
4261  * @return Returns the name of the source in use.
4262  *
4263  * @see elm_map_source_name_set() for more details.
4264  * @deprecated Use elm_map_source_get() instead
4265  *
4266  * @ingroup Map
4267  */
4268 EINA_DEPRECATED EAPI const char           *elm_map_source_name_get(const Evas_Object *obj);
4269
4270 /**
4271  * Set the source of the route service to be used by the map.
4272  *
4273  * @param obj The map object.
4274  * @param source The route service to be used, being it one of
4275  * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV,
4276  * and #ELM_MAP_ROUTE_SOURCE_ORS.
4277  *
4278  * Each one has its own algorithm, so the route retrieved may
4279  * differ depending on the source route. Now, only the default is working.
4280  *
4281  * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at
4282  * http://www.yournavigation.org/.
4283  *
4284  * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic
4285  * assumptions. Its routing core is based on Contraction Hierarchies.
4286  *
4287  * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/
4288  *
4289  * @see elm_map_route_source_get().
4290  * @deprecated Use elm_map_source_set() instead
4291  *
4292  * @ingroup Map
4293  */
4294 EAPI void                  elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source);
4295
4296 /**
4297  * Get the current route source.
4298  *
4299  * @param obj The map object.
4300  * @return The source of the route service used by the map.
4301  *
4302  * @see elm_map_route_source_set() for details.
4303  * @deprecated Use elm_map_source_get() instead
4304  *
4305  * @ingroup Map
4306  */
4307 EAPI Elm_Map_Route_Sources elm_map_route_source_get(const Evas_Object *obj);
4308
4309 /**
4310  * Add a new marker to the map object.
4311  *
4312  * @param obj The map object.
4313  * @param lon The longitude of the marker.
4314  * @param lat The latitude of the marker.
4315  * @param clas The class, to use when marker @b isn't grouped to others.
4316  * @param clas_group The class group, to use when marker is grouped to others
4317  * @param data The data passed to the callbacks.
4318  *
4319  * @return The created marker or @c NULL upon failure.
4320  *
4321  * A marker will be created and shown in a specific point of the map, defined
4322  * by @p lon and @p lat.
4323  *
4324  * It will be displayed using style defined by @p class when this marker
4325  * is displayed alone (not grouped). A new class can be created with
4326  * elm_map_marker_class_new().
4327  *
4328  * If the marker is grouped to other markers, it will be displayed with
4329  * style defined by @p class_group. Markers with the same group are grouped
4330  * if they are close. A new group class can be created with
4331  * elm_map_marker_group_class_new().
4332  *
4333  * Markers created with this method can be deleted with
4334  * elm_map_marker_remove().
4335  *
4336  * A marker can have associated content to be displayed by a bubble,
4337  * when a user click over it, as well as an icon. These objects will
4338  * be fetch using class' callback functions.
4339  *
4340  * @see elm_map_marker_class_new()
4341  * @see elm_map_marker_group_class_new()
4342  * @see elm_map_marker_remove()
4343  *
4344  * @ingroup Map
4345  * @deprecated Use Elm_Map_Overlay instead
4346  */
4347 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);
4348
4349 /**
4350  * Set the maximum numbers of markers' content to be displayed in a group.
4351  *
4352  * @param obj The map object.
4353  * @param max The maximum numbers of items displayed in a bubble.
4354  *
4355  * A bubble will be displayed when the user clicks over the group,
4356  * and will place the content of markers that belong to this group
4357  * inside it.
4358  *
4359  * A group can have a long list of markers, consequently the creation
4360  * of the content of the bubble can be very slow.
4361  *
4362  * In order to avoid this, a maximum number of items is displayed
4363  * in a bubble.
4364  *
4365  * By default this number is 30.
4366  *
4367  * Marker with the same group class are grouped if they are close.
4368  *
4369  * @see elm_map_marker_add()
4370  *
4371  * @ingroup Map
4372  * @deprecated Use Elm_Map_Overlay instead
4373  */
4374 EINA_DEPRECATED EAPI void                  elm_map_max_marker_per_group_set(Evas_Object *obj, int max);
4375
4376 /**
4377  * Remove a marker from the map.
4378  *
4379  * @param marker The marker to remove.
4380  *
4381  * @see elm_map_marker_add()
4382  *
4383  * @ingroup Map
4384  * @deprecated Use Elm_Map_Overlay instead
4385  */
4386 EINA_DEPRECATED EAPI void                  elm_map_marker_remove(Elm_Map_Marker *marker);
4387
4388 /**
4389  * Get the current coordinates of the marker.
4390  *
4391  * @param marker marker.
4392  * @param lat Pointer to store the marker's latitude.
4393  * @param lon Pointer to store the marker's longitude.
4394  *
4395  * These values are set when adding markers, with function
4396  * elm_map_marker_add().
4397  *
4398  * @see elm_map_marker_add()
4399  *
4400  * @ingroup Map
4401  * @deprecated Use Elm_Map_Overlay instead
4402  */
4403 EINA_DEPRECATED EAPI void                  elm_map_marker_region_get(const Elm_Map_Marker *marker, double *lon, double *lat);
4404
4405 /**
4406  * Animatedly bring in given marker to the center of the map.
4407  *
4408  * @param marker The marker to center at.
4409  *
4410  * This causes map to jump to the given @p marker's coordinates
4411  * and show it (by scrolling) in the center of the viewport, if it is not
4412  * already centered. This will use animation to do so and take a period
4413  * of time to complete.
4414  *
4415  * @see elm_map_marker_show() for a function to avoid animation.
4416  * @see elm_map_marker_region_get()
4417  *
4418  * @ingroup Map
4419  * @deprecated Use Elm_Map_Overlay instead
4420  */
4421 EINA_DEPRECATED EAPI void                  elm_map_marker_bring_in(Elm_Map_Marker *marker);
4422
4423 /**
4424  * Show the given marker at the center of the map, @b immediately.
4425  *
4426  * @param marker The marker to center at.
4427  *
4428  * This causes map to @b redraw its viewport's contents to the
4429  * region containing the given @p marker's coordinates, that will be
4430  * moved to the center of the map.
4431  *
4432  * @see elm_map_marker_bring_in() for a function to move with animation.
4433  * @see elm_map_markers_list_show() if more than one marker need to be
4434  * displayed.
4435  * @see elm_map_marker_region_get()
4436  *
4437  * @ingroup Map
4438  * @deprecated Use Elm_Map_Overlay instead
4439  */
4440 EINA_DEPRECATED EAPI void                  elm_map_marker_show(Elm_Map_Marker *marker);
4441
4442 /**
4443  * Move and zoom the map to display a list of markers.
4444  *
4445  * @param markers A list of #Elm_Map_Marker handles.
4446  *
4447  * The map will be centered on the center point of the markers in the list.
4448  * Then the map will be zoomed in order to fit the markers using the maximum
4449  * zoom which allows display of all the markers.
4450  *
4451  * @warning All the markers should belong to the same map object.
4452  *
4453  * @see elm_map_marker_show() to show a single marker.
4454  * @see elm_map_marker_bring_in()
4455  *
4456  * @ingroup Map
4457  * @deprecated Use Elm_Map_Overlay instead
4458  */
4459 EINA_DEPRECATED EAPI void                  elm_map_markers_list_show(Eina_List *markers);
4460
4461 /**
4462  * Set to show markers during zoom level changes or not.
4463  *
4464  * @param obj The map object.
4465  * @param paused Use @c EINA_TRUE to @b not show markers or @c EINA_FALSE
4466  * to show them.
4467  *
4468  * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4469  * for map.
4470  *
4471  * The default is off.
4472  *
4473  * This will stop zooming using animation, changing zoom levels will
4474  * change instantly. This will stop any existing animations that are running.
4475  *
4476  * This sets the paused state to on (@c EINA_TRUE) or off (@c EINA_FALSE)
4477  * for the markers.
4478  *
4479  * The default  is off.
4480  *
4481  * Enabling it will force the map to stop displaying the markers during
4482  * zoom level changes. Set to on if you have a large number of markers.
4483  *
4484  * @see elm_map_paused_markers_get()
4485  *
4486  * @ingroup Map
4487  * @deprecated Use Elm_Map_Overlay instead
4488  */
4489 EINA_DEPRECATED EAPI void                  elm_map_paused_markers_set(Evas_Object *obj, Eina_Bool paused);
4490
4491 /**
4492  * Get a value whether markers will be displayed on zoom level changes or not
4493  *
4494  * @param obj The map object.
4495  * @return @c EINA_TRUE means map @b won't display markers or @c EINA_FALSE
4496  * indicates it will.
4497  *
4498  * This gets the current markers paused state for the map object.
4499  *
4500  * @see elm_map_paused_markers_set() for details.
4501  *
4502  * @ingroup Map
4503  * @deprecated Use Elm_Map_Overlay instead
4504  */
4505 EINA_DEPRECATED EAPI Eina_Bool             elm_map_paused_markers_get(const Evas_Object *obj);
4506
4507 /**
4508  * Get the Evas object returned by the Elm_Map_Marker_Get_Func callback
4509  *
4510  * @param marker The marker which content should be returned.
4511  * @return Return the evas object if it exists, else @c NULL.
4512  *
4513  * To set callback function #Elm_Map_Marker_Get_Func for the marker class,
4514  * elm_map_marker_class_get_cb_set() should be used.
4515  *
4516  * This content is what will be inside the bubble that will be displayed
4517  * when an user clicks over the marker.
4518  *
4519  * This returns the actual Evas object used to be placed inside
4520  * the bubble. This may be @c NULL, as it may
4521  * not have been created or may have been deleted, at any time, by
4522  * the map. <b>Do not modify this object</b> (move, resize,
4523  * show, hide, etc.), as the map is controlling it. This
4524  * function is for querying, emitting custom signals or hooking
4525  * lower level callbacks for events on that object. Do not delete
4526  * this object under any circumstances.
4527  *
4528  * @ingroup Map
4529  * @deprecated Use Elm_Map_Overlay instead
4530  */
4531 EINA_DEPRECATED EAPI Evas_Object          *elm_map_marker_object_get(const Elm_Map_Marker *marker);
4532
4533 /**
4534  * Update the marker
4535  *
4536  * @param marker The marker to be updated.
4537  *
4538  * If a content is set to this marker, it will call function to delete it,
4539  * #Elm_Map_Marker_Del_Func, and then will fetch the content again with
4540  * #Elm_Map_Marker_Get_Func.
4541  *
4542  * These functions are set for the marker class with
4543  * elm_map_marker_class_get_cb_set() and elm_map_marker_class_del_cb_set().
4544  *
4545  * @ingroup Map
4546  * @deprecated Use Elm_Map_Overlay instead
4547  */
4548 EINA_DEPRECATED EAPI void                  elm_map_marker_update(Elm_Map_Marker *marker);
4549
4550 /**
4551  * Close all the bubbles opened by the user.
4552  *
4553  * @param obj The map object.
4554  *
4555  * A bubble is displayed with a content fetched with #Elm_Map_Marker_Get_Func
4556  * when the user clicks on a marker.
4557  *
4558  * This functions is set for the marker class with
4559  * elm_map_marker_class_get_cb_set().
4560  *
4561  * @ingroup Map
4562  * @deprecated Use Elm_Map_Overlay instead
4563  */
4564 EINA_DEPRECATED EAPI void                  elm_map_bubbles_close(Evas_Object *obj);
4565
4566 /**
4567  * Create a new group class.
4568  *
4569  * @param obj The map object.
4570  * @return Returns the new group class.
4571  *
4572  * Each marker must be associated to a group class. Markers in the same
4573  * group are grouped if they are close.
4574  *
4575  * The group class defines the style of the marker when a marker is grouped
4576  * to others markers. When it is alone, another class will be used.
4577  *
4578  * A group class will need to be provided when creating a marker with
4579  * elm_map_marker_add().
4580  *
4581  * Some properties and functions can be set by class, as:
4582  * - style, with elm_map_group_class_style_set()
4583  * - data - to be associated to the group class. It can be set using
4584  *   elm_map_group_class_data_set().
4585  * - min zoom to display markers, set with
4586  *   elm_map_group_class_zoom_displayed_set().
4587  * - max zoom to group markers, set using
4588  *   elm_map_group_class_zoom_grouped_set().
4589  * - visibility - set if markers will be visible or not, set with
4590  *   elm_map_group_class_hide_set().
4591  * - #Elm_Map_Group_Icon_Get_Func - used to fetch icon for markers group classes.
4592  *   It can be set using elm_map_group_class_icon_cb_set().
4593  *
4594  * @see elm_map_marker_add()
4595  * @see elm_map_group_class_style_set()
4596  * @see elm_map_group_class_data_set()
4597  * @see elm_map_group_class_zoom_displayed_set()
4598  * @see elm_map_group_class_zoom_grouped_set()
4599  * @see elm_map_group_class_hide_set()
4600  * @see elm_map_group_class_icon_cb_set()
4601  *
4602  * @ingroup Map
4603  * @deprecated Use Elm_Map_Overlay instead
4604  */
4605 EINA_DEPRECATED EAPI Elm_Map_Group_Class  *elm_map_group_class_new(Evas_Object *obj);
4606
4607 /**
4608  * Set the marker's style of a group class.
4609  *
4610  * @param clas The group class.
4611  * @param style The style to be used by markers.
4612  *
4613  * Each marker must be associated to a group class, and will use the style
4614  * defined by such class when grouped to other markers.
4615  *
4616  * The following styles are provided by default theme:
4617  * @li @c radio - blue circle
4618  * @li @c radio2 - green circle
4619  * @li @c empty
4620  *
4621  * @see elm_map_group_class_new() for more details.
4622  * @see elm_map_marker_add()
4623  *
4624  * @ingroup Map
4625  * @deprecated Use Elm_Map_Overlay instead
4626  */
4627 EINA_DEPRECATED EAPI void                  elm_map_group_class_style_set(Elm_Map_Group_Class *clas, const char *style);
4628
4629 /**
4630  * Set the icon callback function of a group class.
4631  *
4632  * @param clas The group class.
4633  * @param icon_get The callback function that will return the icon.
4634  *
4635  * Each marker must be associated to a group class, and it can display a
4636  * custom icon. The function @p icon_get must return this icon.
4637  *
4638  * @see elm_map_group_class_new() for more details.
4639  * @see elm_map_marker_add()
4640  *
4641  * @ingroup Map
4642  * @deprecated Use Elm_Map_Overlay instead
4643  */
4644 EINA_DEPRECATED EAPI void                  elm_map_group_class_icon_cb_set(Elm_Map_Group_Class *clas, Elm_Map_Group_Icon_Get_Func icon_get);
4645
4646 /**
4647  * Set the data associated to the group class.
4648  *
4649  * @param clas The group class.
4650  * @param data The new user data.
4651  *
4652  * This data will be passed for callback functions, like icon get callback,
4653  * that can be set with elm_map_group_class_icon_cb_set().
4654  *
4655  * If a data was previously set, the object will lose the pointer for it,
4656  * so if needs to be freed, you must do it yourself.
4657  *
4658  * @see elm_map_group_class_new() for more details.
4659  * @see elm_map_group_class_icon_cb_set()
4660  * @see elm_map_marker_add()
4661  *
4662  * @ingroup Map
4663  * @deprecated Use Elm_Map_Overlay instead
4664  */
4665 EINA_DEPRECATED EAPI void                  elm_map_group_class_data_set(Elm_Map_Group_Class *clas, void *data);
4666
4667 /**
4668  * Set the minimum zoom from where the markers are displayed.
4669  *
4670  * @param clas The group class.
4671  * @param zoom The minimum zoom.
4672  *
4673  * Markers only will be displayed when the map is displayed at @p zoom
4674  * or bigger.
4675  *
4676  * @see elm_map_group_class_new() for more details.
4677  * @see elm_map_marker_add()
4678  *
4679  * @ingroup Map
4680  * @deprecated Use Elm_Map_Overlay instead
4681  */
4682 EINA_DEPRECATED EAPI void                  elm_map_group_class_zoom_displayed_set(Elm_Map_Group_Class *clas, int zoom);
4683
4684 /**
4685  * Set the zoom from where the markers are no more grouped.
4686  *
4687  * @param clas The group class.
4688  * @param zoom The maximum zoom.
4689  *
4690  * Markers only will be grouped when the map is displayed at
4691  * less than @p zoom.
4692  *
4693  * @see elm_map_group_class_new() for more details.
4694  * @see elm_map_marker_add()
4695  *
4696  * @ingroup Map
4697  * @deprecated Use Elm_Map_Overlay instead
4698  */
4699 EINA_DEPRECATED EAPI void                  elm_map_group_class_zoom_grouped_set(Elm_Map_Group_Class *clas, int zoom);
4700
4701 /**
4702  * Set if the markers associated to the group class @p clas are hidden or not.
4703  *
4704  * @param clas The group class.
4705  * @param hide Use @c EINA_TRUE to hide markers or @c EINA_FALSE
4706  * to show them.
4707  *
4708  * @param obj The map object.
4709  * If @p hide is @c EINA_TRUE the markers will be hidden, but default
4710  * is to show them.
4711  *
4712  * @ingroup Map
4713  * @deprecated Use Elm_Map_Overlay instead
4714  */
4715 EINA_DEPRECATED EAPI void                  elm_map_group_class_hide_set(Evas_Object *obj, Elm_Map_Group_Class *clas, Eina_Bool hide);
4716
4717 /**
4718  * Create a new marker class.
4719  *
4720  * @param obj The map object.
4721  * @return Returns the new group class.
4722  *
4723  * Each marker must be associated to a class.
4724  *
4725  * The marker class defines the style of the marker when a marker is
4726  * displayed alone, i.e., not grouped to to others markers. When grouped
4727  * it will use group class style.
4728  *
4729  * A marker class will need to be provided when creating a marker with
4730  * elm_map_marker_add().
4731  *
4732  * Some properties and functions can be set by class, as:
4733  * - style, with elm_map_marker_class_style_set()
4734  * - #Elm_Map_Marker_Icon_Get_Func - used to fetch icon for markers classes.
4735  *   It can be set using elm_map_marker_class_icon_cb_set().
4736  * - #Elm_Map_Marker_Get_Func - used to fetch bubble content for marker classes.
4737  *   Set using elm_map_marker_class_get_cb_set().
4738  * - #Elm_Map_Marker_Del_Func - used to delete bubble content for marker classes.
4739  *   Set using elm_map_marker_class_del_cb_set().
4740  *
4741  * @see elm_map_marker_add()
4742  * @see elm_map_marker_class_style_set()
4743  * @see elm_map_marker_class_icon_cb_set()
4744  * @see elm_map_marker_class_get_cb_set()
4745  * @see elm_map_marker_class_del_cb_set()
4746  *
4747  * @ingroup Map
4748  * @deprecated Use Elm_Map_Overlay instead
4749  */
4750 EINA_DEPRECATED EAPI Elm_Map_Marker_Class *elm_map_marker_class_new(Evas_Object *obj);
4751
4752 /**
4753  * Set the marker's style of a marker class.
4754  *
4755  * @param clas The marker class.
4756  * @param style The style to be used by markers.
4757  *
4758  * Each marker must be associated to a marker class, and will use the style
4759  * defined by such class when alone, i.e., @b not grouped to other markers.
4760  *
4761  * The following styles are provided by default theme:
4762  * @li @c radio
4763  * @li @c radio2
4764  * @li @c empty
4765  *
4766  * @see elm_map_marker_class_new() for more details.
4767  * @see elm_map_marker_add()
4768  *
4769  * @ingroup Map
4770  * @deprecated Use Elm_Map_Overlay instead
4771  */
4772 EINA_DEPRECATED EAPI void                  elm_map_marker_class_style_set(Elm_Map_Marker_Class *clas, const char *style);
4773
4774 /**
4775  * Set the icon callback function of a marker class.
4776  *
4777  * @param clas The marker class.
4778  * @param icon_get The callback function that will return the icon.
4779  *
4780  * Each marker must be associated to a marker class, and it can display a
4781  * custom icon. The function @p icon_get must return this icon.
4782  *
4783  * @see elm_map_marker_class_new() for more details.
4784  * @see elm_map_marker_add()
4785  *
4786  * @ingroup Map
4787  * @deprecated Use Elm_Map_Overlay instead
4788  */
4789 EINA_DEPRECATED EAPI void                  elm_map_marker_class_icon_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Icon_Get_Func icon_get);
4790
4791 /**
4792  * Set the bubble content callback function of a marker class.
4793  *
4794  * @param clas The marker class.
4795  * @param get The callback function that will return the content.
4796  *
4797  * Each marker must be associated to a marker class, and it can display a
4798  * a content on a bubble that opens when the user click over the marker.
4799  * The function @p get must return this content object.
4800  *
4801  * If this content will need to be deleted, elm_map_marker_class_del_cb_set()
4802  * can be used.
4803  *
4804  * @see elm_map_marker_class_new() for more details.
4805  * @see elm_map_marker_class_del_cb_set()
4806  * @see elm_map_marker_add()
4807  *
4808  * @ingroup Map
4809  * @deprecated Use Elm_Map_Overlay instead
4810  */
4811 EINA_DEPRECATED EAPI void                  elm_map_marker_class_get_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Get_Func get);
4812
4813 /**
4814  * Set the callback function used to delete bubble content of a marker class.
4815  *
4816  * @param clas The marker class.
4817  * @param del The callback function that will delete the content.
4818  *
4819  * Each marker must be associated to a marker class, and it can display a
4820  * a content on a bubble that opens when the user click over the marker.
4821  * The function to return such content can be set with
4822  * elm_map_marker_class_get_cb_set().
4823  *
4824  * If this content must be freed, a callback function need to be
4825  * set for that task with this function.
4826  *
4827  * If this callback is defined it will have to delete (or not) the
4828  * object inside, but if the callback is not defined the object will be
4829  * destroyed with evas_object_del().
4830  *
4831  * @see elm_map_marker_class_new() for more details.
4832  * @see elm_map_marker_class_get_cb_set()
4833  * @see elm_map_marker_add()
4834  *
4835  * @ingroup Map
4836  * @deprecated Use Elm_Map_Overlay instead
4837  */
4838 EINA_DEPRECATED EAPI void                  elm_map_marker_class_del_cb_set(Elm_Map_Marker_Class *clas, Elm_Map_Marker_Del_Func del);
4839
4840 /**
4841  * Set the route color.
4842  *
4843  * @param route The route object.
4844  * @param r Red channel value, from 0 to 255.
4845  * @param g Green channel value, from 0 to 255.
4846  * @param b Blue channel value, from 0 to 255.
4847  * @param a Alpha channel value, from 0 to 255.
4848  *
4849  * It uses an additive color model, so each color channel represents
4850  * how much of each primary colors must to be used. 0 represents
4851  * absence of this color, so if all of the three are set to 0,
4852  * the color will be black.
4853  *
4854  * These component values should be integers in the range 0 to 255,
4855  * (single 8-bit byte).
4856  *
4857  * This sets the color used for the route. By default, it is set to
4858  * solid red (r = 255, g = 0, b = 0, a = 255).
4859  *
4860  * For alpha channel, 0 represents completely transparent, and 255, opaque.
4861  *
4862  * @see elm_map_route_color_get()
4863  * @deprecated Use elm_map_overlay_color_set() instead
4864  *
4865  * @ingroup Map
4866  */
4867 EINA_DEPRECATED EAPI void                  elm_map_route_color_set(Elm_Map_Route *route, int r, int g, int b, int a);
4868
4869 /**
4870  * Get the route color.
4871  *
4872  * @param route The route object.
4873  * @param r Pointer to store the red channel value.
4874  * @param g Pointer to store the green channel value.
4875  * @param b Pointer to store the blue channel value.
4876  * @param a Pointer to store the alpha channel value.
4877  *
4878  * @see elm_map_route_color_set() for details.
4879  * @deprecated Use elm_map_overlay_color_get() instead
4880  *
4881  * @ingroup Map
4882  */
4883 EINA_DEPRECATED EAPI void                  elm_map_route_color_get(const Elm_Map_Route *route, int *r, int *g, int *b, int *a);
4884
4885 /**
4886  * Remove a route from the map.
4887  *
4888  * @param route The route to remove.
4889  *
4890  * @see elm_map_route_add()
4891  * @deprecated Use elm_map_route_del() instead
4892  *
4893  * @ingroup Map
4894  */
4895 EINA_DEPRECATED EAPI void                  elm_map_route_remove(Elm_Map_Route *route);
4896
4897 /**
4898  * Remove a name from the map.
4899  *
4900  * @param name The name to remove.
4901  *
4902  * Basically the struct handled by @p name will be freed, so conversions
4903  * between address and coordinates will be lost.
4904  *
4905  * @see elm_map_utils_convert_name_into_coord()
4906  * @see elm_map_utils_convert_coord_into_name()
4907  * @deprecated Use elm_map_name_del() instead
4908  *
4909  * @ingroup Map
4910  */
4911 EINA_DEPRECATED EAPI void                  elm_map_name_remove(Elm_Map_Name *name);
4912
4913 /**
4914  * Get the gengrid object's handle which contains a given gengrid item
4915  *
4916  * @param it The item to fetch the container from
4917  * @return The gengrid (parent) object
4918  *
4919  * This returns the gengrid object itself that an item belongs to.
4920  *
4921  * @deprecated Use elm_object_item_widget_get() instead
4922  * @ingroup Gengrid
4923  */
4924 EINA_DEPRECATED EAPI Evas_Object                  *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
4925
4926 /**
4927  * Return the data associated to a given gengrid item
4928  *
4929  * @param it The gengrid item.
4930  * @return the data associated with this item.
4931  *
4932  * This returns the @c data value passed on the
4933  * elm_gengrid_item_append() and related item addition calls.
4934  *
4935  * @see elm_gengrid_item_append()
4936  * @see elm_gengrid_item_data_set()
4937  * @deprecated Use elm_object_item_data_get() instead
4938  * @ingroup Gengrid
4939  */
4940 EINA_DEPRECATED EAPI void                         *elm_gengrid_item_data_get(const Elm_Object_Item *it);
4941
4942 /**
4943  * Set the data associated with a given gengrid item
4944  *
4945  * @param it The gengrid item
4946  * @param data The data pointer to set on it
4947  *
4948  * This @b overrides the @c data value passed on the
4949  * elm_gengrid_item_append() and related item addition calls. This
4950  * function @b won't call elm_gengrid_item_update() automatically,
4951  * so you'd issue it afterwards if you want to have the item
4952  * updated to reflect the new data.
4953  *
4954  * @see elm_gengrid_item_data_get()
4955  * @see elm_gengrid_item_update()
4956  * @deprecated Use elm_object_item_data_set() instead
4957  *
4958  * @ingroup Gengrid
4959  */
4960 EINA_DEPRECATED EAPI void                          elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
4961
4962 /**
4963  * Set whether a given gengrid item is disabled or not.
4964  *
4965  * @param it The gengrid item
4966  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
4967  * to enable it back.
4968  *
4969  * A disabled item cannot be selected or unselected. It will also
4970  * change its appearance, to signal the user it's disabled.
4971  *
4972  * @see elm_gengrid_item_disabled_get()
4973  * @deprecated Use elm_object_item_disabled_set() instead
4974  *
4975  * @ingroup Gengrid
4976  */
4977 EINA_DEPRECATED EAPI void                          elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
4978
4979 /**
4980  * Get whether a given gengrid item is disabled or not.
4981  *
4982  * @param it The gengrid item
4983  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
4984  * (and on errors).
4985  *
4986  * @see elm_gengrid_item_disabled_set() for more details
4987  * @deprecated Use elm_object_item_disabled_get() instead
4988  *
4989  * @ingroup Gengrid
4990  */
4991 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
4992
4993 /**
4994  * Remove a gengrid item from its parent, deleting it.
4995  *
4996  * @param it The item to be removed.
4997  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
4998  *
4999  * @see elm_gengrid_clear(), to remove all items in a gengrid at
5000  * once.
5001  * @deprecated use elm_object_item_de() instead
5002  *
5003  * @ingroup Gengrid
5004  */
5005 EINA_DEPRECATED EAPI void                          elm_gengrid_item_del(Elm_Object_Item *it);
5006
5007 /**
5008  * Update the item class of a gengrid item.
5009  *
5010  * This sets another class of the item, changing the way that it is
5011  * displayed. After changing the item class, elm_gengrid_item_update() is
5012  * called on the item @p it.
5013  *
5014  * @param it The gengrid item
5015  * @param gic The gengrid item class describing the function pointers and the item style.
5016  *
5017  * @deprecated Use elm_gengrid_item_item_class_update instead
5018  * @ingroup Gengrid
5019  */
5020 EINA_DEPRECATED EAPI void                          elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
5021
5022 /**
5023  * Insert an item in a gengrid widget using a user-defined sort function.
5024  *
5025  * @param obj The gengrid object.
5026  * @param gic The item class for the item.
5027  * @param data The item data.
5028  * @param comp User defined comparison function that defines the sort order
5029  *             based on Elm_Gen_Item.
5030  * @param func Convenience function called when the item is selected.
5031  * @param func_data Data to be passed to @p func.
5032  * @return A handle to the item added or @c NULL, on errors.
5033  *
5034  * This inserts an item in the gengrid based on user defined comparison function.
5035  *
5036  * @see elm_gengrid_item_append()
5037  * @see elm_gengrid_item_prepend()
5038  * @see elm_gengrid_item_insert_after()
5039  * @see elm_object_item_del()
5040  * @see elm_gengrid_item_sorted_insert()
5041  *
5042  * @deprecated Use elm_gengrid_item_sorted_insert() instead
5043  * @ingroup Gengrid
5044  */
5045 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);
5046
5047 /**
5048  * Append a filter function for text inserted in the entry
5049  *
5050  * Append the given callback to the list. This functions will be called
5051  * whenever any text is inserted into the entry, with the text to be inserted
5052  * as a parameter. The callback function is free to alter the text in any way
5053  * it wants, but it must remember to free the given pointer and update it.
5054  * If the new text is to be discarded, the function can free it and set its
5055  * text parameter to NULL. This will also prevent any following filters from
5056  * being called.
5057  *
5058  * @param obj The entry object
5059  * @param func The function to use as text filter
5060  * @param data User data to pass to @p func
5061  * @deprecated use elm_entry_markup_filter_append() instead
5062  * @ingroup Entry
5063  */
5064 EINA_DEPRECATED EAPI void               elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5065
5066 /**
5067  * Prepend a filter function for text inserted in the entry
5068  *
5069  * Prepend the given callback to the list. See elm_entry_text_filter_append()
5070  * for more information
5071  *
5072  * @param obj The entry object
5073  * @param func The function to use as text filter
5074  * @param data User data to pass to @p func
5075  * @deprecated use elm_entry_markup_filter_prepend() instead
5076  * @ingroup Entry
5077  */
5078 EINA_DEPRECATED EAPI void               elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5079
5080 /**
5081  * Remove a filter from the list
5082  *
5083  * Removes the given callback from the filter list. See
5084  * elm_entry_text_filter_append() for more information.
5085  *
5086  * @param obj The entry object
5087  * @param func The filter function to remove
5088  * @param data The user data passed when adding the function
5089  * @deprecated use elm_entry_markup_filter_remove() instead
5090  * @ingroup Entry
5091  */
5092 EINA_DEPRECATED EAPI void               elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
5093
5094 /**
5095  * @brief Set the front content of the flip widget.
5096  *
5097  * @param obj The flip object
5098  * @param content The new front content object
5099  *
5100  * Once the content object is set, a previously set one will be deleted.
5101  * If you want to keep that old content object, use the
5102  * elm_flip_content_front_unset() function.
5103  *
5104  * @deprecated Use elm_object_part_content_set(flip, "front") instead
5105  */
5106 EINA_DEPRECATED EAPI void                 elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
5107
5108 /**
5109  * @brief Set the back content of the flip widget.
5110  *
5111  * @param obj The flip object
5112  * @param content The new back content object
5113  *
5114  * Once the content object is set, a previously set one will be deleted.
5115  * If you want to keep that old content object, use the
5116  * elm_flip_content_back_unset() function.
5117  *
5118  * @deprecated Use elm_object_part_content_set(flip, "back") instead
5119  */
5120 EINA_DEPRECATED EAPI void                 elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
5121
5122 /**
5123  * @brief Get the front content used for the flip
5124  *
5125  * @param obj The flip object
5126  * @return The front content object that is being used
5127  *
5128  * Return the front content object which is set for this widget.
5129  *
5130  * @deprecated Use elm_object_part_content_get(flip, "front") instead
5131  */
5132 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_get(const Evas_Object *obj);
5133
5134 /**
5135  * @brief Get the back content used for the flip
5136  *
5137  * @param obj The flip object
5138  * @return The back content object that is being used
5139  *
5140  * Return the back content object which is set for this widget.
5141  *
5142  * @deprecated Use elm_object_part_content_get(flip, "back") instead
5143  */
5144 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_get(const Evas_Object *obj);
5145
5146 /**
5147  * @brief Unset the front content used for the flip
5148  *
5149  * @param obj The flip object
5150  * @return The front content object that was being used
5151  *
5152  * Unparent and return the front content object which was set for this widget.
5153  *
5154  * @deprecated Use elm_object_part_content_unset(flip, "front") instead
5155  */
5156 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_unset(Evas_Object *obj);
5157
5158 /**
5159  * @brief Unset the back content used for the flip
5160  *
5161  * @param obj The flip object
5162  * @return The back content object that was being used
5163  *
5164  * Unparent and return the back content object which was set for this widget.
5165  *
5166  * @deprecated Use elm_object_part_content_unset(flip, "back") instead
5167  */
5168 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_unset(Evas_Object *obj);
5169
5170 /**
5171  * @brief Get flip front visibility state
5172  *
5173  * @param obj The flip object
5174  * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
5175  * showing.
5176  *
5177  * @deprecated Use elm_flip_front_visible_get() instead
5178  */
5179 EINA_DEPRECATED EAPI Eina_Bool            elm_flip_front_get(const Evas_Object *obj);
5180
5181 /*
5182  * Add a new pager to the parent
5183  *
5184  * @param parent The parent object
5185  * @return The new object or NULL if it cannot be created
5186  *
5187  * @ingroup Pager
5188  * @deprecated Use naviframe instead
5189  */
5190 EINA_DEPRECATED EAPI Evas_Object *elm_pager_add(Evas_Object *parent);
5191
5192 /**
5193  * @brief Push an object to the top of the pager stack (and show it).
5194  *
5195  * @param obj The pager object
5196  * @param content The object to push
5197  *
5198  * The object pushed becomes a child of the pager, it will be controlled and
5199  * deleted when the pager is deleted.
5200  *
5201  * @note If the content is already in the stack use
5202  * elm_pager_content_promote().
5203  * @warning Using this function on @p content already in the stack results in
5204  * undefined behavior.
5205  * @deprecated Use naviframe instead
5206  */
5207 EINA_DEPRECATED EAPI void         elm_pager_content_push(Evas_Object *obj, Evas_Object *content);
5208
5209 /**
5210  * @brief Pop the object that is on top of the stack
5211  *
5212  * @param obj The pager object
5213  *
5214  * This pops the object that is on the top(visible) of the pager, makes it
5215  * disappear, then deletes the object. The object that was underneath it on
5216  * the stack will become visible.
5217  * @deprecated Use naviframe instead
5218  */
5219 EINA_DEPRECATED EAPI void         elm_pager_content_pop(Evas_Object *obj);
5220
5221 /**
5222  * @brief Moves an object already in the pager stack to the top of the stack.
5223  *
5224  * @param obj The pager object
5225  * @param content The object to promote
5226  *
5227  * This will take the @p content and move it to the top of the stack as
5228  * if it had been pushed there.
5229  *
5230  * @note If the content isn't already in the stack use
5231  * elm_pager_content_push().
5232  * @warning Using this function on @p content not already in the stack
5233  * results in undefined behavior.
5234  * @deprecated Use naviframe instead
5235  */
5236 EINA_DEPRECATED EAPI void         elm_pager_content_promote(Evas_Object *obj, Evas_Object *content);
5237
5238 /**
5239  * @brief Return the object at the bottom of the pager stack
5240  *
5241  * @param obj The pager object
5242  * @return The bottom object or NULL if none
5243  * @deprecated Use naviframe instead
5244  */
5245 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_bottom_get(const Evas_Object *obj);
5246
5247 /**
5248  * @brief  Return the object at the top of the pager stack
5249  *
5250  * @param obj The pager object
5251  * @return The top object or NULL if none
5252  * @deprecated Use naviframe instead
5253  */
5254 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_top_get(const Evas_Object *obj);
5255
5256 /**
5257  * @brief Set the default item style.
5258  *
5259  * Default item style will be used with items who's style is NULL
5260  *
5261  * @param obj The pager object
5262  * @param style The style
5263  * @deprecated Use naviframe instead
5264  */
5265 EINA_DEPRECATED EAPI void             elm_pager_item_style_default_set(Evas_Object *obj, const char *style);
5266
5267 /**
5268  * @brief Get the default item style
5269  *
5270  * @param obj The pager object
5271  * @return the default item style
5272  *
5273  * @see elm_pager_item_style_default_set()
5274  * @deprecated Use naviframe instead
5275  */
5276 EINA_DEPRECATED EAPI const char      *elm_pager_item_style_default_get(const Evas_Object *obj);
5277
5278 /**
5279  * @brief Set the font size on the label object.
5280  *
5281  * @param obj The label object
5282  * @param size font size
5283  *
5284  * @warning NEVER use this. It is for hyper-special cases only. use styles
5285  * instead. e.g. "default", "marker", "slide_long" etc.
5286  * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
5287  */
5288 EINA_DEPRECATED EAPI void                        elm_label_fontsize_set(Evas_Object *obj, int fontsize);
5289
5290 /**
5291  * @brief Set the text color on the label object
5292  *
5293  * @param obj The label object
5294  * @param r Red property background color of The label object
5295  * @param g Green property background color of The label object
5296  * @param b Blue property background color of The label object
5297  * @param a Alpha property background color of The label object
5298  *
5299  * @warning NEVER use this. It is for hyper-special cases only. use styles
5300  * instead. e.g. "default", "marker", "slide_long" etc.
5301  * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
5302  */
5303 EINA_DEPRECATED EAPI void                        elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5304
5305 /**
5306  * @brief Set the text align on the label object
5307  *
5308  * @param obj The label object
5309  * @param align align mode ("left", "center", "right")
5310  *
5311  * @warning NEVER use this. It is for hyper-special cases only. use styles
5312  * instead. e.g. "default", "marker", "slide_long" etc.
5313  * @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%.
5314  */
5315 EINA_DEPRECATED EAPI void                        elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
5316
5317 /**
5318  * @brief Set background color of the label
5319  *
5320  * @param obj The label object
5321  * @param r Red property background color of The label object
5322  * @param g Green property background color of The label object
5323  * @param b Blue property background color of The label object
5324  * @param a Alpha property background alpha of The label object
5325  *
5326  * @warning NEVER use this. It is for hyper-special cases only. use styles
5327  * instead. e.g. "default", "marker", "slide_long" etc.
5328  * @deprecated Just make colored background by yourself.
5329  */
5330 EINA_DEPRECATED EAPI void                        elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
5331
5332 /**
5333  * @brief Set wrap height of the label
5334  *
5335  * @param obj The label object
5336  * @param h The wrap height in pixels at a minimum where words need to wrap
5337  *
5338  * This function sets the maximum height size hint of the label.
5339  *
5340  * @warning This is only relevant if the label is inside a container.
5341  * @deprecated This function should not be used because of wrong concept.
5342  */
5343 EAPI void                        elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
5344
5345 /**
5346  * @brief get wrap width of the label
5347  *
5348  * @param obj The label object
5349  * @return The wrap height in pixels at a minimum where words need to wrap
5350  * @deprecated This function should not be used because of wrong concept.
5351  */
5352 EAPI Evas_Coord                  elm_label_wrap_height_get(const Evas_Object *obj);
5353
5354 /**
5355  * @brief Flush all caches.
5356  *
5357  * Frees all data that was in cache and is not currently being used to reduce
5358  * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
5359  * to calling all of the following functions:
5360  * @li edje_file_cache_flush()
5361  * @li edje_collection_cache_flush()
5362  * @li eet_clearcache()
5363  * @li evas_image_cache_flush()
5364  * @li evas_font_cache_flush()
5365  * @li evas_render_dump()
5366  * @note Evas caches are flushed for every canvas associated with a window.
5367  * @deprecated Use elm_cache_all_flush() instead.
5368  */
5369 EINA_DEPRECATED EAPI void      elm_all_flush(void);
5370
5371
5372 /**
5373  * @brief Define the uri that will be the video source.
5374  *
5375  * @param video The video object to define the file for.
5376  * @param uri The uri to target.
5377  *
5378  * This function will define an uri as a source for the video of the
5379  * Elm_Video object. URI could be remote source of video, like http:// or local
5380  * like for example WebCam who are most of the time v4l2:// (but that depend an
5381  * you should use Emotion API to request and list the available Webcam on your
5382  *
5383  * @deprecated Use elm_video_file_set() instead.
5384  *
5385  */
5386 EINA_DEPRECATED EAPI void                 elm_video_uri_set(Evas_Object *video, const char *uri);
5387
5388 /**
5389  * @brief Get the region of the image that is currently shown
5390  *
5391  * @param obj
5392  * @param x A pointer to the X-coordinate of region
5393  * @param y A pointer to the Y-coordinate of region
5394  * @param w A pointer to the width
5395  * @param h A pointer to the height
5396  *
5397  * @deprecated Use elm_photocam_image_region_get() instead.
5398  */
5399 EINA_DEPRECATED EAPI void                   elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
5400
5401 /**
5402  * @brief Set the gesture state for photocam.
5403  *
5404  * @param obj The photocam object
5405  * @param gesture The gesture state to set
5406  *
5407  * This sets the gesture state to on(EINA_TRUE) or off (EINA_FALSE) for
5408  * photocam. The default is off. This will start multi touch zooming.
5409  *
5410  * @deprecated Use elm_photocam_gesture_enabled_set() instead.
5411  */
5412 EINA_DEPRECATED EAPI void                   elm_photocam_gesture_set(Evas_Object *obj, Eina_Bool gesture);
5413
5414 /**
5415  * @brief Get the gesture state for photocam.
5416  *
5417  * @param obj The photocam object
5418  * @return The current gesture state
5419  *
5420  * This gets the current gesture state for the photocam object.
5421  *
5422  * @deprecated Use elm_photocam_gesture_enabled_get() instead.
5423  */
5424 EINA_DEPRECATED EAPI Eina_Bool              elm_photocam_gesture_get(const Evas_Object *obj);
5425 /* No documentation for these API before.
5426  *
5427  * @deprecated Use elm_route_latitude_min_max_get()
5428  *             elm_route_longitude_min_max_get()
5429  *             instead.
5430  */
5431 EINA_DEPRECATED EAPI double       elm_route_lon_min_get(Evas_Object *obj);
5432 EINA_DEPRECATED EAPI double       elm_route_lat_min_get(Evas_Object *obj);
5433 EINA_DEPRECATED EAPI double       elm_route_lon_max_get(Evas_Object *obj);
5434 EINA_DEPRECATED EAPI double       elm_route_lat_max_get(Evas_Object *obj);
5435
5436
5437 /**
5438  * Get the duration after which tooltip will be shown.
5439  *
5440  * @return Duration after which tooltip will be shown.
5441  * @deprecated Use elm_config_tooltip_delay_get(void);
5442  */
5443 EINA_DEPRECATED EAPI double      elm_tooltip_delay_get(void);
5444
5445 /**
5446  * Set the duration after which tooltip will be shown.
5447  *
5448  * @return EINA_TRUE if value is set.
5449  * @deprecated Use elm_config_tooltip_delay_set(double delay);
5450  */
5451 EINA_DEPRECATED EAPI Eina_Bool   elm_tooltip_delay_set(double delay);
5452
5453 /**
5454  * Set the corner of the bubble
5455  *
5456  * @param obj The bubble object.
5457  * @param corner The given corner for the bubble.
5458  *
5459  * @deprecated Use elm_bubble_pos_set()
5460  *
5461  */
5462 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
5463
5464 /**
5465  * Get the corner of the bubble
5466  *
5467  * @param obj The bubble object.
5468  * @return The given corner for the bubble.
5469  *
5470  * @deprecated Use elm_bubble_pos_get()
5471  */
5472 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
5473
5474 /**
5475  * Enable or disable day selection
5476  *
5477  * @param obj The calendar object.
5478  * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
5479  * disable it.
5480  *
5481  * @deprecated Use elm_calendar_day_selection_disabled_set()
5482  */
5483 EINA_DEPRECATED EAPI void                 elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
5484
5485 /**
5486  * Get a value whether day selection is enabled or not.
5487  *
5488  * @param obj The calendar object.
5489  * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
5490  * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
5491  *
5492  * @deprecated elm_calendar_day_selection_disabled_get()
5493  */
5494 EINA_DEPRECATED EAPI Eina_Bool            elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
5495
5496 /**
5497  * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
5498  */
5499 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
5500
5501 /**
5502  * Get the configured font cache size
5503  *
5504  * This gets the globally configured font cache size, in bytes.
5505  *
5506  * @return The font cache size
5507  * @deprecated elm_cache_font_cache_size_get(void);
5508  */
5509 EINA_DEPRECATED EAPI int       elm_font_cache_get(void);
5510
5511 /**
5512  * Set the configured font cache size
5513  *
5514  * This sets the globally configured font cache size, in bytes
5515  *
5516  * @param size The font cache size
5517  * @deprecated elm_cache_font_cache_size_set(int size);
5518  */
5519 EINA_DEPRECATED EAPI void      elm_font_cache_set(int size);
5520
5521 /**
5522  * Get the configured image cache size
5523  *
5524  * This gets the globally configured image cache size, in bytes
5525  *
5526  * @return The image cache size
5527  * @ingroup Caches
5528  */
5529 EINA_DEPRECATED EAPI int       elm_image_cache_get(void);
5530 EAPI int       elm_cache_image_cache_size_get(void);
5531
5532 /**
5533  * Set the configured image cache size
5534  *
5535  * This sets the globally configured image cache size, in bytes
5536  *
5537  * @param size The image cache size
5538  * @deprecated Use elm_cache_image_cache_size_set(int size);
5539  */
5540 EINA_DEPRECATED EAPI void      elm_image_cache_set(int size);
5541
5542
5543 /**
5544  * Get the configured edje file cache size.
5545  *
5546  * This gets the globally configured edje file cache size, in number
5547  * of files.
5548  *
5549  * @return The edje file cache size
5550  * @deprecated Use elm_cache_edje_file_cache_size_get(void);
5551  */
5552 EINA_DEPRECATED EAPI int       elm_edje_file_cache_get(void);
5553
5554 /**
5555  * Set the configured edje file cache size
5556  *
5557  * This sets the globally configured edje file cache size, in number
5558  * of files.
5559  *
5560  * @param size The edje file cache size
5561  * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
5562  */
5563 EINA_DEPRECATED EAPI void      elm_edje_file_cache_set(int size);
5564
5565 /**
5566  * Get the configured edje collections (groups) cache size.
5567  *
5568  * This gets the globally configured edje collections cache size, in
5569  * number of collections.
5570  *
5571  * @return The edje collections cache size
5572  * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
5573  */
5574 EINA_DEPRECATED EAPI int       elm_edje_collection_cache_get(void);
5575
5576 /**
5577  * Set the configured edje collections (groups) cache size
5578  *
5579  * This sets the globally configured edje collections cache size, in
5580  * number of collections.
5581  *
5582  * @param size The edje collections cache size
5583  * @deprecated elm_cache_edje_collection_cache_size_set(int size);
5584  */
5585 EINA_DEPRECATED EAPI void      elm_edje_collection_cache_set(int size);
5586
5587 /**
5588  * Gets whether browsing history is enabled for the given object
5589  *
5590  * @param obj The web object
5591  *
5592  * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
5593  *
5594  * @deprecated Use elm_web_history_enabled_get()
5595  */
5596 EINA_DEPRECATED EAPI Eina_Bool         elm_web_history_enable_get(const Evas_Object *obj);
5597
5598 /**
5599  * Enables or disables the browsing history
5600  *
5601  * @param obj The web object
5602  * @param enable Whether to enable or disable the browsing history
5603  *
5604  * @deprecated Use elm_web_history_enabled_set()
5605  *
5606  */
5607 EINA_DEPRECATED EAPI void              elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
5608
5609 /**
5610  * @brief Add an object swallowed in an item at the end of the given menu
5611  * widget
5612  *
5613  * @param obj The menu object.
5614  * @param parent The parent menu item (optional)
5615  * @param subobj The object to swallow
5616  * @param func Function called when the user select the item.
5617  * @param data Data sent by the callback.
5618  * @return Returns the new item.
5619  *
5620  * Add an evas object as an item to the menu.
5621  * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
5622  */
5623 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);
5624
5625 /**
5626  * @brief Sets whether events should be passed to by a click outside
5627  * its area.
5628  *
5629  * @param obj The notify object
5630  * @param repeat EINA_TRUE Events are repeats, else no
5631  *
5632  * When true if the user clicks outside the window the events will be caught
5633  * by the others widgets, else the events are blocked.
5634  *
5635  * @note The default value is EINA_TRUE.
5636  * @deprecated Please use elm_notify_allow_events_set() instead
5637  */
5638 EINA_DEPRECATED EAPI void                         elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
5639
5640 /**
5641  * @brief Return true if events are repeat below the notify object
5642  * @param obj the notify object
5643  *
5644  * @see elm_notify_repeat_events_set()
5645  * @deprecated Please use elm_notify_allow_events_get() instead
5646  */
5647 EINA_DEPRECATED EAPI Eina_Bool                    elm_notify_repeat_events_get(const Evas_Object *obj);
5648
5649 /**
5650  * Set if the cursor set should be searched on the theme or should use
5651  * the provided by the engine, only.
5652  *
5653  * @param obj an object with cursor already set.
5654  * @param engine_only boolean to define if cursors should be looked only
5655  * between the provided by the engine or searched on widget's theme as well.
5656  *
5657  * @deprecated Use elm_object_cursor_theme_search_enabled_set()
5658  */
5659 EINA_DEPRECATED EAPI void        elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
5660
5661 /**
5662  * Get the cursor engine only usage for this object cursor.
5663  *
5664  * @param obj an object with cursor already set.
5665  * @return engine_only boolean to define it cursors should be
5666  * looked only between the provided by the engine or searched on
5667  * widget's theme as well. If the object does not have a cursor
5668  * set, then EINA_FALSE is returned.
5669  *
5670  * @deprecated Use elm_object_cursor_theme_search_enabled_get();
5671  */
5672 EINA_DEPRECATED EAPI Eina_Bool   elm_object_cursor_engine_only_get(const Evas_Object *obj);
5673
5674 /**
5675  * Go to a given items level on a index widget
5676  *
5677  * @param obj The index object
5678  * @param level The index level (one of @c 0 or @c 1)
5679  *
5680  * @deprecated please use "elm_index_level_go" instead.
5681  * @ingroup Index
5682  */
5683 EINA_DEPRECATED EAPI void                  elm_index_item_go(Evas_Object *obj, int level);
5684
5685 /**
5686  * Enable or disable auto hiding feature for a given index widget.
5687  *
5688  * @param obj The index object
5689  * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
5690  *
5691  * @see elm_index_active_get()
5692  *
5693  * @deprecated please use "elm_index_autohide_disabled_set" instead.
5694  * @ingroup Index
5695  */
5696 EINA_DEPRECATED EAPI void                  elm_index_active_set(Evas_Object *obj, Eina_Bool active);
5697
5698 /**
5699  * Get whether auto hiding feature is enabled or not for a given index widget.
5700  *
5701  * @param obj The index object
5702  * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
5703  *
5704  * @see elm_index_active_set() for more details
5705  *
5706  * @deprecated please use "elm_index_autohide_disabled_get" instead.
5707  * @ingroup Index
5708  */
5709 EINA_DEPRECATED EAPI Eina_Bool             elm_index_active_get(const Evas_Object *obj);
5710
5711 /**
5712  * Append a new item, on a given index widget, <b>after the item
5713  * having @p relative as data</b>.
5714  *
5715  * @param obj The index object.
5716  * @param letter Letter under which the item should be indexed
5717  * @param item The item data to set for the index's item
5718  * @param relative The index item to be the predecessor of this new one
5719  * @return A handle to the item added or @c NULL, on errors
5720  *
5721  * Despite the most common usage of the @p letter argument is for
5722  * single char strings, one could use arbitrary strings as index
5723  * entries.
5724  *
5725  * @c item will be the pointer returned back on @c "changed", @c
5726  * "delay,changed" and @c "selected" smart events.
5727  *
5728  * @note If @p relative is @c NULL this function will behave as
5729  * elm_index_item_append().
5730  *
5731  * @deprecated please use "elm_index_item_insert_after" instead.
5732  * @ingroup Index
5733  */
5734 EAPI Elm_Object_Item      *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5735
5736 /**
5737  * Prepend a new item, on a given index widget, <b>after the item
5738  * having @p relative as data</b>.
5739  *
5740  * @param obj The index object.
5741  * @param letter Letter under which the item should be indexed
5742  * @param item The item data to set for the index's item
5743  * @param relative The index item to be the successor of this new one
5744  * @return A handle to the item added or @c NULL, on errors
5745  *
5746  * Despite the most common usage of the @p letter argument is for
5747  * single char strings, one could use arbitrary strings as index
5748  * entries.
5749  *
5750  * @c item will be the pointer returned back on @c "changed", @c
5751  * "delay,changed" and @c "selected" smart events.
5752  *
5753  * @note If @p relative is @c NULL this function will behave as
5754  * elm_index_item_prepend().
5755  *
5756  * @deprecated please use "elm_index_item_insert_before" instead.
5757  * @ingroup Index
5758  */
5759 EAPI Elm_Object_Item      *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
5760
5761 /**
5762  * Set the transparency state of a window.
5763  *
5764  * Use elm_win_alpha_set() instead.
5765  *
5766  * @param obj The window object
5767  * @param transparent If true, the window is transparent
5768  *
5769  * @see elm_win_alpha_set()
5770  * @deprecated Please use elm_win_alpha_set()
5771  */
5772 EINA_DEPRECATED EAPI void                  elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
5773
5774 /**
5775  * Get the transparency state of a window.
5776  *
5777  * @param obj The window object
5778  * @return If true, the window is transparent
5779  *
5780  * @see elm_win_transparent_set()
5781  * @deprecated Please use elm_win_alpha_get()
5782  */
5783 EINA_DEPRECATED EAPI Eina_Bool             elm_win_transparent_get(const Evas_Object *obj);
5784
5785 /**
5786  * Set the theme for all elementary using applications on the current display
5787  *
5788  * @param theme The name of the theme to use. Format same as the ELM_THEME
5789  * environment variable.
5790  * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
5791  */
5792 EINA_DEPRECATED EAPI void             elm_theme_all_set(const char *theme);
5793
5794 /**
5795  * Returns the Evas_Object that represents the content area.
5796  *
5797  * @param obj The conformant object.
5798  * @return The content area of the widget.
5799  *
5800  * @ingroup Conformant
5801  */
5802 EINA_DEPRECATED EAPI Evas_Object                 *elm_conformant_content_area_get(const Evas_Object *obj);
5803
5804 /**
5805  * Set if the object is (up/down) resizable.
5806  *
5807  * @param obj The image object
5808  * @param scale_up A bool to set if the object is resizable up. Default is
5809  * @c EINA_TRUE.
5810  * @param scale_down A bool to set if the object is resizable down. Default
5811  * is @c EINA_TRUE.
5812  *
5813  * This function limits the image resize ability. If @p scale_up is set to
5814  * @c EINA_FALSE, the object can't have its height or width resized to a value
5815  * higher than the original image size. Same is valid for @p scale_down.
5816  *
5817  * @see elm_image_scale_get()
5818  * @deprecated Please use elm_image_resizable_set()
5819  *
5820  * @ingroup Image
5821  */
5822 EINA_DEPRECATED EAPI void             elm_image_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5823
5824 /**
5825  * Get if the object is (up/down) resizable.
5826  *
5827  * @param obj The image object
5828  * @param scale_up A bool to set if the object is resizable up
5829  * @param scale_down A bool to set if the object is resizable down
5830  *
5831  * @see elm_image_scale_set()
5832  * @deprecated Please use elm_image_resizable_get()
5833  *
5834  * @ingroup Image
5835  */
5836 EINA_DEPRECATED EAPI void             elm_image_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5837
5838 /**
5839  * Set if the object is (up/down) resizable.
5840  *
5841  * @param obj The icon object
5842  * @param scale_up A bool to set if the object is resizable up. Default is
5843  * @c EINA_TRUE.
5844  * @param scale_down A bool to set if the object is resizable down. Default
5845  * is @c EINA_TRUE.
5846  *
5847  * This function limits the icon object resize ability. If @p scale_up is set to
5848  * @c EINA_FALSE, the object can't have its height or width resized to a value
5849  * higher than the original icon size. Same is valid for @p scale_down.
5850  *
5851  * @see elm_icon_scale_get()
5852  * @deprecated Please use elm_icon_resizable_set()
5853  *
5854  * @ingroup Icon
5855  */
5856 EINA_DEPRECATED EAPI void                  elm_icon_scale_set(Evas_Object *obj, Eina_Bool scale_up, Eina_Bool scale_down);
5857
5858 /**
5859  * Get if the object is (up/down) resizable.
5860  *
5861  * @param obj The icon object
5862  * @param scale_up A bool to set if the object is resizable up
5863  * @param scale_down A bool to set if the object is resizable down
5864  *
5865  * @see elm_icon_scale_set()
5866  * @deprecated Please use elm_icon_resizable_get()
5867  *
5868  * @ingroup Icon
5869  */
5870 EINA_DEPRECATED EAPI void                  elm_icon_scale_get(const Evas_Object *obj, Eina_Bool *scale_up, Eina_Bool *scale_down);
5871
5872 /**
5873  * Enable or disable preloading of the icon
5874  *
5875  * @param obj The icon object
5876  * @param disable If EINA_TRUE, preloading will be disabled
5877  * @deprecated Use elm_icon_preload_disabled_set() instead
5878  * @ingroup Icon
5879  */
5880 EINA_DEPRECATED EAPI void                  elm_icon_preload_set(Evas_Object *obj, Eina_Bool disable);
5881
5882 /**
5883  * Returns the last selected item, for a given index widget.
5884  *
5885  * @param obj The index object.
5886  * @return The last item @b selected on @p obj (or @c NULL, on errors).
5887  * @deprecated Please use elm_index_selected_item_get() instead.
5888  *
5889  *
5890  * @ingroup Index
5891  */
5892 EINA_DEPRECATED EAPI Elm_Object_Item      *elm_index_item_selected_get(const Evas_Object *obj, int level);
5893
5894 /**
5895  * Get the value of shrink_mode state.
5896  *
5897  * @deprecated elm_multibuttonentry_expanded_get()
5898  */
5899 EINA_DEPRECATED EAPI int                        elm_multibuttonentry_shrink_mode_get(const Evas_Object *obj);
5900
5901 /**
5902  * Set/Unset the multibuttonentry to shrink mode state of single line
5903  *
5904  * @deprecated elm_multibuttonentry_expanded_set()
5905  */
5906 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_shrink_mode_set(Evas_Object *obj, int shrink_mode);
5907
5908 /**
5909  * Get the guide text
5910  *
5911  * @param obj The multibuttonentry object
5912  * @return The guide text, or NULL if none
5913  *
5914  * @ingroup Multibuttonentry
5915  * @deprecated Please use elm_object_part_text_get(obj, "guide");
5916  */
5917 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_guide_text_get(const Evas_Object *obj);
5918
5919 /**
5920  * Set the guide text
5921  *
5922  * @param obj The multibuttonentry object
5923  * @param guidetext The guide text string
5924  *
5925  * @ingroup Multibuttonentry
5926  * @deprecated Please use elm_object_part_text_set(obj, "guide", guidetext);
5927  */
5928 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_guide_text_set(Evas_Object *obj, const char *guidetext);
5929
5930 /**
5931  * Make the elementary object and its children to be unfocusable
5932  * (or focusable).
5933  *
5934  * @param obj The Elementary object to operate on
5935  * @param tree_unfocusable @c EINA_TRUE for unfocusable,
5936  *        @c EINA_FALSE for focusable.
5937  *
5938  * This sets whether the object @p obj and its children objects
5939  * are able to take focus or not. If the tree is set as unfocusable,
5940  * newest focused object which is not in this tree will get focus.
5941  * This API can be helpful for an object to be deleted.
5942  * When an object will be deleted soon, it and its children may not
5943  * want to get focus (by focus reverting or by other focus controls).
5944  * Then, just use this API before deleting.
5945  *
5946  * @see elm_object_tree_unfocusable_get()
5947  *
5948  * @ingroup Focus
5949  * @deprecated Please use elm_object_tree_unfocusable_set()
5950  */
5951 EINA_DEPRECATED EAPI void                 elm_object_tree_unfocusable_set(Evas_Object *obj, Eina_Bool tree_unfocusable);
5952
5953 /**
5954  * Get whether an Elementary object and its children are unfocusable or not.
5955  *
5956  * @param obj The Elementary object to get the information from
5957  * @return @c EINA_TRUE, if the tree is unfocussable,
5958  *         @c EINA_FALSE if not (and on errors).
5959  *
5960  * @see elm_object_tree_unfocusable_set()
5961  *
5962  * @deprecated Please use elm_object_tree_unfocusable_get()
5963  */
5964 EINA_DEPRECATED EAPI Eina_Bool            elm_object_tree_unfocusable_get(const Evas_Object *obj);
5965
5966 /**
5967  * Animatedly bring in, to the visible are of a genlist, a given
5968  * item on it.
5969  *
5970  * @deprecated elm_genlist_item_bring_in()
5971  */
5972 EINA_DEPRECATED EAPI void elm_genlist_item_top_bring_in(Elm_Object_Item *it);
5973
5974 /**
5975  * Animatedly bring in, to the visible are of a genlist, a given
5976  * item on it.
5977  *
5978  * @deprecated elm_genlist_item_bring_in()
5979  */
5980 EINA_DEPRECATED EAPI void elm_genlist_item_middle_bring_in(Elm_Object_Item *it);
5981
5982 /**
5983  * Show the portion of a genlist's internal list containing a given
5984  * item, immediately.
5985  *
5986  * @param it The item to display
5987  *
5988  * @deprecated elm_genlist_item_show()
5989  *
5990  */
5991 EINA_DEPRECATED EAPI void                          elm_genlist_item_top_show(Elm_Object_Item *it);
5992
5993 /**
5994  * Show the portion of a genlist's internal list containing a given
5995  * item, immediately.
5996  *
5997  * @param it The item to display
5998  *
5999  * @deprecated elm_genlist_item_show()
6000  *
6001  */
6002 EINA_DEPRECATED EAPI void                          elm_genlist_item_middle_show(Elm_Object_Item *it);
6003
6004 /**
6005  * Enable or disable round mode.
6006  *
6007  * @param obj The diskselector object.
6008  * @param round @c EINA_TRUE to enable round mode or @c EINA_FALSE to
6009  * disable it.
6010  *
6011  * Disabled by default. If round mode is enabled the items list will
6012  * work like a circle list, so when the user reaches the last item,
6013  * the first one will popup.
6014  *
6015  * @see elm_diskselector_round_enabled_get()
6016  *
6017  * @deprecated elm_diskselector_round_enabled_set()
6018  */
6019 EINA_DEPRECATED EAPI void                   elm_diskselector_round_set(Evas_Object *obj, Eina_Bool round);
6020
6021 /**
6022  * Get a value whether round mode is enabled or not.
6023  *
6024  * @see elm_diskselector_round_enabled_set() for details.
6025  *
6026  * @param obj The diskselector object.
6027  * @return @c EINA_TRUE means round mode is enabled. @c EINA_FALSE indicates
6028  * it's disabled. If @p obj is @c NULL, @c EINA_FALSE is returned.
6029  *
6030  * @deprecated elm_diskselector_round_enabled_get()
6031  */
6032 EINA_DEPRECATED EAPI Eina_Bool              elm_diskselector_round_get(const Evas_Object *obj);
6033
6034 /**
6035  * Get the side labels max length.
6036  *
6037  * @see elm_diskselector_side_text_max_length_set() for details.
6038  *
6039  * @param obj The diskselector object.
6040  * @return The max length defined for side labels, or 0 if not a valid
6041  * diskselector.
6042  *
6043  * @deprecated elm_diskselector_side_text_max_length_get()
6044  */
6045 EINA_DEPRECATED EAPI int                    elm_diskselector_side_label_length_get(const Evas_Object *obj);
6046
6047 /**
6048  * Set the side labels max length.
6049  *
6050  * @param obj The diskselector object.
6051  * @param len The max length defined for side labels.
6052  *
6053  * Length is the number of characters of items' label that will be
6054  * visible when it's set on side positions. It will just crop
6055  * the string after defined size. E.g.:
6056  *
6057  * An item with label "January" would be displayed on side position as
6058  * "Jan" if max length is set to 3, or "Janu", if this property
6059  * is set to 4.
6060  *
6061  * When it's selected, the entire label will be displayed, except for
6062  * width restrictions. In this case label will be cropped and "..."
6063  * will be concatenated.
6064  *
6065  * Default side label max length is 3.
6066  *
6067  * This property will be applied over all items, included before or
6068  * later this function call.
6069  *
6070  * @deprecated elm_diskselector_side_text_max_length_set()
6071  */
6072 EINA_DEPRECATED EAPI void                   elm_diskselector_side_label_length_set(Evas_Object *obj, int len);
6073
6074 /**
6075  * @}
6076  */