NAME    [Toc]    [Back]

     field_opts, field_opts_off, field_opts_on, set_field_opts - form library

LIBRARY    [Toc]    [Back]

     library ``libform''

SYNOPSIS    [Toc]    [Back]

     #include <form.h>

     Form_Options
     field_opts(FIELD *field);

     int
     field_opts_off(FIELD *field, Form_Options options);

     int
     field_opts_on(FIELD *field, Form_Options options);

     int
     set_field_opts(FIELD *field, Form_Options options);

DESCRIPTION    [Toc]    [Back]

     The function field_opts() returns the current options settings for the
     given field.  The field_opts_off() will turn the options given in options
     off for the given field, options not specified in options will remain
     unchanged.  Conversely, the function field_opts_on() will turn on the
     options given in options for the specified field, again, any options not
     specified will remain unchanged.  The options for a field may be set to a
     specific set of options by calling the set_field_opts() function.
     Options may only be changed if the field given is not the currently
     active one.

PARAMETERS    [Toc]    [Back]

     The following options are available for a field:

     O_VISIBLE   The field is visible, hence is displayed when the form is
                 posted.
     O_ACTIVE    The field is active in the form, meaning that it can be visited
 during form processing.
     O_PUBLIC    The contents of the field are echoed to the screen.
     O_EDIT      The contents of the field can be modified
     O_WRAP      The contents of the field are wrapped on a word boundary, if
                 this option is off then the field will be wrapped on a character
 boundary.
     O_BLANK     Blank the field on new data being entered if and only if the
                 field cursor is at the left hand side of the field.
     O_AUTOSKIP  Skip to the next field when the current field reaches it's
                 maximum size.
     O_NULLOK    The field is allowed to contain no data
     O_STATIC    The field is not dynamic, it has a fixed size.
     O_PASSOK    An unmodified field is allowed.

     The following options are on by default for a field: O_VISIBLE, O_ACTIVE,
     O_PUBLIC, O_EDIT, O_WRAP, O_BLANK, O_AUTOSKIP, O_NULLOK, O_PASSOK and
     O_STATIC.

RETURN VALUES    [Toc]    [Back]

     Functions returning pointers will return NULL if an error is detected.
     The functions that return an int will return one of the following error
     values:

     E_OK               The function was successful.
     E_CURRENT          The field specified is the currently active one in the
                        form.

SEE ALSO    [Toc]    [Back]

     curses(3), forms(3)

NOTES    [Toc]    [Back]

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

BSD                             January 1, 2001                            BSD