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

NAME

6       form_field_opts,    set_field_opts,    field_opts_on,   field_opts_off,
7       field_opts - forms field option routines
8

SYNOPSIS

10       cc [ flag... ] file... -lform  -lcurses  [ library... ]
11       #include <form.h>
12
13       int set_field_opts(FIELD *field, OPTIONS opts);
14
15
16       int set_field_opts(FIELD *field, OPTIONS opts);
17
18
19       int field_opts_on(FIELD *field, OPTIONS opts);
20
21
22       int field_opts_off(FIELD *field, OPTIONS opts);
23
24
25       OPTIONS field_opts(FIELD *field);
26
27

DESCRIPTION

29       set_field_opts() turns on the named options of field and turns off  all
30       remaining  options.  Options  are  boolean  values  that  can  be OR-ed
31       together.
32
33
34       field_opts_on() turns on  the  named  options;  no  other  options  are
35       changed.
36
37
38       field_opts_off()  turns  off  the  named  options; no other options are
39       changed.
40
41
42       field_opts() returns the options set for field.
43
44       O_VISIBLE     The field is displayed.
45
46
47       O_ACTIVE           The field is visited during processing.
48
49
50       O_PUBLIC      The field contents are displayed as data is entered.
51
52
53       O_EDIT             The field can be edited.
54
55
56       O_WRAP        Words not fitting on a line are wrapped to the next line.
57
58
59       O_BLANK       The whole field is cleared if a character is entered   in
60                     the first position.
61
62
63       O_AUTOSKIP    Skip  to  the  next  field when the current field becomes
64                      full.
65
66
67       O_NULLOK      A blank field is considered valid.
68
69
70       O_STATIC      The field buffers are fixed in size.
71
72
73       O_PASSOK      Validate field only if modified by user.
74
75

RETURN VALUES

77       set_field_opts, field_opts_on and field_opts_off return one of the fol‐
78       lowing:
79
80       E_OK              The function returned successfully.
81
82
83       E_SYSTEM_ERROR    System error.
84
85
86       E_CURRENT         The field is the current field.
87
88

ATTRIBUTES

90       See attributes(5) for descriptions of the following attributes:
91
92
93
94
95       ┌─────────────────────────────┬─────────────────────────────┐
96       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
97       ├─────────────────────────────┼─────────────────────────────┤
98       │MT-Level                     │Unsafe                       │
99       └─────────────────────────────┴─────────────────────────────┘
100

SEE ALSO

102       curses(3CURSES), forms(3CURSES), attributes(5)
103

NOTES

105       The  header  <form.h>  automatically  includes the headers  <eti.h> and
106       <curses.h>.
107
108
109
110SunOS 5.11                        31 Dec 1996         form_field_opts(3CURSES)
Impressum