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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-842D8557-076B-4A6E-B823-81164368FD86" xml:lang="en"><title>Disabling

    13 and enabling feedback</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section><title>Disabling and enabling feedback for your application</title><p>If

    15 you need to disable tactile feedback for any reason (and then possibly re-enable

    16 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

    17 use an <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#f79365f3d12d54496715be253759dec6" format="application/java-archive">overloaded

    18 version</xref> of the function for disabling only audio or vibration based

    19 feedback.</p><p>Feedback may need to be disabled for example during video

    20 recording in camera applications, because otherwise device vibration sounds

    21 may be recorded along the video clip.</p><note><p>You can and are recommended

    22 to use the API normally for area registry updates even when feedback is disabled.

    23 This way feedback can be turned on successfully even if there was a layout

    24 or view change while feedback was disabled. </p><p>The only exceptions to

    25 this are those applications which will never enable the feedback again (for

    26 example, in some games you might do this if you don’t want feedback, or use

    27 the device vibration for effects in your game).</p></note><p>Any application

    28 can only disable the feedback for itself, i.e. this API provides no means

    29 for globally disabling feedback. </p><p>The user can still disable all the

    30 feedback by changing device feedback settings. Moreover, feedback can be globally

    31 disabled by the feedback system for e.g. during ongoing telephone calls (this

    32 depends on the device configuration).</p></section>

    33 <section><title>Disabling and enabling feedback for a control</title><p>Use

    34 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

    35 can also use an <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classMTouchFeedback.html#087da56921ef7f5deca103ad568efa8d" format="application/java-archive">overloaded

    36 version</xref> of this function to disable or enable only audio or vibration

    37 based feedback.</p></section>

    38 </conbody></concept>