Symbian3/PDK/Source/GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177.dita
changeset 1 25a17d01db0c
child 5 f345bda72bc4
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177.dita	Fri Jan 22 18:26:19 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 task
+  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177" xml:lang="en"><title>Handling
+Feature Notification </title><shortdesc>How to handle notification of changes to a feature using <apiname>RFeatureControl</apiname>. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context id="GUID-96D657EC-032D-535E-926A-924CB5D07324"><p>To handle notification
+of changes to a feature using <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref>, take the
+following steps. </p><p/><p>  <xref href="GUID-623C4183-00F0-36B0-AE1F-5C5EDCAF1B3D.dita"><apiname>MFeatureObserver</apiname></xref> is an
+interface which you
+implement to react to change notification in whatever way you choose. It has
+two member functions which you must implement:  
+</p><p/><p><xref href="GUID-428DC6B1-6847-313F-BEEF-A8EC2442BA57.dita"><apiname>HandleNotifyChange()</apiname></xref> and</p><p><xref href="GUID-F737E1D7-5B67-345D-8290-E31F214D55E8.dita"><apiname>HandleNotifyError()</apiname></xref></p><p/><p>&lt;api-item&gt;HandleNotifyChange()&lt;/api-item&gt;
+takes two arguments: </p><p/><p>a <xref href="GUID-5F29338F-1073-3160-8FDD-E3FD4932F009.dita"><apiname>TFeatureChangeType</apiname></xref> representing
+the kind of change you want to be notified of, and</p><p>a <xref href="GUID-80C51259-F2C4-3877-97B4-EC0C85DE93DE.dita"><apiname>TFeatureEntry</apiname></xref> object
+representing the feature you want to be notified of when it is change. </p><p/><p> <xref href="GUID-F737E1D7-5B67-345D-8290-E31F214D55E8.dita"><apiname>HandleNotifyError()</apiname></xref> takes
+one argument, an integer: this integer represents one of the Symbian OS error
+codes. Any error in the notifier causes the notifier to stop handling notifications.
+Your implementation should respond to each of the error types you expect to
+occur.  
+</p> </context>
+</taskbody><related-links>
+<link href="GUID-2E33854B-5725-55DE-9B03-7A3100F5A5B5.dita"><linktext>Requesting
+feature                 notification</linktext></link>
+<link href="GUID-926862C4-5E13-5896-B959-0D408C748AB5.dita"><linktext>Cancelling
+feature                 notification</linktext></link>
+<link href="GUID-B71AC5E3-8AA8-55AD-916F-9E873926011B.dita"><linktext>Feature Manager
+Collection Overview</linktext></link>
+<link href="GUID-910780A3-D6AB-5EE2-966A-5F228AC5804F.dita"><linktext>Feature Manager
+Notification Tutorials</linktext></link>
+</related-links></task>
\ No newline at end of file