2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
4 <STRONG>form_post</STRONG> - write or erase forms from associated subwin-
10 <STRONG>#include</STRONG> <STRONG><form.h></STRONG>
11 int post_form(FORM *form);
12 int unpost_form(FORM *form);
16 <H2>DESCRIPTION</H2><PRE>
17 The function <STRONG>post_form</STRONG> displays a form to its associated
18 subwindow. To trigger physical display of the subwindow,
19 use <STRONG>refresh</STRONG> or some equivalent <STRONG>curses</STRONG> routine (the
20 implicit <STRONG>doupdate</STRONG> triggered by an <STRONG>curses</STRONG> input request
23 The function <STRONG>unpost_form</STRONG> erases form from its associated
28 <H2>RETURN VALUE</H2><PRE>
29 These routines return one of the following:
31 <STRONG>E_OK</STRONG> The routine succeeded.
33 <STRONG>E_SYSTEM_ERROR</STRONG>
34 System error occurred (see <STRONG>errno</STRONG>).
36 <STRONG>E_BAD_ARGUMENT</STRONG>
37 Routine detected an incorrect or out-of-range argu-
40 <STRONG>E_POSTED</STRONG>
41 The form has already been posted.
43 <STRONG>E_BAD_STATE</STRONG>
44 Routine was called from an initialization or termina-
47 <STRONG>E_NO_ROOM</STRONG>
48 Form is too large for its window.
50 <STRONG>E_NOT_POSTED</STRONG>
51 The form has not been posted.
53 <STRONG>E_NOT_CONNECTED</STRONG>
54 No items are connected to the form.
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>.
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.
72 Juergen Pfeifer. Manual pages and adaptation for new
73 curses by Eric S. Raymond.