Java Reference
In-Depth Information
Table 7-5.
Indexes into Contact Field String Arrays
Attribute
Purpose
ADDR_COUNTRY
Country part of address
ADDR_EXTRA
Extra part of address
ADDR_LOCALITY
Locality part of address
ADDR_POBOX
Post office box part of address
ADDR_POSTALCODE
Postal code part of address
ADDR_REGION
Regional part of address
ADDR_STREET
Street part of address
NAME_FAMILY
Family name portion of name
NAME_GIVEN
Given name portion of name
NAME_OTHER
Other portion of name
NAME_PREFIX
Prefix portion of name (i.e., Dr.)
NAME_SUFFIX
Suffix portion of name (i.e., Jr.)
Modifying a PIM Record
Once you have a
PIMItem
in hand, you can change it. There are three kinds of changes you
might want to make:
• Add a datum to an existing field (e.g., add a new phone number to a contact with
existing phone numbers)
• Replace a datum within an existing field (e.g., replace an existing phone number
with new information)
• Remove a field entirely
In the first case, you use the
PIMItem
's adder methods; in the second and third cases,
you use the
PIMItem
's setter methods to do this.
The following adder methods are available:
•
addBinary
: Adds a new binary (
byte[]
) field datum
•
addDate
: Adds a new
Date
field datum
•
addInt
: Adds a new integer (
int
) field datum
