src/lib/elm_deprecated.h

   1 /**
   2  * @defgroup Toggle Toggle
   3  *
   4  * @image html img/widget/toggle/preview-00.png
   5  * @image latex img/widget/toggle/preview-00.eps
   6  *
   7  * @brief A toggle is a slider which can be used to toggle between
   8  * two values.  It has two states: on and off.
   9  *
  10  * This widget is deprecated. Please use elm_check_add() instead using the
  11  * toggle style like:
  12  *
  13  * @code
  14  * obj = elm_check_add(parent);
  15  * elm_object_style_set(obj, "toggle");
  16  * elm_object_part_text_set(obj, "on", "ON");
  17  * elm_object_part_text_set(obj, "off", "OFF");
  18  * @endcode
  19  *
  20  * Signals that you can add callbacks for are:
  21  * @li "changed" - Whenever the toggle value has been changed.  Is not called
  22  *                 until the toggle is released by the cursor (assuming it
  23  *                 has been triggered by the cursor in the first place).
  24  *
  25  * Default content parts of the toggle widget that you can use for are:
  26  * @li "icon" - An icon of the toggle
  27  *
  28  * Default text parts of the toggle widget that you can use for are:
  29  * @li "elm.text" - Label of the toggle
  30  *
  31  * @ref tutorial_toggle show how to use a toggle.
  32  * @{
  33  */
  34
  35 /**
  36  * @brief Add a toggle to @p parent.
  37  *
  38  * @param parent The parent object
  39  *
  40  * @return The toggle object
  41  */
  42 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_add(Evas_Object *parent);
  43
  44 /**
  45  * @brief Sets the label to be displayed with the toggle.
  46  *
  47  * @param obj The toggle object
  48  * @param label The label to be displayed
  49  *
  50  * @deprecated use elm_object_text_set() instead.
  51  */
  52 EINA_DEPRECATED EAPI void         elm_toggle_label_set(Evas_Object *obj, const char *label);
  53
  54 /**
  55  * @brief Gets the label of the toggle
  56  *
  57  * @param obj  toggle object
  58  * @return The label of the toggle
  59  *
  60  * @deprecated use elm_object_text_get() instead.
  61  */
  62 EINA_DEPRECATED EAPI const char  *elm_toggle_label_get(const Evas_Object *obj);
  63
  64 /**
  65  * @brief Set the icon used for the toggle
  66  *
  67  * @param obj The toggle object
  68  * @param icon The icon object for the button
  69  *
  70  * Once the icon object is set, a previously set one will be deleted
  71  * If you want to keep that old content object, use the
  72  * elm_toggle_icon_unset() function.
  73  *
  74  * @deprecated use elm_object_part_content_set() instead.
  75  */
  76 EINA_DEPRECATED EAPI void         elm_toggle_icon_set(Evas_Object *obj, Evas_Object *icon);
  77
  78 /**
  79  * @brief Get the icon used for the toggle
  80  *
  81  * @param obj The toggle object
  82  * @return The icon object that is being used
  83  *
  84  * Return the icon object which is set for this widget.
  85  *
  86  * @see elm_toggle_icon_set()
  87  *
  88  * @deprecated use elm_object_part_content_get() instead.
  89  */
  90 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_get(const Evas_Object *obj);
  91
  92 /**
  93  * @brief Unset the icon used for the toggle
  94  *
  95  * @param obj The toggle object
  96  * @return The icon object that was being used
  97  *
  98  * Unparent and return the icon object which was set for this widget.
  99  *
 100  * @see elm_toggle_icon_set()
 101  *
 102  * @deprecated use elm_object_part_content_unset() instead.
 103  */
 104 EINA_DEPRECATED EAPI Evas_Object *elm_toggle_icon_unset(Evas_Object *obj);
 105
 106 /**
 107  * @brief Sets the labels to be associated with the on and off states of the toggle.
 108  *
 109  * @param obj The toggle object
 110  * @param onlabel The label displayed when the toggle is in the "on" state
 111  * @param offlabel The label displayed when the toggle is in the "off" state
 112  *
 113  * @deprecated use elm_object_part_text_set() for "on" and "off" parts
 114  * instead.
 115  */
 116 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_set(Evas_Object *obj, const char *onlabel, const char *offlabel);
 117
 118 /**
 119  * @brief Gets the labels associated with the on and off states of the
 120  * toggle.
 121  *
 122  * @param obj The toggle object
 123  * @param onlabel A char** to place the onlabel of @p obj into
 124  * @param offlabel A char** to place the offlabel of @p obj into
 125  *
 126  * @deprecated use elm_object_part_text_get() for "on" and "off" parts
 127  * instead.
 128  */
 129 EINA_DEPRECATED EAPI void         elm_toggle_states_labels_get(const Evas_Object *obj, const char **onlabel, const char **offlabel);
 130
 131 /**
 132  * @brief Sets the state of the toggle to @p state.
 133  *
 134  * @param obj The toggle object
 135  * @param state The state of @p obj
 136  *
 137  * @deprecated use elm_check_state_set() instead.
 138  */
 139 EINA_DEPRECATED EAPI void         elm_toggle_state_set(Evas_Object *obj, Eina_Bool state);
 140
 141 /**
 142  * @brief Gets the state of the toggle to @p state.
 143  *
 144  * @param obj The toggle object
 145  * @return The state of @p obj
 146  *
 147  * @deprecated use elm_check_state_get() instead.
 148  */
 149 EINA_DEPRECATED EAPI Eina_Bool    elm_toggle_state_get(const Evas_Object *obj);
 150
 151 /**
 152  * @brief Sets the state pointer of the toggle to @p statep.
 153  *
 154  * @param obj The toggle object
 155  * @param statep The state pointer of @p obj
 156  *
 157  * @deprecated use elm_check_state_pointer_set() instead.
 158  */
 159 EINA_DEPRECATED EAPI void         elm_toggle_state_pointer_set(Evas_Object *obj, Eina_Bool *statep);
 160
 161 /**
 162  * @}
 163  */
 164
 165 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_add(Evas_Object *parent);
 166 EINA_DEPRECATED EAPI void         elm_scrolled_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
 167 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_single_line_get(const Evas_Object *obj);
 168 EINA_DEPRECATED EAPI void         elm_scrolled_entry_password_set(Evas_Object *obj, Eina_Bool password);
 169 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_password_get(const Evas_Object *obj);
 170 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_set(Evas_Object *obj, const char *entry);
 171 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_entry_get(const Evas_Object *obj);
 172 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_append(Evas_Object *obj, const char *entry);
 173 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_is_empty(const Evas_Object *obj);
 174 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_selection_get(const Evas_Object *obj);
 175 EINA_DEPRECATED EAPI void         elm_scrolled_entry_entry_insert(Evas_Object *obj, const char *entry);
 176 EINA_DEPRECATED EAPI void         elm_scrolled_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type wrap);
 177 EINA_DEPRECATED EAPI void         elm_scrolled_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
 178 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_editable_get(const Evas_Object *obj);
 179 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_none(Evas_Object *obj);
 180 EINA_DEPRECATED EAPI void         elm_scrolled_entry_select_all(Evas_Object *obj);
 181 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_next(Evas_Object *obj);
 182 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_prev(Evas_Object *obj);
 183 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_up(Evas_Object *obj);
 184 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_down(Evas_Object *obj);
 185 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_begin_set(Evas_Object *obj);
 186 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_end_set(Evas_Object *obj);
 187 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_begin_set(Evas_Object *obj);
 188 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_line_end_set(Evas_Object *obj);
 189 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_begin(Evas_Object *obj);
 190 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_selection_end(Evas_Object *obj);
 191 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_format_get(const Evas_Object *obj);
 192 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cursor_is_visible_format_get(const Evas_Object *obj);
 193 EINA_DEPRECATED EAPI const char  *elm_scrolled_entry_cursor_content_get(const Evas_Object *obj);
 194 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cursor_pos_set(Evas_Object *obj, int pos);
 195 EINA_DEPRECATED EAPI int          elm_scrolled_entry_cursor_pos_get(const Evas_Object *obj);
 196 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_cut(Evas_Object *obj);
 197 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_copy(Evas_Object *obj);
 198 EINA_DEPRECATED EAPI void         elm_scrolled_entry_selection_paste(Evas_Object *obj);
 199 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_clear(Evas_Object *obj);
 200 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data);
 201 EINA_DEPRECATED EAPI void         elm_scrolled_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
 202 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_context_menu_disabled_get(const Evas_Object *obj);
 203 EINA_DEPRECATED EAPI void         elm_scrolled_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
 204 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
 205 EINA_DEPRECATED EAPI void         elm_scrolled_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
 206 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
 207 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_get(const Evas_Object *obj);
 208 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_icon_unset(Evas_Object *obj);
 209 EINA_DEPRECATED EAPI void         elm_scrolled_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
 210 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_set(Evas_Object *obj, Evas_Object *end);
 211 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_get(const Evas_Object *obj);
 212 EINA_DEPRECATED EAPI Evas_Object *elm_scrolled_entry_end_unset(Evas_Object *obj);
 213 EINA_DEPRECATED EAPI void         elm_scrolled_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
 214 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_append(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
 215 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_prepend(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
 216 EINA_DEPRECATED EAPI void         elm_scrolled_entry_item_provider_remove(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
 217 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_append(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 218 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_prepend(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 219 EINA_DEPRECATED EAPI void         elm_scrolled_entry_text_filter_remove(Evas_Object *obj, void (*func)(void *data, Evas_Object *entry, char **text), void *data);
 220 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
 221 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
 222 EINA_DEPRECATED EAPI void         elm_scrolled_entry_file_save(Evas_Object *obj);
 223 EINA_DEPRECATED EAPI void         elm_scrolled_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
 224 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_autosave_get(const Evas_Object *obj);
 225 EINA_DEPRECATED EAPI void         elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
 226 EINA_DEPRECATED EAPI Eina_Bool    elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj);
 227
 228 /**
 229  * @brief Sets the content of the hover object and the direction in which it
 230  * will pop out.
 231  *
 232  * @param obj The hover object
 233  * @param swallow The direction that the object will be displayed
 234  * at. Accepted values are "left", "top-left", "top", "top-right",
 235  * "right", "bottom-right", "bottom", "bottom-left", "middle" and
 236  * "smart".
 237  * @param content The content to place at @p swallow
 238  *
 239  * Once the content object is set for a given direction, a previously
 240  * set one (on the same direction) will be deleted. If you want to
 241  * keep that old content object, use the elm_object_part_content_unset()
 242  * function.
 243  *
 244  * All directions may have contents at the same time, except for
 245  * "smart". This is a special placement hint and its use case
 246  * depends of the calculations coming from
 247  * elm_hover_best_content_location_get(). Its use is for cases when
 248  * one desires only one hover content, but with a dynamic special
 249  * placement within the hover area. The content's geometry, whenever
 250  * it changes, will be used to decide on a best location, not
 251  * extrapolating the hover's parent object view to show it in (still
 252  * being the hover's target determinant of its medium part -- move and
 253  * resize it to simulate finger sizes, for example). If one of the
 254  * directions other than "smart" are used, a previously content set
 255  * using it will be deleted, and vice-versa.
 256  *
 257  * @deprecated Use elm_object_part_content_set() instead
 258  */
 259 EINA_DEPRECATED EAPI void         elm_hover_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
 260
 261 /**
 262  * @brief Get the content of the hover object, in a given direction.
 263  *
 264  * Return the content object which was set for this widget in the
 265  * @p swallow direction.
 266  *
 267  * @param obj The hover object
 268  * @param swallow The direction that the object was display at.
 269  * @return The content that was being used
 270  *
 271  * @deprecated Use elm_object_part_content_get() instead
 272  * @see elm_object_part_content_set()
 273  */
 274 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_get(const Evas_Object *obj, const char *swallow);
 275
 276 /**
 277  * @brief Unset the content of the hover object, in a given direction.
 278  *
 279  * Unparent and return the content object set at @p swallow direction.
 280  *
 281  * @param obj The hover object
 282  * @param swallow The direction that the object was display at.
 283  * @return The content that was being used.
 284  *
 285  * @deprecated Use elm_object_part_content_unset() instead
 286  * @see elm_object_part_content_set()
 287  */
 288 EINA_DEPRECATED EAPI Evas_Object *elm_hover_content_unset(Evas_Object *obj, const char *swallow);
 289
 290 /**
 291  * @brief Set the hoversel button label
 292  *
 293  * @param obj The hoversel object
 294  * @param label The label text.
 295  *
 296  * This sets the label of the button that is always visible (before it is
 297  * clicked and expanded).
 298  *
 299  * @deprecated elm_object_text_set()
 300  */
 301 EINA_DEPRECATED EAPI void         elm_hoversel_label_set(Evas_Object *obj, const char *label);
 302
 303 /**
 304  * @brief Get the hoversel button label
 305  *
 306  * @param obj The hoversel object
 307  * @return The label text.
 308  *
 309  * @deprecated elm_object_text_get()
 310  */
 311 EINA_DEPRECATED EAPI const char  *elm_hoversel_label_get(const Evas_Object *obj);
 312
 313 /**
 314  * @brief Set the icon of the hoversel button
 315  *
 316  * @param obj The hoversel object
 317  * @param icon The icon object
 318  *
 319  * Sets the icon of the button that is always visible (before it is clicked
 320  * and expanded).  Once the icon object is set, a previously set one will be
 321  * deleted, if you want to keep that old content object, use the
 322  * elm_hoversel_icon_unset() function.
 323  *
 324  * @see elm_object_content_set() for the button widget
 325  * @deprecated Use elm_object_item_part_content_set() instead
 326  */
 327 EINA_DEPRECATED EAPI void         elm_hoversel_icon_set(Evas_Object *obj, Evas_Object *icon);
 328
 329 /**
 330  * @brief Get the icon of the hoversel button
 331  *
 332  * @param obj The hoversel object
 333  * @return The icon object
 334  *
 335  * Get the icon of the button that is always visible (before it is clicked
 336  * and expanded). Also see elm_object_content_get() for the button widget.
 337  *
 338  * @see elm_hoversel_icon_set()
 339  * @deprecated Use elm_object_item_part_content_get() instead
 340  */
 341 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_get(const Evas_Object *obj);
 342
 343 /**
 344  * @brief Get and unparent the icon of the hoversel button
 345  *
 346  * @param obj The hoversel object
 347  * @return The icon object that was being used
 348  *
 349  * Unparent and return the icon of the button that is always visible
 350  * (before it is clicked and expanded).
 351  *
 352  * @see elm_hoversel_icon_set()
 353  * @see elm_object_content_unset() for the button widget
 354  * @deprecated Use elm_object_item_part_content_unset() instead
 355  */
 356 EINA_DEPRECATED EAPI Evas_Object *elm_hoversel_icon_unset(Evas_Object *obj);
 357
 358 /**
 359  * @brief This returns the data pointer supplied with elm_hoversel_item_add()
 360  * that will be passed to associated function callbacks.
 361  *
 362  * @param it The item to get the data from
 363  * @return The data pointer set with elm_hoversel_item_add()
 364  *
 365  * @see elm_hoversel_item_add()
 366  * @deprecated Use elm_object_item_data_get() instead
 367  */
 368 EINA_DEPRECATED EAPI void        *elm_hoversel_item_data_get(const Elm_Object_Item *it);
 369
 370 /**
 371  * @brief This returns the label text of the given hoversel item.
 372  *
 373  * @param it The item to get the label
 374  * @return The label text of the hoversel item
 375  *
 376  * @see elm_hoversel_item_add()
 377  * @deprecated Use elm_object_item_text_get() instead
 378  */
 379 EINA_DEPRECATED EAPI const char  *elm_hoversel_item_label_get(const Elm_Object_Item *it);
 380
 381 /**
 382  * @brief Set the function to be called when an item from the hoversel is
 383  * freed.
 384  *
 385  * @param it The item to set the callback on
 386  * @param func The function called
 387  *
 388  * That function will receive these parameters:
 389  * @li void * item data
 390  * @li Evas_Object * hoversel object
 391  * @li Elm_Object_Item * hoversel item
 392  *
 393  * @see elm_hoversel_item_add()
 394  * @deprecated Use elm_object_item_del_cb_set() instead
 395  */
 396 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
 397
 398 /**
 399  * @brief Delete an item from the hoversel
 400  *
 401  * @param it The item to delete
 402  *
 403  * This deletes the item from the hoversel (should not be called while the
 404  * hoversel is active; use elm_hoversel_expanded_get() to check first).
 405  *
 406  * @deprecated Use elm_object_item_del() instead
 407  * @see elm_hoversel_item_add()
 408  */
 409 EINA_DEPRECATED EAPI void                         elm_hoversel_item_del(Elm_Object_Item *it);
 410
 411 /**
 412  * Set actionslider labels.
 413  *
 414  * @param obj The actionslider object
 415  * @param left_label The label to be set on the left.
 416  * @param center_label The label to be set on the center.
 417  * @param right_label The label to be set on the right.
 418  * @deprecated use elm_object_text_set() instead.
 419  */
 420 EINA_DEPRECATED EAPI void        elm_actionslider_labels_set(Evas_Object *obj, const char *left_label, const char *center_label, const char *right_label);
 421
 422 /**
 423  * Get actionslider labels.
 424  *
 425  * @param obj The actionslider object
 426  * @param left_label A char** to place the left_label of @p obj into.
 427  * @param center_label A char** to place the center_label of @p obj into.
 428  * @param right_label A char** to place the right_label of @p obj into.
 429  * @deprecated use elm_object_text_set() instead.
 430  */
 431 EINA_DEPRECATED EAPI void        elm_actionslider_labels_get(const Evas_Object *obj, const char **left_label, const char **center_label, const char **right_label);
 432
 433 /**
 434  * Set the label used on the indicator.
 435  *
 436  * @param obj The actionslider object
 437  * @param label The label to be set on the indicator.
 438  * @deprecated use elm_object_text_set() instead.
 439  */
 440 EINA_DEPRECATED EAPI void        elm_actionslider_indicator_label_set(Evas_Object *obj, const char *label);
 441
 442 /**
 443  * Get the label used on the indicator object.
 444  *
 445  * @param obj The actionslider object
 446  * @return The indicator label
 447  * @deprecated use elm_object_text_get() instead.
 448  */
 449 EINA_DEPRECATED EAPI const char *elm_actionslider_indicator_label_get(Evas_Object *obj);
 450
 451 /**
 452  * Set the overlay object used for the background object.
 453  *
 454  * @param obj The bg object
 455  * @param overlay The overlay object
 456  *
 457  * This provides a way for elm_bg to have an 'overlay' that will be on top
 458  * of the bg. Once the over object is set, a previously set one will be
 459  * deleted, even if you set the new one to NULL. If you want to keep that
 460  * old content object, use the elm_bg_overlay_unset() function.
 461  *
 462  * @deprecated use elm_object_part_content_set() instead
 463  *
 464  * @ingroup Bg
 465  */
 466
 467 EINA_DEPRECATED EAPI void         elm_bg_overlay_set(Evas_Object *obj, Evas_Object *overlay);
 468
 469 /**
 470  * Get the overlay object used for the background object.
 471  *
 472  * @param obj The bg object
 473  * @return The content that is being used
 474  *
 475  * Return the content object which is set for this widget
 476  *
 477  * @deprecated use elm_object_part_content_get() instead
 478  *
 479  * @ingroup Bg
 480  */
 481 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_get(const Evas_Object *obj);
 482
 483 /**
 484  * Get the overlay object used for the background object.
 485  *
 486  * @param obj The bg object
 487  * @return The content that was being used
 488  *
 489  * Unparent and return the overlay object which was set for this widget
 490  *
 491  * @deprecated use elm_object_part_content_unset() instead
 492  *
 493  * @ingroup Bg
 494  */
 495 EINA_DEPRECATED EAPI Evas_Object *elm_bg_overlay_unset(Evas_Object *obj);
 496
 497
 498 /**
 499  * Set the label of the bubble
 500  *
 501  * @param obj The bubble object
 502  * @param label The string to set in the label
 503  *
 504  * This function sets the title of the bubble. Where this appears depends on
 505  * the selected corner.
 506  * @deprecated use elm_object_text_set() instead.
 507  */
 508 EINA_DEPRECATED EAPI void         elm_bubble_label_set(Evas_Object *obj, const char *label);
 509
 510 /**
 511  * Get the label of the bubble
 512  *
 513  * @param obj The bubble object
 514  * @return The string of set in the label
 515  *
 516  * This function gets the title of the bubble.
 517  * @deprecated use elm_object_text_get() instead.
 518  */
 519 EINA_DEPRECATED EAPI const char  *elm_bubble_label_get(const Evas_Object *obj);
 520
 521 /**
 522  * Set the info of the bubble
 523  *
 524  * @param obj The bubble object
 525  * @param info The given info about the bubble
 526  *
 527  * This function sets the info of the bubble. Where this appears depends on
 528  * the selected corner.
 529  * @deprecated use elm_object_part_text_set() instead. (with "info" as the parameter).
 530  */
 531 EINA_DEPRECATED EAPI void         elm_bubble_info_set(Evas_Object *obj, const char *info);
 532
 533 /**
 534  * Get the info of the bubble
 535  *
 536  * @param obj The bubble object
 537  *
 538  * @return The "info" string of the bubble
 539  *
 540  * This function gets the info text.
 541  * @deprecated use elm_object_part_text_get() instead. (with "info" as the parameter).
 542  */
 543 EINA_DEPRECATED EAPI const char  *elm_bubble_info_get(const Evas_Object *obj);
 544
 545 /**
 546  * Set the content to be shown in the bubble
 547  *
 548  * Once the content object is set, a previously set one will be deleted.
 549  * If you want to keep the old content object, use the
 550  * elm_bubble_content_unset() function.
 551  *
 552  * @param obj The bubble object
 553  * @param content The given content of the bubble
 554  *
 555  * This function sets the content shown on the middle of the bubble.
 556  *
 557  * @deprecated use elm_object_content_set() instead
 558  *
 559  */
 560 EINA_DEPRECATED EAPI void         elm_bubble_content_set(Evas_Object *obj, Evas_Object *content);
 561
 562 /**
 563  * Get the content shown in the bubble
 564  *
 565  * Return the content object which is set for this widget.
 566  *
 567  * @param obj The bubble object
 568  * @return The content that is being used
 569  *
 570  * @deprecated use elm_object_content_get() instead
 571  *
 572  */
 573 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_get(const Evas_Object *obj);
 574
 575 /**
 576  * Unset the content shown in the bubble
 577  *
 578  * Unparent and return the content object which was set for this widget.
 579  *
 580  * @param obj The bubble object
 581  * @return The content that was being used
 582  *
 583  * @deprecated use elm_object_content_unset() instead
 584  *
 585  */
 586 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_content_unset(Evas_Object *obj);
 587
 588 /**
 589  * Set the icon of the bubble
 590  *
 591  * Once the icon object is set, a previously set one will be deleted.
 592  * If you want to keep the old content object, use the
 593  * elm_icon_content_unset() function.
 594  *
 595  * @param obj The bubble object
 596  * @param icon The given icon for the bubble
 597  *
 598  * @deprecated use elm_object_part_content_set() instead
 599  *
 600  */
 601 EINA_DEPRECATED EAPI void         elm_bubble_icon_set(Evas_Object *obj, Evas_Object *icon);
 602
 603 /**
 604  * Get the icon of the bubble
 605  *
 606  * @param obj The bubble object
 607  * @return The icon for the bubble
 608  *
 609  * This function gets the icon shown on the top left of bubble.
 610  *
 611  * @deprecated use elm_object_part_content_get() instead
 612  *
 613  */
 614 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_get(const Evas_Object *obj);
 615
 616 /**
 617  * Unset the icon of the bubble
 618  *
 619  * Unparent and return the icon object which was set for this widget.
 620  *
 621  * @param obj The bubble object
 622  * @return The icon that was being used
 623  *
 624  * @deprecated use elm_object_part_content_unset() instead
 625  *
 626  */
 627 EINA_DEPRECATED EAPI Evas_Object *elm_bubble_icon_unset(Evas_Object *obj);
 628
 629
 630 /**
 631  * Set the label used in the button
 632  *
 633  * The passed @p label can be NULL to clean any existing text in it and
 634  * leave the button as an icon only object.
 635  *
 636  * @param obj The button object
 637  * @param label The text will be written on the button
 638  * @deprecated use elm_object_text_set() instead.
 639  */
 640 EINA_DEPRECATED EAPI void         elm_button_label_set(Evas_Object *obj, const char *label);
 641
 642 /**
 643  * Get the label set for the button
 644  *
 645  * The string returned is an internal pointer and should not be freed or
 646  * altered. It will also become invalid when the button is destroyed.
 647  * The string returned, if not NULL, is a stringshare, so if you need to
 648  * keep it around even after the button is destroyed, you can use
 649  * eina_stringshare_ref().
 650  *
 651  * @param obj The button object
 652  * @return The text set to the label, or NULL if nothing is set
 653  * @deprecated use elm_object_text_set() instead.
 654  */
 655 EINA_DEPRECATED EAPI const char  *elm_button_label_get(const Evas_Object *obj);
 656
 657 /**
 658  * Set the icon used for the button
 659  *
 660  * Setting a new icon will delete any other that was previously set, making
 661  * any reference to them invalid. If you need to maintain the previous
 662  * object alive, unset it first with elm_button_icon_unset().
 663  *
 664  * @param obj The button object
 665  * @param icon The icon object for the button
 666  * @deprecated use elm_object_part_content_set() instead.
 667  */
 668 EINA_DEPRECATED EAPI void         elm_button_icon_set(Evas_Object *obj, Evas_Object *icon);
 669
 670 /**
 671  * Get the icon used for the button
 672  *
 673  * Return the icon object which is set for this widget. If the button is
 674  * destroyed or another icon is set, the returned object will be deleted
 675  * and any reference to it will be invalid.
 676  *
 677  * @param obj The button object
 678  * @return The icon object that is being used
 679  *
 680  * @deprecated use elm_object_part_content_get() instead
 681  */
 682 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_get(const Evas_Object *obj);
 683
 684 /**
 685  * Remove the icon set without deleting it and return the object
 686  *
 687  * This function drops the reference the button holds of the icon object
 688  * and returns this last object. It is used in case you want to remove any
 689  * icon, or set another one, without deleting the actual object. The button
 690  * will be left without an icon set.
 691  *
 692  * @param obj The button object
 693  * @return The icon object that was being used
 694  * @deprecated use elm_object_part_content_unset() instead.
 695  */
 696 EINA_DEPRECATED EAPI Evas_Object *elm_button_icon_unset(Evas_Object *obj);
 697
 698 /**
 699  * Set a day text color to the same that represents Saturdays.
 700  *
 701  * @param obj The calendar object.
 702  * @param pos The text position. Position is the cell counter, from left
 703  * to right, up to down. It starts on 0 and ends on 41.
 704  *
 705  * @deprecated use elm_calendar_mark_add() instead like:
 706  *
 707  * @code
 708  * struct tm t = { 0, 0, 12, 6, 0, 0, 6, 6, -1 };
 709  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
 710  * @endcode
 711  *
 712  * @see elm_calendar_mark_add()
 713  *
 714  * @ingroup Calendar
 715  */
 716 EINA_DEPRECATED EAPI void elm_calendar_text_saturday_color_set(Evas_Object *obj, int pos);
 717
 718 /**
 719  * Set a day text color to the same that represents Sundays.
 720  *
 721  * @param obj The calendar object.
 722  * @param pos The text position. Position is the cell counter, from left
 723  * to right, up to down. It starts on 0 and ends on 41.
 724
 725  * @deprecated use elm_calendar_mark_add() instead like:
 726  *
 727  * @code
 728  * struct tm t = { 0, 0, 12, 7, 0, 0, 0, 0, -1 };
 729  * elm_calendar_mark_add(obj, "sat", &t, ELM_CALENDAR_WEEKLY);
 730  * @endcode
 731  *
 732  * @see elm_calendar_mark_add()
 733  *
 734  * @ingroup Calendar
 735  */
 736 EINA_DEPRECATED EAPI void elm_calendar_text_sunday_color_set(Evas_Object *obj, int pos);
 737
 738 /**
 739  * Set a day text color to the same that represents Weekdays.
 740  *
 741  * @param obj The calendar object
 742  * @param pos The text position. Position is the cell counter, from left
 743  * to right, up to down. It starts on 0 and ends on 41.
 744  *
 745  * @deprecated use elm_calendar_mark_add() instead like:
 746  *
 747  * @code
 748  * struct tm t = { 0, 0, 12, 1, 0, 0, 0, 0, -1 };
 749  *
 750  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // monday
 751  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 752  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // tuesday
 753  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 754  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // wednesday
 755  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 756  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // thursday
 757  * t.tm_tm_mday++; t.tm_wday++; t.tm_yday++;
 758  * elm_calendar_mark_add(obj, "week", &t, ELM_CALENDAR_WEEKLY); // friday
 759  * @endcode
 760  *
 761  * @see elm_calendar_mark_add()
 762  *
 763  * @ingroup Calendar
 764  */
 765 EINA_DEPRECATED EAPI void elm_calendar_text_weekday_color_set(Evas_Object *obj, int pos);
 766
 767
 768 /**
 769  * @brief Set the text label of the check object
 770  *
 771  * @param obj The check object
 772  * @param label The text label string in UTF-8
 773  *
 774  * @deprecated use elm_object_text_set() instead.
 775  */
 776 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
 777
 778 /**
 779  * @brief Get the text label of the check object
 780  *
 781  * @param obj The check object
 782  * @return The text label string in UTF-8
 783  *
 784  * @deprecated use elm_object_text_get() instead.
 785  */
 786 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
 787
 788 /**
 789  * @brief Set the icon object of the check object
 790  *
 791  * @param obj The check object
 792  * @param icon The icon object
 793  *
 794  * Once the icon object is set, a previously set one will be deleted.
 795  * If you want to keep that old content object, use the
 796  * elm_object_content_unset() function.
 797  *
 798  * @deprecated use elm_object_part_content_set() instead.
 799  *
 800  */
 801 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
 802
 803 /**
 804  * @brief Get the icon object of the check object
 805  *
 806  * @param obj The check object
 807  * @return The icon object
 808  *
 809  * @deprecated use elm_object_part_content_get() instead.
 810  *
 811  */
 812 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
 813
 814 /**
 815  * @brief Unset the icon used for the check object
 816  *
 817  * @param obj The check object
 818  * @return The icon object that was being used
 819  *
 820  * Unparent and return the icon object which was set for this widget.
 821  *
 822  * @deprecated use elm_object_part_content_unset() instead.
 823  *
 824  */
 825 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
 826
 827 /**
 828  * @brief Set the text label of the check object
 829  *
 830  * @param obj The check object
 831  * @param label The text label string in UTF-8
 832  *
 833  * @deprecated use elm_object_text_set() instead.
 834  */
 835 EINA_DEPRECATED EAPI void         elm_check_label_set(Evas_Object *obj, const char *label);
 836
 837 /**
 838  * @brief Get the text label of the check object
 839  *
 840  * @param obj The check object
 841  * @return The text label string in UTF-8
 842  *
 843  * @deprecated use elm_object_text_get() instead.
 844  */
 845 EINA_DEPRECATED EAPI const char  *elm_check_label_get(const Evas_Object *obj);
 846
 847 /**
 848  * @brief Set the icon object of the check object
 849  *
 850  * @param obj The check object
 851  * @param icon The icon object
 852  *
 853  * Once the icon object is set, a previously set one will be deleted.
 854  * If you want to keep that old content object, use the
 855  * elm_object_content_unset() function.
 856  *
 857  * @deprecated use elm_object_part_content_set() instead.
 858  *
 859  */
 860 EINA_DEPRECATED EAPI void         elm_check_icon_set(Evas_Object *obj, Evas_Object *icon);
 861
 862 /**
 863  * @brief Get the icon object of the check object
 864  *
 865  * @param obj The check object
 866  * @return The icon object
 867  *
 868  * @deprecated use elm_object_part_content_get() instead.
 869  *
 870  */
 871 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_get(const Evas_Object *obj);
 872
 873 /**
 874  * @brief Unset the icon used for the check object
 875  *
 876  * @param obj The check object
 877  * @return The icon object that was being used
 878  *
 879  * Unparent and return the icon object which was set for this widget.
 880  *
 881  * @deprecated use elm_object_part_content_unset() instead.
 882  *
 883  */
 884 EINA_DEPRECATED EAPI Evas_Object *elm_check_icon_unset(Evas_Object *obj);
 885
 886 EINA_DEPRECATED EAPI void         elm_check_states_labels_set(Evas_Object *obj, const char *ontext, const char *offtext);
 887 EINA_DEPRECATED EAPI void         elm_check_states_labels_get(const Evas_Object *obj, const char **ontext, const char **offtext);
 888
 889
 890 /**
 891  * Set the content of the conformant widget.
 892  *
 893  * @param obj The conformant object.
 894  * @param content The content to be displayed by the conformant.
 895  *
 896  * Content will be sized and positioned considering the space required
 897  * to display a virtual keyboard. So it won't fill all the conformant
 898  * size. This way is possible to be sure that content won't resize
 899  * or be re-positioned after the keyboard is displayed.
 900  *
 901  * Once the content object is set, a previously set one will be deleted.
 902  * If you want to keep that old content object, use the
 903  * elm_object_content_unset() function.
 904  *
 905  * @see elm_object_content_unset()
 906  * @see elm_object_content_get()
 907  *
 908  * @deprecated use elm_object_content_set() instead
 909  *
 910  * @ingroup Conformant
 911  */
 912 EINA_DEPRECATED EAPI void         elm_conformant_content_set(Evas_Object *obj, Evas_Object *content);
 913
 914 /**
 915  * Get the content of the conformant widget.
 916  *
 917  * @param obj The conformant object.
 918  * @return The content that is being used.
 919  *
 920  * Return the content object which is set for this widget.
 921  * It won't be unparent from conformant. For that, use
 922  * elm_object_content_unset().
 923  *
 924  * @see elm_object_content_set().
 925  * @see elm_object_content_unset()
 926  *
 927  * @deprecated use elm_object_content_get() instead
 928  *
 929  * @ingroup Conformant
 930  */
 931 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_get(const Evas_Object *obj);
 932
 933 /**
 934  * Unset the content of the conformant widget.
 935  *
 936  * @param obj The conformant object.
 937  * @return The content that was being used.
 938  *
 939  * Unparent and return the content object which was set for this widget.
 940  *
 941  * @see elm_object_content_set().
 942  *
 943  * @deprecated use elm_object_content_unset() instead
 944  *
 945  * @ingroup Conformant
 946  */
 947 EINA_DEPRECATED EAPI Evas_Object *elm_conformant_content_unset(Evas_Object *obj);
 948
 949 /**
 950  * Get the side labels max length.
 951  *
 952  * @deprecated use elm_diskselector_side_label_length_get() instead:
 953  *
 954  * @param obj The diskselector object.
 955  * @return The max length defined for side labels, or 0 if not a valid
 956  * diskselector.
 957  *
 958  * @ingroup Diskselector
 959  */
 960 EINA_DEPRECATED EAPI int    elm_diskselector_side_label_lenght_get(const Evas_Object *obj);
 961
 962 /**
 963  * Set the side labels max length.
 964  *
 965  * @deprecated use elm_diskselector_side_label_length_set() instead:
 966  *
 967  * @param obj The diskselector object.
 968  * @param len The max length defined for side labels.
 969  *
 970  * @ingroup Diskselector
 971  */
 972 EINA_DEPRECATED EAPI void   elm_diskselector_side_label_lenght_set(Evas_Object *obj, int len);
 973
 974 /**
 975  * Get the data associated to the item.
 976  *
 977  * @param it The diskselector item
 978  * @return The data associated to @p it
 979  *
 980  * The return value is a pointer to data associated to @p item when it was
 981  * created, with function elm_diskselector_item_append(). If no data
 982  * was passed as argument, it will return @c NULL.
 983  *
 984  * @see elm_diskselector_item_append()
 985  * @deprecated Use elm_object_item_data_get()
 986  *
 987  * @ingroup Diskselector
 988  */
 989 EINA_DEPRECATED EAPI void                  *elm_diskselector_item_data_get(const Elm_Object_Item *it);
 990
 991 /**
 992  * Set the icon associated to the item.
 993  *
 994  * @param it The diskselector item
 995  * @param icon The icon object to associate with @p it
 996  *
 997  * The icon object to use at left side of the item. An
 998  * icon can be any Evas object, but usually it is an icon created
 999  * with elm_icon_add().
1000  *
1001  * Once the icon object is set, a previously set one will be deleted.
1002  * @warning Setting the same icon for two items will cause the icon to
1003  * disappear from the first item.
1004  *
1005  * If an icon was passed as argument on item creation, with function
1006  * elm_diskselector_item_append(), it will be already
1007  * associated to the item.
1008  *
1009  * @see elm_diskselector_item_append()
1010  * @see elm_diskselector_item_icon_get()
1011  *
1012  * @deprecated Use elm_object_item_part_content_set() instead
1013  * @ingroup Diskselector
1014  */
1015 EINA_DEPRECATED EAPI void                   elm_diskselector_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
1016
1017 /**
1018  * Get the icon associated to the item.
1019  *
1020  * @param it The diskselector item
1021  * @return The icon associated to @p it
1022  *
1023  * The return value is a pointer to the icon associated to @p item when it was
1024  * created, with function elm_diskselector_item_append(), or later
1025  * with function elm_diskselector_item_icon_set. If no icon
1026  * was passed as argument, it will return @c NULL.
1027  *
1028  * @see elm_diskselector_item_append()
1029  * @see elm_diskselector_item_icon_set()
1030  *
1031  * @deprecated Use elm_object_item_part_content_set() instead
1032  * @ingroup Diskselector
1033  */
1034 EAPI Evas_Object           *elm_diskselector_item_icon_get(const Elm_Object_Item *it);
1035
1036 /**
1037  * Set the label of item.
1038  *
1039  * @param it The item of diskselector.
1040  * @param label The label of item.
1041  *
1042  * The label to be displayed by the item.
1043  *
1044  * If no icon is set, label will be centered on item position, otherwise
1045  * the icon will be placed at left of the label, that will be shifted
1046  * to the right.
1047  *
1048  * An item with label "January" would be displayed on side position as
1049  * "Jan" if max length is set to 3 with function
1050  * elm_diskselector_side_label_length_set(), or "Janu", if this property
1051  * is set to 4.
1052  *
1053  * When this @p item is selected, the entire label will be displayed,
1054  * except for width restrictions.
1055  * In this case label will be cropped and "..." will be concatenated,
1056  * but only for display purposes. It will keep the entire string, so
1057  * if diskselector is resized the remaining characters will be displayed.
1058  *
1059  * If a label was passed as argument on item creation, with function
1060  * elm_diskselector_item_append(), it will be already
1061  * displayed by the item.
1062  *
1063  * @see elm_diskselector_side_label_length_set()
1064  * @see elm_diskselector_item_label_get()
1065  * @see elm_diskselector_item_append()
1066  *
1067  * @deprecated Use elm_object_item_text_set() instead
1068  * @ingroup Diskselector
1069  */
1070 EINA_DEPRECATED EAPI void                   elm_diskselector_item_label_set(Elm_Object_Item *it, const char *label);
1071
1072 /**
1073  * Get the label of item.
1074  *
1075  * @param it The item of diskselector.
1076  * @return The label of item.
1077  *
1078  * The return value is a pointer to the label associated to @p item when it was
1079  * created, with function elm_diskselector_item_append(), or later
1080  * with function elm_diskselector_item_label_set. If no label
1081  * was passed as argument, it will return @c NULL.
1082  *
1083  * @see elm_diskselector_item_label_set() for more details.
1084  * @see elm_diskselector_item_append()
1085  * @deprecated Use elm_object_item_text_get() instead
1086  *
1087  * @ingroup Diskselector
1088  */
1089 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_label_get(const Elm_Object_Item *it);
1090
1091 /**
1092  * Set the function called when a diskselector item is freed.
1093  *
1094  * @param it The item to set the callback on
1095  * @param func The function called
1096  *
1097  * If there is a @p func, then it will be called prior item's memory release.
1098  * That will be called with the following arguments:
1099  * @li item's data;
1100  * @li item's Evas object;
1101  * @li item itself;
1102  *
1103  * This way, a data associated to a diskselector item could be properly
1104  * freed.
1105  * @deprecated Use elm_object_item_del_cb_set() instead
1106  *
1107  * @ingroup Diskselector
1108  */
1109 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1110
1111 /**
1112  * Delete them item from the diskselector.
1113  *
1114  * @param it The item of diskselector to be deleted.
1115  *
1116  * If deleting all diskselector items is required, elm_diskselector_clear()
1117  * should be used instead of getting items list and deleting each one.
1118  *
1119  * @deprecated Use elm_object_item_del() instead
1120  * @see elm_diskselector_clear()
1121  * @see elm_diskselector_item_append()
1122  *
1123  * @ingroup Diskselector
1124  */
1125 EINA_DEPRECATED EAPI void                   elm_diskselector_item_del(Elm_Object_Item *it);
1126
1127 /**
1128  * Set the text to be shown in the diskselector item.
1129  *
1130  * @param it Target item
1131  * @param text The text to set in the content
1132  *
1133  * Setup the text as tooltip to object. The item can have only one tooltip,
1134  * so any previous tooltip data is removed.
1135  *
1136  * @deprecated Use elm_object_item_tooltip_text_set() instead
1137  * @see elm_object_tooltip_text_set() for more details.
1138  *
1139  * @ingroup Diskselector
1140  */
1141 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
1142
1143 /**
1144  * Set the content to be shown in the tooltip item.
1145  *
1146  * Setup the tooltip to item. The item can have only one tooltip,
1147  * so any previous tooltip data is removed. @p func(with @p data) will
1148  * be called every time that need show the tooltip and it should
1149  * return a valid Evas_Object. This object is then managed fully by
1150  * tooltip system and is deleted when the tooltip is gone.
1151  *
1152  * @param it the diskselector item being attached a tooltip.
1153  * @param func the function used to create the tooltip contents.
1154  * @param data what to provide to @a func as callback data/context.
1155  * @param del_cb called when data is not needed anymore, either when
1156  *        another callback replaces @p func, the tooltip is unset with
1157  *        elm_diskselector_item_tooltip_unset() or the owner @a item
1158  *        dies. This callback receives as the first parameter the
1159  *        given @a data, and @c event_info is the item.
1160  *
1161  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
1162  * @see elm_object_tooltip_content_cb_set() for more details.
1163  *
1164  * @ingroup Diskselector
1165  */
1166 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_content_cb_set(Elm_Object_Item *it, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
1167
1168 /**
1169  * Unset tooltip from item.
1170  *
1171  * @param it diskselector item to remove previously set tooltip.
1172  *
1173  * Remove tooltip from item. The callback provided as del_cb to
1174  * elm_diskselector_item_tooltip_content_cb_set() will be called to notify
1175  * it is not used anymore.
1176  *
1177  * @deprecated Use elm_object_item_tooltip_unset() instead
1178  * @see elm_object_tooltip_unset() for more details.
1179  * @see elm_diskselector_item_tooltip_content_cb_set()
1180  *
1181  * @ingroup Diskselector
1182  */
1183 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_unset(Elm_Object_Item *it);
1184
1185 /**
1186  * Sets a different style for this item tooltip.
1187  *
1188  * @note before you set a style you should define a tooltip with
1189  *       elm_diskselector_item_tooltip_content_cb_set() or
1190  *       elm_diskselector_item_tooltip_text_set()
1191  *
1192  * @param it diskselector item with tooltip already set.
1193  * @param style the theme style to use (default, transparent, ...)
1194  *
1195  * @deprecated Use elm_object_item_tooltip_style_set() instead
1196  * @see elm_object_tooltip_style_set() for more details.
1197  *
1198  * @ingroup Diskselector
1199  */
1200 EINA_DEPRECATED EAPI void                   elm_diskselector_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
1201
1202 /**
1203  * Get the style for this item tooltip.
1204  *
1205  * @param it diskselector item with tooltip already set.
1206  * @return style the theme style in use, defaults to "default". If the
1207  *         object does not have a tooltip set, then NULL is returned.
1208  *
1209  * @deprecated Use elm_object_item_tooltip_style_get() instead
1210  * @see elm_object_tooltip_style_get() for more details.
1211  * @see elm_diskselector_item_tooltip_style_set()
1212  *
1213  * @ingroup Diskselector
1214  */
1215 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_tooltip_style_get(const Elm_Object_Item *it);
1216
1217 /**
1218  * Set the cursor to be shown when mouse is over the diskselector item
1219  *
1220  * @param it Target item
1221  * @param cursor the cursor name to be used.
1222  *
1223  * @see elm_object_cursor_set() for more details.
1224  * @deprecated Use elm_object_item_cursor_set() instead
1225  *
1226  * @ingroup Diskselector
1227  */
1228 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_set(Elm_Object_Item *it, const char *cursor);
1229
1230 /**
1231  * Get the cursor to be shown when mouse is over the diskselector item
1232  *
1233  * @param it diskselector item with cursor already set.
1234  * @return the cursor name.
1235  *
1236  * @see elm_object_cursor_get() for more details.
1237  * @see elm_diskselector_item_cursor_set()
1238  * @deprecated Use elm_object_item_cursor_get() instead
1239  *
1240  * @ingroup Diskselector
1241  */
1242 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_get(const Elm_Object_Item *it);
1243
1244 /**
1245  * Unset the cursor to be shown when mouse is over the diskselector item
1246  *
1247  * @param it Target item
1248  *
1249  * @see elm_object_cursor_unset() for more details.
1250  * @see elm_diskselector_item_cursor_set()
1251  * @deprecated use elm_object_item_cursor_unset() instead
1252  *
1253  * @ingroup Diskselector
1254  */
1255 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_unset(Elm_Object_Item *it);
1256
1257 /**
1258  * Sets a different style for this item cursor.
1259  *
1260  * @note before you set a style you should define a cursor with
1261  *       elm_diskselector_item_cursor_set()
1262  *
1263  * @param it diskselector item with cursor already set.
1264  * @param style the theme style to use (default, transparent, ...)
1265  *
1266  * @see elm_object_cursor_style_set() for more details.
1267  * @deprecated Use elm_object_item_cursor_style_set() instead
1268  *
1269  * @ingroup Diskselector
1270  */
1271 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_style_set(Elm_Object_Item *it, const char *style);
1272
1273 /**
1274  * Get the style for this item cursor.
1275  *
1276  * @param it diskselector item with cursor already set.
1277  * @return style the theme style in use, defaults to "default". If the
1278  *         object does not have a cursor set, then @c NULL is returned.
1279  *
1280  * @see elm_object_cursor_style_get() for more details.
1281  * @see elm_diskselector_item_cursor_style_set()
1282  * @deprecated Use elm_object_item_cursor_style_get() instead
1283  *
1284  * @ingroup Diskselector
1285  */
1286 EINA_DEPRECATED EAPI const char            *elm_diskselector_item_cursor_style_get(const Elm_Object_Item *it);
1287
1288 /**
1289  * Set if the cursor set should be searched on the theme or should use
1290  * the provided by the engine, only.
1291  *
1292  * @note before you set if should look on theme you should define a cursor
1293  * with elm_diskselector_item_cursor_set().
1294  * By default it will only look for cursors provided by the engine.
1295  *
1296  * @param it widget item with cursor already set.
1297  * @param engine_only boolean to define if cursors set with
1298  * elm_diskselector_item_cursor_set() should be searched only
1299  * between cursors provided by the engine or searched on widget's
1300  * theme as well.
1301  *
1302  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
1303  *
1304  * @ingroup Diskselector
1305  */
1306 EINA_DEPRECATED EAPI void                   elm_diskselector_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
1307
1308 /**
1309  * Get the cursor engine only usage for this item cursor.
1310  *
1311  * @param it widget item with cursor already set.
1312  * @return engine_only boolean to define it cursors should be looked only
1313  * between the provided by the engine or searched on widget's theme as well.
1314  * If the item does not have a cursor set, then @c EINA_FALSE is returned.
1315  *
1316  * @see elm_diskselector_item_cursor_engine_only_set()
1317  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
1318  *
1319  * @ingroup Diskselector
1320  */
1321 EINA_DEPRECATED EAPI Eina_Bool              elm_diskselector_item_cursor_engine_only_get(const Elm_Object_Item *it);
1322
1323 EINA_DEPRECATED EAPI void         elm_factory_content_set(Evas_Object *obj, Evas_Object *content);
1324 EINA_DEPRECATED EAPI Evas_Object *elm_factory_content_get(const Evas_Object *obj);
1325
1326 /**
1327  * Get the label of a given flip selector widget's item.
1328  *
1329  * @param it The item to get label from
1330  * @return The text label of @p item or @c NULL, on errors
1331  *
1332  * @see elm_object_item_text_set()
1333  *
1334  * @deprecated see elm_object_item_text_get() instead
1335  * @ingroup Flipselector
1336  */
1337 EINA_DEPRECATED EAPI const char *elm_flipselector_item_label_get(const Elm_Object_Item *it);
1338
1339 /**
1340  * Set the label of a given flip selector widget's item.
1341  *
1342  * @param it The item to set label on
1343  * @param label The text label string, in UTF-8 encoding
1344  *
1345  * @see elm_object_item_text_get()
1346  *
1347  * @deprecated see elm_object_item_text_set() instead
1348  * @ingroup Flipselector
1349  */
1350 EINA_DEPRECATED EAPI void        elm_flipselector_item_label_set(Elm_Object_Item *it, const char *label);
1351
1352 /**
1353  * Delete a given item from a flip selector widget.
1354  *
1355  * @param it The item to delete
1356  *
1357  * @deprecated Use elm_object_item_del() instead
1358  * @ingroup Flipselector
1359  */
1360 EINA_DEPRECATED EAPI void       elm_flipselector_item_del(Elm_Object_Item *it);
1361
1362 /**
1363  * Make a given Elementary object the focused one.
1364  *
1365  * @param obj The Elementary object to make focused.
1366  *
1367  * @note This object, if it can handle focus, will take the focus
1368  * away from the one who had it previously and will, for now on, be
1369  * the one receiving input events.
1370  *
1371  * @see elm_object_focus_get()
1372  * @deprecated use elm_object_focus_set() instead.
1373  *
1374  * @ingroup Focus
1375  */
1376 EINA_DEPRECATED EAPI void elm_object_focus(Evas_Object *obj);
1377
1378 /**
1379  * Remove the focus from an Elementary object
1380  *
1381  * @param obj The Elementary to take focus from
1382  *
1383  * This removes the focus from @p obj, passing it back to the
1384  * previous element in the focus chain list.
1385  *
1386  * @see elm_object_focus() and elm_object_focus_custom_chain_get()
1387  * @deprecated use elm_object_focus_set() instead.
1388  *
1389  * @ingroup Focus
1390  */
1391 EINA_DEPRECATED EAPI void elm_object_unfocus(Evas_Object *obj);
1392
1393 /**
1394  * Give focus to near object in one direction.
1395  *
1396  * Give focus to near object in direction of one object.
1397  * If none focusable object in given direction, the focus will not change.
1398  *
1399  * @param obj The reference object
1400  * @param x Horizontal component of direction to focus
1401  * @param y Vertical component of direction to focus
1402  *
1403  * @deprecated Support it later.
1404  * @ingroup Focus
1405  */
1406 EINA_DEPRECATED EAPI void                 elm_object_focus_direction_go(Evas_Object *obj, int x, int y);
1407
1408 /**
1409  * @brief Set the frame label
1410  *
1411  * @param obj The frame object
1412  * @param label The label of this frame object
1413  *
1414  * @deprecated use elm_object_text_set() instead.
1415  */
1416 EINA_DEPRECATED EAPI void         elm_frame_label_set(Evas_Object *obj, const char *label);
1417
1418 /**
1419  * @brief Get the frame label
1420  *
1421  * @param obj The frame object
1422  *
1423  * @return The label of this frame object or NULL if unable to get frame
1424  *
1425  * @deprecated use elm_object_text_get() instead.
1426  */
1427 EINA_DEPRECATED EAPI const char  *elm_frame_label_get(const Evas_Object *obj);
1428
1429 /**
1430  * @brief Set the content of the frame widget
1431  *
1432  * Once the content object is set, a previously set one will be deleted.
1433  * If you want to keep that old content object, use the
1434  * elm_frame_content_unset() function.
1435  *
1436  * @param obj The frame object
1437  * @param content The content will be filled in this frame object
1438  *
1439  * @deprecated use elm_object_content_set() instead.
1440  */
1441 EINA_DEPRECATED EAPI void         elm_frame_content_set(Evas_Object *obj, Evas_Object *content);
1442
1443 /**
1444  * @brief Get the content of the frame widget
1445  *
1446  * Return the content object which is set for this widget
1447  *
1448  * @param obj The frame object
1449  * @return The content that is being used
1450  *
1451  * @deprecated use elm_object_content_get() instead.
1452  */
1453 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_get(const Evas_Object *obj);
1454
1455 /**
1456  * @brief Unset the content of the frame widget
1457  *
1458  * Unparent and return the content object which was set for this widget
1459  *
1460  * @param obj The frame object
1461  * @return The content that was being used
1462  *
1463  * @deprecated use elm_object_content_unset() instead.
1464  */
1465 EINA_DEPRECATED EAPI Evas_Object *elm_frame_content_unset(Evas_Object *obj);
1466
1467 EINA_DEPRECATED EAPI void          elm_genlist_horizontal_mode_set(Evas_Object *obj, Elm_List_Mode mode);
1468 EINA_DEPRECATED EAPI Elm_List_Mode elm_genlist_horizontal_mode_get(const Evas_Object *obj);
1469 EINA_DEPRECATED EAPI void          elm_genlist_item_icons_orphan(Elm_Object_Item *it);
1470 /**
1471  * This sets the horizontal stretching mode.
1472  *
1473  * @param obj The genlist object
1474  * @param mode The mode to use (one of #ELM_LIST_SCROLL or #ELM_LIST_LIMIT).
1475  *
1476  * This sets the mode used for sizing items horizontally. Valid modes
1477  * are #ELM_LIST_LIMIT and #ELM_LIST_SCROLL. The default is
1478  * ELM_LIST_SCROLL. This mode means that if items are too wide to fit,
1479  * the scroller will scroll horizontally. Otherwise items are expanded
1480  * to fill the width of the viewport of the scroller. If it is
1481  * ELM_LIST_LIMIT, items will be expanded to the viewport width and
1482  * limited to that size.
1483  *
1484  * @see elm_genlist_horizontal_get()
1485  *
1486  * @deprecated use elm_genlist_mode_set()
1487  * @ingroup Genlist
1488  */
1489 EINA_DEPRECATED EAPI void                          elm_genlist_horizontal_set(Evas_Object *obj, Elm_List_Mode mode);
1490
1491 /**
1492  * Gets the horizontal stretching mode.
1493  *
1494  * @param obj The genlist object
1495  * @return The mode to use
1496  * (#ELM_LIST_LIMIT, #ELM_LIST_SCROLL)
1497  *
1498  * @see elm_genlist_horizontal_set()
1499  *
1500  * @deprecated use elm_genlist_mode_get()
1501  * @ingroup Genlist
1502  */
1503 EINA_DEPRECATED EAPI Elm_List_Mode                 elm_genlist_horizontal_get(const Evas_Object *obj);
1504
1505 /**
1506  * Return the data associated to a given genlist item
1507  *
1508  * @param it The genlist item.
1509  * @return the data associated to this item.
1510  *
1511  * This returns the @c data value passed on the
1512  * elm_genlist_item_append() and related item addition calls.
1513  *
1514  * @see elm_genlist_item_append()
1515  * @see elm_genlist_item_data_set()
1516  *
1517  * @deprecated Use elm_object_item_data_get() instead
1518  * @ingroup Genlist
1519  */
1520 EINA_DEPRECATED EAPI void                         *elm_genlist_item_data_get(const Elm_Object_Item *it);
1521
1522 /**
1523  * Set the data associated to a given genlist item
1524  *
1525  * @param it The genlist item
1526  * @param data The new data pointer to set on it
1527  *
1528  * This @b overrides the @c data value passed on the
1529  * elm_genlist_item_append() and related item addition calls. This
1530  * function @b won't call elm_genlist_item_update() automatically,
1531  * so you'd issue it afterwards if you want to hove the item
1532  * updated to reflect the that new data.
1533  *
1534  * @see elm_genlist_item_data_get()
1535  *
1536  * @deprecated Use elm_object_item_data_set() instead
1537  * @ingroup Genlist
1538  */
1539 EINA_DEPRECATED EAPI void                          elm_genlist_item_data_set(Elm_Object_Item *it, const void *data);
1540
1541 /**
1542  * Set whether a given genlist item is disabled or not.
1543  *
1544  * @param it The item
1545  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
1546  * to enable it back.
1547  *
1548  * A disabled item cannot be selected or unselected. It will also
1549  * change its appearance, to signal the user it's disabled.
1550  *
1551  * @see elm_genlist_item_disabled_get()
1552  * @deprecated Use elm_object_item_disabled_set() instead
1553  *
1554  * @ingroup Genlist
1555  */
1556 EINA_DEPRECATED EAPI void                          elm_genlist_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1557
1558 /**
1559  * Get whether a given genlist item is disabled or not.
1560  *
1561  * @param it The item
1562  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
1563  * (and on errors).
1564  *
1565  * @see elm_genlist_item_disabled_set() for more details
1566  * @deprecated Use elm_object_item_disabled_get() instead
1567  *
1568  * @ingroup Genlist
1569  */
1570 EINA_DEPRECATED EAPI Eina_Bool                     elm_genlist_item_disabled_get(const Elm_Object_Item *it);
1571
1572 /**
1573  * Remove a genlist item from the its parent, deleting it.
1574  *
1575  * @param it The item to be removed.
1576  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
1577  *
1578  * @see elm_genlist_clear(), to remove all items in a genlist at
1579  * once.
1580  *
1581  * @deprecated Use elm_object_item_del() instead
1582  * @ingroup Genlist
1583  */
1584 EINA_DEPRECATED EAPI void                          elm_genlist_item_del(Elm_Object_Item *it);
1585
1586 /**
1587  * Get the genlist object's handle which contains a given genlist
1588  * item
1589  *
1590  * @param it The item to fetch the container from
1591  * @return The genlist (parent) object
1592  *
1593  * This returns the genlist object itself that an item belongs to.
1594  * @deprecated Use elm_object_item_widget_get() instead
1595  *
1596  * @ingroup Genlist
1597  */
1598 EINA_DEPRECATED EAPI Evas_Object                  *elm_genlist_item_genlist_get(const Elm_Object_Item *it);
1599
1600 /**
1601  * Get the mode item style of items in the genlist
1602  * @param obj The genlist object
1603  * @return The mode item style string, or NULL if none is specified
1604  *
1605  * This is a constant string and simply defines the name of the
1606  * style that will be used for mode animations. It can be
1607  * @c NULL if you don't plan to use Genlist mode. See
1608  * elm_genlist_item_mode_set() for more info.
1609  *
1610  * @ingroup Genlist
1611  */
1612 EINA_DEPRECATED EAPI const char                   *elm_genlist_mode_item_style_get(const Evas_Object *obj);
1613
1614 /**
1615  * Set the mode item style of items in the genlist
1616  * @param obj The genlist object
1617  * @param style The mode item style string, or NULL if none is desired
1618  *
1619  * This is a constant string and simply defines the name of the
1620  * style that will be used for mode animations. It can be
1621  * @c NULL if you don't plan to use Genlist mode. See
1622  * elm_genlist_item_mode_set() for more info.
1623  *
1624  * @ingroup Genlist
1625  */
1626 EINA_DEPRECATED EAPI void                          elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
1627
1628 /**
1629  * Get the real Evas object created to implement the view of a
1630  * given genlist item
1631  *
1632  * @param it The genlist item.
1633  * @return the Evas object implementing this item's view.
1634  *
1635  * This returns the actual Evas object used to implement the
1636  * specified genlist item's view. This may be @c NULL, as it may
1637  * not have been created or may have been deleted, at any time, by
1638  * the genlist. <b>Do not modify this object</b> (move, resize,
1639  * show, hide, etc.), as the genlist is controlling it. This
1640  * function is for querying, emitting custom signals or hooking
1641  * lower level callbacks for events on that object. Do not delete
1642  * this object under any circumstances.
1643  *
1644  * @see elm_object_item_data_get()
1645  * @deprecated No more support
1646  *
1647  * @ingroup Genlist
1648  */
1649 EINA_DEPRECATED EAPI const Evas_Object            *elm_genlist_item_object_get(const Elm_Object_Item *it);
1650
1651 #define ELM_IMAGE_ROTATE_90_CW 1
1652 #define ELM_IMAGE_ROTATE_180_CW 2
1653 #define ELM_IMAGE_ROTATE_90_CCW 3
1654
1655 /**
1656  * Return the data associated with a given index widget item
1657  *
1658  * @param item The index widget item handle
1659  * @return The data associated with @p it
1660  * @deprecated Use elm_object_item_data_get() instead
1661  *
1662  * @see elm_index_item_data_set()
1663  *
1664  * @ingroup Index
1665  */
1666 EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item);
1667
1668 /**
1669  * Set the data associated with a given index widget item
1670  *
1671  * @param it The index widget item handle
1672  * @param data The new data pointer to set to @p it
1673  *
1674  * This sets new item data on @p it.
1675  *
1676  * @warning The old data pointer won't be touched by this function, so
1677  * the user had better to free that old data himself/herself.
1678  *
1679  * @deprecated Use elm_object_item_data_set() instead
1680  * @ingroup Index
1681  */
1682 EINA_DEPRECATED EAPI void  elm_index_item_data_set(Elm_Object_Item *it, const void *data);
1683
1684 /**
1685  * Set the function to be called when a given index widget item is freed.
1686  *
1687  * @param it The item to set the callback on
1688  * @param func The function to call on the item's deletion
1689  *
1690  * When called, @p func will have both @c data and @c event_info
1691  * arguments with the @p it item's data value and, naturally, the
1692  * @c obj argument with a handle to the parent index widget.
1693  *
1694  * @deprecated Use elm_object_item_del_cb_set() instead
1695  * @ingroup Index
1696  */
1697 EINA_DEPRECATED EAPI void                  elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1698
1699 /**
1700  * Remove an item from a given index widget, <b>to be referenced by
1701  * it's data value</b>.
1702  *
1703  * @param obj The index object
1704  * @param item The item to be removed from @p obj
1705  *
1706  * If a deletion callback is set, via elm_object_item_del_cb_set(),
1707  * that callback function will be called by this one.
1708  *
1709  * @deprecated Use elm_object_item_del() instead
1710  * @ingroup Index
1711  */
1712 EINA_DEPRECATED EAPI void                  elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item);
1713
1714 /**
1715 * @brief Set the label on the label object
1716  *
1717  * @param obj The label object
1718  * @param label The label will be used on the label object
1719  * @deprecated See elm_object_text_set()
1720  */
1721 EINA_DEPRECATED EAPI void        elm_label_label_set(Evas_Object *obj, const char *label);
1722
1723 /**
1724  * @brief Get the label used on the label object
1725  *
1726  * @param obj The label object
1727  * @return The string inside the label
1728  * @deprecated See elm_object_text_get()
1729  */
1730 EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj);
1731
1732
1733 /**
1734  * Set the layout content.
1735  *
1736  * @param obj The layout object
1737  * @param swallow The swallow part name in the edje file
1738  * @param content The child that will be added in this layout object
1739  *
1740  * Once the content object is set, a previously set one will be deleted.
1741  * If you want to keep that old content object, use the
1742  * elm_object_part_content_unset() function.
1743  *
1744  * @note In an Edje theme, the part used as a content container is called @c
1745  * SWALLOW. This is why the parameter name is called @p swallow, but it is
1746  * expected to be a part name just like the second parameter of
1747  * elm_layout_box_append().
1748  *
1749  * @see elm_layout_box_append()
1750  * @see elm_object_part_content_get()
1751  * @see elm_object_part_content_unset()
1752  * @see @ref secBox
1753  * @deprecated use elm_object_part_content_set() instead
1754  *
1755  * @ingroup Layout
1756  */
1757 EINA_DEPRECATED EAPI void         elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content);
1758
1759 /**
1760  * Get the child object in the given content part.
1761  *
1762  * @param obj The layout object
1763  * @param swallow The SWALLOW part to get its content
1764  *
1765  * @return The swallowed object or NULL if none or an error occurred
1766  *
1767  * @deprecated use elm_object_part_content_get() instead
1768  *
1769  * @ingroup Layout
1770  */
1771 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow);
1772
1773 /**
1774  * Unset the layout content.
1775  *
1776  * @param obj The layout object
1777  * @param swallow The swallow part name in the edje file
1778  * @return The content that was being used
1779  *
1780  * Unparent and return the content object which was set for this part.
1781  *
1782  * @deprecated use elm_object_part_content_unset() instead
1783  *
1784  * @ingroup Layout
1785  */
1786 EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow);
1787
1788 /**
1789  * Set the text of the given part
1790  *
1791  * @param obj The layout object
1792  * @param part The TEXT part where to set the text
1793  * @param text The text to set
1794  *
1795  * @ingroup Layout
1796  * @deprecated use elm_object_part_text_set() instead.
1797  */
1798 EINA_DEPRECATED EAPI void         elm_layout_text_set(Evas_Object *obj, const char *part, const char *text);
1799
1800 /**
1801  * Get the text set in the given part
1802  *
1803  * @param obj The layout object
1804  * @param part The TEXT part to retrieve the text off
1805  *
1806  * @return The text set in @p part
1807  *
1808  * @ingroup Layout
1809  * @deprecated use elm_object_part_text_get() instead.
1810  */
1811 EINA_DEPRECATED EAPI const char  *elm_layout_text_get(const Evas_Object *obj, const char *part);
1812
1813 /**
1814  * @def elm_layout_label_set
1815  * Convenience macro to set the label in a layout that follows the
1816  * Elementary naming convention for its parts.
1817  *
1818  * @ingroup Layout
1819  * @deprecated use elm_object_text_set() instead.
1820  */
1821 #define elm_layout_label_set(_ly, _txt) \
1822   elm_layout_text_set((_ly), "elm.text", (_txt))
1823
1824 /**
1825  * @def elm_layout_label_get
1826  * Convenience macro to get the label in a layout that follows the
1827  * Elementary naming convention for its parts.
1828  *
1829  * @ingroup Layout
1830  * @deprecated use elm_object_text_set() instead.
1831  */
1832 #define elm_layout_label_get(_ly) \
1833   elm_layout_text_get((_ly), "elm.text")
1834
1835 EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it);
1836
1837
1838 /**
1839  * Set the content of the mapbuf.
1840  *
1841  * @param obj The mapbuf object.
1842  * @param content The content that will be filled in this mapbuf object.
1843  *
1844  * Once the content object is set, a previously set one will be deleted.
1845  * If you want to keep that old content object, use the
1846  * elm_mapbuf_content_unset() function.
1847  *
1848  * To enable map, elm_mapbuf_enabled_set() should be used.
1849  *
1850  * @deprecated use elm_object_content_set() instead
1851  *
1852  * @ingroup Mapbuf
1853  */
1854 EINA_DEPRECATED EAPI void         elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content);
1855
1856 /**
1857  * Get the content of the mapbuf.
1858  *
1859  * @param obj The mapbuf object.
1860  * @return The content that is being used.
1861  *
1862  * Return the content object which is set for this widget.
1863  *
1864  * @see elm_mapbuf_content_set() for details.
1865  *
1866  * @deprecated use elm_object_content_get() instead
1867  *
1868  * @ingroup Mapbuf
1869  */
1870 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj);
1871
1872 /**
1873  * Unset the content of the mapbuf.
1874  *
1875  * @param obj The mapbuf object.
1876  * @return The content that was being used.
1877  *
1878  * Unparent and return the content object which was set for this widget.
1879  *
1880  * @see elm_mapbuf_content_set() for details.
1881  *
1882  * @deprecated use elm_object_content_unset() instead
1883  *
1884  * @ingroup Mapbuf
1885  */
1886 EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj);
1887
1888 /**
1889  * @brief Set the label of a menu item
1890  *
1891  * @param it The menu item object.
1892  * @param label The label to set for @p item
1893  *
1894  * @warning Don't use this function on items created with
1895  * elm_menu_item_add_object() or elm_menu_item_separator_add().
1896  *
1897  * @deprecated Use elm_object_item_text_set() instead
1898  */
1899 EINA_DEPRECATED EAPI void         elm_menu_item_label_set(Elm_Object_Item *it, const char *label);
1900
1901 /**
1902  * @brief Get the label of a menu item
1903  *
1904  * @param it The menu item object.
1905  * @return The label of @p item
1906  * @deprecated Use elm_object_item_text_get() instead
1907  */
1908 EINA_DEPRECATED EAPI const char  *elm_menu_item_label_get(const Elm_Object_Item *it);
1909
1910 /**
1911  * @brief Set the content object of a menu item
1912  *
1913  * @param it The menu item object
1914  * @param The content object or NULL
1915  * @return EINA_TRUE on success, else EINA_FALSE
1916  *
1917  * Use this function to change the object swallowed by a menu item, deleting
1918  * any previously swallowed object.
1919  *
1920  * @deprecated Use elm_object_item_content_set() instead
1921  */
1922 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj);
1923
1924 /**
1925  * @brief Get the content object of a menu item
1926  *
1927  * @param it The menu item object
1928  * @return The content object or NULL
1929  * @note If @p item was added with elm_menu_item_add_object, this
1930  * function will return the object passed, else it will return the
1931  * icon object.
1932  *
1933  * @see elm_menu_item_object_content_set()
1934  *
1935  * @deprecated Use elm_object_item_content_get() instead
1936  */
1937 EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it);
1938
1939 /**
1940  * @brief Set the disabled state of @p item.
1941  *
1942  * @param it The menu item object.
1943  * @param disabled The enabled/disabled state of the item
1944  * @deprecated Use elm_object_item_disabled_set() instead
1945  */
1946 EINA_DEPRECATED EAPI void         elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
1947
1948 /**
1949  * @brief Get the disabled state of @p item.
1950  *
1951  * @param it The menu item object.
1952  * @return The enabled/disabled state of the item
1953  *
1954  * @see elm_menu_item_disabled_set()
1955  * @deprecated Use elm_object_item_disabled_get() instead
1956  */
1957 EINA_DEPRECATED EAPI Eina_Bool    elm_menu_item_disabled_get(const Elm_Object_Item *it);
1958
1959 /**
1960  * @brief Returns the data associated with menu item @p item.
1961  *
1962  * @param it The item
1963  * @return The data associated with @p item or NULL if none was set.
1964  *
1965  * This is the data set with elm_menu_add() or elm_menu_item_data_set().
1966  *
1967  * @deprecated Use elm_object_item_data_get() instead
1968  */
1969 EINA_DEPRECATED EAPI void        *elm_menu_item_data_get(const Elm_Object_Item *it);
1970
1971 /**
1972  * @brief Set the function called when a menu item is deleted.
1973  *
1974  * @param it The item to set the callback on
1975  * @param func The function called
1976  *
1977  * @see elm_menu_item_add()
1978  * @see elm_menu_item_del()
1979  * @deprecated Use elm_object_item_del_cb_set() instead
1980  */
1981 EINA_DEPRECATED EAPI void                         elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
1982
1983 /**
1984  * @brief Sets the data to be associated with menu item @p item.
1985  *
1986  * @param it The item
1987  * @param data The data to be associated with @p item
1988  *
1989  * @deprecated Use elm_object_item_data_set() instead
1990  */
1991 EINA_DEPRECATED EAPI void         elm_menu_item_data_set(Elm_Object_Item *it, const void *data);
1992
1993 /**
1994  * @brief Deletes an item from the menu.
1995  *
1996  * @param it The item to delete.
1997  *
1998  * @deprecated Use elm_object_item_del() instead
1999  * @see elm_menu_item_add()
2000  */
2001 EINA_DEPRECATED EAPI void                         elm_menu_item_del(Elm_Object_Item *it);
2002
2003 /**
2004  * @brief @brief Return a menu item's owner menu
2005  *
2006  * @param it The menu item
2007  * @return The menu object owning @p item, or NULL on failure
2008  *
2009  * Use this function to get the menu object owning an item.
2010  * @deprecated Use elm_object_item_widget_get() instead
2011  */
2012 EINA_DEPRECATED EAPI Evas_Object                 *elm_menu_item_menu_get(const Elm_Object_Item *it);
2013
2014 /**
2015  * @brief Set the icon of a menu item to the standard icon with name @p icon
2016  *
2017  * @param it The menu item object.
2018  * @param icon The icon object to set for the content of @p item
2019  *
2020  * @deprecated elm_menu_item_icon_name_set() instead
2021  * Once this icon is set, any previously set icon will be deleted.
2022  */
2023 EINA_DEPRECATED EAPI void                         elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon);
2024
2025 /**
2026  * @brief Get the string representation from the icon of a menu item
2027  *
2028  * @param it The menu item object.
2029  * @return The string representation of @p item's icon or NULL
2030  *
2031  * @deprecated elm_menu_item_icon_name_get() instead
2032  * @see elm_menu_item_icon_name_set()
2033  */
2034 EINA_DEPRECATED EAPI const char                  *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it);
2035
2036 /**
2037  * @brief Set the content of the notify widget
2038  *
2039  * @param obj The notify object
2040  * @param content The content will be filled in this notify object
2041  *
2042  * Once the content object is set, a previously set one will be deleted. If
2043  * you want to keep that old content object, use the
2044  * elm_notify_content_unset() function.
2045  *
2046  * @deprecated use elm_object_content_set() instead
2047  *
2048  */
2049 EINA_DEPRECATED EAPI void         elm_notify_content_set(Evas_Object *obj, Evas_Object *content);
2050
2051 /**
2052  * @brief Unset the content of the notify widget
2053  *
2054  * @param obj The notify object
2055  * @return The content that was being used
2056  *
2057  * Unparent and return the content object which was set for this widget
2058  *
2059  * @see elm_notify_content_set()
2060  * @deprecated use elm_object_content_unset() instead
2061  *
2062  */
2063 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj);
2064
2065 /**
2066  * @brief Return the content of the notify widget
2067  *
2068  * @param obj The notify object
2069  * @return The content that is being used
2070  *
2071  * @see elm_notify_content_set()
2072  * @deprecated use elm_object_content_get() instead
2073  *
2074  */
2075 EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj);
2076
2077 /**
2078  * Set a label of an object
2079  *
2080  * @param obj The Elementary object
2081  * @param part The text part name to set (NULL for the default label)
2082  * @param label The new text of the label
2083  *
2084  * @note Elementary objects may have many labels (e.g. Action Slider)
2085  * @deprecated Use elm_object_part_text_set() instead.
2086  * @ingroup General
2087  */
2088 EINA_DEPRECATED EAPI void         elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label);
2089
2090 /**
2091  * Get a label of an object
2092  *
2093  * @param obj The Elementary object
2094  * @param part The text part name to get (NULL for the default label)
2095  * @return text of the label or NULL for any error
2096  *
2097  * @note Elementary objects may have many labels (e.g. Action Slider)
2098  * @deprecated Use elm_object_part_text_get() instead.
2099  * @ingroup General
2100  */
2101 EINA_DEPRECATED EAPI const char  *elm_object_text_part_get(const Evas_Object *obj, const char *part);
2102
2103 /**
2104  * Set a content of an object
2105  *
2106  * @param obj The Elementary object
2107  * @param part The content part name to set (NULL for the default content)
2108  * @param content The new content of the object
2109  *
2110  * @note Elementary objects may have many contents
2111  * @deprecated Use elm_object_part_content_set instead.
2112  * @ingroup General
2113  */
2114 EINA_DEPRECATED EAPI void         elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content);
2115
2116 /**
2117  * Get a content of an object
2118  *
2119  * @param obj The Elementary object
2120  * @param part The content part name to get (NULL for the default content)
2121  * @return content of the object or NULL for any error
2122  *
2123  * @note Elementary objects may have many contents
2124  * @deprecated Use elm_object_part_content_get instead.
2125  * @ingroup General
2126  */
2127 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part);
2128
2129 /**
2130  * Unset a content of an object
2131  *
2132  * @param obj The Elementary object
2133  * @param part The content part name to unset (NULL for the default content)
2134  *
2135  * @note Elementary objects may have many contents
2136  * @deprecated Use elm_object_part_content_unset instead.
2137  * @ingroup General
2138  */
2139 EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part);
2140
2141 /**
2142  * Set a content of an object item
2143  *
2144  * @param it The Elementary object item
2145  * @param part The content part name to set (NULL for the default content)
2146  * @param content The new content of the object item
2147  *
2148  * @note Elementary object items may have many contents
2149  * @deprecated Use elm_object_item_part_content_set instead.
2150  * @ingroup General
2151  */
2152 EINA_DEPRECATED EAPI void         elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content);
2153
2154 /**
2155  * Get a content of an object item
2156  *
2157  * @param it The Elementary object item
2158  * @param part The content part name to unset (NULL for the default content)
2159  * @return content of the object item or NULL for any error
2160  *
2161  * @note Elementary object items may have many contents
2162  * @deprecated Use elm_object_item_part_content_get instead.
2163  * @ingroup General
2164  */
2165 EINA_DEPRECATED EAPI Evas_Object                 *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
2166
2167 /**
2168  * Unset 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  *
2173  * @note Elementary object items may have many contents
2174  * @deprecated Use elm_object_item_part_content_unset instead.
2175  * @ingroup General
2176  */
2177 EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part);
2178
2179 /**
2180  * Get a label of an object item
2181  *
2182  * @param it The Elementary object item
2183  * @param part The text part name to get (NULL for the default label)
2184  * @return text of the label or NULL for any error
2185  *
2186  * @note Elementary object items may have many labels
2187  * @deprecated Use elm_object_item_part_text_get instead.
2188  * @ingroup General
2189  */
2190 EINA_DEPRECATED EAPI const char  *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
2191
2192 /**
2193  * Set a label of an object item
2194  *
2195  * @param it The Elementary object item
2196  * @param part The text part name to set (NULL for the default label)
2197  * @param label The new text of the label
2198  *
2199  * @note Elementary object items may have many labels
2200  * @deprecated Use elm_object_item_part_text_set instead.
2201  * @ingroup General
2202  */
2203 EINA_DEPRECATED EAPI void         elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label);
2204
2205 /**
2206  * @brief Set the content of the panel.
2207  *
2208  * @param obj The panel object
2209  * @param content The panel content
2210  *
2211  * Once the content object is set, a previously set one will be deleted.
2212  * If you want to keep that old content object, use the
2213  * elm_panel_content_unset() function.
2214  *
2215  * @deprecated use elm_object_content_set() instead
2216  *
2217  */
2218 EINA_DEPRECATED EAPI void         elm_panel_content_set(Evas_Object *obj, Evas_Object *content);
2219
2220 /**
2221  * @brief Get the content of the panel.
2222  *
2223  * @param obj The panel object
2224  * @return The content that is being used
2225  *
2226  * Return the content object which is set for this widget.
2227  *
2228  * @see elm_panel_content_set()
2229  *
2230  * @deprecated use elm_object_content_get() instead
2231  *
2232  */
2233 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj);
2234
2235 /**
2236  * @brief Unset the content of the panel.
2237  *
2238  * @param obj The panel object
2239  * @return The content that was being used
2240  *
2241  * Unparent and return the content object which was set for this widget.
2242  *
2243  * @see elm_panel_content_set()
2244  *
2245  * @deprecated use elm_object_content_unset() instead
2246  *
2247  */
2248 EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj);
2249
2250 /**
2251  * Set the left content of the panes widget.
2252  *
2253  * @param obj The panes object.
2254  * @param content The new left content object.
2255  *
2256  * Once the content object is set, a previously set one will be deleted.
2257  * If you want to keep that old content object, use the
2258  * elm_panes_content_left_unset() function.
2259  *
2260  * If panes is displayed vertically, left content will be displayed at
2261  * top.
2262  *
2263  * @see elm_panes_content_left_get()
2264  * @see elm_panes_content_right_set() to set content on the other side.
2265  *
2266  * @deprecated use elm_object_part_content_set() instead
2267  *
2268  * @ingroup Panes
2269  */
2270 EINA_DEPRECATED EAPI void         elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content);
2271
2272 /**
2273  * Set the right content of the panes widget.
2274  *
2275  * @param obj The panes object.
2276  * @param content The new right content object.
2277  *
2278  * Once the content object is set, a previously set one will be deleted.
2279  * If you want to keep that old content object, use the
2280  * elm_panes_content_right_unset() function.
2281  *
2282  * If panes is displayed vertically, left content will be displayed at
2283  * bottom.
2284  *
2285  * @see elm_panes_content_right_get()
2286  * @see elm_panes_content_left_set() to set content on the other side.
2287  *
2288  * @deprecated use elm_object_part_content_set() instead
2289  *
2290  * @ingroup Panes
2291  */
2292 EINA_DEPRECATED EAPI void         elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content);
2293
2294 /**
2295  * Get the left content of the panes.
2296  *
2297  * @param obj The panes object.
2298  * @return The left content object that is being used.
2299  *
2300  * Return the left content object which is set for this widget.
2301  *
2302  * @see elm_panes_content_left_set() for details.
2303  *
2304  * @deprecated use elm_object_part_content_get() instead
2305  *
2306  * @ingroup Panes
2307  */
2308 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj);
2309
2310 /**
2311  * Get the right content of the panes.
2312  *
2313  * @param obj The panes object
2314  * @return The right content object that is being used
2315  *
2316  * Return the right content object which is set for this widget.
2317  *
2318  * @see elm_panes_content_right_set() for details.
2319  *
2320  * @deprecated use elm_object_part_content_get() instead
2321  *
2322  * @ingroup Panes
2323  */
2324 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj);
2325
2326 /**
2327  * Unset the left content used for the panes.
2328  *
2329  * @param obj The panes object.
2330  * @return The left content object that was being used.
2331  *
2332  * Unparent and return the left content object which was set for this widget.
2333  *
2334  * @see elm_panes_content_left_set() for details.
2335  * @see elm_panes_content_left_get().
2336  *
2337  * @deprecated use elm_object_part_content_unset() instead
2338  *
2339  * @ingroup Panes
2340  */
2341 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj);
2342
2343 /**
2344  * Unset the right content used for the panes.
2345  *
2346  * @param obj The panes object.
2347  * @return The right content object that was being used.
2348  *
2349  * Unparent and return the right content object which was set for this
2350  * widget.
2351  *
2352  * @see elm_panes_content_right_set() for details.
2353  * @see elm_panes_content_right_get().
2354  *
2355  * @deprecated use elm_object_part_content_unset() instead
2356  *
2357  * @ingroup Panes
2358  */
2359 EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj);
2360 /**
2361  * Set the label of a given progress bar widget
2362  *
2363  * @param obj The progress bar object
2364  * @param label The text label string, in UTF-8
2365  *
2366  * @ingroup Progressbar
2367  * @deprecated use elm_object_text_set() instead.
2368  */
2369 EINA_DEPRECATED EAPI void         elm_progressbar_label_set(Evas_Object *obj, const char *label);
2370
2371 /**
2372  * Get the label of a given progress bar widget
2373  *
2374  * @param obj The progressbar object
2375  * @return The text label string, in UTF-8
2376  *
2377  * @ingroup Progressbar
2378  * @deprecated use elm_object_text_set() instead.
2379  */
2380 EINA_DEPRECATED EAPI const char  *elm_progressbar_label_get(const Evas_Object *obj);
2381
2382 /**
2383  * Set the icon object of a given progress bar widget
2384  *
2385  * @param obj The progress bar object
2386  * @param icon The icon object
2387  *
2388  * Use this call to decorate @p obj with an icon next to it.
2389  *
2390  * @note Once the icon object is set, a previously set one will be
2391  * deleted. If you want to keep that old content object, use the
2392  * elm_progressbar_icon_unset() function.
2393  *
2394  * @see elm_progressbar_icon_get()
2395  * @deprecated use elm_object_part_content_set() instead.
2396  *
2397  * @ingroup Progressbar
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  * @ingroup Progressbar
2412  */
2413 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj);
2414
2415 /**
2416  * Unset an icon set on a given progress bar widget
2417  *
2418  * @param obj The progress bar object
2419  * @return The icon object that was being used, if any was set, or
2420  * @c NULL, otherwise (and on errors)
2421  *
2422  * This call will unparent and return the icon object which was set
2423  * for this widget, previously, on success.
2424  *
2425  * @see elm_progressbar_icon_set() for more details
2426  * @deprecated use elm_object_part_content_unset() instead.
2427  *
2428  * @ingroup Progressbar
2429  */
2430 EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj);
2431
2432 /**
2433  * @brief Set the text label of the radio object
2434  *
2435  * @param obj The radio object
2436  * @param label The text label string in UTF-8
2437  *
2438  * @deprecated use elm_object_text_set() instead.
2439  */
2440 EINA_DEPRECATED EAPI void         elm_radio_label_set(Evas_Object *obj, const char *label);
2441
2442 /**
2443  * @brief Get the text label of the radio object
2444  *
2445  * @param obj The radio object
2446  * @return The text label string in UTF-8
2447  *
2448  * @deprecated use elm_object_text_set() instead.
2449  */
2450 EINA_DEPRECATED EAPI const char  *elm_radio_label_get(const Evas_Object *obj);
2451
2452 /**
2453  * @brief Set the icon object of the radio object
2454  *
2455  * @param obj The radio object
2456  * @param icon The icon object
2457  *
2458  * Once the icon object is set, a previously set one will be deleted. If you
2459  * want to keep that old content object, use the elm_radio_icon_unset()
2460  * function.
2461  *
2462  * @deprecated use elm_object_part_content_set() instead.
2463  *
2464  */
2465 EINA_DEPRECATED EAPI void         elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon);
2466
2467 /**
2468  * @brief Get the icon object of the radio object
2469  *
2470  * @param obj The radio object
2471  * @return The icon object
2472  *
2473  * @see elm_radio_icon_set()
2474  *
2475  * @deprecated use elm_object_part_content_get() instead.
2476  *
2477  */
2478 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj);
2479
2480 /**
2481  * @brief Unset the icon used for the radio object
2482  *
2483  * @param obj The radio object
2484  * @return The icon object that was being used
2485  *
2486  * Unparent and return the icon object which was set for this widget.
2487  *
2488  * @see elm_radio_icon_set()
2489  * @deprecated use elm_object_part_content_unset() instead.
2490  *
2491  */
2492 EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj);
2493
2494 /**
2495  * @brief Set the content of the scroller widget (the object to be scrolled around).
2496  *
2497  * @param obj The scroller object
2498  * @param content The new content object
2499  *
2500  * Once the content object is set, a previously set one will be deleted.
2501  * If you want to keep that old content object, use the
2502  * elm_scroller_content_unset() function.
2503  * @deprecated use elm_object_content_set() instead
2504  */
2505 EINA_DEPRECATED EAPI void         elm_scroller_content_set(Evas_Object *obj, Evas_Object *child);
2506
2507 /**
2508  * @brief Get the content of the scroller widget
2509  *
2510  * @param obj The slider object
2511  * @return The content that is being used
2512  *
2513  * Return the content object which is set for this widget
2514  *
2515  * @see elm_scroller_content_set()
2516  * @deprecated use elm_object_content_get() instead.
2517  */
2518 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj);
2519
2520 /**
2521  * @brief Unset the content of the scroller widget
2522  *
2523  * @param obj The slider object
2524  * @return The content that was being used
2525  *
2526  * Unparent and return the content object which was set for this widget
2527  *
2528  * @see elm_scroller_content_set()
2529  * @deprecated use elm_object_content_unset() instead.
2530  */
2531 EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj);
2532
2533 /**
2534  * Set the label of a given slider widget
2535  *
2536  * @param obj The progress bar object
2537  * @param label The text label string, in UTF-8
2538  *
2539  * @ingroup Slider
2540  * @deprecated use elm_object_text_set() instead.
2541  */
2542 EINA_DEPRECATED EAPI void         elm_slider_label_set(Evas_Object *obj, const char *label);
2543
2544 /**
2545  * Get the label of a given slider widget
2546  *
2547  * @param obj The progressbar object
2548  * @return The text label string, in UTF-8
2549  *
2550  * @ingroup Slider
2551  * @deprecated use elm_object_text_get() instead.
2552  */
2553 EINA_DEPRECATED EAPI const char  *elm_slider_label_get(const Evas_Object *obj);
2554
2555 /**
2556  * Set the icon object of the slider object.
2557  *
2558  * @param obj The slider object.
2559  * @param icon The icon object.
2560  *
2561  * On horizontal mode, icon is placed at left, and on vertical mode,
2562  * placed at top.
2563  *
2564  * @note Once the icon object is set, a previously set one will be deleted.
2565  * If you want to keep that old content object, use the
2566  * elm_slider_icon_unset() function.
2567  *
2568  * @warning If the object being set does not have minimum size hints set,
2569  * it won't get properly displayed.
2570  *
2571  * @ingroup Slider
2572  * @deprecated use elm_object_part_content_set() instead.
2573  */
2574 EINA_DEPRECATED EAPI void         elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon);
2575
2576 /**
2577  * Unset an icon set on a given slider widget.
2578  *
2579  * @param obj The slider object.
2580  * @return The icon object that was being used, if any was set, or
2581  * @c NULL, otherwise (and on errors).
2582  *
2583  * On horizontal mode, icon is placed at left, and on vertical mode,
2584  * placed at top.
2585  *
2586  * This call will unparent and return the icon object which was set
2587  * for this widget, previously, on success.
2588  *
2589  * @see elm_slider_icon_set() for more details
2590  * @see elm_slider_icon_get()
2591  * @deprecated use elm_object_part_content_unset() instead.
2592  *
2593  * @ingroup Slider
2594  */
2595 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj);
2596
2597 /**
2598  * Retrieve the icon object set for a given slider widget.
2599  *
2600  * @param obj The slider object.
2601  * @return The icon object's handle, if @p obj had one set, or @c NULL,
2602  * otherwise (and on errors).
2603  *
2604  * On horizontal mode, icon is placed at left, and on vertical mode,
2605  * placed at top.
2606  *
2607  * @see elm_slider_icon_set() for more details
2608  * @see elm_slider_icon_unset()
2609  *
2610  * @deprecated use elm_object_part_content_get() instead.
2611  *
2612  * @ingroup Slider
2613  */
2614 EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj);
2615
2616 /**
2617  * Set the end object of the slider object.
2618  *
2619  * @param obj The slider object.
2620  * @param end The end object.
2621  *
2622  * On horizontal mode, end is placed at left, and on vertical mode,
2623  * placed at bottom.
2624  *
2625  * @note Once the icon object is set, a previously set one will be deleted.
2626  * If you want to keep that old content object, use the
2627  * elm_slider_end_unset() function.
2628  *
2629  * @warning If the object being set does not have minimum size hints set,
2630  * it won't get properly displayed.
2631  *
2632  * @deprecated use elm_object_part_content_set() instead.
2633  *
2634  * @ingroup Slider
2635  */
2636 EINA_DEPRECATED EAPI void         elm_slider_end_set(Evas_Object *obj, Evas_Object *end);
2637
2638 /**
2639  * Unset an end object set on a given slider widget.
2640  *
2641  * @param obj The slider object.
2642  * @return The end object that was being used, if any was set, or
2643  * @c NULL, otherwise (and on errors).
2644  *
2645  * On horizontal mode, end is placed at left, and on vertical mode,
2646  * placed at bottom.
2647  *
2648  * This call will unparent and return the icon object which was set
2649  * for this widget, previously, on success.
2650  *
2651  * @see elm_slider_end_set() for more details.
2652  * @see elm_slider_end_get()
2653  *
2654  * @deprecated use elm_object_part_content_unset() instead
2655  * instead.
2656  *
2657  * @ingroup Slider
2658  */
2659 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj);
2660
2661 /**
2662  * Retrieve the end object set for a given slider widget.
2663  *
2664  * @param obj The slider object.
2665  * @return The end object's handle, if @p obj had one set, or @c NULL,
2666  * otherwise (and on errors).
2667  *
2668  * On horizontal mode, icon is placed at right, and on vertical mode,
2669  * placed at bottom.
2670  *
2671  * @see elm_slider_end_set() for more details.
2672  * @see elm_slider_end_unset()
2673  *
2674  *
2675  * @deprecated use elm_object_part_content_get() instead
2676  * instead.
2677  *
2678  * @ingroup Slider
2679  */
2680 EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj);
2681
2682 /**
2683  * Return the data associated with a given slideshow item
2684  *
2685  * @param it The slideshow item
2686  * @return Returns the data associated to this item
2687  *
2688  * @deprecated use elm_object_item_data_get() instead
2689  * @ingroup Slideshow
2690  */
2691 EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it);
2692
2693 /**
2694  * Delete a given item from a slideshow widget.
2695  *
2696  * @param it The slideshow item
2697  *
2698  * @deprecated Use elm_object_item_de() instead
2699  * @ingroup Slideshow
2700  */
2701 EINA_DEPRECATED EAPI void                  elm_slideshow_item_del(Elm_Object_Item *it);
2702
2703 /**
2704  * Display a given slideshow widget's item, programmatically.
2705  *
2706  * @param it The item to display on @p obj's viewport
2707  *
2708  * The change between the current item and @p item will use the
2709  * transition @p obj is set to use (@see
2710  * elm_slideshow_transition_set()).
2711  *
2712  * @deprecated use elm_slideshow_item_show() instead
2713  * @ingroup Slideshow
2714  */
2715 EINA_DEPRECATED EAPI void                  elm_slideshow_show(Elm_Object_Item *it);
2716
2717 /**
2718  * Get the toolbar object from an item.
2719  *
2720  * @param it The item.
2721  * @return The toolbar object.
2722  *
2723  * This returns the toolbar object itself that an item belongs to.
2724  *
2725  * @deprecated use elm_object_item_object_get() instead.
2726  * @ingroup Toolbar
2727  */
2728 EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it);
2729
2730 /**
2731  * Get the label of item.
2732  *
2733  * @param it The item of toolbar.
2734  * @return The label of item.
2735  *
2736  * The return value is a pointer to the label associated to @p item when
2737  * it was created, with function elm_toolbar_item_append() or similar,
2738  * or later,
2739  * with function elm_toolbar_item_label_set. If no label
2740  * was passed as argument, it will return @c NULL.
2741  *
2742  * @see elm_toolbar_item_label_set() for more details.
2743  * @see elm_toolbar_item_append()
2744  *
2745  * @deprecated use elm_object_item_text_get() instead.
2746  * @ingroup Toolbar
2747  */
2748 EINA_DEPRECATED EAPI const char  *elm_toolbar_item_label_get(const Elm_Object_Item *it);
2749
2750 /**
2751  * Set the label of item.
2752  *
2753  * @param it The item of toolbar.
2754  * @param label The label of item.
2755  *
2756  * The label to be displayed by the item.
2757  * Label will be placed at icons bottom (if set).
2758  *
2759  * If a label was passed as argument on item creation, with function
2760  * elm_toolbar_item_append() or similar, it will be already
2761  * displayed by the item.
2762  *
2763  * @see elm_toolbar_item_label_get()
2764  * @see elm_toolbar_item_append()
2765  *
2766  * @deprecated use elm_object_item_text_set() instead
2767  * @ingroup Toolbar
2768  */
2769 EINA_DEPRECATED EAPI void         elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label);
2770
2771 /**
2772  * Return the data associated with a given toolbar widget item.
2773  *
2774  * @param it The toolbar widget item handle.
2775  * @return The data associated with @p item.
2776  *
2777  * @see elm_toolbar_item_data_set()
2778  *
2779  * @deprecated use elm_object_item_data_get() instead.
2780  * @ingroup Toolbar
2781  */
2782 EINA_DEPRECATED EAPI void        *elm_toolbar_item_data_get(const Elm_Object_Item *it);
2783
2784 /**
2785  * Set the data associated with a given toolbar widget item.
2786  *
2787  * @param it The toolbar widget item handle
2788  * @param data The new data pointer to set to @p item.
2789  *
2790  * This sets new item data on @p item.
2791  *
2792  * @warning The old data pointer won't be touched by this function, so
2793  * the user had better to free that old data himself/herself.
2794  *
2795  * @deprecated use elm_object_item_data_set() instead.
2796  * @ingroup Toolbar
2797  */
2798 EINA_DEPRECATED EAPI void         elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data);
2799
2800 /**
2801  * Get a value whether toolbar item is disabled or not.
2802  *
2803  * @param it The item.
2804  * @return The disabled state.
2805  *
2806  * @see elm_toolbar_item_disabled_set() for more details.
2807  *
2808  * @deprecated use elm_object_item_disabled_get() instead.
2809  * @ingroup Toolbar
2810  */
2811 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_item_disabled_get(const Elm_Object_Item *it);
2812
2813 /**
2814  * Sets the disabled/enabled state of a toolbar item.
2815  *
2816  * @param it The item.
2817  * @param disabled The disabled state.
2818  *
2819  * A disabled item cannot be selected or unselected. It will also
2820  * change its appearance (generally greyed out). This sets the
2821  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
2822  * enabled).
2823  *
2824  * @deprecated use elm_object_item_disabled_set() instead.
2825  * @ingroup Toolbar
2826  */
2827 EINA_DEPRECATED EAPI void         elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
2828
2829 /**
2830  * Change a toolbar's orientation
2831  * @param obj The toolbar object
2832  * @param vertical If @c EINA_TRUE, the toolbar is vertical
2833  * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar.
2834  * @ingroup Toolbar
2835  * @deprecated use elm_toolbar_horizontal_set() instead.
2836  */
2837 EINA_DEPRECATED EAPI void         elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical);
2838
2839 /**
2840  * Get a toolbar's orientation
2841  * @param obj The toolbar object
2842  * @return If @c EINA_TRUE, the toolbar is vertical
2843  * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical.
2844  * @ingroup Toolbar
2845  * @deprecated use elm_toolbar_horizontal_get() instead.
2846  */
2847 EINA_DEPRECATED EAPI Eina_Bool    elm_toolbar_orientation_get(const Evas_Object *obj);
2848
2849 /**
2850  * Set the function called when a toolbar item is freed.
2851  *
2852  * @param it The item to set the callback on.
2853  * @param func The function called.
2854  *
2855  * If there is a @p func, then it will be called prior item's memory release.
2856  * That will be called with the following arguments:
2857  * @li item's data;
2858  * @li item's Evas object;
2859  * @li item itself;
2860  *
2861  * This way, a data associated to a toolbar item could be properly freed.
2862  *
2863  * @deprecated Use elm_object_item_del_cb_set() instead
2864  * @ingroup Toolbar
2865  */
2866 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
2867
2868 /**
2869  * Delete them item from the toolbar.
2870  *
2871  * @param it The item of toolbar to be deleted.
2872  *
2873  * @deprecated Use elm_object_item_del() instead
2874  * @see elm_toolbar_item_append()
2875  *
2876  * @ingroup Toolbar
2877  */
2878 EINA_DEPRECATED EAPI void                         elm_toolbar_item_del(Elm_Object_Item *it);
2879
2880 /**
2881  * Set the text to be shown in a given toolbar item's tooltips.
2882  *
2883  * @param it toolbar item.
2884  * @param text The text to set in the content.
2885  *
2886  * Setup the text as tooltip to object. The item can have only one tooltip,
2887  * so any previous tooltip data - set with this function or
2888  * elm_toolbar_item_tooltip_content_cb_set() - is removed.
2889  *
2890  * @deprecated Use elm_object_item_tooltip_text_set() instead
2891  * @see elm_object_tooltip_text_set() for more details.
2892  *
2893  * @ingroup Toolbar
2894  */
2895 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
2896
2897 /**
2898  * Set the content to be shown in the tooltip item.
2899  *
2900  * Setup the tooltip to item. The item can have only one tooltip,
2901  * so any previous tooltip data is removed. @p func(with @p data) will
2902  * be called every time that need show the tooltip and it should
2903  * return a valid Evas_Object. This object is then managed fully by
2904  * tooltip system and is deleted when the tooltip is gone.
2905  *
2906  * @param it the toolbar item being attached a tooltip.
2907  * @param func the function used to create the tooltip contents.
2908  * @param data what to provide to @a func as callback data/context.
2909  * @param del_cb called when data is not needed anymore, either when
2910  *        another callback replaces @a func, the tooltip is unset with
2911  *        elm_toolbar_item_tooltip_unset() or the owner @a item
2912  *        dies. This callback receives as the first parameter the
2913  *        given @a data, and @c event_info is the item.
2914  *
2915  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
2916  * @see elm_object_tooltip_content_cb_set() for more details.
2917  *
2918  * @ingroup Toolbar
2919  */
2920 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);
2921
2922 /**
2923  * Unset tooltip from item.
2924  *
2925  * @param it toolbar item to remove previously set tooltip.
2926  *
2927  * Remove tooltip from item. The callback provided as del_cb to
2928  * elm_toolbar_item_tooltip_content_cb_set() will be called to notify
2929  * it is not used anymore.
2930  *
2931  * @deprecated Use elm_object_item_tooltip_unset() instead
2932  * @see elm_object_tooltip_unset() for more details.
2933  * @see elm_toolbar_item_tooltip_content_cb_set()
2934  *
2935  * @ingroup Toolbar
2936  */
2937 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_unset(Elm_Object_Item *it);
2938
2939 /**
2940  * Sets a different style for this item tooltip.
2941  *
2942  * @note before you set a style you should define a tooltip with
2943  *       elm_toolbar_item_tooltip_content_cb_set() or
2944  *       elm_toolbar_item_tooltip_text_set()
2945  *
2946  * @param it toolbar item with tooltip already set.
2947  * @param style the theme style to use (default, transparent, ...)
2948  *
2949  * @deprecated Use elm_object_item_tooltip_style_set() instead
2950  * @see elm_object_tooltip_style_set() for more details.
2951  *
2952  * @ingroup Toolbar
2953  */
2954 EINA_DEPRECATED EAPI void                         elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
2955
2956 /**
2957  * Get the style for this item tooltip.
2958  *
2959  * @param it toolbar item with tooltip already set.
2960  * @return style the theme style in use, defaults to "default". If the
2961  *         object does not have a tooltip set, then NULL is returned.
2962  *
2963  * @deprecated Use elm_object_item_style_get() instead
2964  * @see elm_object_tooltip_style_get() for more details.
2965  * @see elm_toolbar_item_tooltip_style_set()
2966  *
2967  * @ingroup Toolbar
2968  */
2969 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it);
2970
2971 /**
2972  * Set the type of mouse pointer/cursor decoration to be shown,
2973  * when the mouse pointer is over the given toolbar widget item
2974  *
2975  * @param it toolbar item to customize cursor on
2976  * @param cursor the cursor type's name
2977  *
2978  * This function works analogously as elm_object_cursor_set(), but
2979  * here the cursor's changing area is restricted to the item's
2980  * area, and not the whole widget's. Note that that item cursors
2981  * have precedence over widget cursors, so that a mouse over an
2982  * item with custom cursor set will always show @b that cursor.
2983  *
2984  * If this function is called twice for an object, a previously set
2985  * cursor will be unset on the second call.
2986  *
2987  * @see elm_object_cursor_set()
2988  * @see elm_toolbar_item_cursor_get()
2989  * @see elm_toolbar_item_cursor_unset()
2990  *
2991  * @deprecated use elm_object_item_cursor_set() instead
2992  *
2993  * @ingroup Toolbar
2994  */
2995 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor);
2996
2997 /*
2998  * Get the type of mouse pointer/cursor decoration set to be shown,
2999  * when the mouse pointer is over the given toolbar widget item
3000  *
3001  * @param it toolbar item with custom cursor set
3002  * @return the cursor type's name or @c NULL, if no custom cursors
3003  * were set to @p item (and on errors)
3004  *
3005  * @see elm_object_cursor_get()
3006  * @see elm_toolbar_item_cursor_set()
3007  * @see elm_toolbar_item_cursor_unset()
3008  *
3009  * @deprecated Use elm_object_item_cursor_get() instead
3010  *
3011  * @ingroup Toolbar
3012  */
3013 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_get(const Elm_Object_Item *it);
3014
3015 /**
3016  * Unset any custom mouse pointer/cursor decoration set to be
3017  * shown, when the mouse pointer is over the given toolbar widget
3018  * item, thus making it show the @b default cursor again.
3019  *
3020  * @param it a toolbar item
3021  *
3022  * Use this call to undo any custom settings on this item's cursor
3023  * decoration, bringing it back to defaults (no custom style set).
3024  *
3025  * @see elm_object_cursor_unset()
3026  * @see elm_toolbar_item_cursor_set()
3027  *
3028  * @deprecated Use elm_object_item_cursor_unset() instead
3029  *
3030  * @ingroup Toolbar
3031  */
3032 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_unset(Elm_Object_Item *it);
3033
3034 /**
3035  * Set a different @b style for a given custom cursor set for a
3036  * toolbar item.
3037  *
3038  * @param it toolbar item with custom cursor set
3039  * @param style the <b>theme style</b> to use (e.g. @c "default",
3040  * @c "transparent", etc)
3041  *
3042  * This function only makes sense when one is using custom mouse
3043  * cursor decorations <b>defined in a theme file</b>, which can have,
3044  * given a cursor name/type, <b>alternate styles</b> on it. It
3045  * works analogously as elm_object_cursor_style_set(), but here
3046  * applies only to toolbar item objects.
3047  *
3048  * @warning Before you set a cursor style you should have defined a
3049  *       custom cursor previously on the item, with
3050  *       elm_toolbar_item_cursor_set()
3051  *
3052  * @see elm_toolbar_item_cursor_engine_only_set()
3053  * @see elm_toolbar_item_cursor_style_get()
3054  *
3055  * @deprecated Use elm_object_item_cursor_style_set() instead
3056  *
3057  * @ingroup Toolbar
3058  */
3059 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3060
3061 /**
3062  * Get the current @b style set for a given toolbar item's custom
3063  * cursor
3064  *
3065  * @param it toolbar item with custom cursor set.
3066  * @return style the cursor style in use. If the object does not
3067  *         have a cursor set, then @c NULL is returned.
3068  *
3069  * @see elm_toolbar_item_cursor_style_set() for more details
3070  *
3071  * @deprecated Use elm_object_item_cursor_style_get() instead
3072  *
3073  * @ingroup Toolbar
3074  */
3075 EINA_DEPRECATED EAPI const char                  *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it);
3076
3077 /**
3078  * Set if the (custom)cursor for a given toolbar item should be
3079  * searched in its theme, also, or should only rely on the
3080  * rendering engine.
3081  *
3082  * @param it item with custom (custom) cursor already set on
3083  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3084  * only on those provided by the rendering engine, @c EINA_FALSE to
3085  * have them searched on the widget's theme, as well.
3086  *
3087  * @note This call is of use only if you've set a custom cursor
3088  * for toolbar items, with elm_toolbar_item_cursor_set().
3089  *
3090  * @note By default, cursors will only be looked for between those
3091  * provided by the rendering engine.
3092  *
3093  * @deprecated Use elm_object_item_cursor_engine_only_set() instead
3094  *
3095  * @ingroup Toolbar
3096  */
3097 EINA_DEPRECATED EAPI void                         elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3098
3099 /**
3100  * Get if the (custom) cursor for a given toolbar item is being
3101  * searched in its theme, also, or is only relying on the rendering
3102  * engine.
3103  *
3104  * @param it a toolbar item
3105  * @return @c EINA_TRUE, if cursors are being looked for only on
3106  * those provided by the rendering engine, @c EINA_FALSE if they
3107  * are being searched on the widget's theme, as well.
3108  *
3109  * @see elm_toolbar_item_cursor_engine_only_set(), for more details
3110  *
3111  * @deprecated Use elm_object_item_cursor_engine_only_get() instead
3112  *
3113  * @ingroup Toolbar
3114  */
3115 EINA_DEPRECATED EAPI Eina_Bool                    elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it);
3116
3117 /**
3118  * @brief Link a Elm_Payer with an Elm_Video object.
3119  *
3120  * @param player the Elm_Player object.
3121  * @param video The Elm_Video object.
3122  *
3123  * This mean that action on the player widget will affect the
3124  * video object and the state of the video will be reflected in
3125  * the player itself.
3126  *
3127  * @see elm_player_add()
3128  * @see elm_video_add()
3129  * @deprecated use elm_object_part_content_set() instead
3130  *
3131  * @ingroup Video
3132  */
3133 EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video);
3134
3135 /**
3136  * Set the label of item.
3137  *
3138  * @param it The item of segment control.
3139  * @param label The label of item.
3140  *
3141  * The label to be displayed by the item.
3142  * Label will be at right of the icon (if set).
3143  *
3144  * If a label was passed as argument on item creation, with function
3145  * elm_control_segment_item_add(), it will be already
3146  * displayed by the item.
3147  *
3148  * @see elm_segment_control_item_label_get()
3149  * @see elm_segment_control_item_add()
3150  * @deprecated Use elm_object_item_text_set() instead
3151  *
3152  * @ingroup SegmentControl
3153  */
3154 EINA_DEPRECATED EAPI void              elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label);
3155
3156
3157 /**
3158  * Set the icon associated to the item.
3159  *
3160  * @param it The segment control item.
3161  * @param icon The icon object to associate with @p it.
3162  *
3163  * The icon object to use at left side of the item. An
3164  * icon can be any Evas object, but usually it is an icon created
3165  * with elm_icon_add().
3166  *
3167  * Once the icon object is set, a previously set one will be deleted.
3168  * @warning Setting the same icon for two items will cause the icon to
3169  * disappear from the first item.
3170  *
3171  * If an icon was passed as argument on item creation, with function
3172  * elm_segment_control_item_add(), it will be already
3173  * associated to the item.
3174  *
3175  * @see elm_segment_control_item_add()
3176  * @see elm_segment_control_item_icon_get()
3177  * @deprecated Use elm_object_item_part_content_set() instead
3178  *
3179  * @ingroup SegmentControl
3180  */
3181 EINA_DEPRECATED EAPI void              elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3182
3183 /**
3184  * Remove a segment control item from its parent, deleting it.
3185  *
3186  * @param it The item to be removed.
3187  *
3188  * Items can be added with elm_segment_control_item_add() or
3189  * elm_segment_control_item_insert_at().
3190  *
3191  * @deprecated Use elm_object_item_del() instead
3192  * @ingroup SegmentControl
3193  */
3194 EINA_DEPRECATED EAPI void              elm_segment_control_item_del(Elm_Object_Item *it);
3195
3196 /**
3197  * Get the label
3198  *
3199  * @param obj The multibuttonentry object
3200  * @return The label, or NULL if none
3201  *
3202  * @deprecated Use elm_object_text_get() instead
3203  *
3204  */
3205 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_label_get(const Evas_Object *obj);
3206
3207 /**
3208  * Set the label
3209  *
3210  * @param obj The multibuttonentry object
3211  * @param label The text label string
3212  *
3213  * @deprecated Use elm_object_text_set() instead
3214  *
3215  */
3216 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_label_set(Evas_Object *obj, const char *label);
3217
3218 /**
3219  * Get the label of a given item
3220  *
3221  * @param it The item
3222  * @return The label of a given item, or NULL if none
3223  *
3224  * @deprecated Use elm_object_item_text_get() instead
3225  *
3226  */
3227 EINA_DEPRECATED EAPI const char                *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it);
3228
3229 /**
3230  * Set the label of a given item
3231  *
3232  * @param it The item
3233  * @param str The text label string
3234  *
3235  * @deprecated Use elm_object_item_text_set() instead
3236  */
3237 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str);
3238
3239 /**
3240  * Delete a given item
3241  *
3242  * @param it The item
3243  *
3244  * @deprecated Use elm_object_item_del() instead
3245  *
3246  */
3247 EINA_DEPRECATED EAPI void                       elm_multibuttonentry_item_del(Elm_Object_Item *it);
3248
3249 /**
3250  * @brief Delete the given item instantly.
3251  *
3252  * @param it The naviframe item
3253  *
3254  * This just deletes the given item from the naviframe item list instantly.
3255  * So this would not emit any signals for view transitions but just change
3256  * the current view if the given item is a top one.
3257  *
3258  * @deprecated Use elm_object_item_del() instead
3259  * @ingroup Naviframe
3260  */
3261 EINA_DEPRECATED EAPI void             elm_naviframe_item_del(Elm_Object_Item *it);
3262
3263
3264
3265 /**
3266  * Sets the disabled/enabled state of a list item.
3267  *
3268  * @param it The item.
3269  * @param disabled The disabled state.
3270  *
3271  * A disabled item cannot be selected or unselected. It will also
3272  * change its appearance (generally greyed out). This sets the
3273  * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for
3274  * enabled).
3275  *
3276  * @deprecated Use elm_object_item_disabled_set() instead
3277  *
3278  * @ingroup List
3279  */
3280 EINA_DEPRECATED EAPI void                         elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3281
3282 /**
3283  * Get a value whether list item is disabled or not.
3284  *
3285  * @param it The item.
3286  * @return The disabled state.
3287  *
3288  * @see elm_list_item_disabled_set() for more details.
3289  *
3290  * @deprecated Use elm_object_item_disabled_get() instead
3291  *
3292  * @ingroup List
3293  */
3294 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_disabled_get(const Elm_Object_Item *it);
3295
3296 /**
3297  * Set the function called when a list item is freed.
3298  *
3299  * @param it The item to set the callback on
3300  * @param func The function called
3301  *
3302  * If there is a @p func, then it will be called prior item's memory release.
3303  * That will be called with the following arguments:
3304  * @li item's data;
3305  * @li item's Evas object;
3306  * @li item itself;
3307  *
3308  * This way, a data associated to a list item could be properly freed.
3309  *
3310  * @deprecated Please use elm_object_item_del_cb_set() instead.
3311  *
3312  * @ingroup List
3313  */
3314 EINA_DEPRECATED EAPI void                         elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func);
3315
3316 /**
3317  * Get the data associated to the item.
3318  *
3319  * @param it The list item
3320  * @return The data associated to @p item
3321  *
3322  * The return value is a pointer to data associated to @p item when it was
3323  * created, with function elm_list_item_append() or similar. If no data
3324  * was passed as argument, it will return @c NULL.
3325  *
3326  * @see elm_list_item_append()
3327  *
3328  * @deprecated Please use elm_object_item_data_get() instead.
3329  *
3330  * @ingroup List
3331  */
3332 EINA_DEPRECATED EAPI void                        *elm_list_item_data_get(const Elm_Object_Item *it);
3333
3334 /**
3335  * Get the left side icon associated to the item.
3336  *
3337  * @param it The list item
3338  * @return The left side icon associated to @p item
3339  *
3340  * The return value is a pointer to the icon associated to @p item when
3341  * it was
3342  * created, with function elm_list_item_append() or similar, or later
3343  * with function elm_list_item_icon_set(). If no icon
3344  * was passed as argument, it will return @c NULL.
3345  *
3346  * @see elm_list_item_append()
3347  * @see elm_list_item_icon_set()
3348  *
3349  * @deprecated Please use elm_object_item_part_content_get(item, NULL);
3350  * @ingroup List
3351  */
3352 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_icon_get(const Elm_Object_Item *it);
3353
3354 /**
3355  * Set the left side icon associated to the item.
3356  *
3357  * @param it The list item
3358  * @param icon The left side icon object to associate with @p item
3359  *
3360  * The icon object to use at left side of the item. An
3361  * icon can be any Evas object, but usually it is an icon created
3362  * with elm_icon_add().
3363  *
3364  * Once the icon object is set, a previously set one will be deleted.
3365  * @warning Setting the same icon for two items will cause the icon to
3366  * disappear from the first item.
3367  *
3368  * If an icon was passed as argument on item creation, with function
3369  * elm_list_item_append() or similar, it will be already
3370  * associated to the item.
3371  *
3372  * @see elm_list_item_append()
3373  * @see elm_list_item_icon_get()
3374  *
3375  * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon);
3376  * @ingroup List
3377  */
3378 EINA_DEPRECATED EAPI void                         elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon);
3379
3380 /**
3381  * Get the right side icon associated to the item.
3382  *
3383  * @param it The list item
3384  * @return The right side icon associated to @p item
3385  *
3386  * The return value is a pointer to the icon associated to @p item when
3387  * it was
3388  * created, with function elm_list_item_append() or similar, or later
3389  * with function elm_list_item_icon_set(). If no icon
3390  * was passed as argument, it will return @c NULL.
3391  *
3392  * @see elm_list_item_append()
3393  * @see elm_list_item_icon_set()
3394  *
3395  * @deprecated Please use elm_object_item_part_content_get(item, "end");
3396  * @ingroup List
3397  */
3398 EINA_DEPRECATED EAPI Evas_Object                 *elm_list_item_end_get(const Elm_Object_Item *it);
3399
3400 /**
3401  * Set the right side icon associated to the item.
3402  *
3403  * @param it The list item
3404  * @param end The right side icon object to associate with @p item
3405  *
3406  * The icon object to use at right side of the item. An
3407  * icon can be any Evas object, but usually it is an icon created
3408  * with elm_icon_add().
3409  *
3410  * Once the icon object is set, a previously set one will be deleted.
3411  * @warning Setting the same icon for two items will cause the icon to
3412  * disappear from the first item.
3413  *
3414  * If an icon was passed as argument on item creation, with function
3415  * elm_list_item_append() or similar, it will be already
3416  * associated to the item.
3417  *
3418  * @see elm_list_item_append()
3419  * @see elm_list_item_end_get()
3420  *
3421  * @deprecated Please use elm_object_item_part_content_set(item, "end", end);
3422  * @ingroup List
3423  */
3424 EINA_DEPRECATED EAPI void                         elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end);
3425
3426 /**
3427  * Get the label of item.
3428  *
3429  * @param it The item of list.
3430  * @return The label of item.
3431  *
3432  * The return value is a pointer to the label associated to @p item when
3433  * it was created, with function elm_list_item_append(), or later
3434  * with function elm_list_item_label_set. If no label
3435  * was passed as argument, it will return @c NULL.
3436  *
3437  * @see elm_list_item_label_set() for more details.
3438  * @see elm_list_item_append()
3439  *
3440  * @deprecated Please use elm_object_item_text_get(item);
3441  * @ingroup List
3442  */
3443 EINA_DEPRECATED EAPI const char                  *elm_list_item_label_get(const Elm_Object_Item *it);
3444
3445 /**
3446  * Set the label of item.
3447  *
3448  * @param it The item of list.
3449  * @param text The label of item.
3450  *
3451  * The label to be displayed by the item.
3452  * Label will be placed between left and right side icons (if set).
3453  *
3454  * If a label was passed as argument on item creation, with function
3455  * elm_list_item_append() or similar, it will be already
3456  * displayed by the item.
3457  *
3458  * @see elm_list_item_label_get()
3459  * @see elm_list_item_append()
3460  *
3461  * @deprecated Please use elm_object_item_text_set(item, text);
3462  * @ingroup List
3463  */
3464 EINA_DEPRECATED EAPI void                         elm_list_item_label_set(Elm_Object_Item *it, const char *text);
3465
3466 /**
3467  * Set the text to be shown in a given list item's tooltips.
3468  *
3469  * @param it Target item.
3470  * @param text The text to set in the content.
3471  *
3472  * Setup the text as tooltip to object. The item can have only one tooltip,
3473  * so any previous tooltip data - set with this function or
3474  * elm_list_item_tooltip_content_cb_set() - is removed.
3475  *
3476  * @deprecated Use elm_object_item_tooltip_text_set() instead
3477  * @see elm_object_tooltip_text_set() for more details.
3478  *
3479  * @ingroup List
3480  */
3481 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text);
3482
3483 /**
3484  * @brief Disable size restrictions on an object's tooltip
3485  * @param it The tooltip's anchor object
3486  * @param disable If EINA_TRUE, size restrictions are disabled
3487  * @return EINA_FALSE on failure, EINA_TRUE on success
3488  *
3489  * This function allows a tooltip to expand beyond its parent window's canvas.
3490  * It will instead be limited only by the size of the display.
3491  *
3492  * @deprecated Use elm_object_item_tooltip_window_mode_set() instead
3493  *
3494  */
3495 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable);
3496
3497 /**
3498  * @brief Retrieve size restriction state of an object's tooltip
3499  * @param obj The tooltip's anchor object
3500  * @return If EINA_TRUE, size restrictions are disabled
3501  *
3502  * This function returns whether a tooltip is allowed to expand beyond
3503  * its parent window's canvas.
3504  * It will instead be limited only by the size of the display.
3505  *
3506  * @deprecated Use elm_object_item_tooltip_window_mode_get() instead
3507  *
3508  */
3509 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it);
3510
3511 /**
3512  * Set the content to be shown in the tooltip item.
3513  *
3514  * Setup the tooltip to item. The item can have only one tooltip,
3515  * so any previous tooltip data is removed. @p func(with @p data) will
3516  * be called every time that need show the tooltip and it should
3517  * return a valid Evas_Object. This object is then managed fully by
3518  * tooltip system and is deleted when the tooltip is gone.
3519  *
3520  * @param it the list item being attached a tooltip.
3521  * @param func the function used to create the tooltip contents.
3522  * @param data what to provide to @a func as callback data/context.
3523  * @param del_cb called when data is not needed anymore, either when
3524  *        another callback replaces @a func, the tooltip is unset with
3525  *        elm_list_item_tooltip_unset() or the owner @a item
3526  *        dies. This callback receives as the first parameter the
3527  *        given @a data, and @c event_info is the item.
3528  *
3529  * @deprecated Use elm_object_item_tooltip_content_cb_set() instead
3530  *
3531  * @see elm_object_tooltip_content_cb_set() for more details.
3532  *
3533  * @ingroup List
3534  */
3535 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);
3536
3537 /**
3538  * Unset tooltip from item.
3539  *
3540  * @param it list item to remove previously set tooltip.
3541  *
3542  * Remove tooltip from item. The callback provided as del_cb to
3543  * elm_list_item_tooltip_content_cb_set() will be called to notify
3544  * it is not used anymore.
3545  *
3546  * @deprecated Use elm_object_item_tooltip_unset() instead
3547  * @see elm_object_tooltip_unset() for more details.
3548  * @see elm_list_item_tooltip_content_cb_set()
3549  *
3550  * @ingroup List
3551  */
3552 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_unset(Elm_Object_Item *it);
3553
3554 /**
3555  * Sets a different style for this item tooltip.
3556  *
3557  * @note before you set a style you should define a tooltip with
3558  *       elm_list_item_tooltip_content_cb_set() or
3559  *       elm_list_item_tooltip_text_set()
3560  *
3561  * @param it list item with tooltip already set.
3562  * @param style the theme style to use (default, transparent, ...)
3563  *
3564  *
3565  * @deprecated Use elm_object_item_tooltip_style_set() instead
3566  * @see elm_object_tooltip_style_set() for more details.
3567  *
3568  * @ingroup List
3569  */
3570 EINA_DEPRECATED EAPI void                         elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style);
3571
3572 /**
3573  * Get the style for this item tooltip.
3574  *
3575  * @param it list item with tooltip already set.
3576  * @return style the theme style in use, defaults to "default". If the
3577  *         object does not have a tooltip set, then NULL is returned.
3578  *
3579  * @deprecated Use elm_object_item_tooltip_style_get() instead
3580  *
3581  * @see elm_object_tooltip_style_get() for more details.
3582  * @see elm_list_item_tooltip_style_set()
3583  *
3584  * @ingroup List
3585  */
3586 EINA_DEPRECATED EAPI const char                  *elm_list_item_tooltip_style_get(const Elm_Object_Item *it);
3587
3588 /**
3589  * Set the type of mouse pointer/cursor decoration to be shown,
3590  * when the mouse pointer is over the given list widget item
3591  *
3592  * @param it list item to customize cursor on
3593  * @param cursor the cursor type's name
3594  *
3595  * This function works analogously as elm_object_cursor_set(), but
3596  * here the cursor's changing area is restricted to the item's
3597  * area, and not the whole widget's. Note that that item cursors
3598  * have precedence over widget cursors, so that a mouse over an
3599  * item with custom cursor set will always show @b that cursor.
3600  *
3601  * If this function is called twice for an object, a previously set
3602  * cursor will be unset on the second call.
3603  *
3604  * @see elm_object_cursor_set()
3605  * @see elm_list_item_cursor_get()
3606  * @see elm_list_item_cursor_unset()
3607  *
3608  * @deprecated Please use elm_object_item_cursor_set() instead
3609  * @ingroup List
3610  */
3611 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor);
3612
3613 /*
3614  * Get the type of mouse pointer/cursor decoration set to be shown,
3615  * when the mouse pointer is over the given list widget item
3616  *
3617  * @param it list item with custom cursor set
3618  * @return the cursor type's name or @c NULL, if no custom cursors
3619  * were set to @p item (and on errors)
3620  *
3621  * @see elm_object_cursor_get()
3622  * @see elm_list_item_cursor_set()
3623  * @see elm_list_item_cursor_unset()
3624  *
3625  * @deprecated Please use elm_object_item_cursor_get() instead
3626  * @ingroup List
3627  */
3628 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_get(const Elm_Object_Item *it);
3629
3630 /**
3631  * Unset any custom mouse pointer/cursor decoration set to be
3632  * shown, when the mouse pointer is over the given list widget
3633  * item, thus making it show the @b default cursor again.
3634  *
3635  * @param it a list item
3636  *
3637  * Use this call to undo any custom settings on this item's cursor
3638  * decoration, bringing it back to defaults (no custom style set).
3639  *
3640  * @see elm_object_cursor_unset()
3641  * @see elm_list_item_cursor_set()
3642  *
3643  * @deprecated Please use elm_list_item_cursor_unset() instead
3644  * @ingroup List
3645  */
3646 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_unset(Elm_Object_Item *it);
3647
3648 /**
3649  * Set a different @b style for a given custom cursor set for a
3650  * list item.
3651  *
3652  * @param it list item with custom cursor set
3653  * @param style the <b>theme style</b> to use (e.g. @c "default",
3654  * @c "transparent", etc)
3655  *
3656  * This function only makes sense when one is using custom mouse
3657  * cursor decorations <b>defined in a theme file</b>, which can have,
3658  * given a cursor name/type, <b>alternate styles</b> on it. It
3659  * works analogously as elm_object_cursor_style_set(), but here
3660  * applies only to list item objects.
3661  *
3662  * @warning Before you set a cursor style you should have defined a
3663  *       custom cursor previously on the item, with
3664  *       elm_list_item_cursor_set()
3665  *
3666  * @see elm_list_item_cursor_engine_only_set()
3667  * @see elm_list_item_cursor_style_get()
3668  *
3669  * @deprecated Please use elm_list_item_cursor_style_set() instead
3670  * @ingroup List
3671  */
3672 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style);
3673
3674 /**
3675  * Get the current @b style set for a given list item's custom
3676  * cursor
3677  *
3678  * @param it list item with custom cursor set.
3679  * @return style the cursor style in use. If the object does not
3680  *         have a cursor set, then @c NULL is returned.
3681  *
3682  * @see elm_list_item_cursor_style_set() for more details
3683  *
3684  * @deprecated Please use elm_list_item_cursor_style_get() instead
3685  * @ingroup List
3686  */
3687 EINA_DEPRECATED EAPI const char                  *elm_list_item_cursor_style_get(const Elm_Object_Item *it);
3688
3689 /**
3690  * Set if the (custom)cursor for a given list item should be
3691  * searched in its theme, also, or should only rely on the
3692  * rendering engine.
3693  *
3694  * @param it item with custom (custom) cursor already set on
3695  * @param engine_only Use @c EINA_TRUE to have cursors looked for
3696  * only on those provided by the rendering engine, @c EINA_FALSE to
3697  * have them searched on the widget's theme, as well.
3698  *
3699  * @note This call is of use only if you've set a custom cursor
3700  * for list items, with elm_list_item_cursor_set().
3701  *
3702  * @note By default, cursors will only be looked for between those
3703  * provided by the rendering engine.
3704  *
3705  * @deprecated Please use elm_list_item_cursor_engine_only_set() instead
3706  * @ingroup List
3707  */
3708 EINA_DEPRECATED EAPI void                         elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only);
3709
3710 /**
3711  * Get if the (custom) cursor for a given list item is being
3712  * searched in its theme, also, or is only relying on the rendering
3713  * engine.
3714  *
3715  * @param it a list item
3716  * @return @c EINA_TRUE, if cursors are being looked for only on
3717  * those provided by the rendering engine, @c EINA_FALSE if they
3718  * are being searched on the widget's theme, as well.
3719  *
3720  * @see elm_list_item_cursor_engine_only_set(), for more details
3721  *
3722  * @deprecated Please use elm_list_item_cursor_engine_only_get() instead
3723  * @ingroup List
3724  */
3725 EINA_DEPRECATED EAPI Eina_Bool                    elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it);
3726
3727 /**
3728  * Delete the item from the list.
3729  *
3730  * @param it The item of list to be deleted.
3731  *
3732  * If deleting all list items is required, elm_list_clear()
3733  * should be used instead of getting items list and deleting each one.
3734  *
3735  * @see elm_list_clear()
3736  * @see elm_list_item_append()
3737  * @see elm_widget_item_del_cb_set()
3738  * @deprecated Use elm_object_item_del() instead
3739  *
3740  * @ingroup List
3741  */
3742 EINA_DEPRECATED EAPI void                         elm_list_item_del(Elm_Object_Item *it);
3743
3744 /**
3745  * Set the shrink state of toolbar @p obj.
3746  *
3747  * @param obj The toolbar object.
3748  * @param shrink_mode Toolbar's items display behavior.
3749  *
3750  * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE,
3751  * but will enforce a minimum size so all the items will fit, won't scroll
3752  * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE,
3753  * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to
3754  * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU.
3755  *
3756  * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode);
3757  * @ingroup Toolbar
3758  */
3759 EINA_DEPRECATED EAPI void                         elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode);
3760
3761 /**
3762  * Get the shrink mode of toolbar @p obj.
3763  *
3764  * @param obj The toolbar object.
3765  * @return Toolbar's items display behavior.
3766  *
3767  * @see elm_toolbar_shrink_mode_set() for details.
3768  *
3769  * @deprecated Please use elm_toolbar_shrink_mode_get(obj);
3770  * @ingroup Toolbar
3771  */
3772 EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode      elm_toolbar_mode_shrink_get(const Evas_Object *obj);
3773
3774 /**
3775  * This sets a widget to be displayed to the left of a scrolled entry.
3776  *
3777  * @param obj The scrolled entry object
3778  * @param icon The widget to display on the left side of the scrolled
3779  * entry.
3780  *
3781  * @note A previously set widget will be destroyed.
3782  * @note If the object being set does not have minimum size hints set,
3783  * it won't get properly displayed.
3784  *
3785  * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead
3786  * @see elm_entry_end_set()
3787  */
3788 EINA_DEPRECATED EAPI void               elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon);
3789
3790 /**
3791  * Gets the leftmost widget of the scrolled entry. This object is
3792  * owned by the scrolled entry and should not be modified.
3793  *
3794  * @param obj The scrolled entry object
3795  * @return the left widget inside the scroller
3796  *
3797  * @deprecated Use elm_object_part_content_get(entry, "icon") instead
3798  */
3799 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_get(const Evas_Object *obj);
3800
3801 /**
3802  * Unset the leftmost widget of the scrolled entry, unparenting and
3803  * returning it.
3804  *
3805  * @param obj The scrolled entry object
3806  * @return the previously set icon sub-object of this entry, on
3807  * success.
3808  *
3809  * @deprecated Use elm_object_part_content_unset(entry, "icon") instead
3810  * @see elm_entry_icon_set()
3811  */
3812 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_icon_unset(Evas_Object *obj);
3813
3814 /**
3815  * This sets a widget to be displayed to the end of a scrolled entry.
3816  *
3817  * @param obj The scrolled entry object
3818  * @param end The widget to display on the right side of the scrolled
3819  * entry.
3820  *
3821  * @note A previously set widget will be destroyed.
3822  * @note If the object being set does not have minimum size hints set,
3823  * it won't get properly displayed.
3824  *
3825  * @deprecated Use elm_object_part_content_set(entry, "end", content) instead
3826  * @see elm_entry_icon_set
3827  */
3828 EINA_DEPRECATED EAPI void               elm_entry_end_set(Evas_Object *obj, Evas_Object *end);
3829
3830 /**
3831  * Gets the endmost widget of the scrolled entry. This object is owned
3832  * by the scrolled entry and should not be modified.
3833  *
3834  * @param obj The scrolled entry object
3835  * @return the right widget inside the scroller
3836  *
3837  * @deprecated Use elm_object_part_content_get(entry, "end") instead
3838  */
3839 EAPI Evas_Object       *elm_entry_end_get(const Evas_Object *obj);
3840
3841 /**
3842  * Unset the endmost widget of the scrolled entry, unparenting and
3843  * returning it.
3844  *
3845  * @param obj The scrolled entry object
3846  * @return the previously set icon sub-object of this entry, on
3847  * success.
3848  *
3849  * @deprecated Use elm_object_part_content_unset(entry, "end") instead
3850  * @see elm_entry_icon_set()
3851  */
3852 EINA_DEPRECATED EAPI Evas_Object       *elm_entry_end_unset(Evas_Object *obj);
3853
3854 /**
3855  * Convert a pixel coordinate into a rotated pixel coordinate.
3856  *
3857  * @param obj The map object.
3858  * @param x horizontal coordinate of the point to rotate.
3859  * @param y vertical coordinate of the point to rotate.
3860  * @param cx rotation's center horizontal position.
3861  * @param cy rotation's center vertical position.
3862  * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis.
3863  * @param xx Pointer where to store rotated x.
3864  * @param yy Pointer where to store rotated y.
3865  *
3866  * @ingroup Map
3867  * @deprecated Rotation is not needed to know. Use elm_map_canvas_to_geo_convert() instead
3868  */
3869 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);
3870
3871 /**
3872  * Get the gengrid object's handle which contains a given gengrid item
3873  *
3874  * @param it The item to fetch the container from
3875  * @return The gengrid (parent) object
3876  *
3877  * This returns the gengrid object itself that an item belongs to.
3878  *
3879  * @deprecated Use elm_object_item_widget_get() instead
3880  * @ingroup Gengrid
3881  */
3882 EINA_DEPRECATED EAPI Evas_Object                  *elm_gengrid_item_gengrid_get(const Elm_Object_Item *it);
3883
3884 /**
3885  * Return the data associated to a given gengrid item
3886  *
3887  * @param it The gengrid item.
3888  * @return the data associated with this item.
3889  *
3890  * This returns the @c data value passed on the
3891  * elm_gengrid_item_append() and related item addition calls.
3892  *
3893  * @see elm_gengrid_item_append()
3894  * @see elm_gengrid_item_data_set()
3895  * @deprecated Use elm_object_item_data_get() instead
3896  * @ingroup Gengrid
3897  */
3898 EINA_DEPRECATED EAPI void                         *elm_gengrid_item_data_get(const Elm_Object_Item *it);
3899
3900 /**
3901  * Set the data associated with a given gengrid item
3902  *
3903  * @param it The gengrid item
3904  * @param data The data pointer to set on it
3905  *
3906  * This @b overrides the @c data value passed on the
3907  * elm_gengrid_item_append() and related item addition calls. This
3908  * function @b won't call elm_gengrid_item_update() automatically,
3909  * so you'd issue it afterwards if you want to have the item
3910  * updated to reflect the new data.
3911  *
3912  * @see elm_gengrid_item_data_get()
3913  * @see elm_gengrid_item_update()
3914  * @deprecated Use elm_object_item_data_set() instead
3915  *
3916  * @ingroup Gengrid
3917  */
3918 EINA_DEPRECATED EAPI void                          elm_gengrid_item_data_set(Elm_Object_Item *it, const void *data);
3919
3920 /**
3921  * Set whether a given gengrid item is disabled or not.
3922  *
3923  * @param it The gengrid item
3924  * @param disabled Use @c EINA_TRUE, true disable it, @c EINA_FALSE
3925  * to enable it back.
3926  *
3927  * A disabled item cannot be selected or unselected. It will also
3928  * change its appearance, to signal the user it's disabled.
3929  *
3930  * @see elm_gengrid_item_disabled_get()
3931  * @deprecated Use elm_object_item_disabled_set() instead
3932  *
3933  * @ingroup Gengrid
3934  */
3935 EINA_DEPRECATED EAPI void                          elm_gengrid_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled);
3936
3937 /**
3938  * Get whether a given gengrid item is disabled or not.
3939  *
3940  * @param it The gengrid item
3941  * @return @c EINA_TRUE, if it's disabled, @c EINA_FALSE otherwise
3942  * (and on errors).
3943  *
3944  * @see elm_gengrid_item_disabled_set() for more details
3945  * @deprecated Use elm_object_item_disabled_get() instead
3946  *
3947  * @ingroup Gengrid
3948  */
3949 EINA_DEPRECATED EAPI Eina_Bool                     elm_gengrid_item_disabled_get(const Elm_Object_Item *it);
3950
3951 /**
3952  * Remove a gengrid item from its parent, deleting it.
3953  *
3954  * @param it The item to be removed.
3955  * @return @c EINA_TRUE on success or @c EINA_FALSE, otherwise.
3956  *
3957  * @see elm_gengrid_clear(), to remove all items in a gengrid at
3958  * once.
3959  * @deprecated use elm_object_item_del() instead
3960  *
3961  * @ingroup Gengrid
3962  */
3963 EINA_DEPRECATED EAPI void                          elm_gengrid_item_del(Elm_Object_Item *it);
3964
3965 /**
3966  * Get the real Evas object created to implement the view of a
3967  * given gengrid item
3968  *
3969  * @param it The gengrid item.
3970  * @return the Evas object implementing this item's view.
3971  *
3972  * This returns the actual Evas object used to implement the
3973  * specified gengrid item's view. This may be @c NULL, as it may
3974  * not have been created or may have been deleted, at any time, by
3975  * the gengrid. <b>Do not modify this object</b> (move, resize,
3976  * show, hide, etc.), as the gengrid is controlling it. This
3977  * function is for querying, emitting custom signals or hooking
3978  * lower level callbacks for events on that object. Do not delete
3979  * this object under any circumstances.
3980  *
3981  * @see elm_object_item_data_get()
3982  *
3983  * @ingroup Gengrid
3984  */
3985 EINA_DEPRECATED EAPI const Evas_Object            *elm_gengrid_item_object_get(const Elm_Object_Item *it);
3986
3987 /**
3988  * Update the item class of a gengrid item.
3989  *
3990  * This sets another class of the item, changing the way that it is
3991  * displayed. After changing the item class, elm_gengrid_item_update() is
3992  * called on the item @p it.
3993  *
3994  * @param it The gengrid item
3995  * @param gic The gengrid item class describing the function pointers and the item style.
3996  *
3997  * @deprecated Use elm_gengrid_item_item_class_update instead
3998  * @ingroup Gengrid
3999  */
4000 EINA_DEPRECATED EAPI void                          elm_gengrid_item_item_class_set(Elm_Object_Item *it, const Elm_Gengrid_Item_Class *gic);
4001
4002 /**
4003  * Insert an item in a gengrid widget using a user-defined sort function.
4004  *
4005  * @param obj The gengrid object.
4006  * @param gic The item class for the item.
4007  * @param data The item data.
4008  * @param comp User defined comparison function that defines the sort order
4009  *             based on Elm_Gen_Item.
4010  * @param func Convenience function called when the item is selected.
4011  * @param func_data Data to be passed to @p func.
4012  * @return A handle to the item added or @c NULL, on errors.
4013  *
4014  * This inserts an item in the gengrid based on user defined comparison function.
4015  *
4016  * @see elm_gengrid_item_append()
4017  * @see elm_gengrid_item_prepend()
4018  * @see elm_gengrid_item_insert_after()
4019  * @see elm_object_item_del()
4020  * @see elm_gengrid_item_sorted_insert()
4021  *
4022  * @deprecated Use elm_gengrid_item_sorted_insert() instead
4023  * @ingroup Gengrid
4024  */
4025 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);
4026
4027 /**
4028  * Append a filter function for text inserted in the entry
4029  *
4030  * Append the given callback to the list. This functions will be called
4031  * whenever any text is inserted into the entry, with the text to be inserted
4032  * as a parameter. The callback function is free to alter the text in any way
4033  * it wants, but it must remember to free the given pointer and update it.
4034  * If the new text is to be discarded, the function can free it and set its
4035  * text parameter to NULL. This will also prevent any following filters from
4036  * being called.
4037  *
4038  * @param obj The entry object
4039  * @param func The function to use as text filter
4040  * @param data User data to pass to @p func
4041  * @deprecated use elm_entry_markup_filter_append() instead
4042  * @ingroup Entry
4043  */
4044 EINA_DEPRECATED EAPI void               elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4045
4046 /**
4047  * Prepend a filter function for text inserted in the entry
4048  *
4049  * Prepend the given callback to the list. See elm_entry_text_filter_append()
4050  * for more information
4051  *
4052  * @param obj The entry object
4053  * @param func The function to use as text filter
4054  * @param data User data to pass to @p func
4055  * @deprecated use elm_entry_markup_filter_prepend() instead
4056  * @ingroup Entry
4057  */
4058 EINA_DEPRECATED EAPI void               elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4059
4060 /**
4061  * Remove a filter from the list
4062  *
4063  * Removes the given callback from the filter list. See
4064  * elm_entry_text_filter_append() for more information.
4065  *
4066  * @param obj The entry object
4067  * @param func The filter function to remove
4068  * @param data The user data passed when adding the function
4069  * @deprecated use elm_entry_markup_filter_remove() instead
4070  * @ingroup Entry
4071  */
4072 EINA_DEPRECATED EAPI void               elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
4073
4074 /**
4075  * @brief Set the front content of the flip widget.
4076  *
4077  * @param obj The flip object
4078  * @param content The new front content object
4079  *
4080  * Once the content object is set, a previously set one will be deleted.
4081  * If you want to keep that old content object, use the
4082  * elm_flip_content_front_unset() function.
4083  *
4084  * @deprecated Use elm_object_part_content_set(flip, "front") instead
4085  */
4086 EINA_DEPRECATED EAPI void                 elm_flip_content_front_set(Evas_Object *obj, Evas_Object *content);
4087
4088 /**
4089  * @brief Set the back content of the flip widget.
4090  *
4091  * @param obj The flip object
4092  * @param content The new back content object
4093  *
4094  * Once the content object is set, a previously set one will be deleted.
4095  * If you want to keep that old content object, use the
4096  * elm_flip_content_back_unset() function.
4097  *
4098  * @deprecated Use elm_object_part_content_set(flip, "back") instead
4099  */
4100 EINA_DEPRECATED EAPI void                 elm_flip_content_back_set(Evas_Object *obj, Evas_Object *content);
4101
4102 /**
4103  * @brief Get the front content used for the flip
4104  *
4105  * @param obj The flip object
4106  * @return The front content object that is being used
4107  *
4108  * Return the front content object which is set for this widget.
4109  *
4110  * @deprecated Use elm_object_part_content_get(flip, "front") instead
4111  */
4112 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_get(const Evas_Object *obj);
4113
4114 /**
4115  * @brief Get the back content used for the flip
4116  *
4117  * @param obj The flip object
4118  * @return The back content object that is being used
4119  *
4120  * Return the back content object which is set for this widget.
4121  *
4122  * @deprecated Use elm_object_part_content_get(flip, "back") instead
4123  */
4124 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_get(const Evas_Object *obj);
4125
4126 /**
4127  * @brief Unset the front content used for the flip
4128  *
4129  * @param obj The flip object
4130  * @return The front content object that was being used
4131  *
4132  * Unparent and return the front content object which was set for this widget.
4133  *
4134  * @deprecated Use elm_object_part_content_unset(flip, "front") instead
4135  */
4136 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_front_unset(Evas_Object *obj);
4137
4138 /**
4139  * @brief Unset the back content used for the flip
4140  *
4141  * @param obj The flip object
4142  * @return The back content object that was being used
4143  *
4144  * Unparent and return the back content object which was set for this widget.
4145  *
4146  * @deprecated Use elm_object_part_content_unset(flip, "back") instead
4147  */
4148 EINA_DEPRECATED EAPI Evas_Object         *elm_flip_content_back_unset(Evas_Object *obj);
4149
4150 /**
4151  * @brief Get flip front visibility state
4152  *
4153  * @param obj The flip object
4154  * @return EINA_TRUE if front front is showing, EINA_FALSE if the back is
4155  * showing.
4156  *
4157  * @deprecated Use elm_flip_front_visible_get() instead
4158  */
4159 EINA_DEPRECATED EAPI Eina_Bool            elm_flip_front_get(const Evas_Object *obj);
4160
4161 /*
4162  * Add a new pager to the parent
4163  *
4164  * @param parent The parent object
4165  * @return The new object or NULL if it cannot be created
4166  *
4167  * @ingroup Pager
4168  * @deprecated Use naviframe instead
4169  */
4170 EINA_DEPRECATED EAPI Evas_Object *elm_pager_add(Evas_Object *parent);
4171
4172 /**
4173  * @brief Push an object to the top of the pager stack (and show it).
4174  *
4175  * @param obj The pager object
4176  * @param content The object to push
4177  *
4178  * The object pushed becomes a child of the pager, it will be controlled and
4179  * deleted when the pager is deleted.
4180  *
4181  * @note If the content is already in the stack use
4182  * elm_pager_content_promote().
4183  * @warning Using this function on @p content already in the stack results in
4184  * undefined behavior.
4185  * @deprecated Use naviframe instead
4186  */
4187 EINA_DEPRECATED EAPI void         elm_pager_content_push(Evas_Object *obj, Evas_Object *content);
4188
4189 /**
4190  * @brief Pop the object that is on top of the stack
4191  *
4192  * @param obj The pager object
4193  *
4194  * This pops the object that is on the top(visible) of the pager, makes it
4195  * disappear, then deletes the object. The object that was underneath it on
4196  * the stack will become visible.
4197  * @deprecated Use naviframe instead
4198  */
4199 EINA_DEPRECATED EAPI void         elm_pager_content_pop(Evas_Object *obj);
4200
4201 /**
4202  * @brief Moves an object already in the pager stack to the top of the stack.
4203  *
4204  * @param obj The pager object
4205  * @param content The object to promote
4206  *
4207  * This will take the @p content and move it to the top of the stack as
4208  * if it had been pushed there.
4209  *
4210  * @note If the content isn't already in the stack use
4211  * elm_pager_content_push().
4212  * @warning Using this function on @p content not already in the stack
4213  * results in undefined behavior.
4214  * @deprecated Use naviframe instead
4215  */
4216 EINA_DEPRECATED EAPI void         elm_pager_content_promote(Evas_Object *obj, Evas_Object *content);
4217
4218 /**
4219  * @brief Return the object at the bottom of the pager stack
4220  *
4221  * @param obj The pager object
4222  * @return The bottom object or NULL if none
4223  * @deprecated Use naviframe instead
4224  */
4225 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_bottom_get(const Evas_Object *obj);
4226
4227 /**
4228  * @brief  Return the object at the top of the pager stack
4229  *
4230  * @param obj The pager object
4231  * @return The top object or NULL if none
4232  * @deprecated Use naviframe instead
4233  */
4234 EINA_DEPRECATED EAPI Evas_Object *elm_pager_content_top_get(const Evas_Object *obj);
4235
4236 /**
4237  * @brief Set the default item style.
4238  *
4239  * Default item style will be used with items who's style is NULL
4240  *
4241  * @param obj The pager object
4242  * @param style The style
4243  * @deprecated Use naviframe instead
4244  */
4245 EINA_DEPRECATED EAPI void             elm_pager_item_style_default_set(Evas_Object *obj, const char *style);
4246
4247 /**
4248  * @brief Get the default item style
4249  *
4250  * @param obj The pager object
4251  * @return the default item style
4252  *
4253  * @see elm_pager_item_style_default_set()
4254  * @deprecated Use naviframe instead
4255  */
4256 EINA_DEPRECATED EAPI const char      *elm_pager_item_style_default_get(const Evas_Object *obj);
4257
4258 /**
4259  * @brief Set the font size on the label object.
4260  *
4261  * @param obj The label object
4262  * @param size font size
4263  *
4264  * @warning NEVER use this. It is for hyper-special cases only. use styles
4265  * instead. e.g. "default", "marker", "slide_long" etc.
4266  * @deprecated Use <font_size> tag instead. eg) <font_size=40>abc</font_size>
4267  */
4268 EINA_DEPRECATED EAPI void                        elm_label_fontsize_set(Evas_Object *obj, int fontsize);
4269
4270 /**
4271  * @brief Set the text color on the label object
4272  *
4273  * @param obj The label object
4274  * @param r Red property background color of The label object
4275  * @param g Green property background color of The label object
4276  * @param b Blue property background color of The label object
4277  * @param a Alpha property background color of The label object
4278  *
4279  * @warning NEVER use this. It is for hyper-special cases only. use styles
4280  * instead. e.g. "default", "marker", "slide_long" etc.
4281  * @deprecated Use <color> tag instead. about <color> tag - Text color in one of the following formats: "#RRGGBB", "#RRGGBBAA", "#RGB", and "#RGBA"
4282  */
4283 EINA_DEPRECATED EAPI void                        elm_label_text_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4284
4285 /**
4286  * @brief Set the text align on the label object
4287  *
4288  * @param obj The label object
4289  * @param align align mode ("left", "center", "right")
4290  *
4291  * @warning NEVER use this. It is for hyper-special cases only. use styles
4292  * instead. e.g. "default", "marker", "slide_long" etc.
4293  * @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%.
4294  */
4295 EINA_DEPRECATED EAPI void                        elm_label_text_align_set(Evas_Object *obj, const char *alignmode);
4296
4297 /**
4298  * @brief Set background color of the label
4299  *
4300  * @param obj The label object
4301  * @param r Red property background color of The label object
4302  * @param g Green property background color of The label object
4303  * @param b Blue property background color of The label object
4304  * @param a Alpha property background alpha of The label object
4305  *
4306  * @warning NEVER use this. It is for hyper-special cases only. use styles
4307  * instead. e.g. "default", "marker", "slide_long" etc.
4308  * @deprecated Just make colored background by yourself.
4309  */
4310 EINA_DEPRECATED EAPI void                        elm_label_background_color_set(Evas_Object *obj, unsigned int r, unsigned int g, unsigned int b, unsigned int a);
4311
4312 /**
4313  * @brief Set wrap height of the label
4314  *
4315  * @param obj The label object
4316  * @param h The wrap height in pixels at a minimum where words need to wrap
4317  *
4318  * This function sets the maximum height size hint of the label.
4319  *
4320  * @warning This is only relevant if the label is inside a container.
4321  * @deprecated This function should not be used because of wrong concept.
4322  */
4323 EAPI void                        elm_label_wrap_height_set(Evas_Object *obj, Evas_Coord h);
4324
4325 /**
4326  * @brief get wrap width of the label
4327  *
4328  * @param obj The label object
4329  * @return The wrap height in pixels at a minimum where words need to wrap
4330  * @deprecated This function should not be used because of wrong concept.
4331  */
4332 EAPI Evas_Coord                  elm_label_wrap_height_get(const Evas_Object *obj);
4333
4334 /**
4335  * @brief Flush all caches.
4336  *
4337  * Frees all data that was in cache and is not currently being used to reduce
4338  * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
4339  * to calling all of the following functions:
4340  * @li edje_file_cache_flush()
4341  * @li edje_collection_cache_flush()
4342  * @li eet_clearcache()
4343  * @li evas_image_cache_flush()
4344  * @li evas_font_cache_flush()
4345  * @li evas_render_dump()
4346  * @note Evas caches are flushed for every canvas associated with a window.
4347  * @deprecated Use elm_cache_all_flush() instead.
4348  */
4349 EINA_DEPRECATED EAPI void      elm_all_flush(void);
4350
4351
4352 /**
4353  * @brief Define the uri that will be the video source.
4354  *
4355  * @param video The video object to define the file for.
4356  * @param uri The uri to target.
4357  *
4358  * This function will define an uri as a source for the video of the
4359  * Elm_Video object. URI could be remote source of video, like http:// or local
4360  * like for example WebCam who are most of the time v4l2:// (but that depend an
4361  * you should use Emotion API to request and list the available Webcam on your
4362  *
4363  * @deprecated Use elm_video_file_set() instead.
4364  *
4365  */
4366 EINA_DEPRECATED EAPI void                 elm_video_uri_set(Evas_Object *video, const char *uri);
4367
4368 /**
4369  * @brief Get the region of the image that is currently shown
4370  *
4371  * @param obj
4372  * @param x A pointer to the X-coordinate of region
4373  * @param y A pointer to the Y-coordinate of region
4374  * @param w A pointer to the width
4375  * @param h A pointer to the height
4376  *
4377  * @deprecated Use elm_photocam_image_region_get() instead.
4378  */
4379 EINA_DEPRECATED EAPI void                   elm_photocam_region_get(const Evas_Object *obj, int *x, int *y, int *w, int *h);
4380
4381 /* No documentation for these API before.
4382  *
4383  * @deprecated Use elm_route_latitude_min_max_get()
4384  *             elm_route_longitude_min_max_get()
4385  *             instead.
4386  */
4387 EINA_DEPRECATED EAPI double       elm_route_lon_min_get(Evas_Object *obj);
4388 EINA_DEPRECATED EAPI double       elm_route_lat_min_get(Evas_Object *obj);
4389 EINA_DEPRECATED EAPI double       elm_route_lon_max_get(Evas_Object *obj);
4390 EINA_DEPRECATED EAPI double       elm_route_lat_max_get(Evas_Object *obj);
4391
4392
4393 /**
4394  * Control pasting of text and images for the widget.
4395  *
4396  * Normally the entry allows both text and images to be pasted.  By setting
4397  * textonly to be true, this prevents images from being pasted.
4398  *
4399  * Note this only changes the behaviour of text.
4400  *
4401  * @param obj The entry object
4402  * @param textonly paste mode - EINA_TRUE is text only, EINA_FALSE is
4403  * text+image+other.
4404  * @deprecated Use elm_entry_cnp_mode_set() instead.
4405  */
4406 EINA_DEPRECATED EAPI void               elm_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
4407
4408 /**
4409  * Getting elm_entry text paste/drop mode.
4410  *
4411  * In textonly mode, only text may be pasted or dropped into the widget.
4412  *
4413  * @param obj The entry object
4414  * @return If the widget only accepts text from pastes.
4415  * @deprecated Use elm_entry_cnp_mode_get() instead.
4416  */
4417 EINA_DEPRECATED EAPI Eina_Bool          elm_entry_cnp_textonly_get(const Evas_Object *obj);
4418
4419
4420 /**
4421  * Get the duration after which tooltip will be shown.
4422  *
4423  * @return Duration after which tooltip will be shown.
4424  * @deprecated Use elm_config_tooltip_delay_get(void);
4425  */
4426 EINA_DEPRECATED EAPI double      elm_tooltip_delay_get(void);
4427
4428 /**
4429  * Set the duration after which tooltip will be shown.
4430  *
4431  * @return EINA_TRUE if value is set.
4432  * @deprecated Use elm_config_tooltip_delay_set(double delay);
4433  */
4434 EINA_DEPRECATED EAPI Eina_Bool   elm_tooltip_delay_set(double delay);
4435
4436 /**
4437  * Set the corner of the bubble
4438  *
4439  * @param obj The bubble object.
4440  * @param corner The given corner for the bubble.
4441  *
4442  * @deprecated Use elm_bubble_pos_set()
4443  *
4444  */
4445 EINA_DEPRECATED EAPI void elm_bubble_corner_set(Evas_Object *obj, const char *corner);
4446
4447 /**
4448  * Get the corner of the bubble
4449  *
4450  * @param obj The bubble object.
4451  * @return The given corner for the bubble.
4452  *
4453  * @deprecated Use elm_bubble_pos_get()
4454  */
4455 EINA_DEPRECATED EAPI const char *elm_bubble_corner_get(const Evas_Object *obj);
4456
4457 /**
4458  * Enable or disable day selection
4459  *
4460  * @param obj The calendar object.
4461  * @param enabled @c EINA_TRUE to enable selection or @c EINA_FALSE to
4462  * disable it.
4463  *
4464  * @deprecated Use elm_calendar_day_selection_disabled_set()
4465  */
4466 EINA_DEPRECATED EAPI void                 elm_calendar_day_selection_enabled_set(Evas_Object *obj, Eina_Bool enabled);
4467
4468 /**
4469  * Get a value whether day selection is enabled or not.
4470  *
4471  * @param obj The calendar object.
4472  * @return EINA_TRUE means day selection is enabled. EINA_FALSE indicates
4473  * it's disabled. If @p obj is NULL, EINA_FALSE is returned.
4474  *
4475  * @deprecated elm_calendar_day_selection_disabled_get()
4476  */
4477 EINA_DEPRECATED EAPI Eina_Bool            elm_calendar_day_selection_enabled_get(const Evas_Object *obj);
4478
4479 /**
4480  * @deprecated Use Elm_Calendar_Mark_Repeat_Type instead.
4481  */
4482 typedef _Elm_Calendar_Mark_Repeat_Type Elm_Calendar_Mark_Repeat EINA_DEPRECATED;
4483
4484 /**
4485  * Get the configured font cache size
4486  *
4487  * This gets the globally configured font cache size, in bytes.
4488  *
4489  * @return The font cache size
4490  * @deprecated elm_cache_font_cache_size_get(void);
4491  */
4492 EINA_DEPRECATED EAPI int       elm_font_cache_get(void);
4493
4494 /**
4495  * Set the configured font cache size
4496  *
4497  * This sets the globally configured font cache size, in bytes
4498  *
4499  * @param size The font cache size
4500  * @deprecated elm_cache_font_cache_size_set(int size);
4501  */
4502 EINA_DEPRECATED EAPI void      elm_font_cache_set(int size);
4503
4504 /**
4505  * Get the configured image cache size
4506  *
4507  * This gets the globally configured image cache size, in bytes
4508  *
4509  * @return The image cache size
4510  * @ingroup Caches
4511  */
4512 EINA_DEPRECATED EAPI int       elm_image_cache_get(void);
4513 EAPI int       elm_cache_image_cache_size_get(void);
4514
4515 /**
4516  * Set the configured image cache size
4517  *
4518  * This sets the globally configured image cache size, in bytes
4519  *
4520  * @param size The image cache size
4521  * @deprecated Use elm_cache_image_cache_size_set(int size);
4522  */
4523 EINA_DEPRECATED EAPI void      elm_image_cache_set(int size);
4524
4525
4526 /**
4527  * Get the configured edje file cache size.
4528  *
4529  * This gets the globally configured edje file cache size, in number
4530  * of files.
4531  *
4532  * @return The edje file cache size
4533  * @deprecated Use elm_cache_edje_file_cache_size_get(void);
4534  */
4535 EINA_DEPRECATED EAPI int       elm_edje_file_cache_get(void);
4536
4537 /**
4538  * Set the configured edje file cache size
4539  *
4540  * This sets the globally configured edje file cache size, in number
4541  * of files.
4542  *
4543  * @param size The edje file cache size
4544  * @deprecated Use elm_cache_edje_file_cache_size_get(int size);
4545  */
4546 EINA_DEPRECATED EAPI void      elm_edje_file_cache_set(int size);
4547
4548 /**
4549  * Get the configured edje collections (groups) cache size.
4550  *
4551  * This gets the globally configured edje collections cache size, in
4552  * number of collections.
4553  *
4554  * @return The edje collections cache size
4555  * @deprecated Use elm_cache_edje_collection_cache_size_get(void);
4556  */
4557 EINA_DEPRECATED EAPI int       elm_edje_collection_cache_get(void);
4558
4559 /**
4560  * Set the configured edje collections (groups) cache size
4561  *
4562  * This sets the globally configured edje collections cache size, in
4563  * number of collections.
4564  *
4565  * @param size The edje collections cache size
4566  * @deprecated elm_cache_edje_collection_cache_size_set(int size);
4567  */
4568 EINA_DEPRECATED EAPI void      elm_edje_collection_cache_set(int size);
4569
4570 /**
4571  * Gets whether browsing history is enabled for the given object
4572  *
4573  * @param obj The web object
4574  *
4575  * @return EINA_TRUE if history is enabled, EINA_FALSE otherwise
4576  *
4577  * @deprecated Use elm_web_history_enabled_get()
4578  */
4579 EINA_DEPRECATED EAPI Eina_Bool         elm_web_history_enable_get(const Evas_Object *obj);
4580
4581 /**
4582  * Enables or disables the browsing history
4583  *
4584  * @param obj The web object
4585  * @param enable Whether to enable or disable the browsing history
4586  *
4587  * @deprecated Use elm_web_history_enabled_set()
4588  *
4589  */
4590 EINA_DEPRECATED EAPI void              elm_web_history_enable_set(Evas_Object *obj, Eina_Bool enable);
4591
4592 /**
4593  * @brief Add an object swallowed in an item at the end of the given menu
4594  * widget
4595  *
4596  * @param obj The menu object.
4597  * @param parent The parent menu item (optional)
4598  * @param subobj The object to swallow
4599  * @param func Function called when the user select the item.
4600  * @param data Data sent by the callback.
4601  * @return Returns the new item.
4602  *
4603  * Add an evas object as an item to the menu.
4604  * @deprecated please use "elm_menu_item_add" + "elm_object_item_content_set" instead.
4605  */
4606 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);
4607
4608 /**
4609  * @brief Sets whether events should be passed to by a click outside
4610  * its area.
4611  *
4612  * @param obj The notify object
4613  * @param repeat EINA_TRUE Events are repeats, else no
4614  *
4615  * When true if the user clicks outside the window the events will be caught
4616  * by the others widgets, else the events are blocked.
4617  *
4618  * @note The default value is EINA_TRUE.
4619  * @deprecated Please use elm_notify_allow_events_set() instead
4620  */
4621 EINA_DEPRECATED EAPI void                         elm_notify_repeat_events_set(Evas_Object *obj, Eina_Bool repeat);
4622
4623 /**
4624  * @brief Return true if events are repeat below the notify object
4625  * @param obj the notify object
4626  *
4627  * @see elm_notify_repeat_events_set()
4628  * @deprecated Please use elm_notify_allow_events_get() instead
4629  */
4630 EINA_DEPRECATED EAPI Eina_Bool                    elm_notify_repeat_events_get(const Evas_Object *obj);
4631
4632 /**
4633  * Set if the cursor set should be searched on the theme or should use
4634  * the provided by the engine, only.
4635  *
4636  * @param obj an object with cursor already set.
4637  * @param engine_only boolean to define if cursors should be looked only
4638  * between the provided by the engine or searched on widget's theme as well.
4639  *
4640  * @deprecated Use elm_object_cursor_theme_search_enabled_set()
4641  */
4642 EINA_DEPRECATED EAPI void        elm_object_cursor_engine_only_set(Evas_Object *obj, Eina_Bool engine_only);
4643
4644 /**
4645  * Get the cursor engine only usage for this object cursor.
4646  *
4647  * @param obj an object with cursor already set.
4648  * @return engine_only boolean to define it cursors should be
4649  * looked only between the provided by the engine or searched on
4650  * widget's theme as well. If the object does not have a cursor
4651  * set, then EINA_FALSE is returned.
4652  *
4653  * @deprecated Use elm_object_cursor_theme_search_enabled_get();
4654  */
4655 EINA_DEPRECATED EAPI Eina_Bool   elm_object_cursor_engine_only_get(const Evas_Object *obj);
4656
4657 /**
4658  * Go to a given items level on a index widget
4659  *
4660  * @param obj The index object
4661  * @param level The index level (one of @c 0 or @c 1)
4662  *
4663  * @deprecated please use "elm_index_level_go" instead.
4664  * @ingroup Index
4665  */
4666 EINA_DEPRECATED EAPI void                  elm_index_item_go(Evas_Object *obj, int level);
4667
4668 /**
4669  * Enable or disable auto hiding feature for a given index widget.
4670  *
4671  * @param obj The index object
4672  * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
4673  *
4674  * @see elm_index_active_get()
4675  *
4676  * @deprecated please use "elm_index_autohide_disabled_set" instead.
4677  * @ingroup Index
4678  */
4679 EINA_DEPRECATED EAPI void                  elm_index_active_set(Evas_Object *obj, Eina_Bool active);
4680
4681 /**
4682  * Get whether auto hiding feature is enabled or not for a given index widget.
4683  *
4684  * @param obj The index object
4685  * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
4686  *
4687  * @see elm_index_active_set() for more details
4688  *
4689  * @deprecated please use "elm_index_autohide_disabled_get" instead.
4690  * @ingroup Index
4691  */
4692 EINA_DEPRECATED EAPI Eina_Bool             elm_index_active_get(const Evas_Object *obj);
4693
4694 /**
4695  * Append a new item, on a given index widget, <b>after the item
4696  * having @p relative as data</b>.
4697  *
4698  * @param obj The index object.
4699  * @param letter Letter under which the item should be indexed
4700  * @param item The item data to set for the index's item
4701  * @param relative The index item to be the predecessor of this new one
4702  * @return A handle to the item added or @c NULL, on errors
4703  *
4704  * Despite the most common usage of the @p letter argument is for
4705  * single char strings, one could use arbitrary strings as index
4706  * entries.
4707  *
4708  * @c item will be the pointer returned back on @c "changed", @c
4709  * "delay,changed" and @c "selected" smart events.
4710  *
4711  * @note If @p relative is @c NULL this function will behave as
4712  * elm_index_item_append().
4713  *
4714  * @deprecated please use "elm_index_item_insert_after" instead.
4715  * @ingroup Index
4716  */
4717 EAPI Elm_Object_Item      *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
4718
4719 /**
4720  * Prepend a new item, on a given index widget, <b>after the item
4721  * having @p relative as data</b>.
4722  *
4723  * @param obj The index object.
4724  * @param letter Letter under which the item should be indexed
4725  * @param item The item data to set for the index's item
4726  * @param relative The index item to be the successor of this new one
4727  * @return A handle to the item added or @c NULL, on errors
4728  *
4729  * Despite the most common usage of the @p letter argument is for
4730  * single char strings, one could use arbitrary strings as index
4731  * entries.
4732  *
4733  * @c item will be the pointer returned back on @c "changed", @c
4734  * "delay,changed" and @c "selected" smart events.
4735  *
4736  * @note If @p relative is @c NULL this function will behave as
4737  * elm_index_item_prepend().
4738  *
4739  * @deprecated please use "elm_index_item_insert_before" instead.
4740  * @ingroup Index
4741  */
4742 EAPI Elm_Object_Item      *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
4743
4744 /**
4745  * Set the transparency state of a window.
4746  *
4747  * Use elm_win_alpha_set() instead.
4748  *
4749  * @param obj The window object
4750  * @param transparent If true, the window is transparent
4751  *
4752  * @see elm_win_alpha_set()
4753  * @deprecated Please use elm_win_alpha_set()
4754  */
4755 EINA_DEPRECATED EAPI void                  elm_win_transparent_set(Evas_Object *obj, Eina_Bool transparent);
4756
4757 /**
4758  * Get the transparency state of a window.
4759  *
4760  * @param obj The window object
4761  * @return If true, the window is transparent
4762  *
4763  * @see elm_win_transparent_set()
4764  * @deprecated Please use elm_win_alpha_get()
4765  */
4766 EINA_DEPRECATED EAPI Eina_Bool             elm_win_transparent_get(const Evas_Object *obj);
4767
4768 /**
4769  * Set the theme for all elementary using applications on the current display
4770  *
4771  * @param theme The name of the theme to use. Format same as the ELM_THEME
4772  * environment variable.
4773  * @deprecated Use elm_theme_set(NULL, theme); elm_config_all_flush(); instead.
4774  */
4775 EINA_DEPRECATED EAPI void             elm_theme_all_set(const char *theme);
4776
4777 /**
4778  * @}
4779  */