Tutorial.book

Christopher Raff

Informations

• Publié par: Vaun
• Nombre de lectures: 30
• Langue: English

Extrait

Welcome to the
Palm OS 2.0 Tutorial
for Windows
Navigate this online document as follows:
To see bookmarks Type Control-7
To see information on Tol-?
Adobe Acrobat Reader
To navigate Click on:
any blue hypertext link
any Table of Contents entry
arrows in the menu bar
¤U.S. Robotics
Palm OS“ 2.0 Tutorial
for Windows
Some information in this manual may be out of date.
Read all Release Notes les for the latest information.
'1996, 1997 U.S. Robotics, Inc. All rights reserved.
Documentation stored on the compact disk may be printed by licensee for personal use.
Except for the foregoing, no part of this documentation may be reproduced or transmit-
ted in any form by any means, electronic or mechanical, including photocopying, record-
ing, or any information storage and retrieval system, without permission in writing from
U.S. Robotics.
U.S. Robotics, the U.S. Robotics logo and Graf ti are registered trademarks, and Palm
Computing, HotSync, the Palm OS, and the Palm OS logo are trademarks of U.S. Robot-
ics and its subsidiaries.
All other trademarks or registered trademarks are the property of their respective
owners.
ALL SOFTWARE AND DOCUMENTATION ON THE COMPACT DISK ARE SUBJECT
TO THE LICENSE AGREEMENT.
Contact Information:
Metrowerks U.S.A. and interna- Metrowerks Corporation
tional 2201 Donley Drive, Suite 310
Austin, TX 78758
U.S.A.
Metrowerks Canada Metrowerks Inc.
1500 du College, Suite 300
Ville St-Laurent, QC
Canada H4L 5G6
Metrowerks Mail order Voice: 1-800-377—5416
Fax: [phone]—4901
U.S. Robotics, Palm Computing U.S.A. and Canada: 1-800-881-7256
Division Mail Order elsewhere 1-408-848-5604
Metrowerks World Wide Web http://www.metrowerks.comhttp://www.usr.com/palm
Division World Wide Web
Registration information [e-mail]
Technical support [e-mail]
Sales, marketing, & licensing [e-mail]
CompuServe goto Metrowerks
Table of Contents
Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
About This Document. . . . . . . . . . . . . . . . . . . . . . . . . . 15
Palm OS SDK Documentation . . . . . . . . . . . . . . . 15
Conventions Used in This Guide . . . . . . . . . . . . . . 16
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
System Requirements for Macintosh Users . . . . . . . . . . 18
Hardware Requirements . . . . . . . . . . . . . . . . 18
Softwar . . . . . . . . . . . . . . . . . 18
System Requirements for Windows Users . . . . . . . . . . 18
Navigating Tutorial Phases. . . . . . . . . . . . . . . . . 19
Folder Structure . . . . . . . . . . . . . . . . . . . . 19
Folder Setup . . . . . . . . . . . . . . . . . . . . . . 20
Working With the Tutorial . . . . . . . . . . . . . . . . . 21
Resetting the Device . . . . . . . . . . . . . . . . . . . 21
Soft Reset . . . . . . . . . . . . . . . . . . . . . . . 22
Soft Reset + Up Arrow . . . . . . . . . . . . . . . . . 22
Hard Reset . . . . . . . . . . . . . . . . . . . . . . 22
Deleting the MemoPad Application . . . . . . . . . . . . . 23
Phase 1 Creating a Form and a Button . . . . . . . . . . . . . . . . 25
Project Setup . . . . . . . . . . . . . . . . . . . . . . . 26
Creating a Resource File . . . . . . . . . . . . . . . . . . 27
Creating a New Resource File . . . . . . . . . . . . . . 27
Creating a Form With a Title . . . . . . . . . . . . . . . 30
Adding a Button to the Form . . . . . . . . . . . . . . 32
Components of a Palm OS Project. . . . . . . . . . . . . . 33
Modifying a CodeWarrior Project . . . . . . . . . . . . . . 34
Adding Files to the Project. . . . . . . . . . . . . . . . 34
Adding Resource Files to the Project . . . . . . . . . . . 35
Setting File Access Paths . . . . . . . . . . . . . . . . 36
Examining MemoPad.c . . . . . . . . . . . . . . . . . . 37
The PilotMain Function . . . . . . . . . . . . . . . . . 37
The StartApplication Function . . . . . . . . . . . . . . 38
Palm OS 2.0 Tutorial v
Table of Contents
The EventLoop Function . . . . . . . . . . . . . . . . 38
The MainFormHandleEvent Function . . . . . . . . . . . 39
Examining MemoPadRsc.h. . . . . . . . . . . . . . . . . 40
Building and Downloading the Application . . . . . . . . . 41
Debugging Hints . . . . . . . . . . . . . . . . . . . . 42
Phase 2 Adding a Menu and a Simple Dialog . . . . . . . . . . . . . 43
Overview . . . . . . . . . . . . . . . . . . . . . . . . 43
Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Adding an Options Menu With a Get Info Item . . . . . . . . 45
Background . . . . . . . . . . . . . . . . . . . . . . 45
Creating the Menu Bar . . . . . . . . . . . . . . . . . 45
Creating a Menu . . . . . . . . . . . . . . . . . . . . 47
Adding the Menu to the Menu Bar . . . . . . . . . . . . 48
Code Changes: Simple Menu Behavior . . . . . . . . . . . 49
Changes to MemoPadRsc.h . . . . . . . . . . . . . . . 49
The New Menu Event Handler in MemoPad.c . . . . . . . 49
Adding a Get Info Form With an OK Button . . . . . . . . . 50
Creating a New Form and Its Components. . . . . . . . . 51
Adding Help Text to the Form . . . . . . . . . . . . . . 53
Adding a Bitmap to the Info Form . . . . . . . . . . . . 54
Code Changes: Info Dialog. . . . . . . . . . . . . . . . . 56
Changes to MemoPadRsc.h . . . . . . . . . . . . . . . 56
A New Handler for the Info Dialog . . . . . . . . . . . . 56
Building and Downloading the Application . . . . . . . . . 57
Preparing the Device for Testing . . . . . . . . . . . . . . 58
Exercising the Application . . . . . . . . . . . . . . . . . 58
Phase 3 Adding an Edit Form and Navigation Between Forms . . . 59
Overview . . . . . . . . . . . . . . . . . . . . . . . . 59
Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Adding a New Button to the Main Form . . . . . . . . . . . 61
Code Changes: Event Handler for New Button . . . . . . . . 62
Creating an Edit Form . . . . . . . . . . . . . . . . . . . 63
Creating the Form . . . . . . . . . . . . . . . . . . . 63
Adding a Done Button . . . . . . . . . . . . . . . . . 64
Palm OS 2.0 Tutorial vi
Table of Contents
Code Changes: Edit Form Handling. . . . . . . . . . . . . 66
Adding Edit Form Handling to the Code . . . . . . . . . 66
Other Changes to the Application Code . . . . . . . . . . 67
Building and Downloading the Application . . . . . . . . . 68
Preparing the Device for Testing . . . . . . . . . . . . . . 69
Exercising the Application . . . . . . . . . . . . . . . . . 69
Phase 4 Adding a Text Field and Menu Commands . . . . . . . . . . 71
Overview . . . . . . . . . . . . . . . . . . . . . . . . 71
Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Adding a Large Text Field to the Edit Form. . . . . . . . . . 72
Adding a Graf ti Shift Indicator . . . . . . . . . . . . . . 73
Code Changes: Revised Handler for the Text Field . . . . . . 74
Adding Two Menus to the Edit Form . . . . . . . . . . . . 75
Adding Me