quick_recipes (Symbian Books)

Quick Recipeson Symbian OSMastering C++ Smartphone DevelopmentQuick Recipeson Symbian OSMastering C++ SmartphoneDevelopmentMichael AubertWithAlexey Gusev, Tanzim Husain, Jenny Mulholland,Antony Pranata, Jukka Silvennoinen, Jo StichburyReviewed bySandip Ahluwalia, Ashlee Godwin, Douglas Feather,Maximiliano R. Firtman, Matthew O’Donnell, Tong Ren,Attila Vamos, Jacek Wojciechowski, Colin Ward,Hamish WilleeHead of Symbian PressFreddie GjertsenManaging EditorSatu McNabbCopyright  2008John 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 or transmitted in any formor by any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except under the terms of theCopyright, Designs and Patents Act 1988 or under the terms of a 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 thePublisher should be addressed to the Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate,Chichester, West Sussex 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.

All brand names andproduct names used in this book are trade names, service marks, trademarks or registered trademarks of their respectiveowners. The Publisher is not associated with any product or vendor mentioned in this book.This publication is designed to provide accurate and authoritative information in regard to the subject matter covered. Itis sold on the understanding that the Publisher is not engaged in rendering professional services.

If professional advice orother expert assistance is required, the services of a competent professional should be sought.The Publisher and the Author make no representations or warranties with respect to the accuracy or completeness of thecontents of this work and specifically disclaim all warranties, including without limitation any implied warranties offitness for a particular purpose. The advice and strategies contained herein may not be suitable for every situation. Inview of ongoing research, equipment modifications, changes in governmental regulations, and the constant flow ofinformation relating to the use of experimental reagents, equipment, and devices, the reader is urged to review andevaluate the information provided in the package insert or instructions for each chemical, piece of equipment, reagent, ordevice for, among other things, any changes in the instructions or indication of usage and for added warnings andprecautions.

The fact that an organization or Website is referred to in this work as a citation and/or a potential source offurther information does not mean that the author or the publisher endorses the information the organization or Websitemay provide or recommendations it may make. Further, readers should be aware that Internet Websites listed in this workmay have changed or disappeared between when this work was written and when it is read. No warranty may be createdor extended by any promotional statements for this work. Neither the Publisher nor the Author shall be liable for anydamages arising herefrom.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 that appearsin print may not be available in electronic books.Library of Congress Cataloging-in-Publication DataAubert, Michael.Quick recipes on Symbian OS : mastering C++ smartphone development /Michael Aubert, with Alexey Gusev . . .

[et al.]p. cm.Includes bibliographical references and index.ISBN 978-0-470-99783-3 (pbk. : alk. paper)1. Smartphones – Programming. 2. Symbian OS (Computer file) 3. C++(Computer program language) I. Gusev, Alexey. II. Title.TK6570.M6A92 2008005.26 8 – dc222008013156British Library Cataloguing in Publication DataA catalogue record for this book is available from the British LibraryISBN: 978-0-470-99783-3Typeset 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 sustainable forestryin which at least two trees are planted for each one used for paper production.Pour Marcel et PauletteContentsList of RecipesixForewordxvAbout this BookxviiAbout the AuthorsxixAcknowledgmentsxxiiiSymbian OS Code Conventions and NotationsUsed in the Book1 Introduction and Setup1.11.21.3Tools: What You Need and Where to Find ItWhile You are WaitingPost-Installation2 Quick Start2.12.22.32.42.52.62.72.82.9Hello World Project TemplateRunning Carbide.c++ IDEGenerating the Hello World ProjectBuilding the Hello World ProjectRunning the Hello World Application on theEmulatorRunning the Hello World Application on the DeviceModifying the Hello World ProjectAdvanced Topics on Carbide.c++Linksxxv113699910131416182126viiiCONTENTS3 Symbian OS Development Basics3.13.23.33.43.53.63.73.83.93.103.113.123.133.143.153.163.173.18Fundamental Data Types on Symbian OSSymbian OS Class ConventionsLeaves and Exception HandlingThe Cleanup StackThe Cleanup Stack FAQ: Advanced InformationTwo-Phase ConstructionThin TemplatesDescriptors – Symbian OS StringsArrays on Symbian OSExecutable FilesPlatform Security: CapabilitiesPlatform Security: Data CagingStack Size and Heap SizeStreamsActive ObjectsThreadsTimers and CallbacksSummary4 Symbian C++ Recipes4.14.24.34.44.54.64.74.84.94.10File HandlingContacts and CalendarNetworkingMessagingGraphics and Drawing3D Graphics Using OpenGL ESMultimediaTelephonyConnectivityLocation-Based Services5 Next Level Development5.15.25.3Advanced TechnologiesSymbian Partners OnlyAdvanced Application Deployment6 Releasing Your Application6.16.26.3IndexWhat To Do Before You Release Your ApplicationHow To Distribute Your ApplicationWhere To Go Next292930333638404244545860626263657374757778106136172194217236263282299319319325326329329341345349List of Recipes4.1 File Handling4.1.14.1.24.1.3Easy Recipes4.1.1.1Get A File Server Session4.1.1.2Write Binary Data to a File4.1.1.3Read Binary Data from a File4.1.1.4Read Text from a FileIntermediate Recipes4.1.2.1Get the Path of a Private Folder4.1.2.2Read from and Write to a File Stream4.1.2.3Read and Write Class Members fromand to a File StreamAdvanced Recipes4.1.3.1Read from and Write to a File Store4.1.3.2Share Files between Processes4.2 Contacts and Calendar4.2.34.2.4Easy Recipes4.2.3.1Write Data to a Contact4.2.3.2Read Data from a Contact4.2.3.3Add a New Contact4.2.3.4Remove a Contact4.2.3.5Modify a Calendar Event4.2.3.6Add a New Calendar Event4.2.3.7Remove a Calendar EventIntermediate Recipes4.2.4.1Sort Contacts4.2.4.2Use the vCard Format4.2.4.3Use the vCal Format787979808285868690969898104106109109111113114115117120121121122124xLIST OF RECIPES4.2.54.2.4.4Create a Repeating Calendar EventAdvanced Recipes4.2.5.1Find a Contact4.2.5.2Move a Contact to Another Group4.2.5.3Find Out If You are Available4.2.5.4Get Attendee List4.3 Networking4.3.54.3.64.3.7136Easy Recipes4.3.5.1Send/Receive Data Using TCP Sockets4.3.5.2Force a Connection to Use a SpecificBearer4.3.5.3Force a Connection to Use a SpecificIAP4.3.5.4Resolve Domain Name4.3.5.5Use HTTP GET Request4.3.5.6Parse a URI4.3.5.7Create a URIIntermediate Recipes4.3.6.1Listen for an Incoming ConnectionUsing TCP4.3.6.2Observe Connection Status4.3.6.3Get Active Connection Information4.3.6.4Use Secure Socket4.3.6.5Use HTTP POST Request4.3.6.6Set Advanced HTTP Properties4.3.6.7Extract Local Filename from URIAdvanced Recipes4.3.7.1Retrieve HTTP Proxy Information4.4 Messaging4.4.5Recipes4.4.5.14.4.5.24.4.5.34.4.5.44.4.5.54.4.5.64.4.5.74.4.5.84.4.5.94.4.5.104.4.5.11126128128131133134142142145146148150153154157157159161162164167168169169172177Initialize your Application to UseMessagingCreate a FolderCreate a MessageRead Message DetailsEdit a MessageRetrieve and Edit Message SettingsCopy a MessageMove a MessageSend a MessageDelete MessagesHandle Incoming Messages177180182183185187188189190191192LIST OF RECIPES4.5 Graphics and Drawing4.5.14.5.24.5.3Easy Recipes4.5.1.1Draw Lines and Shapes4.5.1.2Draw Background Color or Fill a Shape4.5.1.3Load and Draw MBM or MIF Images4.5.1.4Draw an Image with a TransparentSectionIntermediate Recipes4.5.2.1Load a JPG or PNG Image4.5.2.2Draw Text to the Screen4.5.2.3Load Fonts4.5.2.4Draw Controls Inside Another ControlAdvanced Recipes4.5.3.1Use Off-Screen Images for Drawing4.5.3.2Load GIF Animation Images4.5.3.3Draw Skins as Backgrounds (S60 Only)4.5.3.4Draw Outside the Symbian OSApplication Framework4.5.3.5Draw with Direct Screen Access4.6 3D Graphics Using OpenGL ES4.6.34.6.44.6.5Easy Recipes4.6.3.1Full-Screen Setup4.6.3.2Display a 3D Object4.6.3.3Translate a 3D Object4.6.3.4Rotate a 3D ObjectIntermediate Recipes4.6.4.1Apply a Texture to a 3D Object4.6.4.2Part-Screen SetupAdvanced Recipes4.6.5.1Animate a Scene4.6.5.2Adapt Performances4.7 Multimedia4.7.14.7.2Easy Recipes4.7.1.1Play an Audio Clip4.7.1.2Perform Basic Audio Operations4.7.1.3Play an Audio Tone4.7.1.4Play a MIDI FileIntermediate Recipes4.7.2.1Get the Default Multimedia StorageLocation4.7.2.2Play a Video Clip4.7.2.3Audio Streamingxi194197197198199200201201203205206208208209211213216217219219222226227228228229231231234236238238241242243244244247250xiiLIST OF RECIPES4.7.3Advanced Recipes4.7.3.1Record Audio4.7.3.2Record a Phone Call4.7.3.3Display a Camera Viewfinder4.7.3.4Capture Still Images from a Camera4.7.3.5Record Video4.8 Telephony4.8.14.8.24.8.3Easy Recipes4.8.1.1Handle Phone Calls4.8.1.2Send DTMF Tones to the Phone Line4.8.1.3Observe the Phone Line State4.8.1.4Retrieve the Network Signal Strength4.8.1.5Retrieve the Battery Status4.8.1.6Retrieve the IMEI Number of the Device4.8.1.7Retrieve the Current Network Name4.8.1.8Retrieve the Current Operator Name4.8.1.9Retrieve the Flight Mode Status4.8.1.10 Retrieve the Network Registration StatusIntermediate Recipes4.8.2.1Retrieve the Phone Number from anIncoming/Outgoing Call4.8.2.2Match a Name to a Phone Number4.8.2.3Retrieve the IMSI Number of the SIMCard4.8.2.4Retrieve the Phone Lock StatusAdvanced Recipes4.8.3.1Retrieve Cell ID and NetworkInformation4.8.3.2Retrieve Call Forwarding Status4.8.3.3Retrieve Call Barring Status4.9 Connectivity4.9.14.9.2Easy Recipes4.9.1.1Print over IrDA4.9.1.2Discover Infrared Devices4.9.1.3Discover Bluetooth Devices4.9.1.4Discover Bluetooth Services for a GivenDeviceIntermediate Recipes4.9.2.1Use the Sockets API4.9.2.2Create a Simple OBEX Client4.9.2.3Create a Simple OBEX Server overBluetooth253253255255258260263268268269269271271272273273274275276276276277278279279280281282283283284286288290290294295LIST OF RECIPES4.9.3Advanced Recipes4.9.3.1Advertise Bluetooth Services4.10Location-Based Services4.10.1 Easy Recipes4.10.1.1 Get the List of Available PositioningTechnology Modules4.10.1.2 Retrieve the Current Module StatusInformation4.10.1.3 Receive Module Status ChangeNotifications4.10.1.4 Set the Module Selection Criteria4.10.2 Intermediate Recipes4.10.2.1 Request Location Information4.10.2.2 Request Extended Location Informationxiii297297299302302304305308310310315ForewordDavid Wood, Executive Vice President Research, SymbianThis book has been designed for people who are in a hurry.Perhaps you are a developer who has been asked to port some software,initially written for another operating system (such as may run on adesktop computer), to Symbian OS.