X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fform_field.3x.html;h=2754a790d01cdd9fd473508e5edecb85a9883a9b;hp=35d82339d822688ffa4e21aff17427e04ec69c28;hb=62ca6190a9a8ddccb2c4d5ca7b2ef9f88432da65;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/doc/html/man/form_field.3x.html b/doc/html/man/form_field.3x.html index 35d82339..2754a790 100644 --- a/doc/html/man/form_field.3x.html +++ b/doc/html/man/form_field.3x.html @@ -1,8 +1,7 @@ - +
+ +- +form_field(3x) form_field(3x) --
+ + + +
form_field - make and break connections between fields and forms --
+
#include <form.h> int set_form_fields(FORM *form, FIELD **fields); FIELD **form_fields(const FORM *form); @@ -57,8 +59,7 @@ int move_field(FIELD *field, int frow, int fcol); --
+
The function set_form_fields changes the field pointer array of the given form. The array must be terminated by a NULL. @@ -69,107 +70,72 @@ The function field_count returns the count of fields in form. - The function move_field move the given field (which must + The function move_field moves the given field (which must be disconnected) to a specified location on the screen. --
- The function form_fields returns NULL on error. +
+ The function form_fields returns a pointer (which may be + NULL). It does not set errno. - The function field_count returns ERR (the general curses - error return value) on error. + The function field_count returns ERR if the form parameter + is NULL. The functions set_form_fields and move_field return one of the following codes on error: E_OK The routine succeeded. - E_SYSTEM_ERROR - System error occurred (see errno). - E_BAD_ARGUMENT - Routine detected an incorrect or out-of-range argu- + Routine detected an incorrect or out-of-range argu- ment. + E_CONNECTED + The field is already connected to a form. + E_POSTED The form is already posted. - E_CONNECTED - The field is already connected to a form. + E_SYSTEM_ERROR + System error occurred (see errno). --
+
curses(3x), form(3x). --
+
The header file <form.h> automatically includes the header file <curses.h>. --
- These routines emulate the System V forms library. They +
+ These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. - The SVr4 forms library documentation specifies the + The SVr4 forms library documentation specifies the field_count error value as -1 (which is the value of ERR). --
+
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + form_field(3x)-