INIT

 (Available in 01 TS COM - TS_COM_IDispatch)

Purpose

Create a 'TS_IDispatch' instance

Syntax

oIDispatch:=TS_IDispatch{ [oIOwner], [symNameSym], [lCountThisComponent],  ; ...
...[uoInvokeHandler] }

Arguments

uoIOwner
NIL, OBJECT(TS_IUnknown)
usymNameSym
NIL, SYMBOL
ulCountThisComponent
NIL, LOGIC
uoInvokeHandler
NIL, OBJECT

Description

This class serves no purpose on its own, the class should be used as a derived from class when defining you own application classes.

Example

CLASS SomeIClass INHERIT TS_IDispatch

METHOD INIT( ..., ...  ; ...
...) CLASS SomeIClass
// Less secure ( and simple ) form of an '[less]safe' init method
// It is better not to call any object method/access/assign from
// inside the init method, if needed do this form the 'New()' method.
// From here on insert you own initialization code
// Process the parameters
   ..., ... 
   IF lParameterError
      TSTrace Warning "... parameter error ..."
      SELF:InvalidateObject( )
   END
// At this point all initialization code should be done
   IF SELF:IsValidObject
//    The 'New()' method will be called by the SUPER class
      SUPER:INIT( ... ; ...
     ... , ... )
   ELSE
      TSTrace Warning TS_TEXT_GEN_CAN_NOT_INITIALIZE
      SELF:InvalidateObject( )
   END
RETURN SELF

METHOD INIT( ..., ...  ; ...
...) CLASS SomeIClass
// Most secure ( and complex ) form of an 'safe' init method
// It is better not to call any object method/access/assign from
// inside the init method, if needed do this form the 'New()' method.
   DO CASE
   CASE SELF:IsInited
      TSTrace Warning "Can not re-init"
   CASE SELF:IsInInit
      SELF:CountInInit( TRUE )
//    From here on insert you own initialization code
//    Process the parameters
      ..., ... 
      IF lParameterError
         TSTrace Warning "... parameter error ..."
         SELF:InvalidateObject( )
      END
//    At this point all initialization code should be done
      SELF:CountInInit( FALSE )
      IF SELF:IsValidObject
         SUPER:INIT( ... ; ...
        ... , ... )
         IF SELF:NeedNew
            SELF:NeedNew:=FALSE
//          Put your 'PostInit()' code in the 'New()' method
            SELF:NEW( ... ; ...
           ... , ... )
         END
      ELSE
         TSTrace Warning TS_TEXT_GEN_CAN_NOT_INITIALIZE
         SELF:InvalidateObject( )
      END
   OTHERWISE
      TSTrace Warning "This can not happen"
   END
RETURN SELF

Source

METHOD INIT( uoIOwner, usymNameSym, ulCountThisComponent, uoInvokeHandler ) CLASS  ; ...
...TS_IDispatch
LOCAL cAccessTypeList AS STRING
LOCAL oCOMGlobalData AS _TS_COMGlobalData
LOCAL oInvokeHandler AS OBJECT
LOCAL oIOwner AS TS_IUnknown
LOCAL lInit AS LOGIC
   TSTrace Enter CREATE
   oCOMGlobalData:=_TS_ModuleGetCOMGlobalData( )
   #IFDEF TS_COMGLOBALDATA_CRITICALSECTION
      EnterCriticalSection( oCOMGlobalData:_COMGGeneralPurposeSection )
   #ENDIF
   IF TS_IsValidObject( uoIOwner, TS_ISVALID_STATIC_IUNKNOWN_NULL )
      oIOwner:=uoIOwner
   ELSE
      oIOwner:=NULL_OBJECT
   END
   IF LOGIC( _CAST, _AND( SELF:_ObjectStat1, TS_OBJSTAT1_ININIT  ; ...
  ... ) )
      SELF:_ObjectStat1+=TS_OBJSTAT1_COUNTVALUE
      cAccessTypeList:=TS_AccessTypeList( uoIOwner, usymNameSym, ulCountThisComponent ; ...
     ... , uoInvokeHandler )
      lInit:=TRUE
      DO CASE
      CASE CharPos( cAccessTypeList, 1 )=="U"
//       Do nothing
      CASE CharPos( cAccessTypeList, 1 )=="O"
//       Do nothing
      OTHERWISE
         lInit:=FALSE
      END
      DO CASE
      CASE CharPos( cAccessTypeList, 2 )=="U"
//       Do nothing
      CASE CharPos( cAccessTypeList, 2 )=="#"
//       Do nothing
      OTHERWISE
         lInit:=FALSE
      END
      DO CASE
      CASE CharPos( cAccessTypeList, 3 )=="U"
//       Do nothing
      CASE CharPos( cAccessTypeList, 3 )=="L"
//       Do nothing
      OTHERWISE
         lInit:=FALSE
      END
      DO CASE
      CASE CharPos( cAccessTypeList, 4 )=="U"
         oInvokeHandler:=NULL_OBJECT
      CASE CharPos( cAccessTypeList, 4 )=="O"
         oInvokeHandler:=uoInvokeHandler
      OTHERWISE
         lInit:=FALSE
      END
      IF lInit
         IF oInvokeHandler<>NULL_OBJECT
            SELF:_InvokeHandler:=oInvokeHandler
         ELSE
            SELF:_InvokeHandler:=SELF
         END
         IF SELF:IIDAdd( TS_GUID_IDispatch( ) )
            SUPER:INIT( oIOwner, usymNameSym, ulCountThisComponent  ; ...
           ... )
            oIOwner:=NULL_OBJECT
         ELSE
            TSTrace Warning "!SELF:IIDAdd(TS_GUID_IDispatch())"
            SELF:InvalidateObject( )
         END
      ELSE
         TSTrace Warning "Invalid parameter(s), Expected 'U|O', 'U|#', 'U|L' and " ; ...
        ... +"'U|O', Found '"+cAccessTypeList+"'"
         SELF:InvalidateObject( )
      END
      SELF:_ObjectStat1-=TS_OBJSTAT1_COUNTVALUE
      IF _AND( SELF:_ObjectStat1, TS_OBJSTAT1_NEWTEST )==TS_OBJSTAT1_NEEDNEW
         SELF:_ObjectStat1:=_AND( SELF:_ObjectStat1 ; ...
        ... , _NOT( TS_OBJSTAT1_NEEDNEW ) )
         IF SELF:IsValidObject
            SELF:NEW( uoIOwner, usymNameSym, ulCountThisComponent ; ...
           ... , uoInvokeHandler )
         ELSE
            TSTrace Warning TS_TEXT_GEN_CAN_NOT_INITIALIZE
            SELF:InvalidateObject( )
         END
      END
   ELSE
      TSTrace Warning "!LOGIC(_CAST,_And(SELF:_ObjectStat1,TS_OBJECT_STATUS_ININIT))"
   END
   IF oIOwner<>NULL_OBJECT
      oIOwner:Release( )
      oIOwner:=NULL_OBJECT
   END
   #IFDEF TS_COMGLOBALDATA_CRITICALSECTION
      LeaveCriticalSection( oCOMGlobalData:_COMGGeneralPurposeSection )
   #ENDIF
   TSTrace Leave
RETURN SELF