form_post(3ocurses)

form_post: post_form, unpost_form -- write or erase forms from associated subwindows

Synopsis

cc [flag . . .] file -lform -locurses [library . . .]

#include <form.h>

int post_form(FORM form);
int unpost_form(FORM form);

Description

post_form writes form into its associated subwindow. The application programmer must use curses library routines to display the form on the physical screen or call update_panels if the panels library is being used.

unpost_form erases form from its associated subwindow.

<Return> value

These routines return one of the following:

E_OK - The function returned successfully.

E_SYSTEM_ERROR - System error.

E_BAD_ARGUMENT - An argument is incorrect.

E_POSTED - The form is posted.

E_NOT_POSTED - The form is not posted.

E_NO_ROOM - The form does not fit in the subwindow.

E_BAD_STATE - The routine was called from an initialization

or termination function.

E_NOT_CONNECTED - The field is not connected to a form.

Notices

The header file form.h automatically includes the header files eti.h and ocurses.h.

References

curses(3ocurses), forms(3ocurses), panels(3ocurses), panel_update(3ocurses)

E_OK	-	The function returned successfully.
E_SYSTEM_ERROR	-	System error.
E_BAD_ARGUMENT	-	An argument is incorrect.
E_POSTED	-	The form is posted.
E_NOT_POSTED	-	The form is not posted.
E_NO_ROOM	-	The form does not fit in the subwindow.
E_BAD_STATE	-	The routine was called from an initialization
		or termination function.
E_NOT_CONNECTED	-	The field is not connected to a form.