Thanks for the good suggestion. Documentation job was super painful and boring actually.
I also considered those kind of a base widget documentation but "focused", "unfocused" are not global smart callback for all widgets.Only focusable widgets emit those signals. So I chose to go through painful path. Any more suggestions will be welcomed. Thanks. Daniel Juyung Seo (SeoZ) On Mon, Jun 10, 2013 at 10:51 PM, Gustavo Lima Chaves <[email protected]>wrote: > * Daniel Juyung Seo - Enlightenment Git <[email protected]> > [2013-06-09 02:54:19 -0700]: > > IMO we'd be better here by taking to a (base) widget documentation > page, where all global smart callbacks and stuff are gathered > together. Replicating this kind of info through the 666 widgets is > going to be painful and error prone. > > > seoz pushed a commit to branch master. > > > > commit 4754dc8bebca94104d97db5c0d47d7e2b26dceef > > Author: Daniel Juyung Seo <[email protected]> > > Date: Sun Jun 9 18:55:42 2013 +0900 > > > > calendar, check, clock, colorselector, datetime, diskselector, > flipselector, gengrid: added "focused" and "unfocused" documentations. > > --- > > src/lib/elm_calendar.c | 4 ++++ > > src/lib/elm_calendar.h | 2 ++ > > src/lib/elm_check.c | 4 ++++ > > src/lib/elm_check.h | 2 ++ > > src/lib/elm_clock.c | 4 ++++ > > src/lib/elm_clock.h | 2 ++ > > src/lib/elm_colorselector.c | 4 ++++ > > src/lib/elm_colorselector.h | 2 ++ > > src/lib/elm_datetime.c | 4 ++++ > > src/lib/elm_datetime.h | 3 ++- > > src/lib/elm_diskselector.c | 4 ++++ > > src/lib/elm_diskselector.h | 3 +++ > > src/lib/elm_flipselector.c | 4 ++++ > > src/lib/elm_flipselector.h | 2 ++ > > src/lib/elm_gengrid.c | 4 ++++ > > src/lib/elm_gengrid.h | 2 ++ > > 16 files changed, 49 insertions(+), 1 deletion(-) > > > > diff --git a/src/lib/elm_calendar.c b/src/lib/elm_calendar.c > > index 26a5683..f83e97f 100644 > > --- a/src/lib/elm_calendar.c > > +++ b/src/lib/elm_calendar.c > > @@ -14,10 +14,14 @@ EAPI Eo_Op ELM_OBJ_CALENDAR_BASE_ID = EO_NOOP; > > > > static const char SIG_CHANGED[] = "changed"; > > static const char SIG_DISPLAY_CHANGED[] = "display,changed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_CHANGED, ""}, > > {SIG_DISPLAY_CHANGED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_calendar.h b/src/lib/elm_calendar.h > > index 38c7bc2..bc1b521 100644 > > --- a/src/lib/elm_calendar.h > > +++ b/src/lib/elm_calendar.h > > @@ -25,6 +25,8 @@ > > * - @c "changed" - emitted when the date in the calendar is changed. > > * - @c "display,changed" - emitted when the current month displayed in > the > > * calendar is changed. > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * Supported elm_object common APIs. > > * @li @ref elm_object_signal_emit > > diff --git a/src/lib/elm_check.c b/src/lib/elm_check.c > > index 52297a8..b96b23c 100644 > > --- a/src/lib/elm_check.c > > +++ b/src/lib/elm_check.c > > @@ -28,10 +28,14 @@ static const Elm_Layout_Part_Alias_Description > _text_aliases[] = > > }; > > > > static const char SIG_CHANGED[] = "changed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > > > /* smart callbacks coming from elm check objects: */ > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_CHANGED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_check.h b/src/lib/elm_check.h > > index a29f39b..a641de5 100644 > > --- a/src/lib/elm_check.h > > +++ b/src/lib/elm_check.h > > @@ -30,6 +30,8 @@ > > * @ref Layout: > > * - @c "changed" - This is called whenever the user changes the state > of > > * the check objects (@c event_info is always @c NULL). > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * Default content parts of the check widget that you can use for are: > > * @li "icon" - An icon of the check > > diff --git a/src/lib/elm_clock.c b/src/lib/elm_clock.c > > index b093893..3068dd9 100644 > > --- a/src/lib/elm_clock.c > > +++ b/src/lib/elm_clock.c > > @@ -16,9 +16,13 @@ EAPI Eo_Op ELM_OBJ_CLOCK_BASE_ID = EO_NOOP; > > static void _time_update(Evas_Object *obj); > > > > static const char SIG_CHANGED[] = "changed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_CHANGED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_clock.h b/src/lib/elm_clock.h > > index e29ac74..18b001b 100644 > > --- a/src/lib/elm_clock.h > > +++ b/src/lib/elm_clock.h > > @@ -39,6 +39,8 @@ > > * This widget emits the following signals, besides the ones sent from > > * @ref Layout: > > * - @c "changed" - the clock's user changed the time > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * Supported elm_object common APIs. > > * @li @ref elm_object_signal_emit > > diff --git a/src/lib/elm_colorselector.c b/src/lib/elm_colorselector.c > > index df33295..7dadcb6 100644 > > --- a/src/lib/elm_colorselector.c > > +++ b/src/lib/elm_colorselector.c > > @@ -23,11 +23,15 @@ EAPI Eo_Op ELM_OBJ_COLORSELECTOR_BASE_ID = EO_NOOP; > > static const char SIG_CHANGED[] = "changed"; > > static const char SIG_COLOR_ITEM_SELECTED[] = "color,item,selected"; > > static const char SIG_COLOR_ITEM_LONGPRESSED[] = > "color,item,longpressed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > static const Evas_Smart_Cb_Description _smart_callbacks[] = > > { > > {SIG_COLOR_ITEM_SELECTED, ""}, > > {SIG_COLOR_ITEM_LONGPRESSED, ""}, > > {SIG_CHANGED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_colorselector.h b/src/lib/elm_colorselector.h > > index 7b344c6..feb635e 100644 > > --- a/src/lib/elm_colorselector.h > > +++ b/src/lib/elm_colorselector.h > > @@ -28,6 +28,8 @@ > > * - @c "color,item,longpressed" - When user long presses on color > > * item. The event info parameter of the callback contains selected > > * color item. > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * See @ref tutorial_colorselector. > > * @{ > > diff --git a/src/lib/elm_datetime.c b/src/lib/elm_datetime.c > > index 9fc4b34..b970837 100644 > > --- a/src/lib/elm_datetime.c > > +++ b/src/lib/elm_datetime.c > > @@ -63,9 +63,13 @@ static Datetime_Mod_Api *dt_mod = NULL; > > > > static const char SIG_CHANGED[] = "changed"; > > static const char SIG_LANG_CHANGED[] = "language,changed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_CHANGED, ""}, > > {SIG_LANG_CHANGED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_datetime.h b/src/lib/elm_datetime.h > > index 5d8958b..7010104 100644 > > --- a/src/lib/elm_datetime.h > > +++ b/src/lib/elm_datetime.h > > @@ -181,9 +181,10 @@ > > * @ref Layout: > > * @li @b "changed" - whenever Datetime field value is changed, this > > * signal is sent. > > - * > > * @li @b "language,changed" - whenever system locale changes, this > > * signal is sent. > > + * @li @c "focused" - When the entry has received focus. > > + * @li @c "unfocused" - When the entry has lost focus. > > * > > * Here is an example on its usage: > > * @li @ref datetime_example > > diff --git a/src/lib/elm_diskselector.c b/src/lib/elm_diskselector.c > > index d3406ae..caca5a4 100644 > > --- a/src/lib/elm_diskselector.c > > +++ b/src/lib/elm_diskselector.c > > @@ -29,6 +29,8 @@ static const char SIG_SCROLL_ANIM_START[] = > "scroll,anim,start"; > > static const char SIG_SCROLL_ANIM_STOP[] = "scroll,anim,stop"; > > static const char SIG_SCROLL_DRAG_START[] = "scroll,drag,start"; > > static const char SIG_SCROLL_DRAG_STOP[] = "scroll,drag,stop"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_SELECTED, ""}, > > @@ -37,6 +39,8 @@ static const Evas_Smart_Cb_Description > _smart_callbacks[] = { > > {SIG_SCROLL_ANIM_STOP, ""}, > > {SIG_SCROLL_DRAG_START, ""}, > > {SIG_SCROLL_DRAG_STOP, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_diskselector.h b/src/lib/elm_diskselector.h > > index f4b0a1c..98e265e 100644 > > --- a/src/lib/elm_diskselector.h > > +++ b/src/lib/elm_diskselector.h > > @@ -33,6 +33,9 @@ > > * @li @c "scroll,anim,stop" - scrolling animation has stopped > > * @li @c "scroll,drag,start" - dragging the diskselector has started > > * @li @c "scroll,drag,stop" - dragging the diskselector has stopped > > + * @li @c "focused" - When the entry has received focus. > > + * @li @c "unfocused" - When the entry has lost focus. > > + * > > * @note The "scroll,anim,*" and "scroll,drag,*" signals are only > emitted by > > * user intervention. > > * > > diff --git a/src/lib/elm_flipselector.c b/src/lib/elm_flipselector.c > > index 1e4e794..b9bfad5 100644 > > --- a/src/lib/elm_flipselector.c > > +++ b/src/lib/elm_flipselector.c > > @@ -37,10 +37,14 @@ EAPI Eo_Op ELM_OBJ_FLIPSELECTOR_BASE_ID = EO_NOOP; > > static const char SIG_SELECTED[] = "selected"; > > static const char SIG_UNDERFLOWED[] = "underflowed"; > > static const char SIG_OVERFLOWED[] = "overflowed"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_SELECTED, ""}, > > {SIG_UNDERFLOWED, ""}, > > {SIG_OVERFLOWED, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > {NULL, NULL} > > }; > > > > diff --git a/src/lib/elm_flipselector.h b/src/lib/elm_flipselector.h > > index 8e4761a..9061c4e 100644 > > --- a/src/lib/elm_flipselector.h > > +++ b/src/lib/elm_flipselector.h > > @@ -29,6 +29,8 @@ > > * from the first item in its list to the last > > * - @c "underflowed" - when the widget's current selection is changed > > * from the last item in its list to the first > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * Available styles for it: > > * - @c "default" > > diff --git a/src/lib/elm_gengrid.c b/src/lib/elm_gengrid.c > > index 0c5838f..7e2e5b0 100644 > > --- a/src/lib/elm_gengrid.c > > +++ b/src/lib/elm_gengrid.c > > @@ -67,6 +67,8 @@ static const char SIG_UNHIGHLIGHTED[] = > "unhighlighted"; > > static const char SIG_LANG_CHANGED[] = "language,changed"; > > static const char SIG_PRESSED[] = "pressed"; > > static const char SIG_RELEASED[] = "released"; > > +static const char SIG_FOCUSED[] = "focused"; /**< handled by elm_widget > */ > > +static const char SIG_UNFOCUSED[] = "unfocused"; /**< handled by > elm_widget */ > > > > static const Evas_Smart_Cb_Description _smart_callbacks[] = { > > {SIG_ACTIVATED, ""}, > > @@ -99,6 +101,8 @@ static const Evas_Smart_Cb_Description > _smart_callbacks[] = { > > {SIG_PRESSED, ""}, > > {SIG_RELEASED, ""}, > > {SIG_SCROLL_PAGE_CHANGE, ""}, > > + {SIG_FOCUSED, ""}, > > + {SIG_UNFOCUSED, ""}, > > > > {NULL, NULL} > > }; > > diff --git a/src/lib/elm_gengrid.h b/src/lib/elm_gengrid.h > > index db93aae..f182d23 100644 > > --- a/src/lib/elm_gengrid.h > > +++ b/src/lib/elm_gengrid.h > > @@ -235,6 +235,8 @@ > > * - @c "language,changed" - This is called when the program's language > is > > * changed. Call the elm_gengrid_realized_items_update() if items > text should > > * be translated. > > + * - @c "focused" - When the entry has received focus. > > + * - @c "unfocused" - When the entry has lost focus. > > * > > * Supported elm_object common APIs > > * @li elm_object_signal_emit() > > > > -- > > > > > ------------------------------------------------------------------------------ > > How ServiceNow helps IT people transform IT departments: > > 1. A cloud service to automate IT design, transition and operations > > 2. Dashboards that offer high-level views of enterprise services > > 3. A single system of record for all IT processes > > http://p.sf.net/sfu/servicenow-d2d-j > > -- > Gustavo Lima Chaves > Senior Developer @ Intel - Open Source Technology Center > > > ------------------------------------------------------------------------------ > How ServiceNow helps IT people transform IT departments: > 1. A cloud service to automate IT design, transition and operations > 2. Dashboards that offer high-level views of enterprise services > 3. A single system of record for all IT processes > http://p.sf.net/sfu/servicenow-d2d-j > _______________________________________________ > enlightenment-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/enlightenment-devel > ------------------------------------------------------------------------------ This SF.net email is sponsored by Windows: Build for Windows Store. http://p.sf.net/sfu/windows-dev2dev _______________________________________________ enlightenment-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
