opensolaris man page for form_sub

form_win(3CURSES)					     Curses Library Functions						 form_win(3CURSES)

NAME
       form_win, set_form_win, set_form_sub, form_sub, scale_form - forms window and subwindow association routines

SYNOPSIS
       cc [ flag... ] file... -lform  -lcurses	[ library... ]
       #include <form.h>

       int set_form_win(FORM *form, WINDOW *win);

       WINDOW *form_win(FORM *form);

       int set_form_sub(FORM *form, WINDOW *sub);

       WINDOW *form_sub(FORM *form);

       int scale_form(FORM *form, int *rows, int *cols);

DESCRIPTION
       set_form_win() sets the window of form to win. form_win() returns a pointer to the window associated with form.set_form_sub() sets the sub-
       window of form to sub. form_sub() returns a pointer to the subwindow associated with form.scale_form() returns  the  smallest  window  size
       necessary  for  the  subwindow  of  form. rows and cols are pointers to the locations used to return the number of rows and columns for the
       form.

RETURN VALUES
       Routines that return pointers always return NULL on error. Routines that return an integer return one of the following:

       E_OK		  The function returnedsuccessfully.

       E_SYSTEM_ERROR	  System error.

       E_BAD_ARGUMENT	  An argument is incorrect.

       E_NOT_CONNECTED	  The field is not connected to a form.

       E_POSTED 	  The form is posted.

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

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

SEE ALSO
       curses(3CURSES), forms(3CURSES), attributes(5)

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

SunOS 5.11							    31 Dec 1996 						 form_win(3CURSES)