Skip Navigation Links | |
Exit Print View | |
![]() |
man pages section 3: Curses Library Functions Oracle Solaris 10 1/13 Information Library |
- character based forms package
#include <form.h>
The form library is built using the curses library, and any program using forms routines must call one of the curses initialization routines such as initscr. A program using these routines must be compiled with -lform and -lcurses on the cc command line.
The forms package gives the applications programmer a terminal-independent method of creating and customizing forms for user-interaction. The forms package includes: field routines, which are used to create and customize fields, link fields and assign field types; fieldtype routines, which are used to create new field types for validating fields; and form routines, which are used to create and customize forms, assign pre/post processing functions, and display and interact with forms.
The forms package establishes initial current default values for field attributes. During field initialization, each field attribute is assigned the current default value for that attribute. An application can change or retrieve a current default attribute value by calling the appropriate set or retrieve routine with a NULL field pointer. If an application changes a current default field attribute value, subsequent fields created using new_field() will have the new default attribute value. (The attributes of previously created fields are not changed if a current default attribute value is changed.)
The following table lists each forms routine and the name of the manual page on which it is described.
Manual Page Name
form_page(3X)
form_data(3X)
form_data(3X)
form_field_new(3X)
form_field_info(3X)
form_field_validation(3X)
form_field_attributes(3X)
form_field_buffer(3X)
form_field(3X)
form_field_attributes(3X)
form_page(3X)
form_field_info(3X)
form_hook(3X)
form_field_just(3X)
form_field_opts(3X)
form_field_opts(3X)
form_field_opts(3X)
form_field_attributes(3X)
form_field_buffer(3X)
form_hook(3X)
form_field_validation(3X)
form_field_userptr(3X)
form_driver(3X)
form_field(3X)
form_hook(3X)
form_opts(3X)
form_opts(3X)
form_opts(3X)
form_page(3X)
form_win(3X)
form_hook(3X)
form_userptr(3X)
form_win(3X)
form_field_new(3X)
form_fieldtype(3X)
form_new(3X)
form_field_new(3X)
form_fieldtype(3X)
form_field(3X)
form_field_new(3X)
form_fieldtype(3X)
form_new(3X)
form_new_page(3X)
form_cursor(3X)
form_post(3X)
form_win(3X)
form_page(3X)
form_field_attributes(3X)
form_field_buffer(3X)
form_field_attributes(3X)
form_hook(3X)
form_field_just(3X)
form_field_opts(3X)
form_field_attributes(3X)
form_field_buffer(3X)
form_hook(3X)
form_field_validation(3X)
form_field_userptr(3X)
form_fieldtype(3X)
form_fieldtype(3X)
form_field(3X)
form_hook(3X)
form_opts(3X)
form_page(3X)
form_win(3X)
form_hook(3X)
form_userptr(3X)
form_win(3X)
form_field_buffer(3X)
form_new_page(3X)
form_post(3X)
Routines that return a pointer always return NULL on error. Routines that return an integer return one of the following:
The function returned successfully.
The field is already connected to a form.
System error.
An argument is incorrect.
The field is the current field.
The form is posted.
The form is not posted.
The field contents are invalid.
The field is not connected to a form.
The form does not fit in the subwindow.
The routine was called from an initialization or termination function.
The form driver request failed.
An unknown request was passed to the form driver.
See attributes(5) for descriptions of the following attributes:
|
curses(3CURSES), attributes(5)
The header <form.h> automatically includes the headers <eti.h> and <curses.h>.