From 94ca9ce615cb1cc1fb2e6a6750382d63f818399f Mon Sep 17 00:00:00 2001 From: Jiyoun Park Date: Thu, 15 Mar 2012 08:58:34 +0000 Subject: [PATCH] update info SVN revision: 69364 --- legacy/elementary/src/lib/elm_deprecated.h | 270 --------------------- legacy/elementary/src/lib/elm_removed.h | 269 ++++++++++++++++++++ 2 files changed, 269 insertions(+), 270 deletions(-) diff --git a/legacy/elementary/src/lib/elm_deprecated.h b/legacy/elementary/src/lib/elm_deprecated.h index 7fe8103a38..fc0d4ac5fb 100644 --- a/legacy/elementary/src/lib/elm_deprecated.h +++ b/legacy/elementary/src/lib/elm_deprecated.h @@ -219,29 +219,6 @@ EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_autosave_get(const Evas_Obj EINA_DEPRECATED EAPI void elm_scrolled_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly); EINA_DEPRECATED EAPI Eina_Bool elm_scrolled_entry_cnp_textonly_get(Evas_Object *obj); -/** - * Get the real Evas object created to implement the view of a - * given genlist item - * - * @param it The genlist item. - * @return the Evas object implementing this item's view. - * - * This returns the actual Evas object used to implement the - * specified genlist item's view. This may be @c NULL, as it may - * not have been created or may have been deleted, at any time, by - * the genlist. Do not modify this object (move, resize, - * show, hide, etc.), as the genlist is controlling it. This - * function is for querying, emitting custom signals or hooking - * lower level callbacks for events on that object. Do not delete - * this object under any circumstances. - * - * @see elm_object_item_data_get() - * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit(). - * - */ -EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it); - - /** * Convert a pixel coordinate (x,y) into a geographic coordinate * (longitude, latitude). @@ -677,250 +654,3 @@ EINA_DEPRECATED EAPI void elm_pager_item_style_default_set(Evas_Obje */ EINA_DEPRECATED EAPI const char *elm_pager_item_style_default_get(const Evas_Object *obj); -/** - * Set the always select mode. - * - * @param obj The genlist object - * @param always_select The always select mode (@c EINA_TRUE = on, @c - * EINA_FALSE = off). Default is @c EINA_FALSE. - * - * Items will only call their selection func and callback when first - * becoming selected. Any further clicks will do nothing, unless you - * enable always select with elm_genlist_always_select_mode_set(). - * This means that, even if selected, every click will make the selected - * callbacks be called. - * - * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_ALWAYS); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. - * - */ -EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); - - -/** - * Get the always select mode. - * - * @param obj The genlist object - * @return The always select mode - * (@c EINA_TRUE = on, @c EINA_FALSE = off) - * - * @deprecated use elm_genlist_select_mode_get instead. - * - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj); - -/** - * Enable/disable the no select mode. - * - * @param obj The genlist object - * @param no_select The no select mode - * (EINA_TRUE = on, EINA_FALSE = off) - * - * This will turn off the ability to select items entirely and they - * will neither appear selected nor call selected callback functions. - * - * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_NONE); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. - * - */ -EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); - -/** - * Gets whether the no select mode is enabled. - * - * @param obj The genlist object - * @return The no select mode - * (@c EINA_TRUE = on, @c EINA_FALSE = off) - * - * @deprecated use elm_genlist_select_mode_get instead. - * - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj); - -/* - * Enable/disable compress mode. - * - * @param obj The genlist object - * @param compress The compress mode - * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE. - * - * This will enable the compress mode where items are "compressed" - * horizontally to fit the genlist scrollable viewport width. This is - * special for genlist. Do not rely on - * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to - * work as genlist needs to handle it specially. - * - * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) - */ -EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress); - -/** - * Sets the display only state of an item. - * - * @param it The item - * @param display_only @c EINA_TRUE if the item is display only, @c - * EINA_FALSE otherwise. - * - * A display only item cannot be selected or unselected. It is for - * display only and not selecting or otherwise clicking, dragging - * etc. by the user, thus finger size rules will not be applied to - * this item. - * - * It's good to set group index items to display only state. - * - * @see elm_genlist_item_display_only_get() - * - * @deprecated elm_genlist_item_display_only_set() - */ -EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only); - -/** - * Get the display only state of an item - * - * @param it The item - * @return @c EINA_TRUE if the item is display only, @c - * EINA_FALSE otherwise. - * - * @see elm_genlist_item_display_only_set() - * - * @deprecated elm_genlist_item_display_only_get() - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it); - -/** - * Get whether the compress mode is enabled. - * - * @param obj The genlist object - * @return The compress mode - * (@c EINA_TRUE = on, @c EINA_FALSE = off) - * - * @deprecated elm_genlsit_mode_get() - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj); - -/** - * Enable/disable height-for-width mode. - * - * @param obj The genlist object - * @param height_for_width The height-for-width mode (@c EINA_TRUE = on, - * @c EINA_FALSE = off). Default is @c EINA_FALSE. - * - * With height-for-width mode the item width will be fixed (restricted - * to a minimum of) to the list width when calculating its size in - * order to allow the height to be calculated based on it. This allows, - * for instance, text block to wrap lines if the Edje part is - * configured with "text.min: 0 1". - * - * @note This mode will make list resize slower as it will have to - * recalculate every item height again whenever the list width - * changes! - * - * @note When height-for-width mode is enabled, it also enables - * compress mode (see elm_genlist_compress_mode_set()) and - * disables homogeneous (see elm_genlist_homogeneous_set()). - * - * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) - */ -EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width); - -/** - * Get whether the height-for-width mode is enabled. - * - * @param obj The genlist object - * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE = - * off) - * - * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj); - -/** - * Activate a genlist mode on an item - * - * @param it The genlist item - * @param mode_type Mode name - * @param mode_set Boolean to define set or unset mode. - * - * A genlist mode is a different way of selecting an item. Once a mode is - * activated on an item, any other selected item is immediately unselected. - * This feature provides an easy way of implementing a new kind of animation - * for selecting an item, without having to entirely rewrite the item style - * theme. However, the elm_genlist_selected_* API can't be used to get what - * item is activate for a mode. - * - * The current item style will still be used, but applying a genlist mode to - * an item will select it using a different kind of animation. - * - * The current active item for a mode can be found by - * elm_genlist_decorated_item_get(). - * - * The characteristics of genlist mode are: - * - Only one mode can be active at any time, and for only one item. - * - Genlist handles deactivating other items when one item is activated. - * - A mode is defined in the genlist theme (edc), and more modes can easily - * be added. - * - A mode style and the genlist item style are different things. They - * can be combined to provide a default style to the item, with some kind - * of animation for that item when the mode is activated. - * - * When a mode is activated on an item, a new view for that item is created. - * The theme of this mode defines the animation that will be used to transit - * the item from the old view to the new view. This second (new) view will be - * active for that item while the mode is active on the item, and will be - * destroyed after the mode is totally deactivated from that item. - * - * @deprecated elm_genlist_item_decorate_mode_set() - */ -EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set); - -/** - * Get the last (or current) genlist mode used. - * - * @param obj The genlist object - * - * This function just returns the name of the last used genlist mode. It will - * be the current mode if it's still active. - * - * @deprecated elm_genlist_item_decorate_mode_get() - */ -EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj); - -/** - * Get active genlist mode item - * - * @param obj The genlist object - * @return The active item for that current mode. Or @c NULL if no item is - * activated with any mode. - * - * This function returns the item that was activated with a mode, by the - * function elm_genlist_item_decorate_mode_set(). - * - * @deprecated elm_genlist_decorated_item_get() - */ -EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj); - -/** - * Set Genlist edit mode - * - * This sets Genlist edit mode. - * - * @param obj The Genlist object - * @param The edit mode status - * (EINA_TRUE = edit mode, EINA_FALSE = normal mode - * - * @deprecated elm_genlist_decorate_mode_set - */ -EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode); - -/** - * Get Genlist edit mode - * - * @param obj The genlist object - * @return The edit mode status - * (EINA_TRUE = edit mode, EINA_FALSE = normal mode - * - * @deprecated elm_genlist_decorate_mode_get() - */ -EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj); - -/** - * @} - */ diff --git a/legacy/elementary/src/lib/elm_removed.h b/legacy/elementary/src/lib/elm_removed.h index 00be548cf3..353bca963b 100644 --- a/legacy/elementary/src/lib/elm_removed.h +++ b/legacy/elementary/src/lib/elm_removed.h @@ -6109,3 +6109,272 @@ EINA_DEPRECATED EAPI void elm_list_always_select_mode_se */ EINA_DEPRECATED EAPI Eina_Bool elm_list_always_select_mode_get(const Evas_Object *obj); +/** + * Get the real Evas object created to implement the view of a + * given genlist item + * + * @param it The genlist item. + * @return the Evas object implementing this item's view. + * + * This returns the actual Evas object used to implement the + * specified genlist item's view. This may be @c NULL, as it may + * not have been created or may have been deleted, at any time, by + * the genlist. Do not modify this object (move, resize, + * show, hide, etc.), as the genlist is controlling it. This + * function is for querying, emitting custom signals or hooking + * lower level callbacks for events on that object. Do not delete + * this object under any circumstances. + * + * @see elm_object_item_data_get() + * @deprecated No more support. If you need to emit signal to item's edje object, use elm_object_item_signal_emit(). + * + */ +EINA_DEPRECATED EAPI const Evas_Object *elm_genlist_item_object_get(const Elm_Object_Item *it); + +/** + * Set the always select mode. + * + * @param obj The genlist object + * @param always_select The always select mode (@c EINA_TRUE = on, @c + * EINA_FALSE = off). Default is @c EINA_FALSE. + * + * Items will only call their selection func and callback when first + * becoming selected. Any further clicks will do nothing, unless you + * enable always select with elm_genlist_always_select_mode_set(). + * This means that, even if selected, every click will make the selected + * callbacks be called. + * + * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_ALWAYS); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. + * + */ +EINA_DEPRECATED EAPI void elm_genlist_always_select_mode_set(Evas_Object *obj, Eina_Bool always_select); + + +/** + * Get the always select mode. + * + * @param obj The genlist object + * @return The always select mode + * (@c EINA_TRUE = on, @c EINA_FALSE = off) + * + * @deprecated use elm_genlist_select_mode_get instead. + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_always_select_mode_get(const Evas_Object *obj); + +/** + * Enable/disable the no select mode. + * + * @param obj The genlist object + * @param no_select The no select mode + * (EINA_TRUE = on, EINA_FALSE = off) + * + * This will turn off the ability to select items entirely and they + * will neither appear selected nor call selected callback functions. + * + * @deprecated use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_NONE); instead. use elm_genlist_select_mode_set(obj, ELM_OBJECT_SELECT_MODE_DEFAULT); for normal mode. + * + */ +EINA_DEPRECATED EAPI void elm_genlist_no_select_mode_set(Evas_Object *obj, Eina_Bool no_select); + +/** + * Gets whether the no select mode is enabled. + * + * @param obj The genlist object + * @return The no select mode + * (@c EINA_TRUE = on, @c EINA_FALSE = off) + * + * @deprecated use elm_genlist_select_mode_get instead. + * + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_no_select_mode_get(const Evas_Object *obj); + +/* + * Enable/disable compress mode. + * + * @param obj The genlist object + * @param compress The compress mode + * (@c EINA_TRUE = on, @c EINA_FALSE = off). Default is @c EINA_FALSE. + * + * This will enable the compress mode where items are "compressed" + * horizontally to fit the genlist scrollable viewport width. This is + * special for genlist. Do not rely on + * elm_genlist_mode_set() being set to @c ELM_LIST_COMPRESS to + * work as genlist needs to handle it specially. + * + * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) + */ +EINA_DEPRECATED EAPI void elm_genlist_compress_mode_set(Evas_Object *obj, Eina_Bool compress); + +/** + * Sets the display only state of an item. + * + * @param it The item + * @param display_only @c EINA_TRUE if the item is display only, @c + * EINA_FALSE otherwise. + * + * A display only item cannot be selected or unselected. It is for + * display only and not selecting or otherwise clicking, dragging + * etc. by the user, thus finger size rules will not be applied to + * this item. + * + * It's good to set group index items to display only state. + * + * @see elm_genlist_item_display_only_get() + * + * @deprecated elm_genlist_item_display_only_set() + */ +EINA_DEPRECATED EAPI void elm_genlist_item_display_only_set(Elm_Object_Item *it, Eina_Bool display_only); + +/** + * Get the display only state of an item + * + * @param it The item + * @return @c EINA_TRUE if the item is display only, @c + * EINA_FALSE otherwise. + * + * @see elm_genlist_item_display_only_set() + * + * @deprecated elm_genlist_item_display_only_get() + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_item_display_only_get(const Elm_Object_Item *it); + +/** + * Get whether the compress mode is enabled. + * + * @param obj The genlist object + * @return The compress mode + * (@c EINA_TRUE = on, @c EINA_FALSE = off) + * + * @deprecated elm_genlsit_mode_get() + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_compress_mode_get(const Evas_Object *obj); + +/** + * Enable/disable height-for-width mode. + * + * @param obj The genlist object + * @param height_for_width The height-for-width mode (@c EINA_TRUE = on, + * @c EINA_FALSE = off). Default is @c EINA_FALSE. + * + * With height-for-width mode the item width will be fixed (restricted + * to a minimum of) to the list width when calculating its size in + * order to allow the height to be calculated based on it. This allows, + * for instance, text block to wrap lines if the Edje part is + * configured with "text.min: 0 1". + * + * @note This mode will make list resize slower as it will have to + * recalculate every item height again whenever the list width + * changes! + * + * @note When height-for-width mode is enabled, it also enables + * compress mode (see elm_genlist_compress_mode_set()) and + * disables homogeneous (see elm_genlist_homogeneous_set()). + * + * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) + */ +EINA_DEPRECATED EAPI void elm_genlist_height_for_width_mode_set(Evas_Object *obj, Eina_Bool height_for_width); + +/** + * Get whether the height-for-width mode is enabled. + * + * @param obj The genlist object + * @return The height-for-width mode (@c EINA_TRUE = on, @c EINA_FALSE = + * off) + * + * @deprecated elm_genlist_mode_set(obj, ELM_LIST_COMPRESS) + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_height_for_width_mode_get(const Evas_Object *obj); + +/** + * Activate a genlist mode on an item + * + * @param it The genlist item + * @param mode_type Mode name + * @param mode_set Boolean to define set or unset mode. + * + * A genlist mode is a different way of selecting an item. Once a mode is + * activated on an item, any other selected item is immediately unselected. + * This feature provides an easy way of implementing a new kind of animation + * for selecting an item, without having to entirely rewrite the item style + * theme. However, the elm_genlist_selected_* API can't be used to get what + * item is activate for a mode. + * + * The current item style will still be used, but applying a genlist mode to + * an item will select it using a different kind of animation. + * + * The current active item for a mode can be found by + * elm_genlist_decorated_item_get(). + * + * The characteristics of genlist mode are: + * - Only one mode can be active at any time, and for only one item. + * - Genlist handles deactivating other items when one item is activated. + * - A mode is defined in the genlist theme (edc), and more modes can easily + * be added. + * - A mode style and the genlist item style are different things. They + * can be combined to provide a default style to the item, with some kind + * of animation for that item when the mode is activated. + * + * When a mode is activated on an item, a new view for that item is created. + * The theme of this mode defines the animation that will be used to transit + * the item from the old view to the new view. This second (new) view will be + * active for that item while the mode is active on the item, and will be + * destroyed after the mode is totally deactivated from that item. + * + * @deprecated elm_genlist_item_decorate_mode_set() + */ +EINA_DEPRECATED EAPI void elm_genlist_item_mode_set(Elm_Object_Item *it, const char *mode_type, Eina_Bool mode_set); + +/** + * Get the last (or current) genlist mode used. + * + * @param obj The genlist object + * + * This function just returns the name of the last used genlist mode. It will + * be the current mode if it's still active. + * + * @deprecated elm_genlist_item_decorate_mode_get() + */ +EINA_DEPRECATED EAPI const char *elm_genlist_mode_type_get(const Evas_Object *obj); + +/** + * Get active genlist mode item + * + * @param obj The genlist object + * @return The active item for that current mode. Or @c NULL if no item is + * activated with any mode. + * + * This function returns the item that was activated with a mode, by the + * function elm_genlist_item_decorate_mode_set(). + * + * @deprecated elm_genlist_decorated_item_get() + */ +EINA_DEPRECATED EAPI const Elm_Object_Item *elm_genlist_mode_item_get(const Evas_Object *obj); + +/** + * Set Genlist edit mode + * + * This sets Genlist edit mode. + * + * @param obj The Genlist object + * @param The edit mode status + * (EINA_TRUE = edit mode, EINA_FALSE = normal mode + * + * @deprecated elm_genlist_decorate_mode_set + */ +EINA_DEPRECATED EAPI void elm_genlist_edit_mode_set(Evas_Object *obj, Eina_Bool edit_mode); + +/** + * Get Genlist edit mode + * + * @param obj The genlist object + * @return The edit mode status + * (EINA_TRUE = edit mode, EINA_FALSE = normal mode + * + * @deprecated elm_genlist_decorate_mode_get() + */ +EINA_DEPRECATED EAPI Eina_Bool elm_genlist_edit_mode_get(const Evas_Object *obj); + +/** + * @} + */