ncurses 5.0
[ncurses.git] / Ada95 / html / man / form_field_new.3x.html
1 <HTML>
2 <BODY>
3 <PRE>
4        <STRONG>form_field_new</STRONG> - create and destroy form fields
5
6
7 </PRE>
8 <H2>SYNOPSIS</H2><PRE>
9        <STRONG>#include</STRONG> <STRONG><form.h></STRONG>
10        FIELD *new_field(int height, int width,
11                         int toprow, int leftcol,
12                         int offscreen, int nbuffers);
13        FIELD *dup_field(FIELD *field, int toprow, int leftcol);
14        FIELD *link_field(FIELD *field, int toprow, int leftcol);
15        int free_field(FIELD *field);
16
17
18 </PRE>
19 <H2>DESCRIPTION</H2><PRE>
20        The  function <STRONG>new_field</STRONG> allocates a new field and initial-
21        izes it from the parameters given: height, width,  row  of
22        upper-left  corner,  column  of  upper-left corner, number
23        off-screen rows, and number of additional working buffers.
24
25        The  function  <STRONG>dup_field</STRONG> duplicates a field at a new loca-
26        tion.  Most attributes (including current contents,  size,
27        validation  type, buffer count, growth threshold, justifi-
28        cation, foreground, background,  pad  character,  options,
29        and  user pointer) are copied.  Field status and the field
30        page bit are not copied.
31
32        The function <STRONG>link_field</STRONG> acts like <STRONG>dup_field</STRONG>, but  the  new
33        field  shares  buffers with its parent.  Attribute data is
34        separate.
35
36        The function <STRONG>free_field</STRONG>  de-allocates  storage  associated
37        with a field.
38
39
40 </PRE>
41 <H2>RETURN VALUE</H2><PRE>
42        The function, <STRONG>new_field</STRONG>, <STRONG>dup_field</STRONG>, <STRONG>link_field</STRONG> return <STRONG>NULL</STRONG>
43        on error.
44
45        The function <STRONG>free_field</STRONG> returns one of the following:
46
47        <STRONG>E_OK</STRONG> The routine succeeded.
48
49        <STRONG>E_SYSTEM_ERROR</STRONG>
50             System error occurred (see <STRONG>errno</STRONG>).
51
52        <STRONG>E_BAD_ARGUMENT</STRONG>
53             Routine detected an incorrect or  out-of-range  argu-
54             ment.
55
56
57 </PRE>
58 <H2>SEE ALSO</H2><PRE>
59        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="form.3x.html">form(3X)</A></STRONG>.
60
61
62 </PRE>
63 <H2>NOTES</H2><PRE>
64        The header file <STRONG><form.h></STRONG> automatically includes the header
65        file <STRONG><curses.h></STRONG>.
66        These routines emulate the System V forms  library.   They
67        were not supported on Version 7 or BSD versions.
68
69        It  may be unwise to count on the set of attributes copied
70        by  <STRONG><A HREF="dup_field.3x.html">dup_field(3X)</A></STRONG>  being  portable;  the  System  V  forms
71        library  documents  are  not  very  explicit  on what gets
72        copied and was not.
73
74
75 </PRE>
76 <H2>AUTHORS</H2><PRE>
77        Juergen Pfeifer.  Manual  pages  and  adaptation  for  new
78        curses by Eric S. Raymond.
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120 </PRE>
121 </BODY>
122 </HTML>