event handling threads 569 events, detecting 570 functionality, adding 576 starting 575 stopping 575 adapters GSDP 642 Add() function CActiveScheduler class 579 AddDir() function directory qualifier, adding 419 address fields dialogs 295 address spaces 27 AddWindowShadow() function CEikonEnv class 364 shadows 364 After() function User class 196 with random number generator 233 AIF Builder 465 AIFs compared to resource files 468 creation 467 file 466 aiftool 465, 469, 484 summary 484 alerts dialogs 312 Alloc() function User class 195 allocation 145 reallocating memory 149 AllocL() function User class 195 AllocLC() descriptor classes 117 AllocMyNextPort() function RGsdpSession class 734 AllocReadResourceL() function 193 AllocReadResourceLC() function 193 animation graphics 365 animation DLL graphics 366 API of CGraphicsContext class 320 APIs 48, 63 client-server 614 dialog APIs 299 DLLs 64 ETEXT 129 exported functions 65 file server 412, 413 sessions 413 FORM 129 functions, types 63 on emulator 761 stream store 412 UML, describing in 73 virtual functions 66 app UI class 82 command handling 94 Solo ships example 264 app view class 82, 97 controls 97 APPARC 82 AppDllUid() function 91 Append() function 120, 128 AppendFormat() function descriptors 129 AppendFormatList() function 208 Application menu 481 style 479 application architecture 51 command handling 94 DLL startup code 89 file server 413 hellogui with CodeWarrior debugger 104 command handling 106 event handling 106 launching 105 terminating 109 streams program 419 system files 409 user files 409 application class 81 application icon 465 color 466 size 466 application identifier stream 443 application information files see AIF Application Launcher 465, 478 application launcher emulator 2 Application Programming Interfaces see APIs application-initiated redraws 328 applications application structure 81 defined 26 delivering to users 479 launching 30 OOM errors 137 processes 26 time-critical applications 612 Application Launcher 469 apprun.exe 89 arguments 59 ARM data alignment 773 ARMI 111, 470 arrays dynamic buffers 200 assert macros 174 asynchronous requests 600 cancel functions 637 handling 648 SendReceive() function 600 Asynchronous request SendReceive() 634 At() function User class 196 automatics 59 Index B backed-up windows window server 354 backed-up-behind windows 108 backing up behind graphics 364 BAFL resource files 51 APIs for reading resources 192 updating 773 barsc.h RResourceFile class 192 barsread.h TResourceReader class 193 Battleships program (example) comms 532 BSP 538 GDP protocol 535 GSDP 536 GSDP see GSDP protocols 534 RGCP 535 TOGS 533 dialogs read-only 294 see also Solo ships without comms menu 530 object-oriented plumbing 532 view 530 Battleships Protocol see BSP Battleships Protocol see BSP BeginRedraw() function DrawTilesNow() function 351 RWindow class 402 binary data 132 BitBlt() function blitting 509 BITGDI 81 rasterizing 507 Bitmap Converter tool 464 bitmaps 456 blitting 507 CFbsBitmap class 508 colour depths 458 conversion 458 disadvantages 508 display modes 514 DrawBitmap() function 326 , 508 GDI 507 GetScanLine() function 508 masks 457 shared memory 607 blank state BSP 752 GSDP Chat 737 bldmake 463 blitting BitBlt() function 509 GDI 507 Bluetooth 471, 477, 681 Bluetooth Security Manager 712 bmconv 484 Boolean data type 55 Boss Puzzle direct file stores 441 bound state GSDP Chat 737 RGCP 743 brush CGraphicsContext class 324 BSP 752 CGameController 759 comms 538 first-move arbitration 758 game UI 759 improvements 760 requests 756 responses 756 scenarios 756 states 752 transitions 753 TOGS 538 BT.PRT 702 buffer descriptors 116, 118 HBufC 116 buffers CBufBase class 197 build tools 484 builds for emulator 13 in IDE 15 button bar 456 buttons 306 command button 306 dialogs 300 C C classes 56, 166 cleanup properties 166 operator new() 147 C Standard Library 170, 211 C Standard Library see STDLIB C++ destructors 145 Hello World example 7, 83 in Symbian OS 53 APIs 63 bad practices 71 casting 68 classes 69 data types 53 design patterns 72 functions 61 naming conventions 56 multiple inheritance 70 object orientation and 53 strings 115 modifying 119 C++ constructor 64 active object classes 566 class initialization 162 leaving functions 161 two-phase construction pattern 159 first phase constructors 162 second phase constructors 161, 162 C32 communications server Symbian OS, comms 526 CActive 683 CActive class 563 Cancel() function 567, 569 implementation of 572 constructor 566 declaration 576 DoCancel() function 567, 569 functions 578 TPriority enumeration 581 CActive() function 578 CActiveScheduler class definition 579 Error() function 576 functions 579 Start() function 575 Stop() function 575 WaitForAnyRequest() function 576 CActiveScheduler() function 579 callbacks see framework functions Cancel() 683 Cancel() function CActive class 567, 569, 578 implementation of 572 Cancel/OK buttons 290 code 290 dialogs 288 CancelClippingRect() function CGraphicsContext class 325 CancelReceive() function asynchronous requests 637 CGsdpSession 650 CanReceivePacket() function 668 captions 468 cardinality UML representation 75 CArrayFixFlat<T> 200 CArrayFixSeg<T> 200 casting 68 CBase cleanup stack and 159 zero initialization 147 CBitmapContext 509 CBitmapDevice 509 CBufBase class 197 CBufFlat 197 CBufSeg 198 allocating 199 CBufStore class 449 CCoeAppUi class 399 CCoeControl abstract class 81 ActivateGc() function 350, 362 ActivateL() function 362 CFleetView class 350 CloseWindow() function 359 component controls 359 ComponentControl() function 348, 360 control environment, accessing 356 ControlEnv() function 357 controls 98, 317 dimming 382 CountComponentControls()function 348, 360 CreateBackedUpWindowL()function 359 CreateWindowL() function 359 DeactivateGc() function 362 Draw() function 331, 362 DrawComponents() function 352 DrawDeferred() function 355, 362 DrawNow() function 331, 362 focus-related functions 391 Index() function 360 IsActivated() function 362 IsBackedUp() function 359 IsBlank() function 362 IsReadyToDraw() function 362 IsVisible() function 362 lodger control 358 MakeVisible() function 362 OwnsWindow() function 359 position 360 Position() function 361 PositionChanged() function361 CCoeControl abstract class PositionRelativeTo Screen()function 361 ProcessPointerEventL()function 386 Rect() function 318, 361 ResetGc() function 362 SetBlank() function 362 SetContainerWindow() function 358 SetContainerWindowL()function 358 SetCornerAndSizeL() function 361 SetExtentL() function 361 SetExtentToWhole ScreenL()function 361 SetPosition() function 361 SetRectL() function 361 SetSizeL() function 361 SetSizeWithout NotificationL() function 361 size 360 Size() function 361 SizeChangedL() function 361 support for drawing 356 SystemGc() function 318, 362 Window() function 344 window-owning control 358 CCoeEnv class 398 control environment 357 Flush() function 358, 365 FsSession() function 357 NormalFont() function 357 Static() function 357 CCoeViewManager 269 CDirectFileStore class 449 CEditableText 505 dynamic buffers 201 CEikApplication class 92 CEikAppUi class 94, 95 CEikDialog class 289, 301 MakeLineVisible() function 298 CEikDocument class 93 CEikListBox class 307 CEikonEnv class AddWindowShadow() function 364 CEmbeddedStore class 449 Certificate Authority 472 certificate file 472 Certificate Generator 472 certificate request 472, 473 Certification Authority 474 CF cards 40 CFbsBitmap 272 CFbsBitmap class 509 CFileStore class 449 CFleetView class CCoeControl abstract class 350 DrawTilesNow() function 350 key events 370 pointer events 373 pick correlation 393 SetZoomL() function 245 CFleetViewData 272 CFont class 496 CFont* Draw() function 319 screen fonts 510 CGameAppUI class CmdHideL() function 531 CGameController BSP protocol 759 ViewCmdHitFleet() function 532 CGameController class 251 Solo ships 222, 225 CGameEngine class 234 Solo ships 225 CGdpBTComms 705 CGdpBTReceiver 703 CGdpBTSender 703 CGdpBtStateMachine 703 CGdpLoopback class 727 CGdpSession 682, 690 CGdpSmsComms 690 CGdpSmsReceiver 690 CGdpSmsResourceManager 690 CGdpSmsSender 690 CGdpStateMachine 683 CGraphicsContext class 491 API 320 BITGDI 507 bitmap drawing functions 509 brush 324 CancelClippingRect() function 325 clipping region 325 colors 513 current position 324 DiscardBrushPattern()function 324 DiscardFont() function 324 DrawText() function 325 fonts 324 graphics context 318, 323 justification 325 MoveBy() function 324 MoveTo() function 324 origin 324 pen 323 Reset() function 325 SetBrushColor() function 324 SetBrushOrigin() function 324 SetBrushPattern() function 324 SetBrushStyle() function 324 SetClippingRect() function 325 SetOrigin() function 324 SetPenColor() function 324 SetPenSize() function 324 SetPenStyle() function 324 SetStrikeThroughStyle()function 324 SetUnderlineStyle() function 324 UseFont() function 324 CGraphicsDevice CreateContext() function 505 CGraphicsDevice class 488, 492 CGsdpDelayedShutdown class 679 CGsdpGdpAdapter class 642 CGsdpProtocolUpdater 655 CGsdpReceiveHandler active object 732 datagrams, receiving 664 GSDP client interface 633 CGsdpScheduler class LaunchFromClient() function 640 ThreadStart() function 680 CGsdpServer class 643 ConstructL() function server construction 678 DecrementSessions() function 678 error handling 645 IncrementSessions() function 678 PanicClient() function 645 SessionForPacket() function 667 CGsdpServer::RunError [...]... data, retrieving 12 7 extracting 12 8 formatting 12 9 HBufC concrete descriptor 11 6 modifying 12 1 heap descriptors 11 8 justification 12 9 letter manipulation 12 8 literal descriptors 11 6, 12 5 pointer descriptors 11 8 searching 12 8 setting 12 8 TDesC abstract class 11 7 trimming 12 9 design patterns 72 destructors 14 5 not needed by T classes 16 7 Detail views 4 81 device dependent code 517 device drivers 33 emulator... classes cleanup properties 16 6 T classes cleanup properties 16 7 cleanup frameworks 13 7, 14 1 user errors 17 2 cleanup stacks 9 CBase and 15 9 NewLC() function 16 4 OOM errors 13 8, 15 4 PushL() failure 15 8 R objects 17 1 when not to use 15 8 when to use 15 5 CleanupClosePushL() function 17 1 CleanupDeletePushL() function 17 2 CleanupReleasePushL() function 17 2 client interfaces 46 GSDP server, launch sequence 673... 16 6 debug keys 13 9 destructors 14 5 double allocation 14 5 double deletes 14 6 E32Main() function 10 engines, testing 17 5 error codes 15 2 GSDP server 645 heap failure 14 7 leaving 14 8 reallocating memory 14 9 leave() function 15 0 libraries, testing 17 5 OOM errors 13 8 panics 13 8, 14 3, 17 3 programming errors 17 3 R classes 16 8 T classes 16 6 user errors 17 2 Error() function CActiveScheduler class 576, 580 ErrorL()... CPU 22 I/O devices 22 RAM 22 ROM 22 Symbian OS devices 22 has-a class relationships 69 UML representation 74 HBufC concrete descriptor 11 6 modifying 12 1 header files resource files 10 0 heap balance check 14 3 heap descriptors 11 8 heap failure tool 13 9 with test functions 17 6 heaps _UHEAP_MARK macro 14 3 failure 14 7 reallocating memory 14 9 heap balance 14 2 memory 11 4 threads 36 Hello World example active... 11 4 threads 36 delayed function calls (DFCs) 33 Delete() function 12 8 CBufBase class 19 7 deletes 14 5 double deletes, problems with 14 6 Deque() function CActive class 578 DeregisterView() 2 71 derivation relationships UML representation 75 Descriptor arrays 205 descriptors 9, 11 3 binary data 13 2 buffer descriptors 11 6, 11 8 clearing 12 8 comparing 12 7 data manipulation 12 8 descriptor data, retrieving 12 7... directories 417 file system drivers 416 filenames 417 files 416 copying to emulator 773 sessions 413 RFs 414 vs L functions 17 0 filenames manipulating 417 parsing 429 files 39, 416 copying to emulator 773 data de-serializing 4 31 serializing 4 31 data, reading 427 TDes8 416 writing 4 21 Fill() functions descriptors 12 8 FillZ() function OOM errors 14 8 Find() function descriptors 12 8 finished state BSP 753 first-phase... EIK_APP_INFO resource 10 1 eikcmds.hrh file command constants 96 Eikon porting 519 replacing 519 eikon.hrh file 18 8 eikon.rh file 18 8 eikon.rsg file 18 8 Email 477 Comms application 526 Symbian OS, comms 526 embedded stores 445 embedding documents 452 emulator 1, 464, 7 61 ini file 769 APIs 7 61 application launcher 2 applications running on target machine 16 assessment of 772 building projects 13 command line... CleanupDeletePushL()function 17 1 CloseWindow() function CCoeControl abstract class 359 CMdaAudioPlayerUtility 275 CmdHideL() function CGameAppUI class 5 31 CMyFleetView 272 CObject class 6 01, 614 CObjectCon class 614 CObjectConIx class 614 CObjectIx class 614 CodeWarrior debugger on-target debugging 10 9 coeaui.h control stack 389 Collate() function descriptors 12 8 Collections 2 01 color 512 TDisplayMode 516 combo boxes... font system 510 screen fonts 510 small fonts 500 TFontSpec class 498 TFontSpec to CFont*, mapping 497 FORM API 12 9 Format() function descriptors 12 9 FormatList() function 209 framework APIs 63 framework functions 63 dialogs 3 01 FRand() function random number generation 233 Free() function User class 19 5 FsSession() function CCoeEnv class 357 Function() function RMessage class 645 functions 61 C++ constructor... file 84 UIDs 86 GUI Environment accessing 252 GUIs app UI class 94 device-specific 5 21 inflexibility 523 menus 5 pen-based 6 porting 519 reference designs 5 21 replacing 519 Uikon 79, 5 21, 523 H HandleCommandL() function 94 app UI class 82 from menu bar 10 7 from shortcut keys 10 8 from tool bar 10 6 in hellogui example 10 6 request functions 568 HandleControlState ChangeL()function 385 dialogs 302 HandlePointerBuffer . retrieving 12 7 extracting 12 8 formatting 12 9 HBufC concrete descriptor 11 6 modifying 12 1 heap descriptors 11 8 justification 12 9 letter manipulation 12 8 literal descriptors 11 6, 12 5 pointer. errors 17 2 cleanup stacks 9 CBase and 15 9 NewLC() function 16 4 OOM errors 13 8, 15 4 PushL() failure 15 8 R objects 17 1 when not to use 15 8 when to use 15 5 CleanupClosePushL() function 17 1 CleanupDeletePushL(). startup code 89 file server 413 hellogui with CodeWarrior debugger 10 4 command handling 10 6 event handling 10 6 launching 10 5 terminating 10 9 streams program 419 system files 409 user files