[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    form_post(3X) manual page Table of Contents

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);

MT-Level

Unsafe

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.

See Also

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

Notes

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

Table of Contents