field_new
NAMESYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
NOTES
PORTABILITY
AUTHORS
NAME
form_field_new − create and destroy form fields
SYNOPSIS
#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);
DESCRIPTION
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, validation 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.
RETURN VALUE
The function, new_field, dup_field, link_field return NULL on error. They set errno according to their success:
|
E_OK |
The routine succeeded. |
E_BAD_ARGUMENT
Routine detected an incorrect or out-of-range argument.
E_SYSTEM_ERROR
System error occurred, e.g., malloc failure.
The function free_field returns one of the following:
|
E_OK |
The routine succeeded. |
E_BAD_ARGUMENT
Routine detected an incorrect or out-of-range argument.
E_CONNECTED
field is connected.
SEE ALSO
ncurses(3NCURSES), form(3FORM).
NOTES
The header file <form.h> automatically includes the header file <curses.h>.
PORTABILITY
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 being portable; the System V forms library documents are not very explicit about what gets copied and what does not.
AUTHORS
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.
More Linux Commands
manpages/unbuffer.1.html
unbuffer(1) - unbuffer output (Commands - Linux man page)...
unbuffer disables the output buffering that occurs when program output is redirected from non-interactive programs. For example, suppose you are watching the ou
manpages/Tcl_DecrRefCount.3.html
Tcl_DecrRefCount(3) - manipulate Tcl objects (Man Page).....
This man page presents an overview of Tcl objects and how they are used. It also describes generic procedures for managing Tcl objects. These procedures are use
manpages/perl5004delta.1.html
perl5004delta(1) - what's new for perl5.004 - Linux man page
This document describes differences between the 5.003 release (as documented in Programming Perl, second edition--the Camel Book) and this one. Supported Enviro
manpages/getgrent.3.html
getgrent(3) - get group file entry - Linux manual page......
The getgrent() function returns a pointer to a structure containing the broken-out fields of a record in the group database (e.g., the local group file /etc/gro
manpages/gunzip.1.html
gunzip(1) - compress or expand files - Linux manual page....
Gzip reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension .gz, while keeping t
manpages/fgetgrent.3.html
fgetgrent(3) - get group file entry - Linux manual page.....
The fgetgrent() function returns a pointer to a structure containing the group information from the file referred to by stream. The first time it is called it r
manpages/perl581delta.1.html
perl581delta(1) - what is new for perl v5.8.1 (Man Page)....
This document describes differences between the 5.8.0 release and the 5.8.1 release. If you are upgrading from an earlier release such as 5.6.1, first read the
manpages/mvwaddstr.3ncurses.html
mvwaddstr(3ncurses) - add a string of characters to a curses
These functions write the (null-terminated) character string str on the given window. It is similar to calling waddch once for each character in the string. The
manpages/aria_ftdump.1.html
aria_ftdump(1) display fulltext index information (ManPage)
Use: aria_ft_dump <table_name> <index_num> -?, -h, --help Display help and exit. -c, --count Calculate per-word stats (counts and global weights). -d, --dump Du
manpages/packet.7.html
packet(7) - packet interface on device level. (Man Page)....
Packet sockets are used to receive or send raw packets at the device driver (OSI Layer 2) level. They allow the user to implement protocol modules in user space
manpages/updwtmp.3.html
updwtmp(3) - append an entry to the wtmp file (Man Page)....
updwtmp.3 - updwtmp() appends the utmp structure ut to the wtmp file. logwtmp() constructs a utmp structure using line, name, host, current time and current pro
manpages/xdr_setpos.3.html
xdr_setpos(3) - library routines for external data represent
These routines allow C programmers to describe arbitrary data structures in a machine-independent fashion. Data for remote procedure calls are transmitted using
