X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_page.3x.html;h=451c967ae6f1ef263f52564f02717f7b167fcd6b;hp=dafa3f02005cd3ca4bb9f6bef257fb2be287e21c;hb=17c5992a16be94247b83f2bbb9accdd9b7e7bb72;hpb=6208c89f98f1cf9fe0980bd8e791846ce007a13d diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index dafa3f02..451c967a 100644 --- a/doc/html/man/form_page.3x.html +++ b/doc/html/man/form_page.3x.html @@ -1,7 +1,7 @@ - + form_page 3x @@ -41,7 +41,7 @@

# form_page 3x

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

```

## 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_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:
+       Except for form_page, each routine returns one of the following:

E_OK The routine succeeded.

-            Routine  detected  an incorrect or out-of-range argu-
-            ment.
+            Routine detected an incorrect or out-of-range argument.

-            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.
@@ -105,22 +104,24 @@

```

## NOTES

```-       The header file <form.h> automatically includes the header
-       file <curses.h>.
+       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.
+       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.
+       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
+       Raymond.

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