4 <STRONG>form_field</STRONG> - make and break connections between fields and
10 <STRONG>#include</STRONG> <STRONG><form.h></STRONG>
11 int set_form_fields(FORM *form, FIELD **fields);
12 FIELD **form_fields(const FORM *form);
13 int field_count(const FORM *form);
14 int move_field(FIELD *field, int frow, int fcol);
18 <H2>DESCRIPTION</H2><PRE>
19 The function <STRONG>set_form_fields</STRONG> changes the field pointer
20 array of the given <EM>form</EM>. The array must be terminated by
21 a <STRONG>NULL</STRONG>.
23 The function <STRONG>form_fields</STRONG> returns the field array of the
26 The function <STRONG>field_count</STRONG> returns the count of fields in
29 The function <STRONG>move_field</STRONG> move the given field (which must
30 be disconnected) to a specified location on the screen.
34 <H2>RETURN VALUES</H2><PRE>
35 The function <STRONG>form_fields</STRONG> returns <STRONG>NULL</STRONG> on error.
37 The function <STRONG>field_count</STRONG> returns <STRONG>ERR</STRONG> (the general <STRONG>curses</STRONG>
38 error return value) on error.
40 The functions <STRONG>set_form_fields</STRONG> and <STRONG>move_field</STRONG> return one of
41 the following codes on error:
43 <STRONG>E_OK</STRONG> The routine succeeded.
45 <STRONG>E_SYSTEM_ERROR</STRONG>
46 System error occurred (see <STRONG>errno</STRONG>).
48 <STRONG>E_BAD_ARGUMENT</STRONG>
49 Routine detected an incorrect or out-of-range argu-
52 <STRONG>E_POSTED</STRONG>
53 The form is already posted.
55 <STRONG>E_CONNECTED</STRONG>
56 The field is already connected to a form.
60 <H2>SEE ALSO</H2><PRE>
61 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="form.3x.html">form(3X)</A></STRONG>.
69 <H2>PORTABILITY</H2><PRE>
70 These routines emulate the System V forms library. They
71 were not supported on Version 7 or BSD versions.
73 The SVr4 forms library documentation specifies the
74 <STRONG>field_count</STRONG> error value as -1 (which is the value of <STRONG>ERR</STRONG>).
79 Juergen Pfeifer. Manual pages and adaptation for new
80 curses by Eric S. Raymond.