formpost(3X)                                                    formpost(3X)



NAME
       formpost - write or erase forms from associated subwindows

SYNOPSIS
       ##include <>
       int postform(FORM *form);
       int unpostform(FORM *form);

DESCRIPTION
       The function postform displays a form to its associated subwindow.  To
       trigger physical display of the subwindow, use refresh or some  equiva-
       lent curses routine (the implicit doupdate triggered by an curses input
       request will do).

       The function unpostform erases form from its associated subwindow.

RETURN VALUE
       These routines return one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The form has already been posted.

       EBADSTATE
            Routine was called from an initialization or termination function.

       ENOROM
            Form is too large for its window.

       ENOTPOSTED
            The form has not been posted.

       ENOTCONECTED
            No items are connected to the form.

SEE ALSO
       curses(3X), form(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These routines emulate the System V forms library.  They were not  sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 formpost(3X)