Symbian/C++ Documentation
Areas of interest
Base/System - S60/Symbian C++
S60 Platform: Log Example
This C++ application demonstrates the usage of the Log Engine API provided by Symbian. The API is used to record events of interest to the user, of which they may not be immediately aware, or which are of high importance since costs are incurred, such as telephone calls. These events can be retrieved by a viewer application and displayed to the user. The Log Engine API is supported from S60 2nd Edition onwards. In the updated version, the timestamp offset of the log events has been corrected, backup & restore and scalability support has been added, and the application views have been simplified.
S60 Platform: Chinese Display Example
This C++ application demonstrates how to display Chinese characters
from resource files. The application supports internationalization and localization. In the
updated version also the context-sensitive help has been added.
The application supports following languages:
English, Taiwan Chinese, Taiwan English,
HongKong Chinese, HongKong English,
Mainland Chinese, and Mainland English.
Main classes: TFontSpec, CCnvCharacterSetConverter
Symbian OS Basics - Workbook
This updated Symbian C++ developer training courseware discusses memory and resource management, descriptors, application structure overview, resource and localization files, UI controls, client/server framework, and active object framework. The workbook also describes seven programming exercises (source code of the exercises is published separately in Symbian OS Basics - Lab Exercises package).
Symbian OS Basics - Lab Exercises
These Symbian C++ examples provide exercises and solutions to the following topics: setting up a development environment and building a simple hello world application, Symbian OS basics, memory and resource management, descriptors, application structure overview, resource and localization files, client/server framework, and active object framework. The exercises complement Symbian OS Basics - Workbook training course material.
S60 Platform: Effective Power and Resource Management
Learn how to reduce power and resource consumption in C++ applications without sacrificing their application performance. RAM usage, server design, code efficiency, battery monitoring, and moderate backlight usage are discussed. Available analyzer tools are also presented. The document refers to a separately published example application.
S60 Platform: Document Handler API Developer's Guide
See this C++ document to learn how to use the Document Handler API to show different content in dedicated applications. These handler applications have been registered to be able to handle files with certain MIME types (for example, Notes can handle text format and Image Viewer can show different types of images). In the file opening process, the MIME type recognition is done using Recognizers (implemented as Ecom plugins from S60 3rd Edition onwards). Besides viewing, file operations like move and copy are used in many S60 applications. The document refers to a code example that is available at www.forum.nokia.com.
S60 Platform: Descriptor Example v2.0
This C++ code example demonstrates how to use descriptors (Symbian OS strings) and related APIs. The example is an S60 application that is used to run one or all example methods. The methods write a log to the screen or to a file that demonstrates the results of different statements. Main classes: TBuf, HBufC, RBuf.
S60 Platform: ECom Plug-In Examples v2.0
This package includes two C++ code examples demonstrating how to create and
use an ECom plug-in from a client application. ECom_Shape draws different
figures and ECom_ Calculator performs calculation for two numbers using the
ECom plug-in component. The examples consist of a custom ECom interface, a
DLL plug-in component with actual implementations for the interface, a resolver
(either a default or custom resolver), and a simple GUI client that uses the
interface. Main classes: REComSession, TEComResolverParams, CEikLabel,
CEikEdwin, TResourceReader, CResolver, TImplementationProxy.
S60 Platform: ECom Plug-in Architecture v2.0
This document describes the ECom framework and discusses why and how it should be used. ECom is a client/server framework that provides a service to instantiate, resolve, and destroy plug-ins. Essentially, it means that functionality that is required by a number of applications can be encapsulated in a dll plugin and accessed by multiple clients through an interface class. The document refers to a separately published code example.
S60 Platform: Power and Resource Management Example v2.0
This updated C++ code example demonstrates the APIs that are available for
figuring out battery, charger, and network status. It also demonstrates some of the
techniques and principles described in the document S60 Platform: Effective
Power and Resource Management (available at www.forum.nokia.com), including
the use of active objects and multiple threads. It is recommended that the
document is read before studying the example.
Main classes: CTelephony, RSystemAgent, TSysAgentEvent, CIdle, CActive.
S60 Platform: Document Handler Example
This C++ example demonstrates how to use the Document Handler and the Recognizer to open and handle certain file types in a dedicated application. The example consists of three components: a caller application trying to open a specific file, a recognizer (a dll component implemented as an ECom plugin from S60 3rd Edition onwards) detecting the file extension, and a document handler opening the file. Note that for the recognizer, a developer certificate is needed due to its ProtServ capability requirement. Usage of the document handler is described in the S60 Platform: Document Handler API Developer's Guide document, available at www.forum.nokia.com. Main classes: CDocumentHandler, CApaDataRecognizerType.
S60 Platform: System Initiated Events v2.1
This updated document describes several different common events that a C++ application can capture from a system. It focuses on events beneficial for application developers, for example, UI and domain specific events. The usage of Publish and Subscribe API and Central Repository are also discussed. While the document focuses on the S60 platform, the information is generally applicable to other devices that are based on Symbian OS.
S60 Platform: FEP Example v2.0
This C++ code example demonstrates how to create and install a custom Front End Processor (FEP). It consists of two components: FepSetup, which can be used to install/switch the active FEP, and FepExample, which contains the actual FEP implementation. FepExample contains a sample multi-tap input engine, which modifies the behavior of the mobile phone's numeric keys. Note that because the active FEP is actually loaded by all applications, platform security (introduced in S60 3rd Edition) requires ALL-TCB capabilities, and thus the FepExample component has to be signed using the Manufacturer Approved Developer Certificate. Note also that FEP might not be compatible with all S60 applications. The known issues are described in the release notes in the example package. The example includes an AknEditStateIndicator.h header that is needed to define MAknEditingStateIndicator. The header was not available in the S60 SDKs until S60 3rd Edition, Feature Pack 1. Main classes: CCoeFep, CCoeFepPlugIn, CFepGenericGlobalSettings, MAknEditingStateIndicator.
S60 Platform: Time Zone Localizer Example
This C++ code example demonstrates how to convert UTC time to local time using the time zone server (RTz) and how to add/remove or find a city from the database using TZLocalizer API. These APIs were introduced in Symbian OS v.9.1 (S60 3rd Edition). In earlier releases the WorldServer API can be used for similar functions. Main classes: RTz, CTzLocalizer
S60 Platform: System Information Example v2.0
This C++ code example demonstrates how to retrieve system information such as software and language versions, running applications, active profile, and battery and network status information. For some of these tasks, the APIs are different for S60 2nd and 3rd Edition. Main classes: HAL, CRepository, CTelephony, CSettingInfo, RSystemAgent.
S60 Platform: Thread And Active Objects Example v1.1
This updated package includes a C++ example that demonstrates how to create an active scheduler and how to use active objects inside a new thread. Documentation is included in the package.
S60 Platform: Multiple Threads Example v1.1
This package includes a C++ Thread example program that demonstrates thread usage and synchronization. A document explaining the use of threads in Symbian OS is included in the package.
Symbian OS: Threads Programming
This document explains the use of threads in Symbian OS. When using threads, synchronization and mutual exclusion must be considered in order to get thread interactions safe.
Symbian OS: Active Objects And The Active Scheduler (With Example) v1.0
This document provides a general introduction to active objects and multitasking in Symbian OS.
