DESIGN (xvwidgets) functions


LIBRARY ROUTINE

xvw_create_application_shell - create an application shell object

LIBRARY CALL

xvobject xvw_create_application_shell(
   char    *name,
   Display *display,
   Screen  *screen)

INPUT

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.