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>.


illumos December 31, 1996 FORM_FIELD_INFO(3CURSES)