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

Types of Form Objects

Now we will discuss each individual type of form object in detail.

Labels

Label objects can be a little bit tricky if you are going to change the label at runtime. They are a snap if the label values don’t switch. Here is the most important label function:

void FrmCopyLabel(FormType *formP, UInt16 labelID, const Char *newLabel)

FrmCopyLabel copies the contents of the new label to the label with the given ID. Unlike almost all the other Form Manager APIs, FrmCopyLabel takes an ID as a parameter, rather than an index.

Note the name of this function includes Copy. This means that the new label will overwrite the contents of the old label. You will have trouble if the length of the new label is longer than the length specified in the resource. Longer strings will definitely cause errors, since FrmCopyLabel will blindly write beyond the space allocated for the label. Thus, this function makes sure you’ve allocated enough space in your resource.

Unfortunately, prior to OS 3.5, FrmCopyLabel would redraw the new label, but would not erase the old one. You can have problems with this in cases where the new text is narrower than the old text; remnants of the old text are left behind like so much screen litter. One way to avoid this problem is to hide the label before doing the copy, and then show it afterward. Here is an example of that:

void SetLabelInForm(FormType *form, UInt16 labelID, const char *newText) { UInt16 labelObjectIndex = FrmGetObjectIndex(form, labelID); ...
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