X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_page.3x.html;h=999089962fea57a66f7c30675dcbf15a93c3bc66;hb=3ab4db240283db0682a66a8587f2174508348bc6;hp=dafa3f02005cd3ca4bb9f6bef257fb2be287e21c;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d;p=ncurses.git diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index dafa3f02..99908996 100644 --- a/doc/html/man/form_page.3x.html +++ b/doc/html/man/form_page.3x.html @@ -1,7 +1,7 @@
- +-form_page(3x) form_page(3x) +form_page(3x) form_page(3x) @@ -54,41 +54,40 @@ #include <form.h> int set_current_field(FORM *form, FIELD *field); FIELD *current_field(const FORM *); + int unfocus_current_field(FORM *form); int set_form_page(FORM *form, int n); int form_page(const FORM *form); int field_index(const FIELD *field);
- The function set_current field sets the current field of - the given form; current_field returns the current field of - the given form. + The function set_current_field sets the current field of the given + form; current_field returns the current field of the given form. - The function set_form_page sets the form's page number - (goes to page n of the form). + The function unfocus_current_field removes the focus from the current + field of the form. In such state, inquiries via current_field shall + return a NULL pointer. - The function form_page returns the form's current page - number. + The function set_form_page sets the form's page number (goes to page n + of the form). - The function field_index returns the index of the field in - the field array of the form it is connected to. It returns - ERR if the argument is the null pointer or the field is - not connected. + The function form_page returns the form's current page number. + + The function field_index returns the index of the field in the field + array of the form it is connected to. It returns ERR if the argument + is the null pointer or the field is not connected.
- Except for form_page, each routine returns one of the fol- - lowing: + Except for form_page, each routine returns one of the following: E_OK The routine succeeded. E_BAD_ARGUMENT - Routine detected an incorrect or out-of-range argu- - ment. + Routine detected an incorrect or out-of-range argument. E_BAD_STATE - Routine was called from an initialization or termina- - tion function. + Routine was called from an initialization or termination function. E_INVALID_FIELD Contents of a field are not valid. @@ -97,7 +96,7 @@ The form driver could not process the request. E_SYSTEM_ERROR - System error occurred (see errno). + System error occurred (see errno(3)).
@@ -105,22 +104,24 @@
- The header file <form.h> automatically includes the header - file <curses.h>. + The header file <form.h> automatically includes the header file + <curses.h>.
- These routines emulate the System V forms library. They - were not supported on Version 7 or BSD versions. + These routines emulate the System V forms library. They were not sup- + ported on Version 7 or BSD versions. + + The unfocus_current_field function is an ncurses extension.
- Juergen Pfeifer. Manual pages and adaptation for new - curses by Eric S. Raymond. + Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. + Raymond. - form_page(3x) + form_page(3x)