DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

form_field_opts(S-osr5)


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

Syntax

cc ... -lform -lcurses

#include <form.h>

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(S-osr5) 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(S-osr5) turns on the named options; no other options are changed.

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

field_opts(S-osr5) 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.

 E_OK            -  The function returned successfully.
 E_SYSTEM_ERROR  -  System error.
 E_CURRENT       -  The field is the current field.

Warning

The header file form.h automatically includes the header files eti.h and curses.h.

Files


/usr/lib/libform.a
the library

See also

curses(S-osr5), forms(S-osr5)

Standards conformance

set_field_opts(S-osr5), field_opts_on(S-osr5), field_opts_off(S-osr5), and field_opts(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 02 June 2005