KDCOPActionProxy Class Reference

#include <kdcopactionproxy.h>

Inheritance diagram for KDCOPActionProxy:

Public Member Functions
	KDCOPActionProxy (TDEActionCollection *actionCollection, DCOPObject *parent)
	KDCOPActionProxy (DCOPObject *parent)
	~KDCOPActionProxy ()
virtual TQValueList< TDEAction * >	actions () const
virtual TDEAction *	action (const char *name) const
virtual TQCString	actionObjectId (const TQCString &name) const
virtual TQMap< TQCString, DCOPRef >	actionMap (const TQCString &appId=TQCString()) const
virtual bool	process (const TQCString &obj, const TQCString &fun, const TQByteArray &data, TQCString &replyType, TQByteArray &replyData)
virtual bool	processAction (const TQCString &obj, const TQCString &fun, const TQByteArray &data, TQCString &replyType, TQByteArray &replyData, TDEAction *action)
Public Member Functions inherited from DCOPObjectProxy
	DCOPObjectProxy (DCOPClient *)
virtual bool	process (const TQCString &obj, const TQCString &fun, const TQByteArray &data, TQCString &replyType, TQByteArray &replyData)

Protected Member Functions
virtual void	virtual_hook (int id, void *data)

Detailed Description

A proxy class publishing a DCOP interface for actions.

The KDCOPActionProxy class provides an easy way to publish a collection of TDEAction objects through DCOP. For the DCOP client the exported actions behave like full-fledged DCOP objects, providing full access to the TDEAction object functionality in the server.

This class can generate DCOP object ids for given action objects, which it automatically processes, as being a DCOPObjectProxy .

Definition at line 39 of file kdcopactionproxy.h.

Constructor & Destructor Documentation

KDCOPActionProxy() [1/2]

KDCOPActionProxy::KDCOPActionProxy	(	TDEActionCollection *	actionCollection,
		DCOPObject *	parent
	)

Constructs a dcop action proxy, being able to export the actions of the provided TDEActionCollection through DCOP, using the parent DCOPObject's object id to generate unique object ids for the actions.

Definition at line 46 of file kdcopactionproxy.cpp.

KDCOPActionProxy() [2/2]

KDCOPActionProxy::KDCOPActionProxy

(

DCOPObject *

parent

)

Use this constructor if do not want to provide the exportable actions through a TDEActionCollection .

You have to reimplement the virtual actions() and action() methods if you use this constructor.

Definition at line 51 of file kdcopactionproxy.cpp.

~KDCOPActionProxy()

KDCOPActionProxy::~KDCOPActionProxy

(

)

Destructor.

Definition at line 65 of file kdcopactionproxy.cpp.

Member Function Documentation

action()

TDEAction * KDCOPActionProxy::action ( const char *  name ) const

virtual

Returns an action object with the given name.

The default implementation queries the action object from the TDEActionCollection, if the first constructor has been used.

Definition at line 78 of file kdcopactionproxy.cpp.

actionMap()

TQMap< TQCString, DCOPRef > KDCOPActionProxy::actionMap ( const TQCString &  appId = TQCString() ) const

virtual

Returns a map of all exported actions, with the action name as keys and a global DCOP reference as data entries.

The appId argument is used to specify the appid component of the DCOP reference. By default the global application id is used ( tdeApp->dcopClient()->appId() ) .

Definition at line 91 of file kdcopactionproxy.cpp.

actionObjectId()

TQCString KDCOPActionProxy::actionObjectId ( const TQCString &  name ) const

virtual

Use this method to retrieve a DCOP object id for an action with the given name.

This class automatically takes care of processing DCOP object requests for the returned object id.

You can construct a global DCOP object referenence using DCOPRef. For example like DCOPRef( tdeApp->dcopClient()->appId, actionProxy->actionObjectId( actionName ) );

The action with the given name has to be available through the action method.

Definition at line 86 of file kdcopactionproxy.cpp.

actions()

TQValueList< TDEAction * > KDCOPActionProxy::actions ( ) const

virtual

Returns a list of exportable actions.

The default implementation returns a list of actions provided by a TDEActionCollection, if the first constructor has been used.

Definition at line 70 of file kdcopactionproxy.cpp.

process()

bool KDCOPActionProxy::process ( const TQCString &  obj, const TQCString &  fun, const TQByteArray &  data, TQCString &  replyType, TQByteArray &  replyData  )

virtual

Internal reimplementation of DCOPObjectProxy::process .

Reimplemented from DCOPObjectProxy.

Definition at line 108 of file kdcopactionproxy.cpp.

processAction()

bool KDCOPActionProxy::processAction ( const TQCString &  obj, const TQCString &  fun, const TQByteArray &  data, TQCString &  replyType, TQByteArray &  replyData, TDEAction *  action  )

virtual

Called by the process method and takes care of processing the object request for an action object.

Definition at line 121 of file kdcopactionproxy.cpp.

virtual_hook()

void KDCOPActionProxy::virtual_hook ( int  id, void *  data  )

protectedvirtual

Definition at line 157 of file kdcopactionproxy.cpp.

---

The documentation for this class was generated from the following files:

• kdcopactionproxy.h
• kdcopactionproxy.cpp