form_field_new(3) UNIX Programmer's Manual form_field_new(3)
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 initializes
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 location.
Most attributes (including current contents, size, valida-
tion type, buffer count, growth threshold, justification,
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 argument.
curses(3), form(3).
The header file <form.h> automatically includes the header
file <curses.h>.
MirOS BSD #10-current Printed 19.2.2012 1
form_field_new(3) UNIX Programmer's Manual form_field_new(3)
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(3) being portable; the System V forms library
documents are not very explicit about what gets copied and
what doesn't.
Juergen Pfeifer. Manual pages and adaptation for new curses
by Eric S. Raymond.
MirOS BSD #10-current Printed 19.2.2012 2
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.