com.jacob.activeX
Class ActiveXDispatchEvents

java.lang.Object
  extended by com.jacob.com.JacobObject
      extended by com.jacob.com.DispatchEvents
          extended by com.jacob.activeX.ActiveXDispatchEvents

public class ActiveXDispatchEvents
extends DispatchEvents

RELEASE 1.12 EXPERIMENTAL.

Use this exactly like the DispatchEvents class. This class plugs in an ActiveXInvocationProxy instead of an InvocationProxy. It is the ActiveXInvocationProxy that implements the reflection calls and invoke the found java event callbacks. See ActiveXInvocationProxy for details.


Constructor Summary
ActiveXDispatchEvents(Dispatch sourceOfEvent, Object eventSink)
          This is the most commonly used constructor.
ActiveXDispatchEvents(Dispatch sourceOfEvent, Object eventSink, String progId)
          None of the samples use this constructor.
ActiveXDispatchEvents(Dispatch sourceOfEvent, Object eventSink, String progId, String typeLib)
          Creates the event callback linkage between the the MS program represented by the Dispatch object and the Java object that will receive the callback.
 
Method Summary
protected  InvocationProxy getInvocationProxy(Object pTargetObject)
          Returns an instance of the proxy configured with pTargetObject as its target
 
Methods inherited from class com.jacob.com.DispatchEvents
finalize, safeRelease
 
Methods inherited from class com.jacob.com.JacobObject
debug, getBuildDate, getBuildVersion, isDebugEnabled
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ActiveXDispatchEvents

public ActiveXDispatchEvents(Dispatch sourceOfEvent,
                             Object eventSink)
This is the most commonly used constructor.

Creates the event callback linkage between the the MS program represented by the Dispatch object and the Java object that will receive the callback.

Parameters:
sourceOfEvent - Dispatch object who's MS app will generate callbacks
eventSink - Java object that wants to receive the events

ActiveXDispatchEvents

public ActiveXDispatchEvents(Dispatch sourceOfEvent,
                             Object eventSink,
                             String progId)
None of the samples use this constructor.

Creates the event callback linkage between the the MS program represented by the Dispatch object and the Java object that will receive the callback.

Parameters:
sourceOfEvent - Dispatch object who's MS app will generate callbacks
eventSink - Java object that wants to receive the events
progId - ???

ActiveXDispatchEvents

public ActiveXDispatchEvents(Dispatch sourceOfEvent,
                             Object eventSink,
                             String progId,
                             String typeLib)
Creates the event callback linkage between the the MS program represented by the Dispatch object and the Java object that will receive the callback.
 >ActiveXDispatchEvents de = 
                        new ActiveXDispatchEvents(someDispatch,someEventHAndler,
                                "Excel.Application",
                                "C:\\Program Files\\Microsoft Office\\OFFICE11\\EXCEL.EXE");

Parameters:
sourceOfEvent - Dispatch object who's MS app will generate callbacks
eventSink - Java object that wants to receive the events
progId - , mandatory if the typelib is specified
typeLib - The location of the typelib to use
Method Detail

getInvocationProxy

protected InvocationProxy getInvocationProxy(Object pTargetObject)
Description copied from class: DispatchEvents
Returns an instance of the proxy configured with pTargetObject as its target

Overrides:
getInvocationProxy in class DispatchEvents
Returns:
InvocationProxy an instance of the proxy this DispatchEvents will send to the COM layer


http://jacob-project.sourceforge.net