X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_page.3x.html;h=451c967ae6f1ef263f52564f02717f7b167fcd6b;hp=07c83da31773f105207f0f3b128dc761a20c356c;hb=17c5992a16be94247b83f2bbb9accdd9b7e7bb72;hpb=761e4f0825b330e970558e82a4bd638383914429 diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index 07c83da3..451c967a 100644 --- a/doc/html/man/form_page.3x.html +++ b/doc/html/man/form_page.3x.html @@ -1,8 +1,7 @@ - + + + form_page 3x -

form_page 3x

-
+

form_page 3x

-
-form_page(3x)                                             form_page(3x)
+form_page(3x)                                                    form_page(3x)
 
 
 
 
-
-

NAME

+

NAME

        form_page - set and get form page number
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #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);
 
 
-
-

DESCRIPTION

-       The  function  set_current field sets the current field of
-       the given form; current_field returns the current field of
-       the given form.
+

DESCRIPTION

+       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.
 
-
-

RETURN VALUE

-       Except for form_page, each routine returns one of the fol-
-       lowing:
+
+

RETURN VALUE

+       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.
@@ -104,36 +99,41 @@
             System error occurred (see errno).
 
 
-
-

SEE ALSO

+

SEE ALSO

        curses(3x), form(3x).
 
 
-
-

NOTES

-       The header file <form.h> automatically includes the header
-       file <curses.h>.
+

NOTES

+       The  header  file  <form.h>  automatically  includes  the  header  file
+       <curses.h>.
 
 
-
-

PORTABILITY

-       These routines emulate the System V forms  library.   They
-       were not supported on Version 7 or BSD versions.
+

PORTABILITY

+       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.
 
-
-

AUTHORS

-       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
-       curses by Eric S. Raymond.
+
+

AUTHORS

+       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
+       Raymond.
 
 
 
-                                                          form_page(3x)
+                                                                 form_page(3x)
 
-
-
-Man(1) output converted with -man2html -
+