elm: added more "focused" and "unfocused" documentations.
authorDaniel Juyung Seo <seojuyung2@gmail.com>
Mon, 10 Jun 2013 05:12:51 +0000 (14:12 +0900)
committerDaniel Juyung Seo <seojuyung2@gmail.com>
Mon, 10 Jun 2013 05:13:55 +0000 (14:13 +0900)
genlist, hover, index, list, map, photocam, progressbar, radio, scroller, slider, slideshow, spinner, toolbar, win.

28 files changed:
src/lib/elm_genlist.c
src/lib/elm_genlist.h
src/lib/elm_hover.c
src/lib/elm_hover.h
src/lib/elm_index.c
src/lib/elm_index.h
src/lib/elm_list.c
src/lib/elm_list.h
src/lib/elm_map.c
src/lib/elm_map.h
src/lib/elm_photocam.c
src/lib/elm_photocam.h
src/lib/elm_progressbar.c
src/lib/elm_progressbar.h
src/lib/elm_radio.c
src/lib/elm_radio.h
src/lib/elm_scroller.c
src/lib/elm_scroller.h
src/lib/elm_slider.c
src/lib/elm_slider.h
src/lib/elm_slideshow.c
src/lib/elm_slideshow.h
src/lib/elm_spinner.c
src/lib/elm_spinner.h
src/lib/elm_toolbar.c
src/lib/elm_toolbar.h
src/lib/elm_win.c
src/lib/elm_win.h

index ffb2cda..a15f8b5 100644 (file)
@@ -135,6 +135,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_LANG_CHANGED, ""},
    {SIG_PRESSED, ""},
    {SIG_RELEASED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
 
    {NULL, NULL}
 };
index 97495ef..34b41e7 100644 (file)
  *   when the user releases an item or keyboard selection is moved so the item
  *   is physically unhighlighted. The %c event_info parameter is the item that
  *   was unhighlighted.
+ * - @c "focused" - When the genlist has received focus. (since 1.8)
+ * - @c "unfocused" - When the genlist has lost focus. (since 1.8)
  *
  *
  * Supported elm_object_item common APIs
index 99343d3..2d166bd 100644 (file)
@@ -49,6 +49,8 @@ static const char SIG_SMART_LOCATION_CHANGED[] = "smart,changed";
 static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_CLICKED, ""},
    {SIG_SMART_LOCATION_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index e1e684d..db37590 100644 (file)
@@ -35,6 +35,8 @@
  * @li @c "clicked" - the user clicked the empty space in the hover to dismiss
  * @li @c "smart,changed" - a content object placed under the "smart"
  *                   policy was replaced to a new slot direction.
+ * @li @c "focused" - When the hover has received focus. (since 1.8)
+ * @li @c "unfocused" - When the hover has lost focus. (since 1.8)
  *
  * Default content parts of the hover widget that you can use for are:
  * @li @c "left"
index 97bd6fd..d46d154 100644 (file)
@@ -31,6 +31,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_LEVEL_UP, ""},
    {SIG_LEVEL_DOWN, ""},
    {SIG_LANG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index db06cd9..f522060 100644 (file)
@@ -41,6 +41,8 @@
  * - @c "level,down" - when the user moves a finger from the second
  *      level to the first level
  * - @c "language,changed" - the program's language changed
+ * - @c "focused" - When the index has received focus. (since 1.8)
+ * - @c "unfocused" - When the index has lost focus. (since 1.8)
  *
  * The @c "delay,changed" event is so that it'll wait a small time
  * before actually reporting those events and, moreover, just the
index 5f487dd..cdd4307 100644 (file)
@@ -41,6 +41,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_SWIPE, ""},
    {SIG_HIGHLIGHTED, ""},
    {SIG_UNHIGHLIGHTED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index a8c11d7..fa33779 100644 (file)
@@ -45,6 +45,8 @@
  *   is physically unhighlighted. The %c event_info parameter is the item that
  *   was unhighlighted.
  * - @c "language,changed" - the program's language changed
+ * - @c "focused" - When the list has received focus. (since 1.8)
+ * - @c "unfocused" - When the list has lost focus. (since 1.8)
  *
  * Available styles for it are:
  * - @c "default"
index 53f6b1d..a6d41b8 100644 (file)
@@ -338,6 +338,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_OVERLAY_CLICKED, ""},
    {SIG_OVERLAY_DEL, ""},
    {SIG_LANG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 3c2d538..b37ad36 100644 (file)
@@ -50,6 +50,8 @@
  * - @c "overlay,clicked" - A overlay is clicked.
  * - @c "loaded" - when a map is finally loaded. @since 1.7
  * - @c "language,changed" - the program's language changed
+ * - @c "focused" - When the map has received focus. (since 1.8)
+ * - @c "unfocused" - When the map has lost focus. (since 1.8)
  *
  * Available style for map widget:
  * - @c "default"
index 019bacb..c20b129 100644 (file)
@@ -62,6 +62,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_SCROLL_ANIM_STOP, ""},
    {SIG_SCROLL_DRAG_START, ""},
    {SIG_SCROLL_DRAG_STOP, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 80d6eea..cdfc46b 100644 (file)
@@ -39,6 +39,8 @@
  * @li @c "scroll,anim,stop" - scrolling animation has stopped
  * @li @c "scroll,drag,start" - dragging the contents around has started
  * @li @c "scroll,drag,stop" - dragging the contents around has stopped
+ * @li @c "focused" - When the photocam has received focus. (since 1.8)
+ * @li @c "unfocused" - When the photocam has lost focus. (since 1.8)
  *
  * This widget implements the @b @ref elm-scrollable-interface
  * interface, so that all (non-deprecated) functions for the base @ref
index 757868f..d28fa68 100644 (file)
@@ -23,6 +23,8 @@ static const char SIG_CHANGED[] = "changed";
  * ones coming from elm layout): */
 static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 797716c..5a10201 100644 (file)
@@ -37,6 +37,8 @@
  * @ref Layout:
  * @li @c "changed" - when the value is changed
  * @since 1.7
+ * @li @c "focused" - When the progressbar has received focus. (since 1.8)
+ * @li @c "unfocused" - When the progressbar has lost focus. (since 1.8)
  *
  * This widget has the following styles:
  * - @c "default"
index 0b3d69f..9cb20d7 100644 (file)
@@ -29,6 +29,8 @@ static const Elm_Layout_Part_Alias_Description _text_aliases[] =
 static const char SIG_CHANGED[] = "changed";
 static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index fec468c..c7fa3a6 100644 (file)
@@ -40,6 +40,8 @@
  * @ref Layout:
  * @li changed - This is called whenever the user changes the state of one of
  * the radio objects within the group of radio objects that work together.
+ * @li @c "focused" - When the radio has received focus. (since 1.8)
+ * @li @c "unfocused" - When the radio has lost focus. (since 1.8)
  *
  * Default text parts of the radio widget that you can use for are:
  * @li "default" - Label of the radio
index 99d843e..2f121de 100644 (file)
@@ -58,6 +58,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] =
    {SIG_HBAR_PRESS, ""},
    {SIG_HBAR_UNPRESS, ""},
    {SIG_SCROLL_PAGE_CHANGE, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index fa052bc..8b2781a 100644 (file)
@@ -36,6 +36,8 @@
  * @li @c "hbar,press" - the horizontal scroll bar has been pressed
  * @li @c "hbar,unpress" - the horizontal scroll bar has been unpressed
  * @li @c "scroll,page,changed" - the visible page has changed
+ * @li @c "focused" - When the scroller has received focus. (since 1.8)
+ * @li @c "unfocused" - When the scroller has lost focus. (since 1.8)
  *
  * This widget implements the @ref elm-scrollable-interface interface.
  * Its (non-deprecated) API functions, except for elm_scroller_add(),
index 4193afd..ceebda0 100644 (file)
@@ -37,6 +37,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_DELAY_CHANGED, ""},
    {SIG_DRAG_START, ""},
    {SIG_DRAG_STOP, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index aea35b1..ee8ed13 100644 (file)
@@ -42,6 +42,8 @@
  * a very short period or when they release their
  * finger/mouse, so it avoids possibly expensive reactions to
  * the value change.
+ * - @c "focused" - When the slider has received focus. (since 1.8)
+ * - @c "unfocused" - When the slider has lost focus. (since 1.8)
  *
  * Available styles for it:
  * - @c "default"
index 1820a12..c5c4525 100644 (file)
@@ -19,6 +19,8 @@ static const char SIG_TRANSITION_END[] = "transition,end";
 static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_CHANGED, ""},
    {SIG_TRANSITION_END, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 08746c6..a99855a 100644 (file)
@@ -57,6 +57,8 @@
  *   item. event_info parameter in callback contains the current visible item
  * - @c "transition,end" - when a slide transition ends. event_info parameter
  *   in callback contains the current visible item
+ * - @c "focused" - When the slideshow has received focus. (since 1.8)
+ * - @c "unfocused" - When the slideshow has lost focus. (since 1.8)
  *
  * List of examples for the slideshow widget:
  * @li @ref slideshow_example
index 1a8a622..0afd7ac 100644 (file)
@@ -24,6 +24,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_CHANGED, ""},
    {SIG_DELAY_CHANGED, ""},
    {SIG_LANG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 3f7a0a8..8393f3f 100644 (file)
@@ -32,6 +32,8 @@
  *    for a very short period or when they release their finger/mouse,
  *    so it avoids possibly expensive reactions to the value change.
  * - @c "language,changed" - the program's language changed
+ * - @c "focused" - When the spinner has received focus. (since 1.8)
+ * - @c "unfocused" - When the spinner has lost focus. (since 1.8)
  *
  * Available styles for it:
  * - @c "default";
index db23414..2c34289 100644 (file)
@@ -25,6 +25,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_LONGPRESSED, ""},
    {SIG_CLICKED_DOUBLE, ""},
    {SIG_LANG_CHANGED, ""},
+   {"focused", ""}, /**< handled by elm_widget */
+   {"unfocused", ""}, /**< handled by elm_widget */
    {NULL, NULL}
 };
 
index 8bc7d6d..0ad69e5 100644 (file)
@@ -29,6 +29,8 @@
  * - @c "longpressed" - when the toolbar is pressed for a certain
  *                      amount of time.
  * - @c "language,changed" - when the program language changes.
+ * - @c "focused" - When the toolbar has received focus. (since 1.8)
+ * - @c "unfocused" - When the toolbar has lost focus. (since 1.8)
  *
  * Available styles for it:
  * - @c "default"
index 90b76c5..256a838 100644 (file)
@@ -164,8 +164,8 @@ struct _Elm_Win_Smart_Data
 };
 
 static const char SIG_DELETE_REQUEST[] = "delete,request";
-static const char SIG_FOCUS_OUT[] = "focus,out";
-static const char SIG_FOCUS_IN[] = "focus,in";
+static const char SIG_FOCUS_OUT[] = "focus,out"; // deprecated. use "focused" instead.
+static const char SIG_FOCUS_IN[] = "focus,in"; // deprecated. use "unfocused" instead.
 static const char SIG_MOVED[] = "moved";
 static const char SIG_WITHDRAWN[] = "withdrawn";
 static const char SIG_ICONIFIED[] = "iconified";
@@ -180,6 +180,8 @@ static const char SIG_IOERR[] = "ioerr";
 static const char SIG_INDICATOR_PROP_CHANGED[] = "indicator,prop,changed";
 static const char SIG_ROTATION_CHANGED[] = "rotation,changed";
 static const char SIG_PROFILE_CHANGED[] = "profile,changed";
+static const char SIG_FOCUSED[] = "focused";
+static const char SIG_UNFOCUSED[] = "unfocused";
 
 static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_DELETE_REQUEST, ""},
@@ -199,6 +201,8 @@ static const Evas_Smart_Cb_Description _smart_callbacks[] = {
    {SIG_INDICATOR_PROP_CHANGED, ""},
    {SIG_ROTATION_CHANGED, ""},
    {SIG_PROFILE_CHANGED, ""},
+   {SIG_FOCUSED, ""},
+   {SIG_UNFOCUSED, ""},
    {NULL, NULL}
 };
 
@@ -832,6 +836,7 @@ _elm_win_focus_in(Ecore_Evas *ee)
    else
      elm_widget_focus_restore(obj);
    evas_object_smart_callback_call(obj, SIG_FOCUS_IN, NULL);
+   evas_object_smart_callback_call(obj, SIG_FOCUSED, NULL);
    sd->focus_highlight.cur.visible = EINA_TRUE;
    _elm_win_focus_highlight_reconfigure_job_start(sd);
    if (sd->frame_obj)
@@ -858,6 +863,7 @@ _elm_win_focus_out(Ecore_Evas *ee)
    elm_object_focus_set(obj, EINA_FALSE);
    _elm_widget_top_win_focused_set(obj, EINA_FALSE);
    evas_object_smart_callback_call(obj, SIG_FOCUS_OUT, NULL);
+   evas_object_smart_callback_call(obj, SIG_UNFOCUSED, NULL);
    sd->focus_highlight.cur.visible = EINA_FALSE;
    _elm_win_focus_highlight_reconfigure_job_start(sd);
    if (sd->frame_obj)
index 28f9740..f231ae7 100644 (file)
@@ -70,8 +70,8 @@
  *
  * @li "delete,request": the user requested to close the window. See
  * elm_win_autodel_set().
- * @li "focus,in": window got focus
- * @li "focus,out": window lost focus
+ * @li "focus,in": window got focus (deprecated. use "focused" instead.)
+ * @li "focus,out": window lost focus (deprecated. use "unfocused" instead.)
  * @li "moved": window that holds the canvas was moved
  * @li "withdrawn": window is still managed normally but removed from view
  * @li "iconified": window is minimized (perhaps into an icon or taskbar)
@@ -86,6 +86,8 @@
  * @li "indicator,prop,changed": an indicator's property has been changed
  * @li "rotation,changed": window rotation has been changed
  * @li "profile,changed": profile of the window has been changed
+ * @li "focused" : When the win has received focus. (since 1.8)
+ * @li "unfocused" : When the win has lost focus. (since 1.8)
  *
  * Examples:
  * @li @ref win_example_01