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

NAME

6       form_field,  set_form_fields,  form_fields,  field_count,  move_field -
7       connect fields to forms
8

SYNOPSIS

10       cc [ flag... ] file... -lform  -lcurses  [ library... ]
11       #include <form.h>
12
13       int set_form_fields(FORM *form, FIELD **field);
14
15
16       FIELD **form_fields(FORM *form);
17
18
19       int field_count(FORM *form);
20
21
22       int move_field(FIELD *field, int frow, int fcol);
23
24

DESCRIPTION

26       set_form_fields() changes the fields connected to form to  fields.  The
27       original fields are disconnected.
28
29
30       form_fields() returns a pointer to the field pointer array connected to
31       form.
32
33
34       field_count() returns the number of fields connected to form.
35
36
37       move_field() moves the disconnected field to the location frow, fcol in
38       the forms subwindow.
39

RETURN VALUES

41       form_fields() returns NULL on error.
42
43
44       field_count() returns -1 on error.
45
46
47       set_form_fields() and move_field() return one of the following:
48
49       E_OK              The function returned successfully.
50
51
52       E_CONNECTED       The field is already connected to a form.
53
54
55       E_SYSTEM_ERROR    System error.
56
57
58       E_BAD_ARGUMENT    An argument is incorrect
59
60
61       E_POSTED          The form is posted.
62
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │MT-Level                     │Unsafe                       │
74       └─────────────────────────────┴─────────────────────────────┘
75

SEE ALSO

77       curses(3CURSES), forms(3CURSES), attributes(5)
78

NOTES

80       The  header  <form.h>  automatically  includes the headers  <eti.h> and
81       <curses.h>.
82
83
84
85SunOS 5.11                        31 Dec 1996              form_field(3CURSES)