display - the X Display structure; pass NULL to use the
default display
screen - the X Screen structure; pass NULL to use the
default screen
OUTPUT
none
RETURN VALUE
returns the application shell object on success,
NULL on failure
DESCRIPTION
Creates an application shell object to serve as
a toplevel for an application; the toplevel serves
as a mediating device between the application and
the window manager. This call allows the application
to have several independant windows, which is the case
with xvroutines having multiple subforms. The routine
also supports the creation of toplevels on potentially
different screens, which applies when a Khoros application
distributes its user interface with the concert program.
Both the display and screen are optional arguments; if
either of these are set to NULL, then the default display
and default screen will be used.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvwidgets/src/shell.c
SEE ALSO
xvwidgets(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.