8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE task |
10 <!DOCTYPE task |
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
12 <task id="GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177" xml:lang="en"><title>Handling |
12 <task id="GUID-ADC42872-9A5B-50F2-8A33-6621A8F7C177" xml:lang="en"><title>Handling |
13 Feature Notification </title><shortdesc>How to handle notification of changes to a feature using <apiname>RFeatureControl</apiname>. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
13 Feature Notification </title><shortdesc>How to handle notification of changes to a feature using <codeph>RFeatureControl</codeph>. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
14 <context id="GUID-96D657EC-032D-535E-926A-924CB5D07324"><p>To handle notification |
14 <context id="GUID-96D657EC-032D-535E-926A-924CB5D07324"><p>To handle notification |
15 of changes to a feature using <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref>, take the |
15 of changes to a feature using <xref href="GUID-F6AAAC24-4A62-383A-86C6-2E46335C3FD4.dita"><apiname>RFeatureControl</apiname></xref>, take the |
16 following steps. </p><p/><p> <xref href="GUID-623C4183-00F0-36B0-AE1F-5C5EDCAF1B3D.dita"><apiname>MFeatureObserver</apiname></xref> is an |
16 following steps. </p><p/><p> <xref href="GUID-623C4183-00F0-36B0-AE1F-5C5EDCAF1B3D.dita"><apiname>MFeatureObserver</apiname></xref> is an |
17 interface which you |
17 interface which you implement to react to change notification in whatever |
18 implement to react to change notification in whatever way you choose. It has |
18 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><api-item>HandleNotifyChange()</api-item> takes two arguments: </p><p/><p>a <xref href="GUID-5F29338F-1073-3160-8FDD-E3FD4932F009.dita"><apiname>TFeatureChangeType</apiname></xref> representing |
19 two member functions which you must implement: |
|
20 </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><api-item>HandleNotifyChange()</api-item> |
|
21 takes two arguments: </p><p/><p>a <xref href="GUID-5F29338F-1073-3160-8FDD-E3FD4932F009.dita"><apiname>TFeatureChangeType</apiname></xref> representing |
|
22 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 |
19 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 |
23 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 |
20 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 |
24 one argument, an integer: this integer represents one of the Symbian OS error |
21 one argument, an integer: this integer represents one of the Symbian platform |
25 codes. Any error in the notifier causes the notifier to stop handling notifications. |
22 error codes. Any error in the notifier causes the notifier to stop handling |
26 Your implementation should respond to each of the error types you expect to |
23 notifications. Your implementation should respond to each of the error types |
27 occur. |
24 you expect to occur. </p> </context> |
28 </p> </context> |
|
29 </taskbody><related-links> |
25 </taskbody><related-links> |
30 <link href="GUID-2E33854B-5725-55DE-9B03-7A3100F5A5B5.dita"><linktext>Requesting |
26 <link href="GUID-2E33854B-5725-55DE-9B03-7A3100F5A5B5.dita"><linktext>Requesting |
31 feature notification</linktext></link> |
27 feature notification</linktext></link> |
32 <link href="GUID-926862C4-5E13-5896-B959-0D408C748AB5.dita"><linktext>Cancelling |
28 <link href="GUID-926862C4-5E13-5896-B959-0D408C748AB5.dita"><linktext>Cancelling |
33 feature notification</linktext></link> |
29 feature notification</linktext></link> |