.TH "DCOPRef" 3 "28 Jan 2004" "dcop Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
DCOPRef \- A DCOPRef(erence) encapsulates a remote DCOP object as a triple <app,obj,type> where type is optional.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <dcopref.h>\fP
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBDCOPRef\fP ()"
.br
.RI "\fICreates a null reference. \fP"
.ti -1c
.RI "\fBDCOPRef\fP (const  \fBDCOPRef\fP &ref)"
.br
.RI "\fICopy constructor. \fP"
.ti -1c
.RI "\fBDCOPRef\fP (const  \fBQCString\fP &app, const  \fBQCString\fP &obj='')"
.br
.RI "\fICreates a reference for application \fCapp\fP and object \fCobj\fP. \fP"
.ti -1c
.RI "\fBDCOPRef\fP (\fBDCOPObject\fP *object)"
.br
.RI "\fICreates a reference to an existing dcop object. \fP"
.ti -1c
.RI "\fBDCOPRef\fP (const  \fBQCString\fP &app, const  \fBQCString\fP &obj, const  \fBQCString\fP &type)"
.br
.RI "\fICreates a reference for application \fCapp\fP and object \fCobj\fP with a specified type \fCtype\fP. \fP"
.ti -1c
.RI "bool \fBisNull\fP () const "
.br
.RI "\fITests wether it is a null reference. \fP"
.ti -1c
.RI "\fBQCString\fP \fBapp\fP () const "
.br
.RI "\fIName of the application in which the object resides. \fP"
.ti -1c
.RI "\fBQCString\fP \fBobj\fP () const "
.br
.RI "\fIObject ID of the referenced object. \fP"
.ti -1c
.RI "\fBQCString\fP \fBobject\fP () const "
.br
.ti -1c
.RI "\fBQCString\fP \fBtype\fP () const "
.br
.RI "\fIType of the referenced object. \fP"
.ti -1c
.RI "\fBDCOPRef\fP & \fBoperator=\fP (const  \fBDCOPRef\fP &)"
.br
.RI "\fIAssignment operator. \fP"
.ti -1c
.RI "void \fBsetRef\fP (const  \fBQCString\fP &app, const  \fBQCString\fP &obj='')"
.br
.RI "\fIChanges the referenced object. \fP"
.ti -1c
.RI "void \fBsetRef\fP (const  \fBQCString\fP &app, const  \fBQCString\fP &obj, const  \fBQCString\fP &type)"
.br
.RI "\fIChanges the referenced object. \fP"
.ti -1c
.RI "void \fBclear\fP ()"
.br
.RI "\fIMakes this a null reference. \fP"
.ti -1c
.RI "\fBDCOPClient\fP * \fBdcopClient\fP () const "
.br
.RI "\fIReturns the dcop client the reference operates on. \fP"
.ti -1c
.RI "void \fBsetDCOPClient\fP (\fBDCOPClient\fP *client)"
.br
.RI "\fISets a specific dcop client for this reference. \fP"
.ti -1c
.RI "\fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6, const  T7 &t7)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8> \fBDCOPReply\fP \fBcall\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6, const  T7 &t7, const  T8 &t8)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "bool \fBsend\fP (const  \fBQCString\fP &fun)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6, const  T7 &t7)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.ti -1c
.RI "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8> bool \fBsend\fP (const  \fBQCString\fP &fun, const  T1 &t1, const  T2 &t2, const  T3 &t3, const  T4 &t4, const  T5 &t5, const  T6 &t6, const  T7 &t7, const  T8 &t8)"
.br
.RI "\fICalls the function \fCfun\fP on the object referenced by this reference. \fP"
.in -1c
.SH "Detailed Description"
.PP 
A DCOPRef(erence) encapsulates a remote DCOP object as a triple <app,obj,type> where type is optional. 

It allows for calling and passing DCOP objects.
.PP
A DCOP reference makes it possible to return references to other DCOP objects in a DCOP interface, for example in the method giveMeAnotherObject() in an interface like this:
.PP
.PP
.nf

	class Example : public \fBDCOPObject\fP
	{
	   K_DCOP
	...
	k_dcop:
	   DCOPRef giveMeAnotherObject();
	   int doSomething( QString, float, bool );
	   ASYNC pingMe( QCString message );
	   UserType userFunction( UserType );
	};
 
.PP
.PP
In addition, the reference can operate as a comfortable generic stub to call remote DCOP objects in cases where no \fBDCOPStub\fP is available. The advantage of using DCOPRef instead of the low-level functions \fBDCOPClient::call()\fP and \fBDCOPClient::send()\fP are the nicer syntax and the implicit runtime error checking.
.PP
Say you want to call the method 'doSomething' from the above interface on an object called 'example' that lives in application 'foo'. Using DCOPRef, you would write
.PP
.PP
.nf

	DCOPRef example( 'foo', 'example' );
	int result = example.call( 'doSomething', 'Hello World', (float)2.5, true );
 
.PP
.PP
If it is important for you to know whether the call succeeded or not, you can use the slightly more elaborate pattern:
.PP
.PP
.nf

	DCOPRef example( 'foo', 'example' );
	\fBDCOPReply\fP reply = example.call( 'doSomething', 'Hello World', (float)2.5, true );
	if ( reply.isValid() ) {
	    int result = reply;
	    // ...
	}
 
.PP
.PP
For curiosity, here is how you would achieve the exactly same functionality by using \fBDCOPClient::call()\fP directly:
.PP
.PP
.nf

    \fBQByteArray\fP data, replyData;
    \fBQCString\fP replyType;
    \fBQDataStream\fP arg( data, IO_WriteOnly );
    arg << \fBQString\fP('hello world' ), (float) 2.5 << true;
    if ( \fBDCOPClient::mainClient()\fP->call( app, obj,
			     'doSomething(QString,float,bool)',
			     data, replyType, replyData ) ) {
	if ( replyType == 'int' ) {
	    int result;
	    \fBQDataStream\fP reply( replyData, IO_ReadOnly );
	    reply >> result;
	    // ...
	}
    }
 
.PP
.PP
As you might see from the code snippet, the DCOPRef has to 'guess' the names of the datatypes of the arguments to construct a dcop call. This is done through global inline overloads of the dcopTypeName function, for example
.PP
.PP
.nf

	inline const char* dcopTypeName( const QString& ) { return 'QString'; }
 
.PP
.PP
If you use custom data types that do support \fBQDataStream\fP but have no corrsponding dcopTypeName overload, you can either provide such an overload or use a \fBDCOPArg\fP wrapper that allows you to specify the type.
.PP
.PP
.nf

	UserType userType;
	\fBDCOPReply\fP reply = example.call( 'userFunction', \fBDCOPArg\fP( userType, 'UserType' ) );
 
.PP
.PP
Similar, when you retrieve such a data type, you can use an explicit call to \fBDCOPReply::get()\fP:
.PP
.PP
.nf

	UserType userType;
	reply.get( userType, 'UserType' );
 
.PP
.PP
The function \fBsend()\fP works very similar to \fBcall()\fP, only that it returns a simple bool on whether the signal could be sent or not:
.PP
.PP
.nf

	if ( example.pingMe( 'message' ) == false )
	   qWarning('could not ping example' );
 
.PP
.PP
A DCOP reference operates on \fBDCOPClient::mainClient()\fP, unless you explicitely specify another client with \fBsetDCOPClient()\fP.
.PP
\fBSee also:\fP
.RS 4
\fBDCOPArg\fP 
.PP
\fBDCOPReply\fP 
.PP
\fBDCOPObject\fP 
.RE
.PP
\fBAuthor:\fP
.RS 4
Matthias Ettrich <ettrich@kde.org>, Torben Weis <weis@kde.org> 
.RE
.PP

.PP
Definition at line 275 of file dcopref.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "DCOPRef::DCOPRef ()"
.PP
Creates a null reference. Definition at line 91 of file dcopref.cpp.
.SS "DCOPRef::DCOPRef (const \fBDCOPRef\fP & ref)"
.PP
Copy constructor. Definition at line 96 of file dcopref.cpp.
.SS "DCOPRef::DCOPRef (const \fBQCString\fP & app, const \fBQCString\fP & obj = '')"
.PP
Creates a reference for application \fCapp\fP and object \fCobj\fP. \fBParameters:\fP
.RS 4
\fIapp\fP The name of an application as registered by the dcopserver. 
.br
\fIobj\fP The name of the dcop object. 
.RE
.PP
Definition at line 111 of file dcopref.cpp.
.SS "DCOPRef::DCOPRef (\fBDCOPObject\fP * object)"
.PP
Creates a reference to an existing dcop object. \fBParameters:\fP
.RS 4
\fIobject\fP The dcop object to create the ref to. 
.RE
.PP
Definition at line 104 of file dcopref.cpp.
.SS "DCOPRef::DCOPRef (const \fBQCString\fP & app, const \fBQCString\fP & obj, const \fBQCString\fP & type)"
.PP
Creates a reference for application \fCapp\fP and object \fCobj\fP with a specified type \fCtype\fP. \fBParameters:\fP
.RS 4
\fIapp\fP The name of an application as registered by the dcopserver. 
.br
\fIobj\fP The name of the dcop object 
.br
\fItype\fP The object's type 
.RE
.PP
Definition at line 116 of file dcopref.cpp.
.SH "Member Function Documentation"
.PP 
.SS "bool DCOPRef::isNull () const"
.PP
Tests wether it is a null reference. \fBReturns:\fP
.RS 4
true if this object is a null reference 
.RE
.PP
Definition at line 121 of file dcopref.cpp.
.PP
References QCString::isNull().
.SS "\fBQCString\fP DCOPRef::app () const"
.PP
Name of the application in which the object resides. \fBReturns:\fP
.RS 4
the application's id. Can be null or empty if not set. 
.RE
.PP
Definition at line 126 of file dcopref.cpp.
.PP
Referenced by operator=().
.SS "\fBQCString\fP DCOPRef::obj () const"
.PP
Object ID of the referenced object. \fBReturns:\fP
.RS 4
the id of the referenced object. Can be null or empty if not set. 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 131 of file dcopref.cpp.
.PP
Referenced by operator=().
.SS "\fBQCString\fP DCOPRef::object () const"
.PP
\fBDeprecated\fP
.RS 4
.RE
.PP
Definition at line 136 of file dcopref.cpp.
.SS "\fBQCString\fP DCOPRef::type () const"
.PP
Type of the referenced object. May be null (i.e. unknown). 
.PP
\fBReturns:\fP
.RS 4
the type of the referenced object, or null if unknown 
.RE
.PP
Definition at line 142 of file dcopref.cpp.
.PP
Referenced by operator=().
.SS "\fBDCOPRef\fP & DCOPRef::operator= (const \fBDCOPRef\fP &)"
.PP
Assignment operator. Copies the references data. Definition at line 157 of file dcopref.cpp.
.PP
References app(), d, obj(), and type().
.SS "void DCOPRef::setRef (const \fBQCString\fP & app, const \fBQCString\fP & obj = '')"
.PP
Changes the referenced object. Resets the type to unknown (null). 
.PP
\fBParameters:\fP
.RS 4
\fIapp\fP the application id. 
.br
\fIobj\fP the object id 
.RE
.PP
Definition at line 166 of file dcopref.cpp.
.SS "void DCOPRef::setRef (const \fBQCString\fP & app, const \fBQCString\fP & obj, const \fBQCString\fP & type)"
.PP
Changes the referenced object. \fBParameters:\fP
.RS 4
\fIapp\fP the application id. 
.br
\fIobj\fP the object id 
.br
\fItype\fP the object's type 
.RE
.PP
Definition at line 173 of file dcopref.cpp.
.SS "void DCOPRef::clear ()"
.PP
Makes this a null reference. Definition at line 180 of file dcopref.cpp.
.SS "\fBDCOPClient\fP * DCOPRef::dcopClient () const"
.PP
Returns the dcop client the reference operates on. If no client has been set, this is the \fBDCOPClient::mainClient()\fP. 
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPClient\fP of this object 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 152 of file dcopref.cpp.
.PP
References DCOPClient::mainClient().
.SS "void DCOPRef::setDCOPClient (\fBDCOPClient\fP * client)"
.PP
Sets a specific dcop client for this reference. Otherwise \fBDCOPClient::mainClient()\fP is used. 
.PP
\fBParameters:\fP
.RS 4
\fIclient\fP the new \fBDCOPClient\fP of this object 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 147 of file dcopref.cpp.
.SS "\fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 401 of file dcopref.h.
.SS "template<class T1> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 422 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 450 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 483 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 520 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 561 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 606 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6, const T7 & t7)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt7\fP the seventh argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 655 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8> \fBDCOPReply\fP DCOPRef::call (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6, const T7 & t7, const T8 & t8)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. \fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt7\fP the seventh argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt8\fP the eigth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBsend()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 708 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "bool DCOPRef::send (const \fBQCString\fP & fun)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 746 of file dcopref.h.
.SS "template<class T1> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 768 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 796 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 829 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 866 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 907 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 952 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6, const T7 & t7)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt7\fP the seventh argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1001 of file dcopref.h.
.PP
References QCString::sprintf().
.SS "template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8> bool DCOPRef::send (const \fBQCString\fP & fun, const T1 & t1, const T2 & t2, const T3 & t3, const T4 & t4, const T5 & t5, const T6 & t6, const T7 & t7, const T8 & t8)\fC [inline]\fP"
.PP
Calls the function \fCfun\fP on the object referenced by this reference. Unlike \fBcall\fP() this method does not expect a return value. 
.PP
\fBParameters:\fP
.RS 4
\fIfun\fP the name of the DCOP function. This can be either the full function signature (e.g. 'setName(QString)') or only the function's name (e.g. 'setName'). In the latter case the exact signature will be guessed from the arguments 
.br
\fIt1\fP the first argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt2\fP the second argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt3\fP the third argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt4\fP the fourth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt5\fP the fifth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt6\fP the sixth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt7\fP the seventh argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.br
\fIt8\fP the eigth argument of the function. This can be a supported base type or a \fBDCOPArg\fP object. 
.RE
.PP
\fBReturns:\fP
.RS 4
the \fBDCOPReply\fP object. Is invalid (\fBDCOPReply::isValid\fP()) when an error occurred. 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBcall()\fP 
.PP
\fBDCOPArg\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 1054 of file dcopref.h.
.PP
References QCString::sprintf().

.SH "Author"
.PP 
Generated automatically by Doxygen for dcop Library from the source code.
