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

NAME

6       form_page, set_form_page, set_current_field, current_field, field_index
7       - set forms current page and field
8

SYNOPSIS

10       cc [ flag... ] file... -lform  -lcurses  [ library... ]
11       #include <form.h>
12
13       int set_form_page(FORM *form, int page);
14
15
16       int form_page(FORM *form);
17
18
19       int set_current_field(FORM *form, FIELD *field);
20
21
22       FIELD *current_field(FORM*form);
23
24
25       int field_index(FIELD *field);
26
27

DESCRIPTION

29       set_form_page() sets the page  number  of  form  to  page.  form_page()
30       returns the current page number of form.
31
32
33       set_current_field()  sets  the  current  field  of  form to field. cur‐
34       rent_field() returns a pointer to the current field of form.
35
36
37       field_index() returns the index in the field pointer array of field.
38

RETURN VALUES

40       form_page() returns -1 on error.
41
42
43       current_field() returns NULL on error.
44
45
46       field_index() returns -1 on error.
47
48
49       set_form_page() and set_current_field() return one of the following:
50
51       E_OK                The function returned successfully.
52
53
54       E_SYSTEM_ERROR      System error.
55
56
57       E_BAD_ARGUMENT      An argument is incorrect.
58
59
60       E_BAD_STATE         The routine was called from an       initialization
61                           or termination function.
62
63
64       E_INVALID_FIELD     The field contents are invalid.
65
66
67       E_REQUEST_DENIED    The form driver request failed
68
69

ATTRIBUTES

71       See attributes(5) for descriptions of the following attributes:
72
73
74
75
76       ┌─────────────────────────────┬─────────────────────────────┐
77       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │MT-Level                     │Unsafe                       │
80       └─────────────────────────────┴─────────────────────────────┘
81

SEE ALSO

83       curses(3CURSES), forms(3CURSES), attributes(5)
84

NOTES

86       The  header  <form.h>  automatically  includes the headers  <eti.h> and
87       <curses.h>.
88
89
90
91SunOS 5.11                        31 Dec 1996               form_page(3CURSES)
Impressum