<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

Contributors: 

feedback client API</title><shortdesc>The Tactile feedback client API is used for producing tactile feedback

<p>The Tactile feedback client API is a library API that has been implemented

with a client-server technique. A major part of the processing is done on

the client side, and thus API calls don't necessarily generate a client-server

<p>You can use tactile feedback in, for example, the following cases:</p>

<ul>

<li>When the user starts to scroll with the scroll bar, user can feel and/or

hear when the scroll bar thumb has been caught.</li>

<li>When button is pressed, user can feel and/or hear the button being pressed.</li>

</ul>

<p>The concept of logical feedback type is very important from this API's

point of view. </p>

<p>In practice it means that, for example, you should not try to use this

API for producing vibrator feedback only. Instead, logical feedback types

such as "basic" or "sensitive" are used on this level, and the actual physical

effect then depends on the settings and device configuration. This way the

feedback works in a unified way from the end user point of view in the whole

device.</p>

tactile feedback for touch events</xref>.</p><p>For the Tactile feedback client

<thead>

<row>

<entry>Error situation</entry>

<entry>Response</entry>

</row>

</thead>

<tbody>

<row>

<entry><codeph>SetFeedbackArea</codeph> returns <codeph>KErrNoMemory</codeph> in

case of an OOM situation.</entry>

<entry>This error can usually be ignored by the application.</entry>

</row>

<row>

<entry><codeph>SetFeedbackArea</codeph> returns <codeph>KErrArgument</codeph></entry>

<entry>The given <codeph>CCoeControl</codeph> pointer is a <codeph>NULL</codeph> pointer

</row>

<row>

<entry><codeph>SetFeedbackArea</codeph> returns <codeph>KErrNotSupported</codeph>.</entry>

<entry>The given logical feedback type or triggering event type is out of

range.</entry>

</row>

<row>

<entry>A tactile feedback enabled control is moved with <codeph>CCoeControl::SetPosition</codeph>,

but the feedback area is not moved.</entry>

<entry>The control must override the <codeph>CCoeControl::PositionChanged</codeph> function,

and update the feedback area there the same way as in the <codeph>SizeChanged</codeph> function.</entry>

</row>

<row>

<entry>Area registry updates not are effective fast enough. This might happen

in some applications which use very many frequently running active objects,

so that the <codeph>CIdle</codeph> object used by the implementation of this

API gets no change to run.</entry>

<entry>Use the <codeph>FlushRegistryUpdates</codeph> function for forcing

an update to the server side after doing all updates on the client side.</entry>

</row>

<row>

<entry>A control's feedback areas are not automatically disabled when the

control is dimmed.</entry>

<entry><codeph>CCoeControl::SetMopParent</codeph> has not been called on the

control, and thus the object provider hierarchy is broken.</entry>

</row>

</tbody>

</tgroup>

</table></section>

</conbody></concept>