<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdbusservicewatcher.cpp -->
<title>Qt 4.8: QDBusServiceWatcher Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtdbus.html">QtDBus</a></li>
<li>QDBusServiceWatcher</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QDBusServiceWatcher Class Reference</h1>
<!-- $$$QDBusServiceWatcher-brief -->
<p>The QDBusServiceWatcher class allows the user to watch for a bus service change. <a href="#details">More...</a></p>
<!-- @@@QDBusServiceWatcher -->
<pre class="cpp"> <span class="preprocessor">#include <QDBusServiceWatcher></span></pre><p><b>Inherits: </b><a href="qobject.html">QObject</a>.</p>
<p>This class was introduced in Qt 4.6.</p>
<ul>
<li><a href="qdbusservicewatcher-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#WatchModeFlag-enum">WatchMode</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#WatchModeFlag-enum">WatchModeFlag</a></b> { WatchForRegistration, WatchForUnregistration, WatchForOwnerChange }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="qdbusservicewatcher.html#watchMode-prop">watchMode</a></b> : WatchMode</li>
<li class="fn"><b><a href="qdbusservicewatcher.html#watchedServices-prop">watchedServices</a></b> : QStringList</li>
</ul>
<ul>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#QDBusServiceWatcher">QDBusServiceWatcher</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#QDBusServiceWatcher-2">QDBusServiceWatcher</a></b> ( const QString & <i>service</i>, const QDBusConnection & <i>connection</i>, WatchMode <i>watchMode</i> = WatchForOwnerChange, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#dtor.QDBusServiceWatcher">~QDBusServiceWatcher</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#addWatchedService">addWatchedService</a></b> ( const QString & <i>newService</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDBusConnection </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#connection">connection</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#removeWatchedService">removeWatchedService</a></b> ( const QString & <i>service</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#setConnection">setConnection</a></b> ( const QDBusConnection & <i>connection</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#watchMode-prop">setWatchMode</a></b> ( WatchMode <i>mode</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#watchedServices-prop">setWatchedServices</a></b> ( const QStringList & <i>services</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> WatchMode </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#watchMode-prop">watchMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#watchedServices-prop">watchedServices</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#serviceOwnerChanged">serviceOwnerChanged</a></b> ( const QString & <i>serviceName</i>, const QString & <i>oldOwner</i>, const QString & <i>newOwner</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#serviceRegistered">serviceRegistered</a></b> ( const QString & <i>serviceName</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qdbusservicewatcher.html#serviceUnregistered">serviceUnregistered</a></b> ( const QString & <i>serviceName</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QDBusServiceWatcher-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QDBusServiceWatcher class allows the user to watch for a bus service change.</p>
<p>A QDBusServiceWatcher object can be used to notify the application about an ownership change of a service name on the bus. It has three watch modes:</p>
<ul>
<li>Watching for service registration only.</li>
<li>Watching for service unregistration only.</li>
<li>Watching for any kind of service ownership change (the default mode).</li>
</ul>
<p>Besides being created or deleted, services may change owners without a unregister/register operation happening. So the <a href="qdbusservicewatcher.html#serviceRegistered">serviceRegistered</a>() and <a href="qdbusservicewatcher.html#serviceUnregistered">serviceUnregistered</a>() signals may not be emitted if that happens.</p>
<p>This class is more efficient than using the <a href="qdbusconnectioninterface.html#serviceOwnerChanged">QDBusConnectionInterface::serviceOwnerChanged</a>() signal because it allows one to receive only the signals for which the class is interested in.</p>
</div>
<p><b>See also </b><a href="qdbusconnection.html">QDBusConnection</a>.</p>
<!-- @@@QDBusServiceWatcher -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$WatchModeFlag$$$WatchForRegistration$$$WatchForUnregistration$$$WatchForOwnerChange -->
<h3 class="flags"><a name="WatchModeFlag-enum"></a>enum QDBusServiceWatcher::<span class="name">WatchModeFlag</span><br/>flags QDBusServiceWatcher::<span class="name">WatchMode</span></h3>
<p><a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> supports three different watch modes, which are configured by this flag:</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QDBusServiceWatcher::WatchForRegistration</tt></td><td class="topAlign"><tt>0x01</tt></td><td class="topAlign">watch for service registration only, ignoring any signals related to other service ownership change.</td></tr>
<tr><td class="topAlign"><tt>QDBusServiceWatcher::WatchForUnregistration</tt></td><td class="topAlign"><tt>0x02</tt></td><td class="topAlign">watch for service unregistration only, ignoring any signals related to other service ownership change.</td></tr>
<tr><td class="topAlign"><tt>QDBusServiceWatcher::WatchForOwnerChange</tt></td><td class="topAlign"><tt>0x03</tt></td><td class="topAlign">watch for any kind of service ownership change.</td></tr>
</table>
<p>The WatchMode type is a typedef for <a href="qflags.html">QFlags</a><WatchModeFlag>. It stores an OR combination of WatchModeFlag values.</p>
<!-- @@@WatchModeFlag -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$watchMode-prop$$$watchMode$$$setWatchModeWatchMode -->
<h3 class="fn"><a name="watchMode-prop"></a><span class="name">watchMode</span> : <span class="type"><a href="qdbusservicewatcher.html#WatchModeFlag-enum">WatchMode</a></span></h3>
<p>The <tt>watchMode</tt> property holds the current watch mode for this <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> object. The default value for this property is QDBusServiceWatcher::WatchForOwnershipChange.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> WatchMode </td><td class="memItemRight bottomAlign"><span class="name"><b>watchMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWatchMode</b></span> ( WatchMode <i>mode</i> )</td></tr>
</table>
<!-- @@@watchMode -->
<!-- $$$watchedServices-prop$$$watchedServices$$$setWatchedServicesconstQStringList& -->
<h3 class="fn"><a name="watchedServices-prop"></a><span class="name">watchedServices</span> : <span class="type"><a href="qstringlist.html">QStringList</a></span></h3>
<p>The <tt>servicesWatched</tt> property holds the list of services watched.</p>
<p>Note that modifying this list with setServicesWatched() is an expensive operation. If you can, prefer to change it by way of <a href="qdbusservicewatcher.html#addWatchedService">addWatchedService</a>() and <a href="qdbusservicewatcher.html#removeWatchedService">removeWatchedService</a>().</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QStringList </td><td class="memItemRight bottomAlign"><span class="name"><b>watchedServices</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setWatchedServices</b></span> ( const QStringList & <i>services</i> )</td></tr>
</table>
<!-- @@@watchedServices -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QDBusServiceWatcher[overload1]$$$QDBusServiceWatcherQObject* -->
<h3 class="fn"><a name="QDBusServiceWatcher"></a>QDBusServiceWatcher::<span class="name">QDBusServiceWatcher</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Creates a <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> object. Note that until you set a connection with <a href="qdbusservicewatcher.html#setConnection">setConnection</a>(), this object will not emit any signals.</p>
<p>The <i>parent</i> parameter is passed to <a href="qobject.html">QObject</a> to set the parent of this object.</p>
<!-- @@@QDBusServiceWatcher -->
<!-- $$$QDBusServiceWatcher$$$QDBusServiceWatcherconstQString&constQDBusConnection&WatchModeQObject* -->
<h3 class="fn"><a name="QDBusServiceWatcher-2"></a>QDBusServiceWatcher::<span class="name">QDBusServiceWatcher</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>service</i>, const <span class="type"><a href="qdbusconnection.html">QDBusConnection</a></span> & <i>connection</i>, <span class="type"><a href="qdbusservicewatcher.html#WatchModeFlag-enum">WatchMode</a></span> <i>watchMode</i> = WatchForOwnerChange, <span class="type"><a href="qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Creates a <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> object and attaches it to the <i>connection</i> connection. Also, this function immediately starts watching for <i>watchMode</i> changes to service <i>service</i>.</p>
<p>The <i>parent</i> parameter is passed to <a href="qobject.html">QObject</a> to set the parent of this object.</p>
<!-- @@@QDBusServiceWatcher -->
<!-- $$$~QDBusServiceWatcher[overload1]$$$~QDBusServiceWatcher -->
<h3 class="fn"><a name="dtor.QDBusServiceWatcher"></a>QDBusServiceWatcher::<span class="name">~QDBusServiceWatcher</span> ()</h3>
<p>Destroys the <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> object and releases any resources associated with it.</p>
<!-- @@@~QDBusServiceWatcher -->
<!-- $$$addWatchedService[overload1]$$$addWatchedServiceconstQString& -->
<h3 class="fn"><a name="addWatchedService"></a><span class="type">void</span> QDBusServiceWatcher::<span class="name">addWatchedService</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>newService</i> )</h3>
<p>Adds <i>newService</i> to the list of services to be watched by this object. This function is more efficient than <a href="qdbusservicewatcher.html#watchedServices-prop">setWatchedServices</a>() and should be used whenever possible to add services.</p>
<!-- @@@addWatchedService -->
<!-- $$$connection[overload1]$$$connection -->
<h3 class="fn"><a name="connection"></a><span class="type"><a href="qdbusconnection.html">QDBusConnection</a></span> QDBusServiceWatcher::<span class="name">connection</span> () const</h3>
<p>Returns the <a href="qdbusconnection.html">QDBusConnection</a> that this object is attached to.</p>
<p><b>See also </b><a href="qdbusservicewatcher.html#setConnection">setConnection</a>().</p>
<!-- @@@connection -->
<!-- $$$removeWatchedService[overload1]$$$removeWatchedServiceconstQString& -->
<h3 class="fn"><a name="removeWatchedService"></a><span class="type">bool</span> QDBusServiceWatcher::<span class="name">removeWatchedService</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>service</i> )</h3>
<p>Removes the <i>service</i> from the list of services being watched by this object. Note that D-Bus notifications are asynchronous, so there may still be signals pending delivery about <i>service</i>. Those signals will still be emitted whenever the D-Bus messages are processed.</p>
<p>This function returns true if any services were removed.</p>
<!-- @@@removeWatchedService -->
<!-- $$$serviceOwnerChanged[overload1]$$$serviceOwnerChangedconstQString&constQString&constQString& -->
<h3 class="fn"><a name="serviceOwnerChanged"></a><span class="type">void</span> QDBusServiceWatcher::<span class="name">serviceOwnerChanged</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>serviceName</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>oldOwner</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>newOwner</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted whenever this object detects that there was a service ownership change relating to the <i>serviceName</i> service. The <i>oldOwner</i> parameter contains the old owner name and <i>newOwner</i> is the new owner. Both <i>oldOwner</i> and <i>newOwner</i> are unique connection names.</p>
<p>Note that this signal is also emitted whenever the <i>serviceName</i> service was registered or unregistered. If it was registered, <i>oldOwner</i> will contain an empty string, whereas if it was unregistered, <i>newOwner</i> will contain an empty string.</p>
<p>If you need only to find out if the service is registered or unregistered only, without being notified that the ownership changed, consider using the specific modes for those operations. This class is more efficient if you use the more specific modes.</p>
<p><b>See also </b><a href="qdbusservicewatcher.html#serviceRegistered">serviceRegistered</a>() and <a href="qdbusservicewatcher.html#serviceUnregistered">serviceUnregistered</a>().</p>
<!-- @@@serviceOwnerChanged -->
<!-- $$$serviceRegistered[overload1]$$$serviceRegisteredconstQString& -->
<h3 class="fn"><a name="serviceRegistered"></a><span class="type">void</span> QDBusServiceWatcher::<span class="name">serviceRegistered</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>serviceName</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted whenever this object detects that the service <i>serviceName</i> became available on the bus.</p>
<p><b>See also </b><a href="qdbusservicewatcher.html#serviceUnregistered">serviceUnregistered</a>() and <a href="qdbusservicewatcher.html#serviceOwnerChanged">serviceOwnerChanged</a>().</p>
<!-- @@@serviceRegistered -->
<!-- $$$serviceUnregistered[overload1]$$$serviceUnregisteredconstQString& -->
<h3 class="fn"><a name="serviceUnregistered"></a><span class="type">void</span> QDBusServiceWatcher::<span class="name">serviceUnregistered</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>serviceName</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted whenever this object detects that the service <i>serviceName</i> was unregistered from the bus and is no longer available.</p>
<p><b>See also </b><a href="qdbusservicewatcher.html#serviceRegistered">serviceRegistered</a>() and <a href="qdbusservicewatcher.html#serviceOwnerChanged">serviceOwnerChanged</a>().</p>
<!-- @@@serviceUnregistered -->
<!-- $$$setConnection[overload1]$$$setConnectionconstQDBusConnection& -->
<h3 class="fn"><a name="setConnection"></a><span class="type">void</span> QDBusServiceWatcher::<span class="name">setConnection</span> ( const <span class="type"><a href="qdbusconnection.html">QDBusConnection</a></span> & <i>connection</i> )</h3>
<p>Sets the D-Bus connection that this object is attached to be <i>connection</i>. All services watched will be transferred to this connection.</p>
<p>Note that <a href="qdbusconnection.html">QDBusConnection</a> objects are reference counted: <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> will keep a reference for this connection while it exists. The connection is not closed until the reference count drops to zero, so this will ensure that any notifications are received while this <a href="qdbusservicewatcher.html">QDBusServiceWatcher</a> object exists.</p>
<p><b>See also </b><a href="qdbusservicewatcher.html#connection">connection</a>().</p>
<!-- @@@setConnection -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
1dd17e0d683ef79b4bb6872bbf359d7f
>
files
>
5057
