form_field(S-osr5)

form_field: set_form_fields, form_fields, field_count, move_field -- connect fields to forms

Syntax

cc ... -lform -lcurses

#include <form.h>

int set_form_fields(FORM *form, FIELD **field);
FIELD **form_fields(FORM *form);
int field_count(FORM *Pform);
int move_field(FIELD *field, int frow, int fcol);

Description

set_form_fields(S-osr5) changes the fields connected to form to fields. The original fields are disconnected.

form_fields(S-osr5) returns a pointer to the field pointer array connected to form.

field_count(S-osr5) returns the number of fields connected to form.

move_field(S-osr5) moves the disconnected field to the location frow, fcol in the forms(S-osr5) subwindow.

Return values

form_fields( ) returns NULL on error.

field_count( ) returns -1 on error.

set_form_fields( ) and move_field( ) return one of the following:

E_OK - The function returned successfully.

E_CONNECTED - The field is already connected to a form.

E_SYSTEM_ERROR - System error.

E_BAD_ARGUMENT - An argument is incorrect.

E_POSTED - The form is posted.

Warning

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

Files

/usr/lib/libform.a: the library

Standards conformance

set_form_fields(S-osr5), form_fields(S-osr5), field_count(S-osr5), and move_field(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.

`E_OK`	-	The function returned successfully.
`E_CONNECTED`	-	The field is already connected to a form.
`E_SYSTEM_ERROR`	-	System error.
`E_BAD_ARGUMENT`	-	An argument is incorrect.
`E_POSTED`	-	The form is posted.