<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>QIrRemoteDeviceWatcher Class Reference</title>
  <link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><img src="images/qpelogo.png" align="left" width="32" height="32" border="0" /></td>
<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="groups.html"><font color="#004faf">Grouped Classes</font></a>&nbsp;&middot; <a href="annotated.html"><font color="#004faf">Annotated</font></a>&nbsp;&middot; <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top"><img src="images/codeless.png" align="right" border="0" /></td></tr></table><h1 class="title">QIrRemoteDeviceWatcher Class Reference</h1>
<p>The QIrRemoteDeviceWatcher class watches for remote devices. <a href="#details">More...</a></p>
<pre>    #include &lt;QIrRemoteDeviceWatcher&gt;</pre><p>Inherits <a href="qobject.html">QObject</a>.</p>
<ul>
<li><a href="qirremotedevicewatcher-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h3>Public Functions</h3>
<ul>
<li><div class="fn"/><b><a href="qirremotedevicewatcher.html#QIrRemoteDeviceWatcher">QIrRemoteDeviceWatcher</a></b> ( QObject * <i>parent</i> = 0 )</li>
<li><div class="fn"/><b><a href="qirremotedevicewatcher.html#dtor.QIrRemoteDeviceWatcher">~QIrRemoteDeviceWatcher</a></b> ()</li>
<li><div class="fn"/>bool <b><a href="qirremotedevicewatcher.html#watch">watch</a></b> ( int <i>ms</i>, QIr::DeviceClasses <i>classes</i> = QIr::All )</li>
</ul>
<ul>
<li><div class="fn"/>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h3>Signals</h3>
<ul>
<li><div class="fn"/>void <b><a href="qirremotedevicewatcher.html#deviceFound">deviceFound</a></b> ()</li>
</ul>
<ul>
<li><div class="fn"/>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"/>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
<li><div class="fn"/>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
<li><div class="fn"/>1 public type inherited from <a href="qobject.html#public-variables">QObject</a></li>
<li><div class="fn"/>4 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li><div class="fn"/>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li><div class="fn"/>2 protected variables inherited from <a href="qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QIrRemoteDeviceWatcher class watches for remote devices.</p>
<p>QIrRemoteDeviceWatcher can be used to wait for remote infrared devices to come into range, and notify the user. Using this class, a system can alert the user that another infrared device is available for communication.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="QIrRemoteDeviceWatcher"></a>QIrRemoteDeviceWatcher::QIrRemoteDeviceWatcher ( <a href="qobject.html">QObject</a> * <i>parent</i> = 0 )</h3>
<p>Constructs a remote device watcher. The <i>parent</i> parameter specifies the object's parent.</p>
<h3 class="fn"><a name="dtor.QIrRemoteDeviceWatcher"></a>QIrRemoteDeviceWatcher::~QIrRemoteDeviceWatcher ()</h3>
<p>Destroys the device watcher.</p>
<h3 class="fn"><a name="deviceFound"></a>void QIrRemoteDeviceWatcher::deviceFound ()&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted whenever a new infrared device comes into range.</p>
<h3 class="fn"><a name="watch"></a>bool QIrRemoteDeviceWatcher::watch ( int <i>ms</i>, <a href="qir.html#DeviceClass-enum">QIr::DeviceClasses</a> <i>classes</i> = QIr::All )</h3>
<p>Starts a watch for remote devices. The <i>ms</i> parameter specifies the maximum time to watch, and the <i>classes</i> parameter specifies the filter of the types of devices we're interested in.</p>
<p>NOTE: Due to the underlying system implementation, this function is blocking and will not return until a device has been found or the timeout has elapsed.</p>
<p>The function will return false if the watch could not be started or an error occurred, and true otherwise. In case a new device was found within the specified timeout, the <a href="qirremotedevicewatcher.html#deviceFound">deviceFound</a>() signal will be emitted and this function will return true.</p>
<p>This function is designed to be called repeatedly in a loop. It is designed to be used as a low-power, passive watcher of remote devices, such that a user can be notified when a new device has come into range.</p>
<p>See also <a href="qirremotedevicewatcher.html#deviceFound">deviceFound</a>().</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td align="left">Copyright &copy; 2008 Trolltech</td>
<td align="center"><a href="trademarks.html">Trademarks</a></td>
<td align="right"><div align="right">Qtopia 4.3.4</div></td>
</tr></table></div></address></body>
</html>
