DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_rootwindow - create a rootwindow object

LIBRARY CALL

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

INPUT

OUTPUT

none

RETURN VALUE

The rootwindow object on success, NULL on failure

DESCRIPTION

Creates a rootwindow object. This is a toplevel object similar to a shell object, which 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/xvobjects/src/RootWindow.c

SEE ALSO

xvobjects(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.