Symbian3/SDK/Source/GUID-842D8557-076B-4A6E-B823-81164368FD86.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-842D8557-076B-4A6E-B823-81164368FD86.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,38 @@
+<?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>
\ No newline at end of file