Framework/Article/Asynchronous Callback Service

Asynchronous callback service

UNO awt provides a GUI based uno API for OpenOffice.org developer. Sometimes it's necessary that an implementation is called by OpenOffice.org at a later time to do certain tasks. Sometimes this is also bound to GUI library actions which must be completed before another request can be processed. For example you want to change something when a dialog is ready for user input. The notification windowShown at com.sun.star.awt.XWindowListener can be used to be notified when a dialog becomes visible. The dialog itself is not ready yet. The asynchronous callback service can solve this problem. The callback will be called when OpenOffice.org enters the message loop and the callback message gets processed. There are several other scenarios where this service can be useful.

The service will be available in OpenOffice.org 2.4 and later.

ATTENTION: The asynchronous callback service can only work when VCL has been correctly initialized by OpenOffice.org and the message loop is running.

The following code snippets show the interface and service definitions for the new asynchronous callback service.

#ifndef __com_sun_star_awt_XRequestCallback_idl__#define __com_sun_star_awt_XRequestCallback_idl__#ifndef __com_sun_star_awt_XCallback_idl__ #include <com/sun/star/awt/XCallback.idl> #endif//=============================================================================
module com { module sun { module star { module awt {//============================================================================= /** specifices an interface which can be used to call back
an implementation
*/
interface XRequestCallback
{//-------------------------------------------------------------------------/** adds a callback request to the implementation
@param aData
any private data which will be provided to the callback implementation.
@param xCallback
a reference to the callback which should be called by the implementation
of this interface.
*/void addCallback([in] XCallback xCallback, [in] any aData );};//=============================================================================};};};};#endif

A callback will be added to the asynchronous callback service using addCallback. The method allows one to use an additonal parameter which will be provided to the callback method. The data can be anything which can be transported via a UNO any.