background image
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
19
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
19
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
19
This proto is used for a picker that lets the user maintain and switch between
different owner cards, or "personae." Here's an example:
© 2007-2024, o7 studio » при воспроизведении материала сайта ссылка обязательна