<?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/src/gui/embedded/qwindowsystem_qws.cpp -->
<head>
<title>Qt 4.2: QWSServer::KeyboardFilter 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"><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><h1 align="center">QWSServer::KeyboardFilter Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1>
<p>The KeyboardFilter class provides a global keyboard event filter. <a href="#details">More...</a></p>
<pre> #include <<a href="qwsserver.html">QWSServer</a>></pre><ul>
<li><a href="qwsserver-keyboardfilter-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"/>virtual <b><a href="qwsserver-keyboardfilter.html#dtor.KeyboardFilter">~KeyboardFilter</a></b> ()</li>
<li><div class="fn"/>virtual bool <b><a href="qwsserver-keyboardfilter.html#filter">filter</a></b> ( int <i>unicode</i>, int <i>keycode</i>, int <i>modifiers</i>, bool <i>isPress</i>, bool <i>autoRepeat</i> ) = 0</li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The KeyboardFilter class provides a global keyboard event filter.</p>
<p>Note that this class is only available in <a href="qtopiacore.html">Qtopia Core</a>.</p>
<p>KeyboardFilter is used to implement a global, low-level filter on key events in the <a href="qtopiacore.html">Qtopia Core</a> server application; this can be used to implement things like APM (advanced power management) suspended from a button without having to filter for it in all applications.</p>
<p>See also <a href="qwsserver.html">QWSServer</a>, <a href="qwsinputmethod.html">QWSInputMethod</a>, and <a href="qtopiacore-charinput.html">Character Input</a>.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="dtor.KeyboardFilter"></a>KeyboardFilter::~KeyboardFilter () <tt> [virtual]</tt></h3>
<p>Destroys the keyboard filter.</p>
<h3 class="fn"><a name="filter"></a>bool KeyboardFilter::filter ( int <i>unicode</i>, int <i>keycode</i>, int <i>modifiers</i>, bool <i>isPress</i>, bool <i>autoRepeat</i> ) <tt> [pure virtual]</tt></h3>
<p>Returns true if the specified key event should be filtered, stopping the event from being processed any further; otherwise returns false.</p>
<p><table align="center" cellpadding="2" cellspacing="1" border="0">
<thead><tr valign="top" class="qt-style"><th>Parameter</th><th>Description</th></tr></thead>
<tr valign="top" class="odd"><td><i>unicode</i></td><td>The unicode value of the key.</td></tr>
<tr valign="top" class="even"><td><i>keycode</i></td><td>The Qt keycode value as defined by the <a href="qt.html#Key-enum">Qt::Key</a> enum.</td></tr>
<tr valign="top" class="odd"><td><i>modifiers</i></td><td>An OR combination of <a href="qt.html#KeyboardModifier-enum">Qt::KeyboardModifier</a> values, indicating whether <b>Shift/Alt/Ctrl</b> keys are pressed.</td></tr>
<tr valign="top" class="even"><td><i>isPress</i></td><td>True if the event is a key press event; otherwise false.</td></tr>
<tr valign="top" class="odd"><td><i>autoRepeat</i></td><td>True if the event is caused by auto repeat (i.e. the user has held the key down and this is the second or subsequent key event being sent); otherwise false.</td></tr>
</table></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>
