Symbian3/PDK/Source/GUID-086939FA-D381-5705-BEE6-6DF2D3624849.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Fri, 22 Jan 2010 18:26:19 +0000
changeset 1 25a17d01db0c
child 5 f345bda72bc4
permissions -rw-r--r--
Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608

<?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-086939FA-D381-5705-BEE6-6DF2D3624849" xml:lang="en"><title>Timers
and Timing Services Example Code</title><shortdesc>This example describes how to use <apiname>RTimer</apiname> functions.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<ul>
<li id="GUID-9D1268CE-9D9F-5B51-A578-772937196CD7"><p> <xref href="GUID-086939FA-D381-5705-BEE6-6DF2D3624849.dita#GUID-086939FA-D381-5705-BEE6-6DF2D3624849/GUID-3205DDD3-D057-56BF-8F64-CF1AFF52619B">BasicTimer: the asynchronous timer</xref> </p> </li>
<li id="GUID-044A87AB-3F8E-575F-9220-6C07FB0BC952"><p> <xref href="GUID-086939FA-D381-5705-BEE6-6DF2D3624849.dita#GUID-086939FA-D381-5705-BEE6-6DF2D3624849/GUID-0554FACD-5075-5C8D-8634-F60D31D1EDB7">Periodic: a periodic timer and a heartbeat timer</xref> </p> </li>
</ul>
<section id="GUID-3205DDD3-D057-56BF-8F64-CF1AFF52619B"><title>BasicTimer:
the asynchronous timer</title> <p><b>Download</b> </p> <p>Click the following
link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-0feaa43f-bf66-4a6c-b61b-f768f6524d22.zip" scope="external">BasicTimer.zip</xref>.</p><p>Click the following link to
download additional files: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.zip" scope="external">CommonFramework.zip</xref></p><p>Click <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-0feaa43f-bf66-4a6c-b61b-f768f6524d22.html" scope="peer">browse BasicTimer</xref> to view the example code.</p><p>Click <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.html" scope="peer">browse CommonFramework </xref> to view additional files.</p> <p><b>Description</b> </p> <p>This
example demonstrates the asynchronous timer, <codeph>RTimer</codeph>. The
example does <i>not</i> use active objects. </p><p><b>Class summary</b></p><ul>
<li><p><xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita"><apiname>RTimer</apiname></xref> - Asynchronous timer services.</p></li>
<li><p><xref href="GUID-E0B34F3E-D4C4-3232-B8B1-7DB35B454646.dita"><apiname>TRequestStatus</apiname></xref> - Indicates the completion status
of a request made to a service provider.</p></li>
</ul> <p><b>Security issues</b> </p> <p>The example requires no specific capabilities
in order to run - and does not demonstrate any security issues. </p> </section>
<section id="GUID-0554FACD-5075-5C8D-8634-F60D31D1EDB7"><title>Periodic: a
periodic timer and a heartbeat timer</title> <p><b>Download</b> </p> <p>Download
the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-3195c0fc-704f-4fd4-8c99-407f795abc5f.zip" scope="external">Periodic.zip</xref>. </p><p>Download some additional files
required by the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.zip" scope="external">CommonFramework.zip</xref></p><p>View the source code: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-3195c0fc-704f-4fd4-8c99-407f795abc5f.html" scope="peer">browse</xref>. View the additional file: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.html" scope="peer">browse</xref></p> <p><b>Description</b> </p> <p>The example demonstrates
a periodic and a heartbeat timer and shows the differences between them. </p><p><b>Class
summary</b></p><ul>
<li><p><xref href="GUID-8D6075C7-A340-36A6-A152-0E3E76070311.dita"><apiname>CHeartBeat</apiname></xref></p></li>
<li><p><xref href="GUID-3CECC9FC-58C1-3117-AAF2-FDF88341F56F.dita"><apiname>CPeriodic</apiname></xref> - Periodic timer active object.</p></li>
</ul> <p><b>Security issues</b> </p> <p>The example requires no specific capabilities
in order to run - and does not demonstrate any security issues. </p> </section>
</conbody></concept>