elm_widget_item_eo.legacy: change @ingroup to Elm_General

Summary:
The @ingroup of elm_object_item APIs is Elm_General in elm_object_item.h.

Since legacy prefix of Elm_Widget_Item is elm_object_item,
the prefix of Elm_Widget_Item APIs is elm_object_item.

Consequently, to display the legacy Elm_Widget_Item APIs with
elm_object_item APIs, the @ingroup is changed from Elm_Object_Item_Group
to Elm_General.

Test Plan: make doc and check the documentation

Reviewers: segfaultxavi

Reviewed By: segfaultxavi

Subscribers: cedric, #reviewers, #committers

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D8529
This commit is contained in:
Jaehyun Cho 2019-04-02 10:25:58 +02:00 committed by Xavi Artigas
parent a10e1bc597
commit fe54a4dd1a
1 changed files with 59 additions and 47 deletions

View File

@ -4,6 +4,18 @@
#ifndef _ELM_WIDGET_ITEM_EO_CLASS_TYPE
#define _ELM_WIDGET_ITEM_EO_CLASS_TYPE
/**
* @typedef Elm_Widget_Item
* An Elementary widget item handle.
* This is a sub component of an Elementary widget and it is the same as
* Elementary object item, Elm_Object_Item.
* Common functions for Elementary widget item are provided on this page.
* Each Elementary widget also provides its own functions to use Elementary
* widget item.
* For more details about how Elementary widget item is used with Elementary
* widget, please refer each Elementary widget's documents.
* @ingroup Elm_General
*/
typedef Eo Elm_Widget_Item;
#endif
@ -26,7 +38,7 @@ typedef Eo Elm_Widget_Item;
*
* @return @c false on failure, @c true on success
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Eina_Bool elm_object_item_tooltip_window_mode_set(Elm_Widget_Item *obj, Eina_Bool disable);
@ -41,7 +53,7 @@ EAPI Eina_Bool elm_object_item_tooltip_window_mode_set(Elm_Widget_Item *obj, Ein
*
* @return If @c true, size restrictions are disabled
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Eina_Bool elm_object_item_tooltip_window_mode_get(const Elm_Widget_Item *obj);
@ -57,7 +69,7 @@ EAPI Eina_Bool elm_object_item_tooltip_window_mode_get(const Elm_Widget_Item *ob
* @param[in] obj The object.
* @param[in] style The theme style used/to use (default, transparent, ...)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_tooltip_style_set(Elm_Widget_Item *obj, const char *style);
@ -74,7 +86,7 @@ EAPI void elm_object_item_tooltip_style_set(Elm_Widget_Item *obj, const char *st
*
* @return The theme style used/to use (default, transparent, ...)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_tooltip_style_get(const Elm_Widget_Item *obj);
@ -94,7 +106,7 @@ EAPI const char *elm_object_item_tooltip_style_get(const Elm_Widget_Item *obj);
* @param[in] obj The object.
* @param[in] cursor The cursor type's name
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_cursor_set(Elm_Widget_Item *obj, const char *cursor);
@ -115,7 +127,7 @@ EAPI void elm_object_item_cursor_set(Elm_Widget_Item *obj, const char *cursor);
*
* @return The cursor type's name
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_cursor_get(const Elm_Widget_Item *obj);
@ -135,7 +147,7 @@ EAPI const char *elm_object_item_cursor_get(const Elm_Widget_Item *obj);
* @param[in] style The theme style to use/in use (e.g. $"default",
* $"transparent", etc)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_cursor_style_set(Elm_Widget_Item *obj, const char *style);
@ -155,7 +167,7 @@ EAPI void elm_object_item_cursor_style_set(Elm_Widget_Item *obj, const char *sty
*
* @return The theme style to use/in use (e.g. $"default", $"transparent", etc)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_cursor_style_get(const Elm_Widget_Item *obj);
@ -174,7 +186,7 @@ EAPI const char *elm_object_item_cursor_style_get(const Elm_Widget_Item *obj);
* provided by the rendering engine, @c false to have them searched on the
* widget's theme, as well.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_cursor_engine_only_set(Elm_Widget_Item *obj, Eina_Bool engine_only);
@ -194,7 +206,7 @@ EAPI void elm_object_item_cursor_engine_only_set(Elm_Widget_Item *obj, Eina_Bool
* rendering engine, @c false to have them searched on the widget's theme, as
* well.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Eina_Bool elm_object_item_cursor_engine_only_get(const Elm_Widget_Item *obj);
@ -209,7 +221,7 @@ EAPI Eina_Bool elm_object_item_cursor_engine_only_get(const Elm_Widget_Item *obj
* @param[in] part The content part name (NULL for the default content)
* @param[in] content The content of the object item
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_part_content_set(Elm_Widget_Item *obj, const char *part, Efl_Canvas_Object *content);
@ -225,7 +237,7 @@ EAPI void elm_object_item_part_content_set(Elm_Widget_Item *obj, const char *par
*
* @return The content of the object item
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_part_content_get(const Elm_Widget_Item *obj, const char *part);
@ -238,7 +250,7 @@ EAPI Efl_Canvas_Object *elm_object_item_part_content_get(const Elm_Widget_Item *
* @param[in] part The text part name (NULL for the default label)
* @param[in] label Text of the label
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_part_text_set(Elm_Widget_Item *obj, const char *part, const char *label);
@ -252,7 +264,7 @@ EAPI void elm_object_item_part_text_set(Elm_Widget_Item *obj, const char *part,
*
* @return Text of the label
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_part_text_get(const Elm_Widget_Item *obj, const char *part);
@ -266,7 +278,7 @@ EAPI const char *elm_object_item_part_text_get(const Elm_Widget_Item *obj, const
*
* @since 1.10
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_focus_set(Elm_Widget_Item *obj, Eina_Bool focused);
@ -279,7 +291,7 @@ EAPI void elm_object_item_focus_set(Elm_Widget_Item *obj, Eina_Bool focused);
*
* @since 1.10
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Eina_Bool elm_object_item_focus_get(const Elm_Widget_Item *obj);
@ -291,7 +303,7 @@ EAPI Eina_Bool elm_object_item_focus_get(const Elm_Widget_Item *obj);
*
* @since 1.9
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_style_set(Elm_Widget_Item *obj, const char *style);
@ -304,7 +316,7 @@ EAPI void elm_object_item_style_set(Elm_Widget_Item *obj, const char *style);
*
* @since 1.9
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_style_get(const Elm_Widget_Item *obj);
@ -323,7 +335,7 @@ EAPI const char *elm_object_item_style_get(const Elm_Widget_Item *obj);
* @param[in] disable @c true, if the widget item is disabled, @c false if it's
* enabled (or on errors)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_disabled_set(Elm_Widget_Item *obj, Eina_Bool disable);
@ -343,7 +355,7 @@ EAPI void elm_object_item_disabled_set(Elm_Widget_Item *obj, Eina_Bool disable);
* @return @c true, if the widget item is disabled, @c false if it's enabled
* (or on errors)
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Eina_Bool elm_object_item_disabled_get(const Elm_Widget_Item *obj);
@ -356,7 +368,7 @@ EAPI Eina_Bool elm_object_item_disabled_get(const Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const Eina_List *elm_object_item_access_order_get(Elm_Widget_Item *obj);
@ -368,7 +380,7 @@ EAPI const Eina_List *elm_object_item_access_order_get(Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_access_order_set(Elm_Widget_Item *obj, Eina_List *objs);
@ -382,7 +394,7 @@ EAPI void elm_object_item_access_order_set(Elm_Widget_Item *obj, Eina_List *objs
*
* @return The widget object
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_widget_get(const Elm_Widget_Item *obj);
@ -399,7 +411,7 @@ EAPI Efl_Canvas_Object *elm_object_item_widget_get(const Elm_Widget_Item *obj);
* @param[in] obj The object.
* @param[in] text The text to set in the content.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_tooltip_text_set(Elm_Widget_Item *obj, const char *text);
@ -415,7 +427,7 @@ EAPI void elm_object_item_tooltip_text_set(Elm_Widget_Item *obj, const char *tex
* @ref elm_object_item_tooltip_content_cb_set
* @param[in] obj The object.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_tooltip_unset(Elm_Widget_Item *obj);
@ -430,7 +442,7 @@ EAPI void elm_object_item_tooltip_unset(Elm_Widget_Item *obj);
* See: elm_object_cursor_unset() See: @ref elm_object_item_cursor_set
* @param[in] obj The object.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_cursor_unset(Elm_Widget_Item *obj);
@ -445,7 +457,7 @@ EAPI void elm_object_item_cursor_unset(Elm_Widget_Item *obj);
*
* @return Content object
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_part_content_unset(Elm_Widget_Item *obj, const char *part);
@ -466,7 +478,7 @@ EAPI Efl_Canvas_Object *elm_object_item_part_content_unset(Elm_Widget_Item *obj,
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_signal_callback_add(Elm_Widget_Item *obj, const char *emission, const char *source, Elm_Object_Item_Signal_Cb func, void *data);
@ -491,7 +503,7 @@ EAPI void elm_object_item_signal_callback_add(Elm_Widget_Item *obj, const char *
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void *elm_object_item_signal_callback_del(Elm_Widget_Item *obj, const char *emission, const char *source, Elm_Object_Item_Signal_Cb func);
@ -507,7 +519,7 @@ EAPI void *elm_object_item_signal_callback_del(Elm_Widget_Item *obj, const char
* @param[in] emission The signal's name.
* @param[in] source The signal's source.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_signal_emit(Elm_Widget_Item *obj, const char *emission, const char *source);
@ -518,7 +530,7 @@ EAPI void elm_object_item_signal_emit(Elm_Widget_Item *obj, const char *emission
* @param[in] txt The text that describes the widget to people with poor or no
* vision
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_access_info_set(Elm_Widget_Item *obj, const char *txt);
@ -531,7 +543,7 @@ EAPI void elm_object_item_access_info_set(Elm_Widget_Item *obj, const char *txt)
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_access_object_get(const Elm_Widget_Item *obj);
@ -556,7 +568,7 @@ EAPI Efl_Canvas_Object *elm_object_item_access_object_get(const Elm_Widget_Item
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_domain_translatable_part_text_set(Elm_Widget_Item *obj, const char *part, const char *domain, const char *label);
@ -574,7 +586,7 @@ EAPI void elm_object_item_domain_translatable_part_text_set(Elm_Widget_Item *obj
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI const char *elm_object_item_translatable_part_text_get(const Elm_Widget_Item *obj, const char *part);
@ -599,7 +611,7 @@ EAPI const char *elm_object_item_translatable_part_text_get(const Elm_Widget_Ite
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_domain_part_text_translatable_set(Elm_Widget_Item *obj, const char *part, const char *domain, Eina_Bool translatable);
@ -631,7 +643,7 @@ EAPI void elm_object_item_domain_part_text_translatable_set(Elm_Widget_Item *obj
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_track(Elm_Widget_Item *obj);
@ -647,7 +659,7 @@ EAPI Efl_Canvas_Object *elm_object_item_track(Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_untrack(Elm_Widget_Item *obj);
@ -670,7 +682,7 @@ EAPI void elm_object_item_untrack(Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI int elm_object_item_track_get(const Elm_Widget_Item *obj);
@ -683,7 +695,7 @@ EAPI int elm_object_item_track_get(const Elm_Widget_Item *obj);
* @param[in] obj The object.
* @param[in] del_cb The function called
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_del_cb_set(Elm_Widget_Item *obj, Evas_Smart_Cb del_cb);
@ -707,7 +719,7 @@ EAPI void elm_object_item_del_cb_set(Elm_Widget_Item *obj, Evas_Smart_Cb del_cb)
* receives as the first parameter the given @c data, and @c event_info is the
* item.
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_tooltip_content_cb_set(Elm_Widget_Item *obj, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb);
@ -720,7 +732,7 @@ EAPI void elm_object_item_tooltip_content_cb_set(Elm_Widget_Item *obj, Elm_Toolt
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_access_register(Elm_Widget_Item *obj);
@ -728,7 +740,7 @@ EAPI Efl_Canvas_Object *elm_object_item_access_register(Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_access_unregister(Elm_Widget_Item *obj);
@ -736,7 +748,7 @@ EAPI void elm_object_item_access_unregister(Elm_Widget_Item *obj);
*
* @since 1.8
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_access_order_unset(Elm_Widget_Item *obj);
@ -752,7 +764,7 @@ EAPI void elm_object_item_access_order_unset(Elm_Widget_Item *obj);
*
* @since 1.16
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Efl_Canvas_Object *elm_object_item_focus_next_object_get(const Elm_Widget_Item *obj, Elm_Focus_Direction dir);
@ -765,7 +777,7 @@ EAPI Efl_Canvas_Object *elm_object_item_focus_next_object_get(const Elm_Widget_I
*
* @since 1.16
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_focus_next_object_set(Elm_Widget_Item *obj, Efl_Canvas_Object *next, Elm_Focus_Direction dir);
@ -779,7 +791,7 @@ EAPI void elm_object_item_focus_next_object_set(Elm_Widget_Item *obj, Efl_Canvas
*
* @since 1.16
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI Elm_Widget_Item *elm_object_item_focus_next_item_get(const Elm_Widget_Item *obj, Elm_Focus_Direction dir);
@ -792,7 +804,7 @@ EAPI Elm_Widget_Item *elm_object_item_focus_next_item_get(const Elm_Widget_Item
*
* @since 1.16
*
* @ingroup Elm_Object_Item_Group
* @ingroup Elm_General
*/
EAPI void elm_object_item_focus_next_item_set(Elm_Widget_Item *obj, Elm_Widget_Item *next_item, Elm_Focus_Direction dir);