Namespace EcmaScriptComponent
Class CComponentExtension

class CComponentExtension {
public:
    CComponentExtension(
        const XGlobalObject &pGlobalObject,
        const XObjectManagerFactory &pObjectManagerFactory,
        Som::CErrorHandler *pErrorHandler);
    ~CComponentExtension();
public:
    void Register(const CString &strPropertyName);
    };

The component-based extension package for the ECMAScript interpreter.

This class implements component-based extensions for ECMAScript interpreter as specified in Unicorn ECMAScript Interpreter Reference Manual. Component-based Extensions Version 2.0.

Every object of this class must be associated with an ECMAScript interpreter (an object of class EcmaScript::CInterpreter ). When a component-based extension package is constructed, the global object of the associated ECMAScript interpreter must be specified as an argument of the constructor. Once the CComponentExtension object is constructed, its member function Register must be called in order to create the initial set of component-based extension objects in the object space of the associated ECMAScript interpreter.

Since:

1.00.00

Version:

1.00.00

Author:

Alexey Gokhberg

See Also:

CObjectManagerFactory, EcmaScript::CGlobalObject, Som::CErrorHandler

CComponentExtension

CComponentExtension(
    const XGlobalObject &pGlobalObject,
    const XObjectManagerFactory &pObjectManagerFactory,
    Som::CErrorHandler *pErrorHandler);

Constructs the component-based extension package.

Parameters:

pGlobalObject - the ECMAScript global object. The ECMAScript interpreter which owns the specified global object will be associated with this extension package.

pObjectManagerFactory - the SOM object manager factory generating object managers for this extension package

pErrorHandler - the SOM IDL error handler. This object is used to report errors that my occur while parsing SOM interface definitions.

~CComponentExtension

~CComponentExtension();

Destroys the component-based extension package.

Register

void Register(const CString &strPropertyName);

Registers this component-based extension package with the associated ECMAScript interpreter.

This function creates the initial set of component-based extension objects in the object space of the ECMAScript interpreter associated with this extension package.

The name of the ECMAScript global object property bound to the Component constructor must be supplied as an argument of Register . Normally this name is "Component" ; however, an application programmer may choose another name, if necessary.

Parameters:

strPropertyName - a string containing the name of the global object property to be bound to the Component constructor