C H A P T E R 1 9
Built-in Applications and System Data
get information from Names soup entries
for credit/phone card information (
for custom fields information (
for e-mail address information (
for e-mail network information (
for phone number information (
These functions and methods are all described in Newton Programmer's Reference.
Using the Names Soup
The Names application stores its data in the
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
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:
. 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
data stored by the system. This data is described in
"System Data" beginning on page 19-44.
This proto is used for a picker that lets the user maintain and switch between
different owner cards, or "personae." Here's an example: