Manual pages › X Window and screen libraries (3X)

form_f_new(3X)

create and destroy forms fields

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

form_field_new: new_field, dup_field, link_field, free_field, - create and destroy forms fields

SYNOPSIS

#include <form.h>

FIELD *new_field(int r, int c, int frow, int fcol,
     int nrow, int ncol);

FIELD *dup_field(FIELD *field, int frow, int fcol);
FIELD *link_field(FIELD *field, int frow, int fcol);

int free_field(FIELD *field);

DESCRIPTION

new_field creates a new field with r rows and c columns, starting at frow, fcol, in the subwindow of a form. nrow is the number of off-screen rows and nbuf is the number of additional working buffers. This routine returns a pointer to the new field.

dup_field duplicates field at the specified location. All field attributes are duplicated, including the current contents of the field buffers.

link_field also duplicates field at the specified location. However, unlike dup_field, the new field shares the field buffers with the original field. After creation, the attributes of the new field can be changed without affecting the original field.

free_field frees the storage allocated for field.

RETURN VALUE

Routines  that  return  pointers  return  NULL   on   error.
free_field returns 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.

NOTES