form_post(S)

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

Syntax

cc ... -lform -lcurses

#include <form.h>

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

Description

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

unpost_form(S) erases form from its associated subwindow.

Return values

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.

Warning

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

Files

/usr/lib/libform.a: the library

Standards conformance

post_form(S) and unpost_form(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`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.