src/lib/elm_deprecated.h

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