X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=inline;f=doc%2Fhtml%2Fman%2Fform_page.3x.html;h=999089962fea57a66f7c30675dcbf15a93c3bc66;hb=3ab4db240283db0682a66a8587f2174508348bc6;hp=33e232442a990d9281ec4a50390f68cc1d909e4c;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e;p=ncurses.git diff --git a/doc/html/man/form_page.3x.html b/doc/html/man/form_page.3x.html index 33e23244..99908996 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 - set and get form page number --
+
#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. @@ -101,39 +96,44 @@ The form driver could not process the request. E_SYSTEM_ERROR - System error occurred (see errno). + System error occurred (see errno(3)). --
+
curses(3x), form(3x). --
- 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)-