swinopen(3G)							  swinopen(3G)

NAME    [Toc]    [Back]

     swinopen -	creates	a graphics subwindow

C SPECIFICATION    [Toc]    [Back]

     long swinopen(parent)
     long parent;

PARAMETERS    [Toc]    [Back]

     parent   expects the GID (graphics	window identifier) of the window (or
	      subwindow) in which you want to open a subwindow.	 The GID is
	      the returned function  value of a	previous call to either
	      swinopen or winopen.

FUNCTION RETURN	VALUE
     The returned value	of this	function is either a -1	or the graphics	window
     identifier	for the	subwindow just created.	 Use this value	to identify
     this subwindow to other graphics routines.

     A returned	function value of -1 indicates that the	system cannot create
     any more graphics windows.

DESCRIPTION    [Toc]    [Back]

     swinopen creates a	graphics subwindow. The	graphics state of the new
     subwindow is initialized to its defaults (see greset) and it becomes the
     current window.

     Subwindows	have no	window borders or window manager function buttons.
     Window constraints	do not apply to	subwindows.  A subwindow is
     repositioned automatically	when its parent	is moved, so that its origin
     with respect to the parent's origin remains constant.  Resizing the
     parent does not automatically resize a subwindow, but keeps the distance
     between the upper left hand corners constant.  Imaging in a subwindow is
     limited (clipped) to the area of the parent window.

     After calling swinopen, the application must call winposition to specify
     the location of the subwindow's boundaries	with respect to	the origin of
     its parent	window.

     If	parent is the GID of a subwindow, the parent of	that subwindow becomes
     the parent	of the new subwindow for the purpose of	positioning the
     subwindow.

     When using	the DGL	(Distributed Graphics Library),	the graphics window
     identifier	also identifies	the graphics server associated with the
     window.

     swinopen queues the pseudo	devices	INPUTCHANGE and	REDRAW.

SEE ALSO    [Toc]    [Back]

     greset, winclose, winget, winopen,	winposition, winset


									PPPPaaaaggggeeee 1111