WWW-www.enlightenment.org pushed a commit to branch master.

http://git.enlightenment.org/website/www-content.git/commit/?id=e10689d9773050e76175294e394a85f69650c730

commit e10689d9773050e76175294e394a85f69650c730
Author: Xavi Artigas <xavierarti...@yahoo.es>
Date:   Tue Jan 2 02:15:14 2018 -0800

    Wiki page focus.md changed with summary [Added summary] by Xavi Artigas
---
 pages/develop/guides/c/ui/focus.md.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/pages/develop/guides/c/ui/focus.md.txt 
b/pages/develop/guides/c/ui/focus.md.txt
index ba48ab88c..01170c57c 100644
--- a/pages/develop/guides/c/ui/focus.md.txt
+++ b/pages/develop/guides/c/ui/focus.md.txt
@@ -38,6 +38,8 @@ When EFL receives an ordinal focus navigation command 
(typically though the <kbd
 
 As you add widgets to your GUI, the *focusable* ones are added to a list (not 
all widgets can be selected, like text labels, for example). Ordinal commands 
then move the focus through this list. If a widget is a container for other 
widgets (like Box), focus will move through its children *before* moving out of 
the container and onto its siblings.
 
+So, the bottom line is: **Add widgets to your GUI in the same order in which 
you will want the user to navigate them**. The order in which the widgets are 
added has no other impact, so it is worth walking the extra mile and do it in a 
sensible order: In this way, your GUI will be more keyboard-friendly.
+
 ## Setting the Focus on a Widget ##
 
 Sometimes you want to bypass EFL's default behavior and programmatically set 
the focus to a particular widget, for example, on the [OK] button once enough 
information has been added to a form.
@@ -90,6 +92,14 @@ Here's an usage example based on the EFL examples repository 
[tutorial/c/focus/s
    }
 ```
 
+## Summary ##
+
+* Add widgets to your GUI in the same order you will want your users to 
navigate them.
+
+* Manually set the focus to a widget using ``efl_ui_focus_util_focus()``.
+
+* Be notified of focus changes by listening to the 
``EFL_UI_FOCUS_OBJECT_EVENT_FOCUS_CHANGED`` event.
+
 ## Further Reading ##
 
 [Introduction to Eo](/develop/tutorials/c/eo-intro.md)

-- 


Reply via email to