scrnattach(3G)

NAME
     scrnattach - attaches the input focus to a screen

C SPECIFICATION
     long scrnattach(gsnr)
     long gsnr;

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

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
     scrnattach 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 scrnattach with the argument INFOCUSSCRN simply
     returns the screen that currently has the input focus.

     On error, scrnattach leaves the input focus unchanged.

SEE ALSO
     getgdesc, getwscrn, scrnselect

NOTES
     This routine is available only in immediate mode.

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