scrnat(3G)

NAME
     scrnat - attaches the input focus to a screen

FORTRAN 77 SPECIFICATION
     integer*4 function scrnat(gsnr)
     integer*4 gsnr

PARAMETERS
     gsnr   expects a screen number or the symbolic constant, INFOCU.

FUNCTION RETURN VALUE
     The function returns the screen that previously had input focus, or -1 if
     there was an error (e.g., gsnr is not a valid screen number).

DESCRIPTION
     scrnat attaches the input focus to the specified screen.  It waits for
     any window manager or menu interaction to be completed before doing the
     attach.  Calling scrnat with the argument INFOCU simply returns the
     screen that currently has the input focus.

     On error, scrnat leaves the input focus unchanged.

SEE ALSO
     getgde, getwsc, scrnse

NOTES
     This routine is available only in immediate mode.

     Use getgde(GDNSCR) to determine the number of screens available to your
     program.  Screens are numbered starting from zero.