contents   index   previous   next



seShareReadObject

 

syntax:

   sebool

seShareReadObject(secontext se,seobject object);

where:

se the context the object belongs to

 

object the object to make shared read

 

return:

This function returns TRUE if the object was successfully shared for reading, FALSE if it could not be.

 

description:

Calling this routine makes the given object, and all its children, read-only and shareable. The object handle no longer follows the usual ScriptEase lifetime rules but rather is valid until the ScriptEase engine is cleaned up using the seTerminate call. All shared objects exist for the life of the program. The seobject handle passed to the routine can be used from then on in any context.

 

When using this routine, you must remember that any object and all its children are shared. This means the object's base class, which it refers to via its _prototype is also shared. If you have a complicated object hierarchy, you may end up sharing a large number of objects. All these objects will persist until the program terminates the ScriptEase engine. Also remember that shared objects and their children become read-only to all contexts, including the one that originally shared them.

 

Objects can only be made sharable when there is a single context existing. You must mark all objects you wish to share before making additional contexts. This routine will fail once two or more contexts exist.

 

see:


VARIABLE WRITING