Symbian OS C++ for Mobile Phones VOL 1 PHẦN 10 ppsx

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
ServiceL error handling 646
CGsdpSession class
CanReceivePacket() function 668

destructor 643
GSDP server implementation 642
message handling 644
ReceivePacket() function 668
ChangeMode() function 416
ChangeState() 685
CHARACTER_SET statement 182
charconv.h 132
charconv.lib 132
Chat
GSDP 736
check boxes 306
CheckPackets() function 647, 649
receive queues 666
choice lists, dialogs 306
CHOICELIST structs 294
class diagrams 72
classes 69
framework APIs 63
initializing 162
interfaces 69
library APIs 63
naming conventions 56
UML, describing in 73
cleanup 135
C classes cleanup properties 166
T classes cleanup properties 167
cleanup frameworks 137, 141

user errors 172

cleanup stacks 9
CBase and 159
NewLC() function 164
OOM errors 138, 154
PushL() failure 158
R objects 171
when not to use 158
when to use 155
CleanupClosePushL() function 171
CleanupDeletePushL() function 172
CleanupReleasePushL() function 172
client interfaces 46
GSDP server, launch sequence 673
client rectangle 97
client threads 45
client-server framework 595
APIs 614
CSharableSession class 598
DSession class 598
fixed processes 607
inter-thread data transfer 596
package classes 616
interface versions 621
message passing 596
message slots 621
performance 602
client-side buffering 604
data caching 606
high-level transactions 605
running in same process 606

shared memory 607
requests 597
RSessionBase class 597
servers and threads 610
client-side objects, sharing 611
multithreading 611
thread priorities 613
time-critical applications 612
sessions 598
ClientRect() function 95
clients
datagrams
receiving 664
sending 650
unwrapping 666
GSDP server, connecting to 637
See also client-server framework; servers

software 26
clipping region
CGraphicsContext class 325
Close() function
RGsdpSession class 734
RSessionbase class 600
with CleanupDeletePushL()function 171
CloseWindow() function
CCoeControl abstract class 359
CMdaAudioPlayerUtility 275
CmdHideL() function
CGameAppUI class 531

CMyFleetView 272
CObject class 601, 614
CObjectCon class 614
CObjectConIx class 614
CObjectIx class 614
CodeWarrior debugger
on-target debugging 109
coeaui.h
control stack 389
Collate() function
descriptors 128
Collections 201
color 512
TDisplayMode 516
combo boxes 307
command buttons
dialogs 306
commands
eikcmds.hrh file 96
from menu bar 107
from shortcut keys 108
from toolbar 106
generating from events 375
hellogui with CodeWarrior debugger 106
Uikon and app UI 94
comms
asynchronous 532
awkwardness 533
Battleships program (example) 532
BSP 538

C32 communications server 526
Email 526
ETEL telephony server 526
external formats 533
GDP protocol 535
GSDP 536
introduction 525
pattern re-use 538
protocols 534
reliability 536
RGCP 535

Symbian OS 526
test programs 538
TOGS 533
unreliable 533
Comms application
Email 526
Communication protocols 689
Compact Flash cards see CF cards
Complete() function
RMessage class 645
Complete() function
CSharableSession class 598
CompleteL() 683
complex getter functions 60
component controls 317
CCoeControl abstract class 359
compound controls 347
ComponentControl() function

CCoeControl abstract class 348, 360
compound controls 348
compound controls 317, 380
component controls 347
ComponentControl() function 348
CountComponentControls()function 348
lodger control 347
concrete controls
Uikon 81
concurrency
window server 351
CONE 82
CCoeControl abstract class 81
file server sessions 170
iCoeEnv 414
CONE GUI framework 43
CONE see Control environment
Connect() function
RSessionBase class 598
ConnectL() function
GSDP server, connecting 637
errors 640
launch sequence 672
reliable connections 639
RGsdpSession class 734
implementation 639
consoles
9
const rule
breaking

Draw() function 334
constants 58
Construct() function
RWindowBase class 401
ConstructL()
CRgcpSession class 748
second phase constructor 161
server construction 678
constructor see C++ constructor
Contacts application 265
containers
controls 387 see compound controls
context switching 27
performance issues 603, 606
Continue button
dialogs 294
control context
graphics 367
control environment 50, 357, 382, 385, 388, 390, 391 see also CONE accessing
CCoeControl abstract class 356
CCoeEnv class 357
control factory 308
Control Panel 478
control stack 388
Control() function 303, 309
ControlCaption() function 304
ControlEnv() function
CCoeControl abstract class 357
controller
data

restoring 263
storing 261
GUI environment, accessing 252
MVC 329
Solo ships 251
zooming 253
ControlOrNull() function 303
controls 81, 97
accessing 309
CCoeControl abstract class 317
component controls
317
compound controls 317
dialogs
compound controls 380
control observers 379, 383
control validation 383
custom controls 309
dimmed controls 379, 382
invisible controls 379, 382
using in 308
general-purpose 381
graphics 316
IdOfFocusControl() function 303
iObserver 384
states 379
changes 385
HandleControlState ChangeL() function 385
writing to 384
convenience functions 64

descriptors 127
Converse application
RGCP 751
cooperative multitasking 45
coordinate classes
graphics 322
TPoint class 322
TRect class 322
TSize class 322
COppFleetView 272
Copy() function
descriptors 128
CountComponentControls()function
CCoeControl abstract class 348, 360
compound controls 348
CPermanentFileStore class 449
CPersistentStore class 449
CPU 22
CQikApplication class 92
CQikAppUi class 94, 95
CQikDocument class 93
Create() function 416, 423
RThread class 616
CreateAppUiL() function 93
CreateBackedUpWindowL()function
CCoeControl abstract class 359
CreateContext() function 505
CreateCustomControlL() function 309
dialogs 302
CreateDocumentL() function 91

CreateLocal() function 567
CreateResourceReaderLC()function 193
CreateScreenFont() function 250
CreateSession() function
GSDP server, connecting to 638
CreateSubSession() function
RSubSessionBase class 602
CreateWindowL() function
CCoeControl abstract class 359
CRgcpSession class 745
declaration of 745
functions 748
CSecureStore class 449
CServer class 614, 623
CSession class 598, 614, 624
CSharableSession class 598, 624
CSmsBuffer 694
CSmsMessage 694
CSoundEffects 275
CStreamStore base class 449
CTextView class 505
CTypefaceStore class 510
cue text
dialogs 281
current position
CGraphicsContext class 324
Current() function
CActiveScheduler class 579
cursor movement

DrawTilesNow() function 341
flicker-free redraw 341
cursors 392
custom controls
dialogs 309
D
data
<< and >> operators 432
alignment 773
externalizing 431
handling 484
internalizing 431
naming conventions 58
raw data 434
datagrams 723
queues 731
receive queues 666
receiving 642, 664
See also GSDP datagrams; GDP
datagrams
sending 650, 662
session capability 729
unwrapping 666
data types 53
date editors 307
DBMS
CF cards 40, 415
DeactivateGc() function
CCoeControl abstract class 362
debug keys 775

DEBUGGER() macro 173
debugging
Symbian OS 16
DecrementSessions() function
GSDP server shutdown 678
default heaps 114
threads 36
delayed function calls (DFCs) 33
Delete() function 128
CBufBase class 197
deletes 145
double deletes, problems with 146
Deque() function
CActive class 578
DeregisterView() 271
derivation relationships
UML representation 75
Descriptor arrays 205
descriptors 9, 113
binary data 132
buffer descriptors 116, 118
clearing 128
comparing 127
data manipulation 128
descriptor data, retrieving 127
extracting 128
formatting 129
HBufC concrete descriptor 116
modifying 121
heap descriptors 118

justification 129
letter manipulation
128
literal descriptors 116, 125
pointer descriptors 118
searching 128
setting 128
TDesC abstract class 117
trimming 129
design patterns 72
destructors 145
not needed by T classes 167
Detail views 481
device dependent code 517
device drivers 33
emulator not used 774
device independence
code
device influence on 517
drawing
lines 494
text 501
fonts 495
GDI 507
line drawing 494
rich text view class 505
SIBO 518
view classes
reusing 503
using 501

zooming 517
DFCs 33
DIALOG resource STRUCT 300
dialogs 278, 283, 482
alerts 312
APIs 299
basic functions 301
framework functions 301
library functions 303
basic programming techniques 286
buttons 306
adding 300
check boxes 306
command 306
option 306
CEikDialog class 289
code 289
command handling 94
container behavior 385
controls 283
accessing 309
compound 380
custom controls 309
dimmed 379
, 382
invisible 379, 382
iObserver 384
observers 383
states 379
using 308

validation 383
writing to 384
cue text 281
focus 281
graphics interaction 377
focus 379, 381
key distribution 381
programmer requirements 380
user requirements 377
initializing 290
launching 287
lists 306
modality 284, 288
multi-page dialogs 281
OfferKeyEventL() function 381
processing 284, 295
query dialogs 278, 312
read-only dialogs 293
resource file definition 288
resource specifications 299
single-page dialogs 280
sleeping dialogs 312
standard dialogs 312
stock controls 304
typical elements 286
dictionary file store 451
dictionary stores 451
dictionary write streams 451
digital certificate 474
dimmed controls 382

dialogs 379
direct navigation links 483
directories 417
DiscardBrushPattern() function
CGraphicsContext class 324
DiscardFont() function
CGraphicsContext class 324
Draw() function 320
display modes 514
DLL boundaries 26
DLLs 28, 64
attaching 29
E32Dll() function 91
optimizing 29
startup code 89
writable static data not supported 38
DNL 267, 274
DNLs 483
DoCancel() function 567, 571
CActive class 569, 578
CFlashingHello class 584
GSDP server client interface 636
document class 81, 93
document data streams 443
documents
document files 409
DoInsertL() function 197
draw functions
update functions, do not mix with 340
Draw() function

CCoeControl abstract class 331, 362
CFont* 319
const rule, breaking 334
description 318
DiscardFont() function 320
DrawRect() function 319
DrawText() function 320
graphics 318
graphics context 318
HandleRedrawEvent() function 352
how to draw 333
Leave rule, breaking 334
MVC 331
Rect() function 318
redrawing 331
Shrink() function 318
SystemGc() function 318
UseFont() function 319
views, drawing 237
wasteful redraws, avoiding 333
where to draw 332
DrawArc() function
drawing functions 326
DrawBetweenRects() function 501
DrawBitmap() function
bitmaps 326
drawing functions 326
DrawBorders() function 238
views, drawing 238
DrawComponents() function

CCoeControl abstract class 352
HandleRedrawEvent() function 352
ResetGc() function
353
DrawDeferred() function
CCoeControl abstract class 355, 362
DrawEllipse() function
drawing functions 326
DrawHorizontalBorder() function 238
drawing everything
flicker-free redraw 335
drawing functions
DrawArc() function 326
DrawBitmap() function 326
DrawEllipse() function 326
DrawLine() function 326
DrawLineBy() function 326
DrawLineTo() function 326
DrawPie() function 326
DrawPolygon() function 326
DrawPolyLine() function 326
DrawRect() function 326
DrawRoundRect() function 326
DrawText() function 327
graphics 325
MoveBy() function 325
MoveTo() function 325
Plot() function 325
drawing to windows
DrawTilesNow() function 350

window server 349
DrawLine() function
drawing functions 326
DrawLineBy() function
drawing functions 326
DrawLineTo() function
drawing functions 326
DrawNow() function
CCoeControl abstract class 331, 362
problems with 334
redrawing 331
DrawOutside() function
views, drawing 238
DrawPie() function
drawing functions 326
DrawPolygon() function
drawing functions 326
DrawPolyLine() function
drawing functions 326
DrawRect() function
Draw() function 319
drawing functions 326
DrawRoundRect() function
drawing functions 326
DrawText() function
CGraphicsContext class 325
Draw() function 320
drawing functions 327

DrawTile() function 238, 240

DrawTilesNow() function 350
DrawTilesNow() function
ActivateGc() function 350
BeginRedraw() function 351
CFleetView class 350
cursor movement 341
drawing to windows 350
DrawTiles() function 350
EndRedraw() function 351
flicker-free redraw 339
hit reports 339
Invalidate() function 350
DrawVerticalBorder() function 238
DrawXxxNow() functions
flicker-free redraw 340
scrolling 368
drive mapping
Symbian OS 765
drivers see device drivers
DSession class 598
dynamic buffers 197
Dynamic Link Libraries see DLLs
Dynamic Navigational Link 267
E
E32 31
e32def.h
variable argument lists 208
E32Dll() function 91, 642
e32keys.h
key events 372

E32Main() function 9
error handling framework 10
e32math.h
Math class 208
e32std.h
locale-related classes 206
e32svr.h
RDebug class 210
EActivePriorityIdle 582
EActivePriorityRedraw Events 582
EActivePriorityWsEvents 581
ECOM 652
introduction 652
retrieving protocol information 658
UIDs 655
Edit menu 481
edit windows 289, 307
EditL() function 93
EDWIN 289
EEikCtEdwin control type 289
EEventInteractionRefused event type 385
EEventPointerBufferReady event 395
EEventPrepareFocus
Transition event type 386
EEventRequestFocus 386
eexe.obj stub file 768
efsrv see file server
EIK_APP_INFO resource 101
eikcmds.hrh file
command constants 96

Eikon
porting 519
replacing 519
eikon.hrh file 188
eikon.rh file 188
eikon.rsg file 188
Email 477
Comms application 526
Symbian OS, comms 526
embedded stores 445
embedding
documents 452
emulator 1, 464, 761
.ini file 769
APIs 761
application launcher 2
applications
running on target machine 16
assessment of 772
building projects 13
command line syntax 770
communications 774
crashing
Bluetooth port conflict 772
device drivers not programmed with 774
directory scheme 767
drive mapping 765
GSDP server startup 674
GUI 2
key mapping 770

launching 2
micro-kernel not programmed with
774
source compatibility 763
startup 768
parameters 769
using 1
EndRedraw() function
DrawTilesNow() function 351
RWindow class 402
engines 26
classes 225
ExternalizeL() function 261
testing 175
EnterL() 683
entries
directories 417
ENUM statement 182
enumerated constants 58
EOwnerProcess
GSDP server startup 674
epoc.exe 768
Ericsson MC218 23
error code returns
vs. leave() functions 170
error handling 9, 135
C classes 166
debug keys 139
destructors 145
double allocation 145

double deletes 146
E32Main() function 10
engines, testing 175
error codes 152
GSDP server 645
heap failure 147
leaving 148
reallocating memory 149
leave() function 150
libraries, testing 175
OOM errors 138
panics 138, 143, 173
programming errors 173
R classes
168
T classes 166
user errors 172
Error() function
CActiveScheduler class 576, 580
ErrorL() 683
ErrorOnStateEntry() 684
ErrorOnStateExit() 684
ESOCK 689
ESOCK sockets server 51
Symbian OS, comms 526
ETEL 689
ETEL telephony server 51
Symbian OS, comms 526
ETEXT API 129
euser.dll user library 32, 49