Symbian3/SDK/Source/GUID-842D8557-076B-4A6E-B823-81164368FD86.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 21 Jan 2010 18:18:20 +0000
changeset 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of Documentation_content according to Feature bug 1266 bug 1268 bug 1269 bug 1270 bug 1372 bug 1374 bug 1375 bug 1379 bug 1380 bug 1381 bug 1382 bug 1383 bug 1385

<?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:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-842D8557-076B-4A6E-B823-81164368FD86" xml:lang="en"><title>Disabling
and enabling feedback</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<section><title>Disabling and enabling feedback for your application</title><p>If
you need to disable tactile feedback for any reason (and then possibly re-enable
it later), use the function <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#68dc5cb09c94b8c42e50e2043249b4c4" format="application/java-archive"><codeph>SetFeedbackEnabledForThisApp</codeph></xref>. </p><p>You can also
use an <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#f79365f3d12d54496715be253759dec6" format="application/java-archive">overloaded
version</xref> of the function for disabling only audio or vibration based
feedback.</p><p>Feedback may need to be disabled for example during video
recording in camera applications, because otherwise device vibration sounds
may be recorded along the video clip.</p><note><p>You can and are recommended
to use the API normally for area registry updates even when feedback is disabled.
This way feedback can be turned on successfully even if there was a layout
or view change while feedback was disabled. </p><p>The only exceptions to
this are those applications which will never enable the feedback again (for
example, in some games you might do this if you don’t want feedback, or use
the device vibration for effects in your game).</p></note><p>Any application
can only disable the feedback for itself, i.e. this API provides no means
for globally disabling feedback. </p><p>The user can still disable all the
feedback by changing device feedback settings. Moreover, feedback can be globally
disabled by the feedback system for e.g. during ongoing telephone calls (this
depends on the device configuration).</p></section>
<section><title>Disabling and enabling feedback for a control</title><p>Use
the funtion <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#3430455447f3294fde61a91c545c7847" format="application/java-archive"><codeph>EnableFeedbackForControl</codeph></xref> to disable and enable feedback for a control.</p><p>You
can also use an <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#087da56921ef7f5deca103ad568efa8d" format="application/java-archive">overloaded
version</xref> of this function to disable or enable only audio or vibration
based feedback.</p></section>
</conbody></concept>