swinopen(3G) swinopen(3G)
NAME
swinopen - creates a graphics subwindow
C SPECIFICATION
long swinopen(parent)
long parent;
PARAMETERS
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
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
greset, winclose, winget, winopen, winposition, winset
Page 1