Main Page | Class Hierarchy | Alphabetical List | Compound List | Compound Members

IRiActivityNode Struct Reference

Inherits IDispatch.

List of all members.

Public Member Functions

HRESULT Create ([in] BSTR idName,[in] VARIANT vOwner,[out, retval] VARIANT *pVal)
HRESULT Run ([in] BSTR bszActivityName)
HRESULT Stop ([in] BSTR bszActivityName)
HRESULT KillAll ()


Detailed Description

The IRiActivityNode interface provides basic methods that enable an application to control Activities. It includes methods for creating, running and stopping activities. An Activity is represented in graph as sequence of connected commands (called activity nodes). See command reference documentation for more detail description of command objects.

Root-level name in the scripting engine's name space: Activity


Member Function Documentation

HRESULT IRiActivityNode::Create [in] BSTR  idName,
[in] VARIANT  vOwner,
[out, retval] VARIANT *  pVal
 

Create activity node specified by class name or guid identification. Class name identification requires package name and class name of the activity node. See command reference documentation for list of available activity nodes. Default input and output control flow attributes are automatically added to activity node if not defined explicitly by node.

Parameters:
idName – identification of the activity node. Can be either guid or class name.
vOwner – full name identification of owner object where newly created activity node will be added.
Returns:
pVal - full name identification of created activity object in the graph
Example:
 szNewSaveActivity = Activity.Create('FileIO Package/Save Object Command', Space.CurrentScene()) 
 Activity.Create('Space 3D Package/New Scene Command', '/Project') 

HRESULT IRiActivityNode::Run [in] BSTR  bszActivityName  ) 
 

Run Activity processing from activity node specified in input parameter. Activity node must have at least one control flow connector. Activity finishes when it reaches end (there is no transition link to other activity node) or when it is stopped explicitly by Stop or KillAll command.

Parameters:
bszActivityName – full name identification of the activity node in graph.
See also:
Stop()

KillAll()

Example:
 Activity.Run(Space.CurrentScene()+'/szNewSaveActivity')

HRESULT IRiActivityNode::Stop [in] BSTR  bszActivityName  ) 
 

Stop Activity. Interrupts activity execution started by run command.

Parameters:
bszActivityName – identification of activity started by run command
See also:
Run()
Example:
 Activity.Stop(Space.CurrentScene()+'/szNewSaveActivity') 

HRESULT IRiActivityNode::KillAll  ) 
 

Stop all activities running in system.


Generated on Tue Jan 31 21:00:25 2006 for trueSpace7 Script Objects by doxygen 1.3.2