form_post(3) [netbsd man page]

FORMS(3)						   BSD Library Functions Manual 						  FORMS(3)

NAME

     post_form, unpost_form -- form library

LIBRARY

     Curses Form Library (libform, -lform)

SYNOPSIS

     #include <form.h>

     int
     post_form(FORM *form);

     int
     unpost_form(FORM *form);

DESCRIPTION

     The post_form() function performs the actions necessary to present the form on the curses screen.	If there are any init functions that need
     to be called then they will be called prior to the form being posted and the cursor will be positioned on the first active field that can be
     visited.  Conversely, the function unpost_form() removes the form from the screen and calls any termination functions that were specified.

RETURN VALUES

     The functions will return one of the following error values:

     E_OK		The function was successful.
     E_BAD_ARGUMENT	A bad argument was passed to the function.
     E_POSTED		The form is already posted to the screen.
     E_NOT_POSTED	The form was not posted to the screen.
     E_NOT_CONNECTED	There are no fields associated with the form.
     E_BAD_STATE	The function was called from within a init or term function.

SEE ALSO

     curses(3), forms(3)

NOTES

     The header <form.h> automatically includes both <curses.h> and <eti.h>.

BSD
								  January 1, 2001							       BSD

form_post(3CURSES)					     Curses Library Functions						form_post(3CURSES)

NAME

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

SYNOPSIS

       cc [ flag... ] file... -lform -lcurses [ 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 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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       curses(3CURSES), forms(3CURSES), panel_update(3CURSES), panels(3CURSES), attributes(5)

NOTES

       The header <form.h> automatically includes the headers  <eti.h> and <curses.h>.

SunOS 5.10							    31 Dec 1996 						form_post(3CURSES)