DESIGN (xvlang) functions


LIBRARY ROUTINE

xvw_create_workspace - create a workspace object

LIBRARY CALL

xvobject xvw_create_workspace(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The workspace object on success, NULL on failure

DESCRIPTION

The workspace visual programming object provides a canvas in which other visual programming objects may be placed and combined into a visual program. The workspace object supports the saving, restoring, execution, and management of visual programs. It also serves as a visual programming editor.

The workspace object does not directly support visual programming, but rather provides a canvas in which other visual programming components can be combined in which to create a visual program. Its role is similar to that of the manager object; however, instead of allowing the creation and management of GUI objects, the workspace object allows the creation and management of visual programming objects.

The workspace object allows (1) specification of an internal routine to be used for saving a network, and (2) specification of an internal routine to be used for restoring a network.

The workspace object can be used to create new visual programming models other than the one used in cantata; all that is necessary is to provide different routines for saving and restoring of networks.

Moreover, the workspace object has the capability to manipulate any other visual programming object that is subclassed from the node object, such as glyphs, conditionals, loops, and procedures. However, if the visual programming toolkit is extended to include other visual programming objects that are subclassed from the node object, they will automatically be usable in a workspace object.

As a visual programming editor, the workspace object comes with a full suite of capabilities including running a network, stopping a network, single stepping through a network, resetting the network, redrawing the network, clearing the network, checking the network, and providing information about the network.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvlang/src/Workspace.c

SEE ALSO

xvlang(3)

COPYRIGHT

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