Enlightenment CVS committal

Author  : ningerso
Project : e17
Module  : libs/ewl

Dir     : e17/libs/ewl/src/bin/tests


Modified Files:
        ewl_password.c 


Log Message:
Add password tutorial.

===================================================================
RCS file: /cvs/e/e17/libs/ewl/src/bin/tests/ewl_password.c,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -3 -r1.2 -r1.3
--- ewl_password.c      10 Mar 2006 04:05:42 -0000      1.2
+++ ewl_password.c      31 Mar 2006 05:26:52 -0000      1.3
@@ -2,6 +2,40 @@
 #include <stdio.h>
 #include <stdlib.h>
 
+/**
+ * @addtogroup Ewl_Password
+ * @section text_tut Tutorial
+ *
+ * The password extends a basic Ewl_Entry to provide an obscured view of the
+ * text entered.
+ *
+ * @code
+ * Ewl_Widget *password;
+ * password = ewl_password_new();
+ * ewl_widget_show(password);
+ * @endcode
+ *
+ * Manipulation of the password widget is generally done through the Ewl_Entry
+ * API since the password widget inherits from the entry. The first point it
+ * diverges from the entry API is for retrieving the current string in the
+ * widget. This is necessary because the entry API returns the text that is
+ * hiding the actual contents entered.
+ *
+ * @code
+ * void ewl_password_text_set(Ewl_Password *e, const char *t);
+ * char *ewl_password_text_get(Ewl_Password *e);
+ * @endcode
+ *
+ * The character used to hide the text of the password is also configurable at
+ * runtime, the default obscuring character is '*'.
+ *
+ * @code
+ * void ewl_password_obscure_set(Ewl_Password *e, char o);
+ * char ewl_password_obscure_get(Ewl_Password *e);
+ * @endcode
+ *
+ */
+
 static Ewl_Widget *password[2];
 
 static int create_test(Ewl_Container *win);




-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
enlightenment-cvs mailing list
enlightenment-cvs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs

Reply via email to