Apple Newton Utilities User's Guide download pdf (Page 681)

100

101

CHAPTER 19

Built-in Applications and System Data

Names 19-7

■ get information from Names soup entries

■

for credit/phone card information (BcCreditCards)

■

for custom ﬁelds 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:

1 2 ... 676 677 678 679 680 681 682 683 684 685 686 ... 941 942

Comments to this Manuals

No comments

Apple Newton Utilities User's Guide Page 681

Comments to this Manuals

Related products and manuals for Software Apple Newton Utilities