elm: added more "focused" and "unfocused" documentations.

genlist, hover, index, list, map, photocam, progressbar, radio, scroller, slider, slideshow, spinner, toolbar, win.
This commit is contained in:
Daniel Juyung Seo 2013-06-10 14:12:51 +09:00
parent f1b685897d
commit 6cf684f02a
28 changed files with 64 additions and 4 deletions

View 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}
};

View File

@ -367,6 +367,8 @@
* 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

View 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}
};

View 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"

View 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}
};

View 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

View 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}
};

View 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"

View 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}
};

View 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"

View 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}
};

View 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

View 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}
};

View 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"

View 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}
};

View 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

View 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}
};

View 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(),

View 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}
};

View 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"

View 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}
};

View 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

View 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}
};

View 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";

View 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}
};

View 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"

View 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)

View 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