scrnattach(3G)							scrnattach(3G)

NAME    [Toc]    [Back]

     scrnattach	- attaches the input focus to a	screen

C SPECIFICATION    [Toc]    [Back]

     long scrnattach(gsnr)
     long gsnr;

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     getgdesc, getwscrn, scrnselect

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111