:: com :: sun :: star :: frame ::

Description

extends an existing XDispatch implementation with functionality for dispatch recording

This interface can be implemented as an additional one beside an existing XDispatch one to provide record functionality of dispatches. Because it's an additional interface the status events are available there and not at this interface.

But normaly this interface mustn't be used directly. If a dispatch object is well known and recording was enabled on a XDispatchRecorderSupplier it's possible to use method XDispatchRecorderSupplier::dispatchAndRecord() of it to make dispatch and recording automaticly. The interface XRecordableDispatch is used transparently there.

Example

 XDispatch xDispatcher = xFrame.queryDispatch(aURL,"",0);
 XRecordableDispatch xRecordable = (XRecordableDispatch)UnoRuntime.queryInterface(
   XRecordableDispatch.class,
   xDispatcher);

 xDispatcher.addStatusListener(this,aURL);

 if (xRecordable!=null)
   xRecordable.dispatchAndRecord(aURL,lArguments,xRecorder);
 else
   xDispatcher.dispatch(aURL,lArguments);
 ...
 xDispatcher.removeStatusListener(this,aURL);
 

Since

OOo 1.1.2

See also

XDispatchRecorderSupplier, XDispatch