Skip to Main Content
Palm OS Programming, 2nd Edition
book

Palm OS Programming, 2nd Edition

by Julie McKeehan, Neil Rhodes
October 2001
Intermediate to advanced content levelIntermediate to advanced
704 pages
19h 33m
English
O'Reilly Media, Inc.
Content preview from Palm OS Programming, 2nd Edition

Form Object APIs

These are the most important form object APIs.

Converting Between IDs and Indexes

Most Form Manager routines require a form object index, but what you’ve specified in the form resource is a form object ID. As a result, you’ll find yourself converting from IDs to indexes very often.

UInt16 FrmGetObjectIndex(const FormType *form, UInt16 formObjectID)

FrmGetObjectIndex searches through the objects in the form, returning the index of the one that matches the given object ID. You will be using this routine all the time.

UInt16 FrmGetObjectID(const FormType *form, UInt16 formObjectIndex)

FrmGetObjectID returns the ID of the form object at the specified index. It is not commonly needed.

We don’t know why the Palm OS architects thought it necessary to have both form object IDs and form object indexes (it seems as though using indexes would have been simpler).

Warning

Unfortunately, you’ll find it very easy to accidentally pass an ID to a routine expecting an index. Since the data types (UInt16) are exactly the same, the compiler can’t catch this type of error. Instead, you’ll get a runtime error when the object at that index can’t be found (since you’ll be passing a number like 1000 to specify a 0-based index).

Hiding and Showing Objects

The initial state of the usable bit for each form object is specified in the form resource. Sometimes, you may want to dynamically hide or show a specific form object. You can do this with FrmHideObject or FrmShowObject .

void ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

Palm OS Network Programming

Palm OS Network Programming

Greg Winton
Palm Programming: The Developer's Guide

Palm Programming: The Developer's Guide

Neil Rhodes, Julie McKeehan

Publisher Resources

ISBN: 1565928563Errata Page