4 <!-- Manpage converted by man2html 3.0.1 -->
8 <B>form_field</B> - make and break connections between fields and
13 <H2>SYNOPSIS</H2><PRE>
14 <B>#include</B> <B><form.h></B>
15 int set_form_fields(FORM *form, FIELD **fields);
16 FIELD **form_fields(const FORM *form);
17 int field_count(const FORM *form);
18 int move_field(FIELD *field, int frow, int fcol);
22 <H2>DESCRIPTION</H2><PRE>
23 The function <B>set_form_fields</B> changes the field pointer
24 array of the given <I>form</I>. The array must be terminated by
27 The function <B>form_fields</B> returns the field array of the
30 The function <B>field_count</B> returns the count of fields in
33 The function <B>move_field</B> move the given field (which must
34 be disconnected) to a specified location on the screen.
38 <H2>RETURN VALUES</H2><PRE>
39 The function <B>form_fields</B> returns <B>NULL</B> on error.
41 The function <B>field_count</B> returns <B>ERR</B> (the general <B>curses</B>
42 error return value) on error.
44 The functions <B>set_form_fields</B> and <B>move_field</B> return one of
45 the following codes on error:
47 <B>E_OK</B> The routine succeeded.
50 System error occurred (see <B>errno</B>).
53 Routine detected an incorrect or out-of-range argu-
57 The form is already posted.
60 The field is already connected to a form.
64 <H2>SEE ALSO</H2><PRE>
65 <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="form.3x.html">form(3x)</A></B>.
70 The header file <B><form.h></B> automatically includes the header
71 file <B><curses.h></B>.
75 <H2>PORTABILITY</H2><PRE>
76 These routines emulate the System V forms library. They
77 were not supported on Version 7 or BSD versions.
79 The SVr4 forms library documentation specifies the
80 <B>field_count</B> error value as -1 (which is the value of <B>ERR</B>).
85 Juergen Pfeifer. Manual pages and adaptation for new
86 curses by Eric S. Raymond.
132 Man(1) output converted with
133 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>