1form_win(3CURSES)          Curses Library Functions          form_win(3CURSES)
2
3
4

NAME

6       form_win, set_form_win, set_form_sub, form_sub, scale_form - forms win‐
7       dow and subwindow association routines
8

SYNOPSIS

10       cc [ flag... ] file... -lform  -lcurses  [ library... ]
11       #include <form.h>
12
13       int set_form_win(FORM *form, WINDOW *win);
14
15
16       WINDOW *form_win(FORM *form);
17
18
19       int set_form_sub(FORM *form, WINDOW *sub);
20
21
22       WINDOW *form_sub(FORM *form);
23
24
25       int scale_form(FORM *form, int *rows, int *cols);
26
27

DESCRIPTION

29       set_form_win() sets the window of form to  win.  form_win()  returns  a
30       pointer to the window associated with form.set_form_sub() sets the sub‐
31       window of form to sub. form_sub() returns a pointer  to  the  subwindow
32       associated with form.scale_form() returns the smallest window size nec‐
33       essary for the subwindow of form. rows and cols  are  pointers  to  the
34       locations used to return the number of rows and columns for the form.
35

RETURN VALUES

37       Routines  that  return  pointers  always return NULL on error. Routines
38       that return an integer return one of the following:
39
40       E_OK               The function returnedsuccessfully.
41
42
43       E_SYSTEM_ERROR     System error.
44
45
46       E_BAD_ARGUMENT     An argument is incorrect.
47
48
49       E_NOT_CONNECTED    The field is not connected to a form.
50
51
52       E_POSTED           The form is posted.
53
54

ATTRIBUTES

56       See attributes(5) for descriptions of the following attributes:
57
58
59
60
61       ┌─────────────────────────────┬─────────────────────────────┐
62       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
63       ├─────────────────────────────┼─────────────────────────────┤
64       │MT-Level                     │Unsafe                       │
65       └─────────────────────────────┴─────────────────────────────┘
66

SEE ALSO

68       curses(3CURSES), forms(3CURSES), attributes(5)
69

NOTES

71       The header <form.h> automatically includes  the  headers   <eti.h>  and
72       <curses.h>.
73
74
75
76SunOS 5.11                        31 Dec 1996                form_win(3CURSES)