form_post(3curses)


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

 
 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 curses.h.

References

curses(3curses), forms(3curses), panels(3curses), panel_update(3curses)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.