FORM_FIELD_OPTS(3CURSES) Curses Library Functions FORM_FIELD_OPTS(3CURSES)


NAME


form_field_opts, set_field_opts, field_opts_on, field_opts_off,
field_opts - forms field option routines

SYNOPSIS


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

int set_field_opts(FIELD *field, OPTIONS opts);


int set_field_opts(FIELD *field, OPTIONS opts);


int field_opts_on(FIELD *field, OPTIONS opts);


int field_opts_off(FIELD *field, OPTIONS opts);


OPTIONS field_opts(FIELD *field);


DESCRIPTION


set_field_opts() turns on the named options of field and turns off all
remaining options. Options are boolean values that can be OR-ed together.


field_opts_on() turns on the named options; no other options are changed.


field_opts_off() turns off the named options; no other options are
changed.


field_opts() returns the options set for field.

O_VISIBLE
The field is displayed.


O_ACTIVE
The field is visited during processing.


O_PUBLIC
The field contents are displayed as data is entered.


O_EDIT
The field can be edited.


O_WRAP
Words not fitting on a line are wrapped to the next line.


O_BLANK
The whole field is cleared if a character is entered in the
first position.


O_AUTOSKIP
Skip to the next field when the current field becomes full.


O_NULLOK
A blank field is considered valid.


O_STATIC
The field buffers are fixed in size.


O_PASSOK
Validate field only if modified by user.


RETURN VALUES


set_field_opts, field_opts_on and field_opts_off return one of the
following:

E_OK
The function returned successfully.


E_SYSTEM_ERROR
System error.


E_CURRENT
The field is the current field.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


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

SEE ALSO


curses(3CURSES), forms(3CURSES), attributes(7)

NOTES


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


illumos December 31, 1996 FORM_FIELD_OPTS(3CURSES)