form_field_info(3) [netbsd man page]

FORMS(3)						   BSD Library Functions Manual 						  FORMS(3)

NAME

     dynamic_field_info, field_info -- form library

LIBRARY

     Curses Form Library (libform, -lform)

SYNOPSIS

     #include <form.h>

     int
     dynamic_field_info(FIELD *field, int *drows, int *dcols, int *max);

     int
     field_info(FIELD *field, int *rows, int *cols, int *frow, int *fcol, int *nrow, int *nbuf);

DESCRIPTION

     The function dynamic_field_info() returns the sizing information for the field given.  The function will return the number of rows, columns
     and the maximum growth of the field in the storage pointed to by the drows, dcols and max parameters respectively.  Dynamic field information
     cannot be requested for the default field.  If the field given is not dynamic then dynamic_field_info() will simply return the size of the
     actual field.  The field_info() will return the number or rows, columns, field starting row, field starting column, number of off screen rows
     and number of buffers in rows, cols, frow, fcol, nrow and nbuf respectively.

RETURN VALUES

     The functions will return one of the following error values:

     E_OK		The function was successful.
     E_BAD_ARGUMENT	A bad argument was passed to the function.

SEE ALSO

     curses(3), forms(3)

NOTES

     The header <form.h> automatically includes both <curses.h> and <eti.h>.

BSD
								  January 1, 2001							       BSD

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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       curses(3CURSES), forms(3CURSES), attributes(5)

NOTES

       The header <form.h> automatically includes the headers  <eti.h> and <curses.h>.

SunOS 5.11							    31 Dec 1996 					  form_field_info(3CURSES)