H65430 s 00122/00000/00000 d D 1.1 02/05/02 15:35:04 root 2 1 cC cF1 cK32884 cO-rw-rw-r-- e s 00000/00000/00000 d D 1.0 02/05/02 15:35:04 root 1 0 c BitKeeper file /Mastodon/Core/Build/ncurses/Ada95/html/form_field_new.3x.html cBor@egypt.pell.portland.or.us|ChangeSet|20020502223039|07086|e73225ae258b78f8 cHegypt.pell.portland.or.us cK27940 cPAda95/html/form_field_new.3x.html cR7eb730cc7c1400f2 cV4 cX0x821 cZ-07:00 e u U f e 0 f x 0x821 t T I 2
form_field_new - create and destroy form fields
#include <form.h> FIELD *new_field(int height, int width, int toprow, int leftcol, int offscreen, int nbuffers); FIELD *dup_field(FIELD *field, int toprow, int leftcol); FIELD *link_field(FIELD *field, int toprow, int leftcol); int free_field(FIELD *field);
The function new_field allocates a new field and initial- izes it from the parameters given: height, width, row of upper-left corner, column of upper-left corner, number off-screen rows, and number of additional working buffers. The function dup_field duplicates a field at a new loca- tion. Most attributes (including current contents, size, validation type, buffer count, growth threshold, justifi- cation, foreground, background, pad character, options, and user pointer) are copied. Field status and the field page bit are not copied. The function link_field acts like dup_field, but the new field shares buffers with its parent. Attribute data is separate. The function free_field de-allocates storage associated with a field.
The function, new_field, dup_field, link_field return NULL on error. The function free_field returns one of the following: E_OK The routine succeeded. E_SYSTEM_ERROR System error occurred (see errno). E_BAD_ARGUMENT Routine detected an incorrect or out-of-range argu- ment.
curses(3X), form(3X).
The header file <form.h> automatically includes the header file <curses.h>. These routines emulate the System V forms library. They were not supported on Version 7 or BSD versions. It may be unwise to count on the set of attributes copied by dup_field(3x) being portable; the System V forms library documents are not very explicit on what gets copied and was not.
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.E 2 I 1 E 1