From 278d1296d008b9e43716d46acb1acd3f0ba7c382 Mon Sep 17 00:00:00 2001 From: jypark Date: Sat, 10 Mar 2012 11:04:05 +0000 Subject: [PATCH] update removed file git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/elementary@69169 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33 --- src/lib/elm_removed.h | 2438 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 2438 insertions(+) diff --git a/src/lib/elm_removed.h b/src/lib/elm_removed.h index 4dbecfc..e190ad8 100644 --- a/src/lib/elm_removed.h +++ b/src/lib/elm_removed.h @@ -2160,3 +2160,2441 @@ EINA_DEPRECATED EAPI Elm_Genlist_Item_Type elm_genlist_item_flags_get(con * @deprecated Use elm_genlist_item_all_contents_unset() instead * @ingroup Genlist */ + +#define ELM_IMAGE_ROTATE_90_CW 1 +#define ELM_IMAGE_ROTATE_180_CW 2 +#define ELM_IMAGE_ROTATE_90_CCW 3 + +/** + * Return the data associated with a given index widget item + * + * @param item The index widget item handle + * @return The data associated with @p it + * @deprecated Use elm_object_item_data_get() instead + * + * @see elm_index_item_data_set() + * + */ +EINA_DEPRECATED EAPI void *elm_index_item_data_get(const Elm_Object_Item *item); + +/** + * Set the data associated with a given index widget item + * + * @param it The index widget item handle + * @param data The new data pointer to set to @p it + * + * This sets new item data on @p it. + * + * @warning The old data pointer won't be touched by this function, so + * the user had better to free that old data himself/herself. + * + * @deprecated Use elm_object_item_data_set() instead + */ +EINA_DEPRECATED EAPI void elm_index_item_data_set(Elm_Object_Item *it, const void *data); + +/** + * Set the function to be called when a given index widget item is freed. + * + * @param it The item to set the callback on + * @param func The function to call on the item's deletion + * + * When called, @p func will have both @c data and @c event_info + * arguments with the @p it item's data value and, naturally, the + * @c obj argument with a handle to the parent index widget. + * + * @deprecated Use elm_object_item_del_cb_set() instead + */ +EINA_DEPRECATED EAPI void elm_index_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); + +/** + * Remove an item from a given index widget, to be referenced by + * it's data value. + * + * @param obj The index object + * @param item The item to be removed from @p obj + * + * If a deletion callback is set, via elm_object_item_del_cb_set(), + * that callback function will be called by this one. + * + * @deprecated Use elm_object_item_del() instead + */ +EINA_DEPRECATED EAPI void elm_index_item_del(Evas_Object *obj, Elm_Object_Item *item); + +/** +* @brief Set the label on the label object + * + * @param obj The label object + * @param label The label will be used on the label object + * @deprecated See elm_object_text_set() + */ +EINA_DEPRECATED EAPI void elm_label_label_set(Evas_Object *obj, const char *label); + +/** + * @brief Get the label used on the label object + * + * @param obj The label object + * @return The string inside the label + * @deprecated See elm_object_text_get() + */ +EINA_DEPRECATED EAPI const char *elm_label_label_get(const Evas_Object *obj); + + +/** + * Set the layout content. + * + * @param obj The layout object + * @param swallow The swallow part name in the edje file + * @param content The child that will be added in this layout object + * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_object_part_content_unset() function. + * + * @note In an Edje theme, the part used as a content container is called @c + * SWALLOW. This is why the parameter name is called @p swallow, but it is + * expected to be a part name just like the second parameter of + * elm_layout_box_append(). + * + * @see elm_layout_box_append() + * @see elm_object_part_content_get() + * @see elm_object_part_content_unset() + * @see @ref secBox + * @deprecated use elm_object_part_content_set() instead + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_layout_content_set(Evas_Object *obj, const char *swallow, Evas_Object *content); + +/** + * Get the child object in the given content part. + * + * @param obj The layout object + * @param swallow The SWALLOW part to get its content + * + * @return The swallowed object or NULL if none or an error occurred + * + * @deprecated use elm_object_part_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_get(const Evas_Object *obj, const char *swallow); + +/** + * Unset the layout content. + * + * @param obj The layout object + * @param swallow The swallow part name in the edje file + * @return The content that was being used + * + * Unparent and return the content object which was set for this part. + * + * @deprecated use elm_object_part_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_layout_content_unset(Evas_Object *obj, const char *swallow); + +/** + * Set the text of the given part + * + * @param obj The layout object + * @param part The TEXT part where to set the text + * @param text The text to set + * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise + * + * @deprecated use elm_object_part_text_set() instead. + */ +EINA_DEPRECATED EAPI Eina_Bool elm_layout_text_set(Evas_Object *obj, const char *part, const char *text); + +/** + * Get the text set in the given part + * + * @param obj The layout object + * @param part The TEXT part to retrieve the text off + * + * @return The text set in @p part + * + * @deprecated use elm_object_part_text_get() instead. + */ +EINA_DEPRECATED EAPI const char *elm_layout_text_get(const Evas_Object *obj, const char *part); + +/** + * @def elm_layout_label_set + * Convenience macro to set the label in a layout that follows the + * Elementary naming convention for its parts. + * + * @deprecated use elm_object_text_set() instead. + */ +#define elm_layout_label_set(_ly, _txt) \ + elm_layout_text_set((_ly), "elm.text", (_txt)) + +/** + * @def elm_layout_label_get + * Convenience macro to get the label in a layout that follows the + * Elementary naming convention for its parts. + * + * @deprecated use elm_object_text_set() instead. + */ +#define elm_layout_label_get(_ly) \ + elm_layout_text_get((_ly), "elm.text") + +EINA_DEPRECATED EAPI Evas_Object *elm_list_item_base_get(const Elm_Object_Item *it); + + +/** + * Set the content of the mapbuf. + * + * @param obj The mapbuf object. + * @param content The content that will be filled in this mapbuf object. + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_mapbuf_content_unset() function. + * + * To enable map, elm_mapbuf_enabled_set() should be used. + * + * @deprecated use elm_object_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_mapbuf_content_set(Evas_Object *obj, Evas_Object *content); + +/** + * Get the content of the mapbuf. + * + * @param obj The mapbuf object. + * @return The content that is being used. + * + * Return the content object which is set for this widget. + * + * @see elm_mapbuf_content_set() for details. + * + * @deprecated use elm_object_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_get(const Evas_Object *obj); + +/** + * Unset the content of the mapbuf. + * + * @param obj The mapbuf object. + * @return The content that was being used. + * + * Unparent and return the content object which was set for this widget. + * + * @see elm_mapbuf_content_set() for details. + * + * @deprecated use elm_object_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_mapbuf_content_unset(Evas_Object *obj); + +/** + * @brief Set the label of a menu item + * + * @param it The menu item object. + * @param label The label to set for @p item + * + * @warning Don't use this function on items created with + * elm_menu_item_add_object() or elm_menu_item_separator_add(). + * + * @deprecated Use elm_object_item_text_set() instead + */ +EINA_DEPRECATED EAPI void elm_menu_item_label_set(Elm_Object_Item *it, const char *label); + +/** + * @brief Get the label of a menu item + * + * @param it The menu item object. + * @return The label of @p item + * @deprecated Use elm_object_item_text_get() instead + */ +EINA_DEPRECATED EAPI const char *elm_menu_item_label_get(const Elm_Object_Item *it); + +/** + * @brief Set the content object of a menu item + * + * @param it The menu item object + * @param The content object or NULL + * @return EINA_TRUE on success, else EINA_FALSE + * + * Use this function to change the object swallowed by a menu item, deleting + * any previously swallowed object. + * + * @deprecated Use elm_object_item_content_set() instead + */ +EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_object_content_set(Elm_Object_Item *it, Evas_Object *obj); + +/** + * @brief Get the content object of a menu item + * + * @param it The menu item object + * @return The content object or NULL + * @note If @p item was added with elm_menu_item_add_object, this + * function will return the object passed, else it will return the + * icon object. + * + * @see elm_menu_item_object_content_set() + * + * @deprecated Use elm_object_item_content_get() instead + */ +EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_object_content_get(const Elm_Object_Item *it); + +/** + * @brief Set the disabled state of @p item. + * + * @param it The menu item object. + * @param disabled The enabled/disabled state of the item + * @deprecated Use elm_object_item_disabled_set() instead + */ +EINA_DEPRECATED EAPI void elm_menu_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); + +/** + * @brief Get the disabled state of @p item. + * + * @param it The menu item object. + * @return The enabled/disabled state of the item + * + * @see elm_menu_item_disabled_set() + * @deprecated Use elm_object_item_disabled_get() instead + */ +EINA_DEPRECATED EAPI Eina_Bool elm_menu_item_disabled_get(const Elm_Object_Item *it); + +/** + * @brief Returns the data associated with menu item @p item. + * + * @param it The item + * @return The data associated with @p item or NULL if none was set. + * + * This is the data set with elm_menu_add() or elm_menu_item_data_set(). + * + * @deprecated Use elm_object_item_data_get() instead + */ +EINA_DEPRECATED EAPI void *elm_menu_item_data_get(const Elm_Object_Item *it); + +/** + * @brief Set the function called when a menu item is deleted. + * + * @param it The item to set the callback on + * @param func The function called + * + * @see elm_menu_item_add() + * @see elm_menu_item_del() + * @deprecated Use elm_object_item_del_cb_set() instead + */ +EINA_DEPRECATED EAPI void elm_menu_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); + +/** + * @brief Sets the data to be associated with menu item @p item. + * + * @param it The item + * @param data The data to be associated with @p item + * + * @deprecated Use elm_object_item_data_set() instead + */ +EINA_DEPRECATED EAPI void elm_menu_item_data_set(Elm_Object_Item *it, const void *data); + +/** + * @brief Deletes an item from the menu. + * + * @param it The item to delete. + * + * @deprecated Use elm_object_item_del() instead + * @see elm_menu_item_add() + */ +EINA_DEPRECATED EAPI void elm_menu_item_del(Elm_Object_Item *it); + +/** + * @brief @brief Return a menu item's owner menu + * + * @param it The menu item + * @return The menu object owning @p item, or NULL on failure + * + * Use this function to get the menu object owning an item. + * @deprecated Use elm_object_item_widget_get() instead + */ +EINA_DEPRECATED EAPI Evas_Object *elm_menu_item_menu_get(const Elm_Object_Item *it); + +/** + * @brief Set the icon of a menu item to the standard icon with name @p icon + * + * @param it The menu item object. + * @param icon The icon object to set for the content of @p item + * + * @deprecated elm_menu_item_icon_name_set() instead + * Once this icon is set, any previously set icon will be deleted. + */ +EINA_DEPRECATED EAPI void elm_menu_item_object_icon_name_set(Elm_Object_Item *it, const char *icon); + +/** + * @brief Get the string representation from the icon of a menu item + * + * @param it The menu item object. + * @return The string representation of @p item's icon or NULL + * + * @deprecated elm_menu_item_icon_name_get() instead + * @see elm_menu_item_icon_name_set() + */ +EINA_DEPRECATED EAPI const char *elm_menu_item_object_icon_name_get(const Elm_Object_Item *it); + +/** + * @brief Set the content of the notify widget + * + * @param obj The notify object + * @param content The content will be filled in this notify object + * + * Once the content object is set, a previously set one will be deleted. If + * you want to keep that old content object, use the + * elm_notify_content_unset() function. + * + * @deprecated use elm_object_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_notify_content_set(Evas_Object *obj, Evas_Object *content); + +/** + * @brief Unset the content of the notify widget + * + * @param obj The notify object + * @return The content that was being used + * + * Unparent and return the content object which was set for this widget + * + * @see elm_notify_content_set() + * @deprecated use elm_object_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_unset(Evas_Object *obj); + +/** + * @brief Return the content of the notify widget + * + * @param obj The notify object + * @return The content that is being used + * + * @see elm_notify_content_set() + * @deprecated use elm_object_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_notify_content_get(const Evas_Object *obj); + +/** + * Set a label of an object + * + * @param obj The Elementary object + * @param part The text part name to set (NULL for the default label) + * @param label The new text of the label + * + * @note Elementary objects may have many labels (e.g. Action Slider) + * @deprecated Use elm_object_part_text_set() instead. + */ +EINA_DEPRECATED EAPI void elm_object_text_part_set(Evas_Object *obj, const char *part, const char *label); + +/** + * Get a label of an object + * + * @param obj The Elementary object + * @param part The text part name to get (NULL for the default label) + * @return text of the label or NULL for any error + * + * @note Elementary objects may have many labels (e.g. Action Slider) + * @deprecated Use elm_object_part_text_get() instead. + */ +EINA_DEPRECATED EAPI const char *elm_object_text_part_get(const Evas_Object *obj, const char *part); + +/** + * Set a content of an object + * + * @param obj The Elementary object + * @param part The content part name to set (NULL for the default content) + * @param content The new content of the object + * + * @note Elementary objects may have many contents + * @deprecated Use elm_object_part_content_set instead. + */ +EINA_DEPRECATED EAPI void elm_object_content_part_set(Evas_Object *obj, const char *part, Evas_Object *content); + +/** + * Get a content of an object + * + * @param obj The Elementary object + * @param part The content part name to get (NULL for the default content) + * @return content of the object or NULL for any error + * + * @note Elementary objects may have many contents + * @deprecated Use elm_object_part_content_get instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_get(const Evas_Object *obj, const char *part); + +/** + * Unset a content of an object + * + * @param obj The Elementary object + * @param part The content part name to unset (NULL for the default content) + * + * @note Elementary objects may have many contents + * @deprecated Use elm_object_part_content_unset instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_object_content_part_unset(Evas_Object *obj, const char *part); + +/** + * Set a content of an object item + * + * @param it The Elementary object item + * @param part The content part name to set (NULL for the default content) + * @param content The new content of the object item + * + * @note Elementary object items may have many contents + * @deprecated Use elm_object_item_part_content_set instead. + */ +EINA_DEPRECATED EAPI void elm_object_item_content_part_set(Elm_Object_Item *it, const char *part, Evas_Object *content); + +/** + * Get a content of an object item + * + * @param it The Elementary object item + * @param part The content part name to unset (NULL for the default content) + * @return content of the object item or NULL for any error + * + * @note Elementary object items may have many contents + * @deprecated Use elm_object_item_part_content_get instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part); + +/** + * Unset a content of an object item + * + * @param it The Elementary object item + * @param part The content part name to unset (NULL for the default content) + * + * @note Elementary object items may have many contents + * @deprecated Use elm_object_item_part_content_unset instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_object_item_content_part_unset(Elm_Object_Item *it, const char *part); + +/** + * Get a label of an object item + * + * @param it The Elementary object item + * @param part The text part name to get (NULL for the default label) + * @return text of the label or NULL for any error + * + * @note Elementary object items may have many labels + * @deprecated Use elm_object_item_part_text_get instead. + */ +EINA_DEPRECATED EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part); + +/** + * Set a label of an object item + * + * @param it The Elementary object item + * @param part The text part name to set (NULL for the default label) + * @param label The new text of the label + * + * @note Elementary object items may have many labels + * @deprecated Use elm_object_item_part_text_set instead. + */ +EINA_DEPRECATED EAPI void elm_object_item_text_part_set(Elm_Object_Item *it, const char *part, const char *label); + +/** + * @brief Set the content of the panel. + * + * @param obj The panel object + * @param content The panel content + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_panel_content_unset() function. + * + * @deprecated use elm_object_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_panel_content_set(Evas_Object *obj, Evas_Object *content); + +/** + * @brief Get the content of the panel. + * + * @param obj The panel object + * @return The content that is being used + * + * Return the content object which is set for this widget. + * + * @see elm_panel_content_set() + * + * @deprecated use elm_object_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_get(const Evas_Object *obj); + +/** + * @brief Unset the content of the panel. + * + * @param obj The panel object + * @return The content that was being used + * + * Unparent and return the content object which was set for this widget. + * + * @see elm_panel_content_set() + * + * @deprecated use elm_object_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panel_content_unset(Evas_Object *obj); + +/** + * Set the left content of the panes widget. + * + * @param obj The panes object. + * @param content The new left content object. + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_panes_content_left_unset() function. + * + * If panes is displayed vertically, left content will be displayed at + * top. + * + * @see elm_panes_content_left_get() + * @see elm_panes_content_right_set() to set content on the other side. + * + * @deprecated use elm_object_part_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_panes_content_left_set(Evas_Object *obj, Evas_Object *content); + +/** + * Set the right content of the panes widget. + * + * @param obj The panes object. + * @param content The new right content object. + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_panes_content_right_unset() function. + * + * If panes is displayed vertically, left content will be displayed at + * bottom. + * + * @see elm_panes_content_right_get() + * @see elm_panes_content_left_set() to set content on the other side. + * + * @deprecated use elm_object_part_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_panes_content_right_set(Evas_Object *obj, Evas_Object *content); + +/** + * Get the left content of the panes. + * + * @param obj The panes object. + * @return The left content object that is being used. + * + * Return the left content object which is set for this widget. + * + * @see elm_panes_content_left_set() for details. + * + * @deprecated use elm_object_part_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_get(const Evas_Object *obj); + +/** + * Get the right content of the panes. + * + * @param obj The panes object + * @return The right content object that is being used + * + * Return the right content object which is set for this widget. + * + * @see elm_panes_content_right_set() for details. + * + * @deprecated use elm_object_part_content_get() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_get(const Evas_Object *obj); + +/** + * Unset the left content used for the panes. + * + * @param obj The panes object. + * @return The left content object that was being used. + * + * Unparent and return the left content object which was set for this widget. + * + * @see elm_panes_content_left_set() for details. + * @see elm_panes_content_left_get(). + * + * @deprecated use elm_object_part_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_left_unset(Evas_Object *obj); + +/** + * Unset the right content used for the panes. + * + * @param obj The panes object. + * @return The right content object that was being used. + * + * Unparent and return the right content object which was set for this + * widget. + * + * @see elm_panes_content_right_set() for details. + * @see elm_panes_content_right_get(). + * + * @deprecated use elm_object_part_content_unset() instead + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_panes_content_right_unset(Evas_Object *obj); +/** + * Set the label of a given progress bar widget + * + * @param obj The progress bar object + * @param label The text label string, in UTF-8 + * + * @deprecated use elm_object_text_set() instead. + */ +EINA_DEPRECATED EAPI void elm_progressbar_label_set(Evas_Object *obj, const char *label); + +/** + * Get the label of a given progress bar widget + * + * @param obj The progressbar object + * @return The text label string, in UTF-8 + * + * @deprecated use elm_object_text_set() instead. + */ +EINA_DEPRECATED EAPI const char *elm_progressbar_label_get(const Evas_Object *obj); + +/** + * Set the icon object of a given progress bar widget + * + * @param obj The progress bar object + * @param icon The icon object + * + * Use this call to decorate @p obj with an icon next to it. + * + * @note Once the icon object is set, a previously set one will be + * deleted. If you want to keep that old content object, use the + * elm_progressbar_icon_unset() function. + * + * @see elm_progressbar_icon_get() + * @deprecated use elm_object_part_content_set() instead. + * + */ +EINA_DEPRECATED EAPI void elm_progressbar_icon_set(Evas_Object *obj, Evas_Object *icon); + +/** + * Retrieve the icon object set for a given progress bar widget + * + * @param obj The progress bar object + * @return The icon object's handle, if @p obj had one set, or @c NULL, + * otherwise (and on errors) + * + * @see elm_progressbar_icon_set() for more details + * @deprecated use elm_object_part_content_get() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_get(const Evas_Object *obj); + +/** + * Unset an icon set on a given progress bar widget + * + * @param obj The progress bar object + * @return The icon object that was being used, if any was set, or + * @c NULL, otherwise (and on errors) + * + * This call will unparent and return the icon object which was set + * for this widget, previously, on success. + * + * @see elm_progressbar_icon_set() for more details + * @deprecated use elm_object_part_content_unset() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_progressbar_icon_unset(Evas_Object *obj); + +/** + * @brief Set the text label of the radio object + * + * @param obj The radio object + * @param label The text label string in UTF-8 + * + * @deprecated use elm_object_text_set() instead. + */ +EINA_DEPRECATED EAPI void elm_radio_label_set(Evas_Object *obj, const char *label); + +/** + * @brief Get the text label of the radio object + * + * @param obj The radio object + * @return The text label string in UTF-8 + * + * @deprecated use elm_object_text_set() instead. + */ +EINA_DEPRECATED EAPI const char *elm_radio_label_get(const Evas_Object *obj); + +/** + * @brief Set the icon object of the radio object + * + * @param obj The radio object + * @param icon The icon object + * + * Once the icon object is set, a previously set one will be deleted. If you + * want to keep that old content object, use the elm_radio_icon_unset() + * function. + * + * @deprecated use elm_object_part_content_set() instead. + * + */ +EINA_DEPRECATED EAPI void elm_radio_icon_set(Evas_Object *obj, Evas_Object *icon); + +/** + * @brief Get the icon object of the radio object + * + * @param obj The radio object + * @return The icon object + * + * @see elm_radio_icon_set() + * + * @deprecated use elm_object_part_content_get() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_get(const Evas_Object *obj); + +/** + * @brief Unset the icon used for the radio object + * + * @param obj The radio object + * @return The icon object that was being used + * + * Unparent and return the icon object which was set for this widget. + * + * @see elm_radio_icon_set() + * @deprecated use elm_object_part_content_unset() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_radio_icon_unset(Evas_Object *obj); + +/** + * @brief Set the content of the scroller widget (the object to be scrolled around). + * + * @param obj The scroller object + * @param content The new content object + * + * Once the content object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_scroller_content_unset() function. + * @deprecated use elm_object_content_set() instead + */ +EINA_DEPRECATED EAPI void elm_scroller_content_set(Evas_Object *obj, Evas_Object *child); + +/** + * @brief Get the content of the scroller widget + * + * @param obj The slider object + * @return The content that is being used + * + * Return the content object which is set for this widget + * + * @see elm_scroller_content_set() + * @deprecated use elm_object_content_get() instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_get(const Evas_Object *obj); + +/** + * @brief Unset the content of the scroller widget + * + * @param obj The slider object + * @return The content that was being used + * + * Unparent and return the content object which was set for this widget + * + * @see elm_scroller_content_set() + * @deprecated use elm_object_content_unset() instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_scroller_content_unset(Evas_Object *obj); + +/** + * Set the label of a given slider widget + * + * @param obj The progress bar object + * @param label The text label string, in UTF-8 + * + * @deprecated use elm_object_text_set() instead. + */ +EINA_DEPRECATED EAPI void elm_slider_label_set(Evas_Object *obj, const char *label); + +/** + * Get the label of a given slider widget + * + * @param obj The progressbar object + * @return The text label string, in UTF-8 + * + * @deprecated use elm_object_text_get() instead. + */ +EINA_DEPRECATED EAPI const char *elm_slider_label_get(const Evas_Object *obj); + +/** + * Set the icon object of the slider object. + * + * @param obj The slider object. + * @param icon The icon object. + * + * On horizontal mode, icon is placed at left, and on vertical mode, + * placed at top. + * + * @note Once the icon object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_slider_icon_unset() function. + * + * @warning If the object being set does not have minimum size hints set, + * it won't get properly displayed. + * + * @deprecated use elm_object_part_content_set() instead. + */ +EINA_DEPRECATED EAPI void elm_slider_icon_set(Evas_Object *obj, Evas_Object *icon); + +/** + * Unset an icon set on a given slider widget. + * + * @param obj The slider object. + * @return The icon object that was being used, if any was set, or + * @c NULL, otherwise (and on errors). + * + * On horizontal mode, icon is placed at left, and on vertical mode, + * placed at top. + * + * This call will unparent and return the icon object which was set + * for this widget, previously, on success. + * + * @see elm_slider_icon_set() for more details + * @see elm_slider_icon_get() + * @deprecated use elm_object_part_content_unset() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_unset(Evas_Object *obj); + +/** + * Retrieve the icon object set for a given slider widget. + * + * @param obj The slider object. + * @return The icon object's handle, if @p obj had one set, or @c NULL, + * otherwise (and on errors). + * + * On horizontal mode, icon is placed at left, and on vertical mode, + * placed at top. + * + * @see elm_slider_icon_set() for more details + * @see elm_slider_icon_unset() + * + * @deprecated use elm_object_part_content_get() instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_slider_icon_get(const Evas_Object *obj); + +/** + * Set the end object of the slider object. + * + * @param obj The slider object. + * @param end The end object. + * + * On horizontal mode, end is placed at left, and on vertical mode, + * placed at bottom. + * + * @note Once the icon object is set, a previously set one will be deleted. + * If you want to keep that old content object, use the + * elm_slider_end_unset() function. + * + * @warning If the object being set does not have minimum size hints set, + * it won't get properly displayed. + * + * @deprecated use elm_object_part_content_set() instead. + * + */ +EINA_DEPRECATED EAPI void elm_slider_end_set(Evas_Object *obj, Evas_Object *end); + +/** + * Unset an end object set on a given slider widget. + * + * @param obj The slider object. + * @return The end object that was being used, if any was set, or + * @c NULL, otherwise (and on errors). + * + * On horizontal mode, end is placed at left, and on vertical mode, + * placed at bottom. + * + * This call will unparent and return the icon object which was set + * for this widget, previously, on success. + * + * @see elm_slider_end_set() for more details. + * @see elm_slider_end_get() + * + * @deprecated use elm_object_part_content_unset() instead + * instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_unset(Evas_Object *obj); + +/** + * Retrieve the end object set for a given slider widget. + * + * @param obj The slider object. + * @return The end object's handle, if @p obj had one set, or @c NULL, + * otherwise (and on errors). + * + * On horizontal mode, icon is placed at right, and on vertical mode, + * placed at bottom. + * + * @see elm_slider_end_set() for more details. + * @see elm_slider_end_unset() + * + * + * @deprecated use elm_object_part_content_get() instead + * instead. + * + */ +EINA_DEPRECATED EAPI Evas_Object *elm_slider_end_get(const Evas_Object *obj); + +/** + * Return the data associated with a given slideshow item + * + * @param it The slideshow item + * @return Returns the data associated to this item + * + * @deprecated use elm_object_item_data_get() instead + */ +EINA_DEPRECATED EAPI void *elm_slideshow_item_data_get(const Elm_Object_Item *it); + +/** + * Delete a given item from a slideshow widget. + * + * @param it The slideshow item + * + * @deprecated Use elm_object_item_de() instead + */ +EINA_DEPRECATED EAPI void elm_slideshow_item_del(Elm_Object_Item *it); + +/** + * Display a given slideshow widget's item, programmatically. + * + * @param it The item to display on @p obj's viewport + * + * The change between the current item and @p item will use the + * transition @p obj is set to use (@see + * elm_slideshow_transition_set()). + * + * @deprecated use elm_slideshow_item_show() instead + */ +EINA_DEPRECATED EAPI void elm_slideshow_show(Elm_Object_Item *it); + +/** + * Get the toolbar object from an item. + * + * @param it The item. + * @return The toolbar object. + * + * This returns the toolbar object itself that an item belongs to. + * + * @deprecated use elm_object_item_object_get() instead. + */ +EINA_DEPRECATED EAPI Evas_Object *elm_toolbar_item_toolbar_get(const Elm_Object_Item *it); + +/** + * Get the label of item. + * + * @param it The item of toolbar. + * @return The label of item. + * + * The return value is a pointer to the label associated to @p item when + * it was created, with function elm_toolbar_item_append() or similar, + * or later, + * with function elm_toolbar_item_label_set. If no label + * was passed as argument, it will return @c NULL. + * + * @see elm_toolbar_item_label_set() for more details. + * @see elm_toolbar_item_append() + * + * @deprecated use elm_object_item_text_get() instead. + */ +EINA_DEPRECATED EAPI const char *elm_toolbar_item_label_get(const Elm_Object_Item *it); + +/** + * Set the label of item. + * + * @param it The item of toolbar. + * @param label The label of item. + * + * The label to be displayed by the item. + * Label will be placed at icons bottom (if set). + * + * If a label was passed as argument on item creation, with function + * elm_toolbar_item_append() or similar, it will be already + * displayed by the item. + * + * @see elm_toolbar_item_label_get() + * @see elm_toolbar_item_append() + * + * @deprecated use elm_object_item_text_set() instead + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_label_set(Elm_Object_Item *it, const char *label); + +/** + * Return the data associated with a given toolbar widget item. + * + * @param it The toolbar widget item handle. + * @return The data associated with @p item. + * + * @see elm_toolbar_item_data_set() + * + * @deprecated use elm_object_item_data_get() instead. + */ +EINA_DEPRECATED EAPI void *elm_toolbar_item_data_get(const Elm_Object_Item *it); + +/** + * Set the data associated with a given toolbar widget item. + * + * @param it The toolbar widget item handle + * @param data The new data pointer to set to @p item. + * + * This sets new item data on @p item. + * + * @warning The old data pointer won't be touched by this function, so + * the user had better to free that old data himself/herself. + * + * @deprecated use elm_object_item_data_set() instead. + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_data_set(Elm_Object_Item *it, const void *data); + +/** + * Get a value whether toolbar item is disabled or not. + * + * @param it The item. + * @return The disabled state. + * + * @see elm_toolbar_item_disabled_set() for more details. + * + * @deprecated use elm_object_item_disabled_get() instead. + */ +EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_disabled_get(const Elm_Object_Item *it); + +/** + * Sets the disabled/enabled state of a toolbar item. + * + * @param it The item. + * @param disabled The disabled state. + * + * A disabled item cannot be selected or unselected. It will also + * change its appearance (generally greyed out). This sets the + * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for + * enabled). + * + * @deprecated use elm_object_item_disabled_set() instead. + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); + +/** + * Change a toolbar's orientation + * @param obj The toolbar object + * @param vertical If @c EINA_TRUE, the toolbar is vertical + * By default, a toolbar will be horizontal. Use this function to create a vertical toolbar. + * @deprecated use elm_toolbar_horizontal_set() instead. + */ +EINA_DEPRECATED EAPI void elm_toolbar_orientation_set(Evas_Object *obj, Eina_Bool vertical); + +/** + * Get a toolbar's orientation + * @param obj The toolbar object + * @return If @c EINA_TRUE, the toolbar is vertical + * By default, a toolbar will be horizontal. Use this function to determine whether a toolbar is vertical. + * @deprecated use elm_toolbar_horizontal_get() instead. + */ +EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_orientation_get(const Evas_Object *obj); + +/** + * Set the function called when a toolbar item is freed. + * + * @param it The item to set the callback on. + * @param func The function called. + * + * If there is a @p func, then it will be called prior item's memory release. + * That will be called with the following arguments: + * @li item's data; + * @li item's Evas object; + * @li item itself; + * + * This way, a data associated to a toolbar item could be properly freed. + * + * @deprecated Use elm_object_item_del_cb_set() instead + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); + +/** + * Delete them item from the toolbar. + * + * @param it The item of toolbar to be deleted. + * + * @deprecated Use elm_object_item_del() instead + * @see elm_toolbar_item_append() + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_del(Elm_Object_Item *it); + +/** + * Set the text to be shown in a given toolbar item's tooltips. + * + * @param it toolbar item. + * @param text The text to set in the content. + * + * Setup the text as tooltip to object. The item can have only one tooltip, + * so any previous tooltip data - set with this function or + * elm_toolbar_item_tooltip_content_cb_set() - is removed. + * + * @deprecated Use elm_object_item_tooltip_text_set() instead + * @see elm_object_tooltip_text_set() for more details. + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_text_set(Elm_Object_Item *it, const char *text); + +/** + * Set the content to be shown in the tooltip item. + * + * Setup the tooltip to item. The item can have only one tooltip, + * so any previous tooltip data is removed. @p func(with @p data) will + * be called every time that need show the tooltip and it should + * return a valid Evas_Object. This object is then managed fully by + * tooltip system and is deleted when the tooltip is gone. + * + * @param it the toolbar item being attached a tooltip. + * @param func the function used to create the tooltip contents. + * @param data what to provide to @a func as callback data/context. + * @param del_cb called when data is not needed anymore, either when + * another callback replaces @a func, the tooltip is unset with + * elm_toolbar_item_tooltip_unset() or the owner @a item + * dies. This callback receives as the first parameter the + * given @a data, and @c event_info is the item. + * + * @deprecated Use elm_object_item_tooltip_content_cb_set() instead + * @see elm_object_tooltip_content_cb_set() for more details. + * + */ +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); + +/** + * Unset tooltip from item. + * + * @param it toolbar item to remove previously set tooltip. + * + * Remove tooltip from item. The callback provided as del_cb to + * elm_toolbar_item_tooltip_content_cb_set() will be called to notify + * it is not used anymore. + * + * @deprecated Use elm_object_item_tooltip_unset() instead + * @see elm_object_tooltip_unset() for more details. + * @see elm_toolbar_item_tooltip_content_cb_set() + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_unset(Elm_Object_Item *it); + +/** + * Sets a different style for this item tooltip. + * + * @note before you set a style you should define a tooltip with + * elm_toolbar_item_tooltip_content_cb_set() or + * elm_toolbar_item_tooltip_text_set() + * + * @param it toolbar item with tooltip already set. + * @param style the theme style to use (default, transparent, ...) + * + * @deprecated Use elm_object_item_tooltip_style_set() instead + * @see elm_object_tooltip_style_set() for more details. + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_tooltip_style_set(Elm_Object_Item *it, const char *style); + +/** + * Get the style for this item tooltip. + * + * @param it toolbar item with tooltip already set. + * @return style the theme style in use, defaults to "default". If the + * object does not have a tooltip set, then NULL is returned. + * + * @deprecated Use elm_object_item_style_get() instead + * @see elm_object_tooltip_style_get() for more details. + * @see elm_toolbar_item_tooltip_style_set() + * + */ +EINA_DEPRECATED EAPI const char *elm_toolbar_item_tooltip_style_get(const Elm_Object_Item *it); + +/** + * Set the type of mouse pointer/cursor decoration to be shown, + * when the mouse pointer is over the given toolbar widget item + * + * @param it toolbar item to customize cursor on + * @param cursor the cursor type's name + * + * This function works analogously as elm_object_cursor_set(), but + * here the cursor's changing area is restricted to the item's + * area, and not the whole widget's. Note that that item cursors + * have precedence over widget cursors, so that a mouse over an + * item with custom cursor set will always show @b that cursor. + * + * If this function is called twice for an object, a previously set + * cursor will be unset on the second call. + * + * @see elm_object_cursor_set() + * @see elm_toolbar_item_cursor_get() + * @see elm_toolbar_item_cursor_unset() + * + * @deprecated use elm_object_item_cursor_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_set(Elm_Object_Item *it, const char *cursor); + +/* + * Get the type of mouse pointer/cursor decoration set to be shown, + * when the mouse pointer is over the given toolbar widget item + * + * @param it toolbar item with custom cursor set + * @return the cursor type's name or @c NULL, if no custom cursors + * were set to @p item (and on errors) + * + * @see elm_object_cursor_get() + * @see elm_toolbar_item_cursor_set() + * @see elm_toolbar_item_cursor_unset() + * + * @deprecated Use elm_object_item_cursor_get() instead + * + */ +EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_get(const Elm_Object_Item *it); + +/** + * Unset any custom mouse pointer/cursor decoration set to be + * shown, when the mouse pointer is over the given toolbar widget + * item, thus making it show the @b default cursor again. + * + * @param it a toolbar item + * + * Use this call to undo any custom settings on this item's cursor + * decoration, bringing it back to defaults (no custom style set). + * + * @see elm_object_cursor_unset() + * @see elm_toolbar_item_cursor_set() + * + * @deprecated Use elm_object_item_cursor_unset() instead + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_unset(Elm_Object_Item *it); + +/** + * Set a different @b style for a given custom cursor set for a + * toolbar item. + * + * @param it toolbar item with custom cursor set + * @param style the theme style to use (e.g. @c "default", + * @c "transparent", etc) + * + * This function only makes sense when one is using custom mouse + * cursor decorations defined in a theme file, which can have, + * given a cursor name/type, alternate styles on it. It + * works analogously as elm_object_cursor_style_set(), but here + * applies only to toolbar item objects. + * + * @warning Before you set a cursor style you should have defined a + * custom cursor previously on the item, with + * elm_toolbar_item_cursor_set() + * + * @see elm_toolbar_item_cursor_engine_only_set() + * @see elm_toolbar_item_cursor_style_get() + * + * @deprecated Use elm_object_item_cursor_style_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_style_set(Elm_Object_Item *it, const char *style); + +/** + * Get the current @b style set for a given toolbar item's custom + * cursor + * + * @param it toolbar item with custom cursor set. + * @return style the cursor style in use. If the object does not + * have a cursor set, then @c NULL is returned. + * + * @see elm_toolbar_item_cursor_style_set() for more details + * + * @deprecated Use elm_object_item_cursor_style_get() instead + * + */ +EINA_DEPRECATED EAPI const char *elm_toolbar_item_cursor_style_get(const Elm_Object_Item *it); + +/** + * Set if the (custom)cursor for a given toolbar item should be + * searched in its theme, also, or should only rely on the + * rendering engine. + * + * @param it item with custom (custom) cursor already set on + * @param engine_only Use @c EINA_TRUE to have cursors looked for + * only on those provided by the rendering engine, @c EINA_FALSE to + * have them searched on the widget's theme, as well. + * + * @note This call is of use only if you've set a custom cursor + * for toolbar items, with elm_toolbar_item_cursor_set(). + * + * @note By default, cursors will only be looked for between those + * provided by the rendering engine. + * + * @deprecated Use elm_object_item_cursor_engine_only_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_toolbar_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only); + +/** + * Get if the (custom) cursor for a given toolbar item is being + * searched in its theme, also, or is only relying on the rendering + * engine. + * + * @param it a toolbar item + * @return @c EINA_TRUE, if cursors are being looked for only on + * those provided by the rendering engine, @c EINA_FALSE if they + * are being searched on the widget's theme, as well. + * + * @see elm_toolbar_item_cursor_engine_only_set(), for more details + * + * @deprecated Use elm_object_item_cursor_engine_only_get() instead + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_toolbar_item_cursor_engine_only_get(const Elm_Object_Item *it); + +/** + * @brief Link a Elm_Payer with an Elm_Video object. + * + * @param player the Elm_Player object. + * @param video The Elm_Video object. + * + * This mean that action on the player widget will affect the + * video object and the state of the video will be reflected in + * the player itself. + * + * @see elm_player_add() + * @see elm_video_add() + * @deprecated use elm_object_part_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_player_video_set(Evas_Object *player, Evas_Object *video); + +/** + * Set the label of item. + * + * @param it The item of segment control. + * @param label The label of item. + * + * The label to be displayed by the item. + * Label will be at right of the icon (if set). + * + * If a label was passed as argument on item creation, with function + * elm_control_segment_item_add(), it will be already + * displayed by the item. + * + * @see elm_segment_control_item_label_get() + * @see elm_segment_control_item_add() + * @deprecated Use elm_object_item_text_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_segment_control_item_label_set(Elm_Object_Item *it, const char *label); + + +/** + * Set the icon associated to the item. + * + * @param it The segment control item. + * @param icon The icon object to associate with @p it. + * + * The icon object to use at left side of the item. An + * icon can be any Evas object, but usually it is an icon created + * with elm_icon_add(). + * + * Once the icon object is set, a previously set one will be deleted. + * @warning Setting the same icon for two items will cause the icon to + * disappear from the first item. + * + * If an icon was passed as argument on item creation, with function + * elm_segment_control_item_add(), it will be already + * associated to the item. + * + * @see elm_segment_control_item_add() + * @see elm_segment_control_item_icon_get() + * @deprecated Use elm_object_item_part_content_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_segment_control_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); + +/** + * Remove a segment control item from its parent, deleting it. + * + * @param it The item to be removed. + * + * Items can be added with elm_segment_control_item_add() or + * elm_segment_control_item_insert_at(). + * + * @deprecated Use elm_object_item_del() instead + */ +EINA_DEPRECATED EAPI void elm_segment_control_item_del(Elm_Object_Item *it); + +/** + * Get the label + * + * @param obj The multibuttonentry object + * @return The label, or NULL if none + * + * @deprecated Use elm_object_text_get() instead + * + */ +EINA_DEPRECATED EAPI const char *elm_multibuttonentry_label_get(const Evas_Object *obj); + +/** + * Set the label + * + * @param obj The multibuttonentry object + * @param label The text label string + * + * @deprecated Use elm_object_text_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_multibuttonentry_label_set(Evas_Object *obj, const char *label); + +/** + * Get the label of a given item + * + * @param it The item + * @return The label of a given item, or NULL if none + * + * @deprecated Use elm_object_item_text_get() instead + * + */ +EINA_DEPRECATED EAPI const char *elm_multibuttonentry_item_label_get(const Elm_Object_Item *it); + +/** + * Set the label of a given item + * + * @param it The item + * @param str The text label string + * + * @deprecated Use elm_object_item_text_set() instead + */ +EINA_DEPRECATED EAPI void elm_multibuttonentry_item_label_set(Elm_Object_Item *it, const char *str); + +/** + * Delete a given item + * + * @param it The item + * + * @deprecated Use elm_object_item_del() instead + * + */ +EINA_DEPRECATED EAPI void elm_multibuttonentry_item_del(Elm_Object_Item *it); + +/** + * @brief Delete the given item instantly. + * + * @param it The naviframe item + * + * This just deletes the given item from the naviframe item list instantly. + * So this would not emit any signals for view transitions but just change + * the current view if the given item is a top one. + * + * @deprecated Use elm_object_item_del() instead + */ +EINA_DEPRECATED EAPI void elm_naviframe_item_del(Elm_Object_Item *it); + + + +/** + * Sets the disabled/enabled state of a list item. + * + * @param it The item. + * @param disabled The disabled state. + * + * A disabled item cannot be selected or unselected. It will also + * change its appearance (generally greyed out). This sets the + * disabled state (@c EINA_TRUE for disabled, @c EINA_FALSE for + * enabled). + * + * @deprecated Use elm_object_item_disabled_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_list_item_disabled_set(Elm_Object_Item *it, Eina_Bool disabled); + +/** + * Get a value whether list item is disabled or not. + * + * @param it The item. + * @return The disabled state. + * + * @see elm_list_item_disabled_set() for more details. + * + * @deprecated Use elm_object_item_disabled_get() instead + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_list_item_disabled_get(const Elm_Object_Item *it); + +/** + * Set the function called when a list item is freed. + * + * @param it The item to set the callback on + * @param func The function called + * + * If there is a @p func, then it will be called prior item's memory release. + * That will be called with the following arguments: + * @li item's data; + * @li item's Evas object; + * @li item itself; + * + * This way, a data associated to a list item could be properly freed. + * + * @deprecated Please use elm_object_item_del_cb_set() instead. + * + */ +EINA_DEPRECATED EAPI void elm_list_item_del_cb_set(Elm_Object_Item *it, Evas_Smart_Cb func); + +/** + * Get the data associated to the item. + * + * @param it The list item + * @return The data associated to @p item + * + * The return value is a pointer to data associated to @p item when it was + * created, with function elm_list_item_append() or similar. If no data + * was passed as argument, it will return @c NULL. + * + * @see elm_list_item_append() + * + * @deprecated Please use elm_object_item_data_get() instead. + * + */ +EINA_DEPRECATED EAPI void *elm_list_item_data_get(const Elm_Object_Item *it); + +/** + * Get the left side icon associated to the item. + * + * @param it The list item + * @return The left side icon associated to @p item + * + * The return value is a pointer to the icon associated to @p item when + * it was + * created, with function elm_list_item_append() or similar, or later + * with function elm_list_item_icon_set(). If no icon + * was passed as argument, it will return @c NULL. + * + * @see elm_list_item_append() + * @see elm_list_item_icon_set() + * + * @deprecated Please use elm_object_item_part_content_get(item, NULL); + */ +EINA_DEPRECATED EAPI Evas_Object *elm_list_item_icon_get(const Elm_Object_Item *it); + +/** + * Set the left side icon associated to the item. + * + * @param it The list item + * @param icon The left side icon object to associate with @p item + * + * The icon object to use at left side of the item. An + * icon can be any Evas object, but usually it is an icon created + * with elm_icon_add(). + * + * Once the icon object is set, a previously set one will be deleted. + * @warning Setting the same icon for two items will cause the icon to + * disappear from the first item. + * + * If an icon was passed as argument on item creation, with function + * elm_list_item_append() or similar, it will be already + * associated to the item. + * + * @see elm_list_item_append() + * @see elm_list_item_icon_get() + * + * @deprecated Please use elm_object_item_part_content_set(item, NULL, icon); + */ +EINA_DEPRECATED EAPI void elm_list_item_icon_set(Elm_Object_Item *it, Evas_Object *icon); + +/** + * Get the right side icon associated to the item. + * + * @param it The list item + * @return The right side icon associated to @p item + * + * The return value is a pointer to the icon associated to @p item when + * it was + * created, with function elm_list_item_append() or similar, or later + * with function elm_list_item_icon_set(). If no icon + * was passed as argument, it will return @c NULL. + * + * @see elm_list_item_append() + * @see elm_list_item_icon_set() + * + * @deprecated Please use elm_object_item_part_content_get(item, "end"); + */ +EINA_DEPRECATED EAPI Evas_Object *elm_list_item_end_get(const Elm_Object_Item *it); + +/** + * Set the right side icon associated to the item. + * + * @param it The list item + * @param end The right side icon object to associate with @p item + * + * The icon object to use at right side of the item. An + * icon can be any Evas object, but usually it is an icon created + * with elm_icon_add(). + * + * Once the icon object is set, a previously set one will be deleted. + * @warning Setting the same icon for two items will cause the icon to + * disappear from the first item. + * + * If an icon was passed as argument on item creation, with function + * elm_list_item_append() or similar, it will be already + * associated to the item. + * + * @see elm_list_item_append() + * @see elm_list_item_end_get() + * + * @deprecated Please use elm_object_item_part_content_set(item, "end", end); + */ +EINA_DEPRECATED EAPI void elm_list_item_end_set(Elm_Object_Item *it, Evas_Object *end); + +/** + * Get the label of item. + * + * @param it The item of list. + * @return The label of item. + * + * The return value is a pointer to the label associated to @p item when + * it was created, with function elm_list_item_append(), or later + * with function elm_list_item_label_set. If no label + * was passed as argument, it will return @c NULL. + * + * @see elm_list_item_label_set() for more details. + * @see elm_list_item_append() + * + * @deprecated Please use elm_object_item_text_get(item); + */ +EINA_DEPRECATED EAPI const char *elm_list_item_label_get(const Elm_Object_Item *it); + +/** + * Set the label of item. + * + * @param it The item of list. + * @param text The label of item. + * + * The label to be displayed by the item. + * Label will be placed between left and right side icons (if set). + * + * If a label was passed as argument on item creation, with function + * elm_list_item_append() or similar, it will be already + * displayed by the item. + * + * @see elm_list_item_label_get() + * @see elm_list_item_append() + * + * @deprecated Please use elm_object_item_text_set(item, text); + */ +EINA_DEPRECATED EAPI void elm_list_item_label_set(Elm_Object_Item *it, const char *text); + +/** + * Set the text to be shown in a given list item's tooltips. + * + * @param it Target item. + * @param text The text to set in the content. + * + * Setup the text as tooltip to object. The item can have only one tooltip, + * so any previous tooltip data - set with this function or + * elm_list_item_tooltip_content_cb_set() - is removed. + * + * @deprecated Use elm_object_item_tooltip_text_set() instead + * @see elm_object_tooltip_text_set() for more details. + * + */ +EINA_DEPRECATED EAPI void elm_list_item_tooltip_text_set(Elm_Object_Item *it, const char *text); + +/** + * @brief Disable size restrictions on an object's tooltip + * @param it The tooltip's anchor object + * @param disable If EINA_TRUE, size restrictions are disabled + * @return EINA_FALSE on failure, EINA_TRUE on success + * + * This function allows a tooltip to expand beyond its parent window's canvas. + * It will instead be limited only by the size of the display. + * + * @deprecated Use elm_object_item_tooltip_window_mode_set() instead + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_set(Elm_Object_Item *it, Eina_Bool disable); + +/** + * @brief Retrieve size restriction state of an object's tooltip + * @param obj The tooltip's anchor object + * @return If EINA_TRUE, size restrictions are disabled + * + * This function returns whether a tooltip is allowed to expand beyond + * its parent window's canvas. + * It will instead be limited only by the size of the display. + * + * @deprecated Use elm_object_item_tooltip_window_mode_get() instead + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_list_item_tooltip_window_mode_get(const Elm_Object_Item *it); + +/** + * Set the content to be shown in the tooltip item. + * + * Setup the tooltip to item. The item can have only one tooltip, + * so any previous tooltip data is removed. @p func(with @p data) will + * be called every time that need show the tooltip and it should + * return a valid Evas_Object. This object is then managed fully by + * tooltip system and is deleted when the tooltip is gone. + * + * @param it the list item being attached a tooltip. + * @param func the function used to create the tooltip contents. + * @param data what to provide to @a func as callback data/context. + * @param del_cb called when data is not needed anymore, either when + * another callback replaces @a func, the tooltip is unset with + * elm_list_item_tooltip_unset() or the owner @a item + * dies. This callback receives as the first parameter the + * given @a data, and @c event_info is the item. + * + * @deprecated Use elm_object_item_tooltip_content_cb_set() instead + * + * @see elm_object_tooltip_content_cb_set() for more details. + * + */ +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); + +/** + * Unset tooltip from item. + * + * @param it list item to remove previously set tooltip. + * + * Remove tooltip from item. The callback provided as del_cb to + * elm_list_item_tooltip_content_cb_set() will be called to notify + * it is not used anymore. + * + * @deprecated Use elm_object_item_tooltip_unset() instead + * @see elm_object_tooltip_unset() for more details. + * @see elm_list_item_tooltip_content_cb_set() + * + */ +EINA_DEPRECATED EAPI void elm_list_item_tooltip_unset(Elm_Object_Item *it); + +/** + * Sets a different style for this item tooltip. + * + * @note before you set a style you should define a tooltip with + * elm_list_item_tooltip_content_cb_set() or + * elm_list_item_tooltip_text_set() + * + * @param it list item with tooltip already set. + * @param style the theme style to use (default, transparent, ...) + * + * + * @deprecated Use elm_object_item_tooltip_style_set() instead + * @see elm_object_tooltip_style_set() for more details. + * + */ +EINA_DEPRECATED EAPI void elm_list_item_tooltip_style_set(Elm_Object_Item *it, const char *style); + +/** + * Get the style for this item tooltip. + * + * @param it list item with tooltip already set. + * @return style the theme style in use, defaults to "default". If the + * object does not have a tooltip set, then NULL is returned. + * + * @deprecated Use elm_object_item_tooltip_style_get() instead + * + * @see elm_object_tooltip_style_get() for more details. + * @see elm_list_item_tooltip_style_set() + * + */ +EINA_DEPRECATED EAPI const char *elm_list_item_tooltip_style_get(const Elm_Object_Item *it); + +/** + * Set the type of mouse pointer/cursor decoration to be shown, + * when the mouse pointer is over the given list widget item + * + * @param it list item to customize cursor on + * @param cursor the cursor type's name + * + * This function works analogously as elm_object_cursor_set(), but + * here the cursor's changing area is restricted to the item's + * area, and not the whole widget's. Note that that item cursors + * have precedence over widget cursors, so that a mouse over an + * item with custom cursor set will always show @b that cursor. + * + * If this function is called twice for an object, a previously set + * cursor will be unset on the second call. + * + * @see elm_object_cursor_set() + * @see elm_list_item_cursor_get() + * @see elm_list_item_cursor_unset() + * + * @deprecated Please use elm_object_item_cursor_set() instead + */ +EINA_DEPRECATED EAPI void elm_list_item_cursor_set(Elm_Object_Item *it, const char *cursor); + +/* + * Get the type of mouse pointer/cursor decoration set to be shown, + * when the mouse pointer is over the given list widget item + * + * @param it list item with custom cursor set + * @return the cursor type's name or @c NULL, if no custom cursors + * were set to @p item (and on errors) + * + * @see elm_object_cursor_get() + * @see elm_list_item_cursor_set() + * @see elm_list_item_cursor_unset() + * + * @deprecated Please use elm_object_item_cursor_get() instead + */ +EINA_DEPRECATED EAPI const char *elm_list_item_cursor_get(const Elm_Object_Item *it); + +/** + * Unset any custom mouse pointer/cursor decoration set to be + * shown, when the mouse pointer is over the given list widget + * item, thus making it show the @b default cursor again. + * + * @param it a list item + * + * Use this call to undo any custom settings on this item's cursor + * decoration, bringing it back to defaults (no custom style set). + * + * @see elm_object_cursor_unset() + * @see elm_list_item_cursor_set() + * + * @deprecated Please use elm_list_item_cursor_unset() instead + */ +EINA_DEPRECATED EAPI void elm_list_item_cursor_unset(Elm_Object_Item *it); + +/** + * Set a different @b style for a given custom cursor set for a + * list item. + * + * @param it list item with custom cursor set + * @param style the theme style to use (e.g. @c "default", + * @c "transparent", etc) + * + * This function only makes sense when one is using custom mouse + * cursor decorations defined in a theme file, which can have, + * given a cursor name/type, alternate styles on it. It + * works analogously as elm_object_cursor_style_set(), but here + * applies only to list item objects. + * + * @warning Before you set a cursor style you should have defined a + * custom cursor previously on the item, with + * elm_list_item_cursor_set() + * + * @see elm_list_item_cursor_engine_only_set() + * @see elm_list_item_cursor_style_get() + * + * @deprecated Please use elm_list_item_cursor_style_set() instead + */ +EINA_DEPRECATED EAPI void elm_list_item_cursor_style_set(Elm_Object_Item *it, const char *style); + +/** + * Get the current @b style set for a given list item's custom + * cursor + * + * @param it list item with custom cursor set. + * @return style the cursor style in use. If the object does not + * have a cursor set, then @c NULL is returned. + * + * @see elm_list_item_cursor_style_set() for more details + * + * @deprecated Please use elm_list_item_cursor_style_get() instead + */ +EINA_DEPRECATED EAPI const char *elm_list_item_cursor_style_get(const Elm_Object_Item *it); + +/** + * Set if the (custom)cursor for a given list item should be + * searched in its theme, also, or should only rely on the + * rendering engine. + * + * @param it item with custom (custom) cursor already set on + * @param engine_only Use @c EINA_TRUE to have cursors looked for + * only on those provided by the rendering engine, @c EINA_FALSE to + * have them searched on the widget's theme, as well. + * + * @note This call is of use only if you've set a custom cursor + * for list items, with elm_list_item_cursor_set(). + * + * @note By default, cursors will only be looked for between those + * provided by the rendering engine. + * + * @deprecated Please use elm_list_item_cursor_engine_only_set() instead + */ +EINA_DEPRECATED EAPI void elm_list_item_cursor_engine_only_set(Elm_Object_Item *it, Eina_Bool engine_only); + +/** + * Get if the (custom) cursor for a given list item is being + * searched in its theme, also, or is only relying on the rendering + * engine. + * + * @param it a list item + * @return @c EINA_TRUE, if cursors are being looked for only on + * those provided by the rendering engine, @c EINA_FALSE if they + * are being searched on the widget's theme, as well. + * + * @see elm_list_item_cursor_engine_only_set(), for more details + * + * @deprecated Please use elm_list_item_cursor_engine_only_get() instead + */ +EINA_DEPRECATED EAPI Eina_Bool elm_list_item_cursor_engine_only_get(const Elm_Object_Item *it); + +/** + * Delete the item from the list. + * + * @param it The item of list to be deleted. + * + * If deleting all list items is required, elm_list_clear() + * should be used instead of getting items list and deleting each one. + * + * @see elm_list_clear() + * @see elm_list_item_append() + * @see elm_widget_item_del_cb_set() + * @deprecated Use elm_object_item_del() instead + * + */ +EINA_DEPRECATED EAPI void elm_list_item_del(Elm_Object_Item *it); + +/** + * Set the shrink state of toolbar @p obj. + * + * @param obj The toolbar object. + * @param shrink_mode Toolbar's items display behavior. + * + * The toolbar won't scroll if #ELM_TOOLBAR_SHRINK_NONE, + * but will enforce a minimum size so all the items will fit, won't scroll + * and won't show the items that don't fit if #ELM_TOOLBAR_SHRINK_HIDE, + * will scroll if #ELM_TOOLBAR_SHRINK_SCROLL, and will create a button to + * pop up excess elements with #ELM_TOOLBAR_SHRINK_MENU. + * + * @deprecated Please use elm_toolbar_shrink_mode_set(obj, shrink_mode); + */ +EINA_DEPRECATED EAPI void elm_toolbar_mode_shrink_set(Evas_Object *obj, Elm_Toolbar_Shrink_Mode shrink_mode); + +/** + * Get the shrink mode of toolbar @p obj. + * + * @param obj The toolbar object. + * @return Toolbar's items display behavior. + * + * @see elm_toolbar_shrink_mode_set() for details. + * + * @deprecated Please use elm_toolbar_shrink_mode_get(obj); + */ +EINA_DEPRECATED EAPI Elm_Toolbar_Shrink_Mode elm_toolbar_mode_shrink_get(const Evas_Object *obj); + +/** + * This sets a widget to be displayed to the left of a scrolled entry. + * + * @param obj The scrolled entry object + * @param icon The widget to display on the left side of the scrolled + * entry. + * + * @note A previously set widget will be destroyed. + * @note If the object being set does not have minimum size hints set, + * it won't get properly displayed. + * + * @deprecated Use elm_object_part_content_set(entry, "icon", content) instead + * @see elm_entry_end_set() + */ +EINA_DEPRECATED EAPI void elm_entry_icon_set(Evas_Object *obj, Evas_Object *icon); + +/** + * Gets the leftmost widget of the scrolled entry. This object is + * owned by the scrolled entry and should not be modified. + * + * @param obj The scrolled entry object + * @return the left widget inside the scroller + * + * @deprecated Use elm_object_part_content_get(entry, "icon") instead + */ +EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_get(const Evas_Object *obj); + +/** + * Unset the leftmost widget of the scrolled entry, unparenting and + * returning it. + * + * @param obj The scrolled entry object + * @return the previously set icon sub-object of this entry, on + * success. + * + * @deprecated Use elm_object_part_content_unset(entry, "icon") instead + * @see elm_entry_icon_set() + */ +EINA_DEPRECATED EAPI Evas_Object *elm_entry_icon_unset(Evas_Object *obj); + +/** + * This sets a widget to be displayed to the end of a scrolled entry. + * + * @param obj The scrolled entry object + * @param end The widget to display on the right side of the scrolled + * entry. + * + * @note A previously set widget will be destroyed. + * @note If the object being set does not have minimum size hints set, + * it won't get properly displayed. + * + * @deprecated Use elm_object_part_content_set(entry, "end", content) instead + * @see elm_entry_icon_set + */ +EINA_DEPRECATED EAPI void elm_entry_end_set(Evas_Object *obj, Evas_Object *end); + +/** + * Gets the endmost widget of the scrolled entry. This object is owned + * by the scrolled entry and should not be modified. + * + * @param obj The scrolled entry object + * @return the right widget inside the scroller + * + * @deprecated Use elm_object_part_content_get(entry, "end") instead + */ +EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_get(const Evas_Object *obj); + +/** + * Unset the endmost widget of the scrolled entry, unparenting and + * returning it. + * + * @param obj The scrolled entry object + * @return the previously set icon sub-object of this entry, on + * success. + * + * @deprecated Use elm_object_part_content_unset(entry, "end") instead + * @see elm_entry_icon_set() + */ +EINA_DEPRECATED EAPI Evas_Object *elm_entry_end_unset(Evas_Object *obj); + +/** + * Set route service to be used. By default used source is + * #ELM_MAP_ROUTE_SOURCE_YOURS. + * + * @see elm_map_route_source_set() + * @see elm_map_route_source_get() + * + */ +typedef enum +{ + ELM_MAP_ROUTE_SOURCE_YOURS, /**< Routing service http://www.yournavigation.org/ . Set by default.*/ + ELM_MAP_ROUTE_SOURCE_MONAV, /**< MoNav offers exact routing without heuristic assumptions. Its routing core is based on Contraction Hierarchies. It's not working with Map yet. */ + ELM_MAP_ROUTE_SOURCE_ORS, /**< Open Route Service: http://www.openrouteservice.org/ . It's not working with Map yet. */ + ELM_MAP_ROUTE_SOURCE_LAST +} Elm_Map_Route_Sources; + +/** + * Convert a pixel coordinate into a rotated pixel coordinate. + * + * @param obj The map object. + * @param x horizontal coordinate of the point to rotate. + * @param y vertical coordinate of the point to rotate. + * @param cx rotation's center horizontal position. + * @param cy rotation's center vertical position. + * @param degree amount of degrees from 0.0 to 360.0 to rotate around Z axis. + * @param xx Pointer where to store rotated x. + * @param yy Pointer where to store rotated y. + * + * @deprecated Use elm_map_canvas_to_geo_convert() instead + */ +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); + +/** + * Convert a pixel coordinate (x,y) into a geographic coordinate + * (longitude, latitude). + * + * @param obj The map object. + * @param x the coordinate. + * @param y the coordinate. + * @param size the size in pixels of the map. + * The map is a square and generally his size is : pow(2.0, zoom)*256. + * @param lon Pointer to store the longitude that correspond to x. + * @param lat Pointer to store the latitude that correspond to y. + * + * @note Origin pixel point is the top left corner of the viewport. + * Map zoom and size are taken on account. + * + * @see elm_map_utils_convert_geo_into_coord() if you need the inverse. + * + * @deprecated Use elm_map_canvas_to_geo_convert() instead + */ +EINA_DEPRECATED EAPI void elm_map_utils_convert_coord_into_geo(const Evas_Object *obj, int x, int y, int size, double *lon, double *lat); + +/** + * Convert a geographic coordinate (longitude, latitude) into a pixel + * coordinate (x, y). + * + * @param obj The map object. + * @param lon the longitude. + * @param lat the latitude. + * @param size the size in pixels of the map. The map is a square + * and generally his size is : pow(2.0, zoom)*256. + * @param x Pointer to store the horizontal pixel coordinate that + * correspond to the longitude. + * @param y Pointer to store the vertical pixel coordinate that + * correspond to the latitude. + * + * @note Origin pixel point is the top left corner of the viewport. + * Map zoom and size are taken on account. + * + * @see elm_map_utils_convert_coord_into_geo() if you need the inverse. + * + * @deprecatedUse Use elm_map_canvas_to_geo_convert() instead + */ +EINA_DEPRECATED EAPI void elm_map_utils_convert_geo_into_coord(const Evas_Object *obj, double lon, double lat, int size, int *x, int *y); + +/** + * Get the information of downloading status. + * + * @param obj The map object. + * @param try_num Pointer to store number of tiles being downloaded. + * @param finish_num Pointer to store number of tiles successfully + * downloaded. + * + * This gets the current downloading status for the map object, the number + * of tiles being downloaded and the number of tiles already downloaded. + * + * @deprecatedUse Use elm_map_tile_load_status_get() instead + */ +EINA_DEPRECATED EAPI void elm_map_utils_downloading_status_get(const Evas_Object *obj, int *try_num, int *finish_num); + +/** + * Convert a geographic coordinate (longitude, latitude) into a name + * (address). + * + * @param obj The map object. + * @param lon the longitude. + * @param lat the latitude. + * @return name A #Elm_Map_Name handle for this coordinate. + * + * To get the string for this address, elm_map_name_address_get() + * should be used. + * + * @see elm_map_utils_convert_name_into_coord() if you need the inverse. + * @deprecatedUse Use elm_map_name_add() instead + * + */ +EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_coord_into_name(const Evas_Object *obj, double lon, double lat); + +/** + * Convert a name (address) into a geographic coordinate + * (longitude, latitude). + * + * @param obj The map object. + * @param address The address. + * @return name A #Elm_Map_Name handle for this address. + * + * To get the longitude and latitude, elm_map_name_region_get() + * should be used. + * + * @see elm_map_utils_convert_coord_into_name() if you need the inverse. + * @deprecatedUse Use elm_map_name_geo_request() instead + * + */ +EINA_DEPRECATED EAPI Elm_Map_Name *elm_map_utils_convert_name_into_coord(const Evas_Object *obj, char *address); + +/** + * Convert canvas coordinates into a geographic coordinate + * (longitude, latitude). + * + * @param obj The map object. + * @param x horizontal coordinate of the point to convert. + * @param y vertical coordinate of the point to convert. + * @param lon A pointer to the longitude. + * @param lat A pointer to the latitude. + * + * This gets longitude and latitude from canvas x, y coordinates. The canvas + * coordinates mean x, y coordinate from current viewport. + * + * see elm_map_rotate_get() + * @deprecatedUse Use elm_map_canvas_to_region_convert() instead + * + */ +EINA_DEPRECATED EAPI void elm_map_canvas_to_geo_convert(const Evas_Object *obj, const Evas_Coord x, const Evas_Coord y, double *lon, double *lat); + +/** + * Get the current geographic coordinates of the map. + * + * @param obj The map object. + * @param lon Pointer to store longitude. + * @param lat Pointer to store latitude. + * + * This gets the current center coordinates of the map object. It can be + * set by elm_map_region_bring_in() and elm_map_region_show(). + * + * @see elm_map_region_bring_in() + * @see elm_map_region_show() + * + * @deprecated Use elm_map_region_get() instead + */ +EINA_DEPRECATED EAPI void elm_map_geo_region_get(const Evas_Object *obj, double *lon, double *lat); + +/** + * Animatedly bring in given coordinates to the center of the map. + * + * @param obj The map object. + * @param lon Longitude to center at. + * @param lat Latitude to center at. + * + * This causes map to jump to the given @p lat and @p lon coordinates + * and show it (by scrolling) in the center of the viewport, if it is not + * already centered. This will use animation to do so and take a period + * of time to complete. + * + * @see elm_map_region_show() for a function to avoid animation. + * @see elm_map_region_get() + * + * @deprecated Use elm_map_region_bring_in() instead + */ +EINA_DEPRECATED EAPI void elm_map_geo_region_bring_in(Evas_Object *obj, double lon, double lat); + +/** + * Show the given coordinates at the center of the map, @b immediately. + * + * @param obj The map object. + * @param lon Longitude to center at. + * @param lat Latitude to center at. + * + * This causes map to @b redraw its viewport's contents to the + * region containing the given @p lat and @p lon, that will be moved to the + * center of the map. + * + * @see elm_map_region_bring_in() for a function to move with animation. + * @see elm_map_region_get() + * + * @deprecated Use elm_map_region_show() instead + */ +EINA_DEPRECATED EAPI void elm_map_geo_region_show(Evas_Object *obj, double lon, double lat); + +/** + * Set the minimum zoom of the source. + * + * @param obj The map object. + * @param zoom New minimum zoom value to be used. + * + * By default, it's 0. + * + * @deprecated Use elm_map_zoom_min_set() instead + */ +EINA_DEPRECATED EAPI void elm_map_source_zoom_min_set(Evas_Object *obj, int zoom); + +/** + * Get the minimum zoom of the source. + * + * @param obj The map object. + * @return Returns the minimum zoom of the source. + * + * @see elm_map_zoom_min_set() for details. + * + * @deprecated Use elm_map_zoom_min_get() instead + */ +EINA_DEPRECATED EAPI int elm_map_source_zoom_min_get(const Evas_Object *obj); + +/** + * Set the maximum zoom of the source. + * + * @param obj The map object. + * @param zoom New maximum zoom value to be used. + * + * By default, it's 18. + * + * @deprecated Use elm_map_zoom_max_set() instead + */ +EINA_DEPRECATED EAPI void elm_map_source_zoom_max_set(Evas_Object *obj, int zoom); + +/** + * Get the maximum zoom of the source. + * + * @param obj The map object. + * @return Returns the maximum zoom of the source. + * + * @see elm_map_zoom_min_set() for details. + * + * @deprecated Use elm_map_zoom_max_get() instead + */ +EINA_DEPRECATED EAPI int elm_map_source_zoom_max_get(const Evas_Object *obj); + + +/** + * Get the list of available sources. + * + * @param obj The map object. + * @return The source names list. + * + * It will provide a list with all available sources, that can be set as + * current source with elm_map_source_name_set(), or get with + * elm_map_source_name_get(). + * + * Available sources: + * @li "Mapnik" + * @li "Osmarender" + * @li "CycleMap" + * @li "Maplint" + * + * @see elm_map_source_name_set() for more details. + * @see elm_map_source_name_get() + * @deprecated Use elm_map_sources_get() instead + * + */ +EINA_DEPRECATED EAPI const char **elm_map_source_names_get(const Evas_Object *obj); + +/** + * Set the source of the map. + * + * @param obj The map object. + * @param source_name The source to be used. + * + * Map widget retrieves images that composes the map from a web service. + * This web service can be set with this method. + * + * A different service can return a different maps with different + * information and it can use different zoom values. + * + * The @p source_name need to match one of the names provided by + * elm_map_source_names_get(). + * + * The current source can be get using elm_map_source_name_get(). + * + * @see elm_map_source_names_get() + * @see elm_map_source_name_get() + * @deprecated Use elm_map_source_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_map_source_name_set(Evas_Object *obj, const char *source_name); + +/** + * Get the name of currently used source. + * + * @param obj The map object. + * @return Returns the name of the source in use. + * + * @see elm_map_source_name_set() for more details. + * @deprecated Use elm_map_source_get() instead + * + */ +EINA_DEPRECATED EAPI const char *elm_map_source_name_get(const Evas_Object *obj); + +/** + * Set the source of the route service to be used by the map. + * + * @param obj The map object. + * @param source The route service to be used, being it one of + * #ELM_MAP_ROUTE_SOURCE_YOURS (default), #ELM_MAP_ROUTE_SOURCE_MONAV, + * and #ELM_MAP_ROUTE_SOURCE_ORS. + * + * Each one has its own algorithm, so the route retrieved may + * differ depending on the source route. Now, only the default is working. + * + * #ELM_MAP_ROUTE_SOURCE_YOURS is the routing service provided at + * http://www.yournavigation.org/. + * + * #ELM_MAP_ROUTE_SOURCE_MONAV, offers exact routing without heuristic + * assumptions. Its routing core is based on Contraction Hierarchies. + * + * #ELM_MAP_ROUTE_SOURCE_ORS, is provided at http://www.openrouteservice.org/ + * + * @see elm_map_route_source_get(). + * @deprecated Use elm_map_source_set() instead + * + */ +EINA_DEPRECATED EAPI void elm_map_route_source_set(Evas_Object *obj, Elm_Map_Route_Sources source); -- 2.7.4