Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) User Manual

Page 681

C H A P T E R 1 9

Built-in Applications and System Data

Names

19-7

■

get information from Names soup entries

■

for credit/phone card information (

BcCreditCards

)

■

for custom fields information (

BcCustomFields

)

■

for e-mail address information (

BcEmailAddress

)

■

for e-mail network information (

BcEmailNetwork

)

■

for phone number information (

BcPhoneNumber

)

These functions and methods are all described in Newton Programmer’s Reference.

Using the Names Soup

The Names application stores its data in the

ROM_CardFileSoupName

(“Names”)

soup. Entries in this soup are frames for either a person, an owner, a group, a
company, or a worksite card.

The soup formats for each of these types of entries are described in “Names Soup
Format” (page 16-15) in Newton Programmer’s Reference. A list of these frames is
available in the Summary; see “Names Soup” (page 19-49).

To avoid future compatibility problems with soup format changes, you should use
the Names methods provided for getting or setting information in the Names soup.
If none is available for getting the information you want, use the global functions

GetSysEntryData

and

SetSysEntryData

to get or change entries in any of

the built-in soups. They allow you to get and set the values of slots in a soup entry.
If you don’t use these functions to get and set entry slots in the built-in soups, your
application may break under future versions of system software.

Using the Names Protos

The Names application uses two protos which are available to you:

protoPersonaPopup

and

protoEmporiumPopup

. These protos provide

pickers that maintain lists of personae and emporia. Personae are people who use
the Newton device, and emporia are places where the Newton device is used.

Note that you can get the information on the current

owner

and

worksite

from

the

user configuration

data stored by the system. This data is described in

“System Data” beginning on page 19-44.

protoPersonaPopup

This proto is used for a picker that lets the user maintain and switch between
different owner cards, or “personae.” Here’s an example: