ETI forms

Querying the presence of offscreen data

It may be desirable to indicate to the user whether there is additional data either ahead or behind in a scrollable field. It is the responsibility of application developers to indicate, however they like, the presence of off screen data. The following functions allow the developer to query the presence of offscreen data.

SYNOPSIS

   int data_ahead(form)
   FORM	form;
   
   int data_behind(form)
   FORM	form;

data_ahead returns TRUE, if there is either more data offscreen to the right if the current field is a one line field, or more data offscreen below if the current field is multiline. Otherwise FALSE is returned. Data is defined to be any non-pad character; see ``Setting the field foreground, background, and pad character'' for more detail on the pad character.

data_behind returns TRUE, if the first character position of the current field is not currently being displayed. Otherwise FALSE is returned.