FORM_FIELD_INFO(3CURSES) Curses Library Functions FORM_FIELD_INFO(3CURSES)
NAME
form_field_info, field_info, dynamic_field_info - get forms field
characteristics
SYNOPSIS
cc [
flag... ]
file...
-lform -lcurses [
library... ]
#include <form.h>
int field_info(
FIELD *field,
int *rows,
int *cols,
int *frow,
int *fcol,
int *nrow,
int *nbuf);
int dynamic_field_info(
FIELD *field,
int *drows,
int *dcols,
int *max);
DESCRIPTION
field_info() returns the size, position, and other named field
characteristics, as defined in the original call to
new_field(), to
the locations pointed to by the arguments
rows,
cols,
frow,
fcol,
nrow, and
nbuf.
dynamic_field_info() returns the actual size of the
field in the
pointer arguments
drows,
dcols and returns the maximum growth allowed
for
field in
max. If no maximum growth limit is specified for
field,
max will contain 0. A field can be made dynamic by turning off the
field option
O_STATIC.
RETURN VALUES
These routines return one of the following:
E_OK The function returned successfully.
E_SYSTEM_ERROR System error.
E_BAD_ARGUMENT An argument is incorrect.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES),
forms(3CURSES),
attributes(7)NOTES
The header
<form.h> automatically includes the headers
<eti.h> and
<curses.h>.
December 31, 1996 FORM_FIELD_INFO(3CURSES)