~oif-team/ubuntu/natty/qt4-x11/xi2.1

« back to all changes in this revision

Viewing changes to doc/html/qdbusabstractadaptor.html

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2006-10-12 23:14:14 UTC
  • mto: (15.1.1 lenny) (1.3.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 16.
  • Revision ID: james.westby@ubuntu.com-20061012231414-y2oqbom5dy389os0
Tags: upstream-4.2.0
ImportĀ upstreamĀ versionĀ 4.2.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="iso-8859-1"?>
 
2
<!DOCTYPE html
 
3
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
 
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 
5
<!-- /tmp/qt-4.2.0-qt-1159540607313/qt-x11-opensource-src-4.2.0/tools/qdbus/src/qdbusabstractadaptor.cpp -->
 
6
<head>
 
7
  <title>Qt 4.2: QDBusAbstractAdaptor Class Reference</title>
 
8
  <link href="classic.css" rel="stylesheet" type="text/css" />
 
9
</head>
 
10
<body>
 
11
<table border="0" cellpadding="0" cellspacing="0" width="100%">
 
12
<tr>
 
13
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
 
14
<td width="1">&nbsp;&nbsp;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&nbsp;&middot; <a href="classes.html"><font color="#004faf">All&nbsp;Classes</font></a>&nbsp;&middot; <a href="mainclasses.html"><font color="#004faf">Main&nbsp;Classes</font></a>&nbsp;&middot; <a href="groups.html"><font color="#004faf">Grouped&nbsp;Classes</font></a>&nbsp;&middot; <a href="modules.html"><font color="#004faf">Modules</font></a>&nbsp;&middot; <a href="functions.html"><font color="#004faf">Functions</font></a></td>
 
15
<td align="right" valign="top" width="230"><a href="http://www.trolltech.com"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></a></td></tr></table><h1 align="center">QDBusAbstractAdaptor Class Reference<br /><sup><sup>[<a href="qtdbus.html">QtDBus</a> module]</sup></sup></h1>
 
16
<p>The QDBusAbstractAdaptor class is the base class of D-Bus adaptor classes. <a href="#details">More...</a></p>
 
17
<pre> #include &lt;QDBusAbstractAdaptor&gt;</pre><p>Inherits <a href="qobject.html">QObject</a>.</p>
 
18
<p>This class was introduced in Qt 4.2.</p>
 
19
<ul>
 
20
<li><a href="qdbusabstractadaptor-members.html">List of all members, including inherited members</a></li>
 
21
</ul>
 
22
<a name="public-functions"></a>
 
23
<h3>Public Functions</h3>
 
24
<ul>
 
25
<li><div class="fn"/><b><a href="qdbusabstractadaptor.html#dtor.QDBusAbstractAdaptor">~QDBusAbstractAdaptor</a></b> ()</li>
 
26
</ul>
 
27
<ul>
 
28
<li><div class="fn"/>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
 
29
</ul>
 
30
<a name="protected-functions"></a>
 
31
<h3>Protected Functions</h3>
 
32
<ul>
 
33
<li><div class="fn"/><b><a href="qdbusabstractadaptor.html#QDBusAbstractAdaptor">QDBusAbstractAdaptor</a></b> ( QObject * <i>obj</i> )</li>
 
34
<li><div class="fn"/>bool <b><a href="qdbusabstractadaptor.html#autoRelaySignals">autoRelaySignals</a></b> () const</li>
 
35
<li><div class="fn"/>void <b><a href="qdbusabstractadaptor.html#setAutoRelaySignals">setAutoRelaySignals</a></b> ( bool <i>enable</i> )</li>
 
36
</ul>
 
37
<ul>
 
38
<li><div class="fn"/>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
 
39
</ul>
 
40
<a name="macros"></a>
 
41
<h3>Macros</h3>
 
42
<ul>
 
43
<li><div class="fn"/><b><a href="qdbusabstractadaptor.html#Q_ASYNC">Q_ASYNC</a></b></li>
 
44
</ul>
 
45
<h3>Additional Inherited Members</h3>
 
46
<ul>
 
47
<li><div class="fn"/>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
 
48
<li><div class="fn"/>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
 
49
<li><div class="fn"/>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
 
50
<li><div class="fn"/>5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
 
51
</ul>
 
52
<a name="details"></a>
 
53
<hr />
 
54
<h2>Detailed Description</h2>
 
55
<p>The QDBusAbstractAdaptor class is the base class of D-Bus adaptor classes.</p>
 
56
<p>The QDBusAbstractAdaptor class is the starting point for all objects intending to provide interfaces to the external world using D-Bus. This is accomplished by attaching a one or more classes derived from QDBusAbstractAdaptor to a normal <a href="qobject.html">QObject</a> and then registering that <a href="qobject.html">QObject</a> with QDBusConnection::registerObject. QDBusAbstractAdaptor objects are intended to be light-weight wrappers, mostly just relaying calls into the real object (its parent) and the signals from it.</p>
 
57
<p>Each QDBusAbstractAdaptor-derived class should define the D-Bus interface it is implementing using the Q_CLASSINFO macro in the class definition.</p>
 
58
<p>QDBusAbstractAdaptor uses the standard <a href="qobject.html">QObject</a> mechanism of signals, slots and properties to determine what signals, methods and properties to export to the bus. Any signal emitted by QDBusAbstractAdaptor-derived classes will be automatically be relayed through any D-Bus connections the object is registered on.</p>
 
59
<p>Classes derived from QDBusAbstractAdaptor must be created on the heap using the <i>new</i> operator and must not be deleted by the user (they will be deleted automatically when the object they are connected to is also deleted).</p>
 
60
<p>See also <a href="usingadaptors.html">Using adaptors</a> and <a href="qdbusconnection.html">QDBusConnection</a>.</p>
 
61
<hr />
 
62
<h2>Member Function Documentation</h2>
 
63
<h3 class="fn"><a name="QDBusAbstractAdaptor"></a>QDBusAbstractAdaptor::QDBusAbstractAdaptor ( <a href="qobject.html">QObject</a> * <i>obj</i> )&nbsp;&nbsp;<tt> [protected]</tt></h3>
 
64
<p>Constructs a <a href="qdbusabstractadaptor.html">QDBusAbstractAdaptor</a> with <i>obj</i> as the parent object.</p>
 
65
<h3 class="fn"><a name="dtor.QDBusAbstractAdaptor"></a>QDBusAbstractAdaptor::~QDBusAbstractAdaptor ()</h3>
 
66
<p>Destroys the adaptor.</p>
 
67
<p><b>Warning:</b> Adaptors are destroyed automatically when the real object they refer to is destroyed. Do not delete the adaptors yourself.</p>
 
68
<h3 class="fn"><a name="autoRelaySignals"></a>bool QDBusAbstractAdaptor::autoRelaySignals () const&nbsp;&nbsp;<tt> [protected]</tt></h3>
 
69
<p>Returns true if automatic signal relaying from the real object (see object()) is enabled, otherwiser returns false.</p>
 
70
<p>See also <a href="qdbusabstractadaptor.html#setAutoRelaySignals">setAutoRelaySignals</a>().</p>
 
71
<h3 class="fn"><a name="setAutoRelaySignals"></a>void QDBusAbstractAdaptor::setAutoRelaySignals ( bool <i>enable</i> )&nbsp;&nbsp;<tt> [protected]</tt></h3>
 
72
<p>Toggles automatic signal relaying from the real object (see object()).</p>
 
73
<p>Automatic signal relaying consists of signal-to-signal connection of the signals on the parent that have the exact same method signatue in both classes.</p>
 
74
<p>If <i>enable</i> is set to true, connect the signals; if set to false, disconnect all signals.</p>
 
75
<p>See also <a href="qdbusabstractadaptor.html#autoRelaySignals">autoRelaySignals</a>().</p>
 
76
<hr />
 
77
<h2>Macro Documentation</h2>
 
78
<h3 class="fn"><a name="Q_ASYNC"></a>Q_ASYNC</h3>
 
79
<p>The Q_ASYNC macro can be used to mark a method to be called and not wait for it to finish processing before returning from <a href="qdbusabstractinterface.html#call">QDBusInterface::call</a>(). The called method cannot return any output arguments and, if it does, any such arguments will be discarded.</p>
 
80
<p>You can use this macro in your own adaptors by placing it before your method's return value (which must be &quot;void&quot;) in the class declaration, as shown in the example:</p>
 
81
<pre> Q_ASYNC void myMethod();</pre>
 
82
<p>Its presence in the method implementation (outside the class declaration) is optional.</p>
 
83
<p>This function was introduced in Qt 4.2.</p>
 
84
<p>See also <a href="usingadaptors.html">Using adaptors</a>.</p>
 
85
<p /><address><hr /><div align="center">
 
86
<table width="100%" cellspacing="0" border="0"><tr class="address">
 
87
<td width="30%">Copyright &copy; 2006 <a href="trolltech.html">Trolltech</a></td>
 
88
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
 
89
<td width="30%" align="right"><div align="right">Qt 4.2.0</div></td>
 
90
</tr></table></div></address></body>
 
91
</html>