<?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">
<!-- /tmp/qt-4.2.1-harald-1161357942206/qt-x11-opensource-src-4.2.1/doc/src/emb-pointer.qdoc -->
<head>
<title>Qt 4.2: Pointer Handling</title>
<link rel="contents" href="qtopiacore.html" />
<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"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<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><p>
[<a href="qtopiacore.html">Contents</a>]
</p>
<h1 align="center">Pointer Handling<br /><small></small></h1>
<p>Pointer handling in Qtopia Core works for both mouse and mouse-like devices such as touch panels and trackballs. The various drivers can be enabled and disabled using the <tt>configure</tt> script.</p>
<p>For example:</p>
<pre> configure -qt-mouse-tslib</pre>
<p>Run <tt>./configure -help</tt> to list the available drivers. In the default Qt configuration, only the "pc" mouse driver is enabled.</p>
<a name="available-drivers"></a>
<h2>Available Drivers</h2>
<p>Qtopia Core provides drivers for the MouseMan, IntelliMouse, Microsoft, NEC Vr41XX, Linux Touch Panel and Yopy protocols as well as the universal touch screen library, tslib.</p>
<p>Provided that the "pc" mouse driver is enabled, Qtopia Core will try to auto-detect the mouse device if it is one of the supported types on <tt>/dev/psaux</tt> or one of the <tt>/dev/ttyS</tt>? serial lines. If multiple mice are detected, all may be used simultaneously. Note that Qtopia Core does not support auto-detection of <i>touch panels</i> in which case the driver must be specified explicitly to determine which device to use.</p>
<p>Other drivers can be added by deriving from the <a href="qwsmousehandler.html">QWSMouseHandler</a> and <a href="qmousedriverplugin.html">QMouseDriverPlugin</a> classes and using Qt's plugin mechanism.</p>
<a name="specifying-a-driver"></a>
<h2>Specifying a Driver</h2>
<p>To specify which driver to use, set the <a href="qtopiacore-envvars.html#qws-mouse-proto">QWS_MOUSE_PROTO</a> environment variable. For example (if the current shell is bash, ksh, zsh or sh):</p>
<pre> export QWS_MOUSE_PROTO=<driver>:<device></pre>
<p>The <tt><driver></tt> argument is either <tt>MouseMan</tt>, <tt>IntelliMouse</tt>, <tt>Microsoft</tt>, <tt>VR41xx</tt>, <tt>LinuxTP</tt>, <tt>Yopy</tt> or <tt>Tslib</tt>, and the <tt><device></tt> argument is typically <tt>/dev/mouse</tt> for mouse devices and <tt>/dev/ts</tt> for touch panels. Note that the latter argument is optional.</p>
<p>
[<a href="qtopiacore.html">Contents</a>]
</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright © 2006 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt 4.2.1</div></td>
</tr></table></div></address></body>
</html>
