Wiley.Symbian.OS.C.plus.plus.for.Mobile.Phones.Aug.2007 (Symbian Books)

Symbian OS C++ for Mobile PhonesVolume 3Symbian OS C++for Mobile PhonesVolume 3Richard Harrison, Mark ShackmanWithAdi Rome, Alex Wilbur, Andrew Jordan, Douglas Feather,Ernesto Guisado, Hassan Ali, Ioannis Douros, John Pagonis,Lucian Piros, Mark Cawston, Martin Hardman, Mathew Inwood,Rick Martin, Sanjeet Matharu, Tim Williams, Yang ZhangReviewed byGraeme Duncan, Guanyun Zhang, Ian McDowall,Jehad Al-Ansari, Jonathan Allin, Jo Stichbury,Kostyantyn Lutsenko, Lane Roberts, Lars Kurth, Mark Jacobs,Mark Welsh, Mathias Malmqvist, Matthew O’Donnell,Rahul Singh, Ricky Junday, Robert Palmer,Rosanna Ashworth-Jones, Sorin Basca, Tim Labeeuw,Warren Day, Will BambergHead of Symbian PressFreddie GjertsenManaging EditorSatu McNabbCopyright ¤ 2007Symbian Software LtdPublished byJohn Wiley & Sons, Ltd The Atrium, Southern Gate, Chichester,West Sussex PO19 8SQ, EnglandTelephone (+44) 1243 779777Email (for orders and customer service enquiries): cs-books@wiley.co.ukVisit our Home Page on www.wileyeurope.com or www.wiley.comAll Rights Reserved.

No part of this publication may be reproduced, stored in a retrieval system ortransmitted in any form or by any means, electronic, mechanical, photocopying, recording, scanning orotherwise, except under the terms of the Copyright, Designs and Patents Act 1988 or under the terms ofa licence issued by the Copyright Licensing Agency Ltd, 90 Tottenham Court Road, London W1T 4LP,UK, without the permission in writing of the Publisher. Requests to the Publisher should be addressed tothe Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester, WestSussex PO19 8SQ, England, or emailed to permreq@wiley.co.uk, or faxed to (+44) 1243 770620.Designations used by companies to distinguish their products are often claimed as trademarks.

Allbrand names and product names used in this book are trade names, service marks, trademarks orregistered trademarks of their respective owners. The Publisher is not associated with any product orvendor mentioned in this book.This publication is designed to provide accurate and authoritative information in regard to the subjectmatter covered. It is sold on the understanding that the Publisher is not engaged in renderingprofessional services. If professional advice or other expert assistance is required, the services of acompetent professional should be sought.Other Wiley Editorial OfficesJohn Wiley & Sons Inc., 111 River Street, Hoboken, NJ 07030, USAJossey-Bass, 989 Market Street, San Francisco, CA 94103-1741, USAWiley-VCH Verlag GmbH, Boschstr.

12, D-69469 Weinheim, GermanyJohn Wiley & Sons Australia Ltd, 42 McDougall Street, Milton, Queensland 4064, AustraliaJohn Wiley & Sons (Asia) Pte Ltd, 2 Clementi Loop #02-01, Jin Xing Distripark, Singapore 129809John Wiley & Sons Canada Ltd, 6045 Freemont Blvd, Mississauga, Ontario, L5R 4J3, CanadaWiley also publishes its books in a variety of electronic formats. Some content thatappears in print may not be available in electronic books.Library of Congress Cataloging-in-Publication DataHarrison, Richard.Symbian OS C++ for mobile phones / By Richard Harrison.p. cm.Includes bibliographical references and index.ISBN 0-470-85611-4 (Paper : allk.

paper)1. Cellular telephone systems – Computer programs. 2. Operatingsystems (Computers) I. Title.TK6570.M6H295 2003621.3845 6 – dc212003006223British Library Cataloguing in Publication DataA catalogue record for this book is available from the British LibraryISBN: 978-0-470-06641-6Typeset in 10/12pt Optima by Laserwords Private Limited, Chennai, IndiaPrinted and bound in Great Britain by Bell & Bain, GlasgowThis book is printed on acid-free paper responsibly manufactured from sustainableforestry in which at least two trees are planted for each one used for paper production.ContentsAbout the AuthorsxiAcknowledgementsxixSymbian Press AcknowledgmentsxxiAbout this bookxxiiiGlossaryxxvii123Getting Started11.1Using the Emulator1.2Hello World – Text VersionSummary1615A System Introduction to Symbian OS172.1Symbian OS Basics2.2Framework Basics2.3APIs Covered in this BookSummary17303639Symbian OS C++413.13.23.33.43.53.6414349515556Fundamental Data TypesNaming ConventionsFunctionsAPIsTemplatesCastingvi45CONTENTS3.7Classes3.8Design PatternsSummary575960Objects – Memory Management, Cleanupand Error Handling614.1Object Creation and Destruction4.2Class Categories in Symbian OS4.3Error Handling4.4The Cleanup Stack4.5Two-Phase ConstructionSummary626670768185Descriptors875.1Overview5.2Anatomy of Descriptors5.3Literals5.4Stack Descriptors5.5Pointer Descriptors5.6Heap Descriptors5.7Narrow, Wide and Neutral Descriptors5.8Descriptors and Binary Data5.9Using Descriptors with Methods5.10 Some Descriptor Operations5.11 Correct Use of Descriptors5.12 Manipulating DescriptorsSummary6Active Objects6.1The Asynchronous Service6.2Multitasking and Pre-emption6.3A More In-depth Look at Active Objects6.4How It Works6.5Active Object Priorities6.6Active Object Cancellation6.7Starting and Stopping the Scheduler6.8Understanding a Stray Signal6.9Other Common Active Object Errors6.10 Implementing State Machines6.11 Long-Running Tasks and Active ObjectsSummary7Files and the File System7.17.2File-Based ApplicationsDrives and File Types879193939599108109110121128138148151151156158167171176181182187190194200203203204CONTENTS7.3File System Services7.4Streams7.5StoresSummary8Interprocess Communication Mechanisms8.1Overview8.2Client–server IPC8.3Publish and Subscribe IPC8.4Message Queue IPC8.5Which IPC Mechanism Should You Use?Summary9Platform Security and Publishing Applications9.1Releasing an Application9.2How Does Platform Security Work?9.3How Do I Support Platform Security?9.4Preparing an Application for Distribution9.5Overview of Symbian Signed9.5Installing a SIS File9.6List of CapabilitiesSummaryvii20521622423924124124725325725926126326326426626827227928028110 Debugging and the Emulator28310.1 Using the Emulator10.2 Emulator Debugging10.3 Debugging on a Phone10.4 Miscellaneous ToolsSummary28328930630830911 The Application Framework31111.1 Symbian OS Application Framework11.2 S60 and UIQ Platform Application Frameworks11.3 A Graphical Hello WorldSummary31131331533012 A Simple Graphical Application33112.1 Implementing the Game on S6012.2 Differences for UIQ 3Summary33335536613 Resource Files13.113.213.3Why a Symbian-Specific Resource Compiler?Source File SyntaxBitmaps and Icons367367368372viiiCONTENTS13.4 Updating the Resource Files13.5 Application Registration Files13.6 Localizable Strings13.7 Multiple Resource Files13.8 Compiling a Resource File13.9 The Content of a Compiled Resource File13.10 Reading Resource FilesSummary14 Views and the View Architecture14.1 The View Architecture14.2 The MCoeView Interface14.3 Introduction to the Example Application14.4 Creating and Managing the Views14.5 Implementing the MCoeView Interface14.6 Command MenusSummary15 Controls15.1 What Is a Control?15.2 Control Types15.3 Control Layout15.4 Handling Key and Pointer Events15.5 Observing a Control15.6 Drawing a Control15.7 Backed-up Windows15.8 Backed-up-Behind Windows15.9 Dimmed and Invisible ControlsSummary16 Dialogs16.1 What Is a Dialog?16.2 Simple Dialogs16.3 Complex Dialogs16.4 Single-Page Dialogs16.5 Multi-Page Dialogs16.6 Dialog APIs16.7 Stock Controls for Dialogs16.8 Custom Controls in DialogsSummary17 Graphics for Display17.117.2Drawing BasicsThe CGraphicsContext API377378379382383385388389391392397398406408414421423423424429432442444451452454455457457459462464466472475477480481482486CONTENTS17.3 Drawing and Redrawing17.4 Drawing Controls17.5 Sharing the Screen17.6 Support for Drawing in CCoeControl17.7 Special Effects17.8 Window Server Features17.9 Device- and Size-Independent GraphicsSummary18 Graphics for Interaction18.1 Key, Pointer and Command Basics18.2 User Requirements for Interaction18.3 Some Basic Abstractions18.4 Processing Key Events18.5 Processing Pointer Events18.6 Window Server and Control Environment APIsSummaryix49249950251452152652955655755855956156757157658219 Plug-ins and Extensibility58319.1 System Services19.2 What Is a Plug-in?19.3 The ECOM Library19.4 Plug-ins in Symbian OSSummary58358759360360420 Communications and Messaging Services20.1 Communications in Noughts and Crosses20.2 Communication Between Controller and Transport20.3 Serial Communications20.4 Socket-based Communications20.5 Messaging20.6 SecuritySummary21 Multimedia21.1 The Multimedia Framework21.2 The Image Conversion Library21.3 Camera API21.4 Tuner APISummary22 Introduction to SQL RDBMS22.122.2Overview of RDBMSSQL Basics605605606609615632646649651651682699706712715715716xCONTENTS22.3 Symbian SQL Server Component Architecture22.4 Symbian SQL Error CodesSummary729751753Appendix: Developer Resources755References761Index763About the AuthorsRichard Harrison, Lead AuthorRichard spent the first years of his working life teaching mathematics,physics and computer science.

During that time he wrote a Forth languageimplementation for Acorn Computers, and wrote accompanying usermanuals for the Acorn Atom and BBC Micro.He joined Psion in 1983, and worked on a range of documentationand software projects. Amongst other roles, he was the principal designerand author of the Psion Series 3 word processor, and lead author for thePsion SIBO SDK.Richard transferred to Symbian at its inception in 1998, when his initialresponsibility was to build up and lead the System Integration team.