---

Address Book Constants Reference

Overview

Constants

Global Variables

Record Properties

Properties common to all types of records.

extern NSString * const kABUIDProperty;
extern NSString * const kABCreationDateProperty;
extern NSString * const kABModificationDateProperty;

Discussion

These constants are described in “Constants” in “ABRecord”.

Person Properties

Properties common to all persons.

extern NSString * const kABFirstNameProperty;
extern NSString * const kABLastNameProperty;
extern NSString * const kABFirstNamePhoneticProperty;
extern NSString * const kABLastNamePhoneticProperty;
extern NSString * const kABBirthdayProperty;
extern NSString * const kABOrganizationProperty;
extern NSString * const kABJobTitleProperty;
extern NSString * const kABHomePageProperty;
extern NSString * const kABURLsProperty;
extern NSString * const kABCalendarURIsProperty;
extern NSString * const kABEmailProperty;
extern NSString * const kABAddressProperty;
extern NSString * const kABPhoneProperty;
extern NSString * const kABAIMInstantProperty;
extern NSString * const kABJabberInstantProperty;
extern NSString * const kABMSNInstantProperty;
extern NSString * const kABYahooInstantProperty;
extern NSString * const kABICQInstantProperty;
extern NSString * const kABNoteProperty;
extern NSString * const kABMiddleNameProperty;
extern NSString * const kABMiddleNamePhoneticProperty;
extern NSString * const kABTitleProperty;
extern NSString * const kABSuffixProperty;
extern NSString * const kABNicknameProperty;
extern NSString * const kABMaidenNameProperty;
extern NSString * const kABOtherDatesProperty;
extern NSString * const kABRelatedNamesProperty;
extern NSString * const kABDepartmentProperty;
extern NSString * const kABPersonFlags;

Discussion

These constants are described in “Constants” in “ABPerson”.

Address Keys

Keys used to specify the different fields in a kABAddressProperty for person records.

extern NSString * const kABAddressStreetKey;
extern NSString * const kABAddressCityKey;
extern NSString * const kABAddressStateKey;
extern NSString * const kABAddressZIPKey;
extern NSString * const kABAddressCountryKey;
extern NSString * const kABAddressCountryCodeKey;

Discussion

These constants as well as the possible values of kABAddressCountryCodeKey are described in “Constants” in “ABPerson”.

Multi-value List Labels

Pre-defined labels used by a multi-value list.

extern NSString * const kABEmailWorkLabel;
extern NSString * const kABEmailHomeLabel;
extern NSString * const kABAddressHomeLabel;
extern NSString * const kABAddressWorkLabel;
extern NSString * const kABPhoneWorkLabel;
extern NSString * const kABPhoneHomeLabel;
extern NSString * const kABPhoneMobileLabel;
extern NSString * const kABPhoneMainLabel;
extern NSString * const kABPhoneHomeFAXLabel;
extern NSString * const kABPhoneWorkFAXLabel;
extern NSString * const kABPhonePagerLabel;
extern NSString * const kABAIMWorkLabel;
extern NSString * const kABAIMHomeLabel;
extern NSString * const kABJabberWorkLabel;
extern NSString * const kABJabberHomeLabel;
extern NSString * const kABMSNWorkLabel;
extern NSString * const kABMSNHomeLabel;
extern NSString * const kABYahooWorkLabel;
extern NSString * const kABYahooHomeLabel;
extern NSString * const kABICQWorkLabel;
extern NSString * const kABICQHomeLabel;
extern NSString * const kABAnniversaryLabel;
extern NSString * const kABMotherLabel;
extern NSString * const kABFatherLabel;
extern NSString * const kABParentLabel;
extern NSString * const kABSisterLabel;
extern NSString * const kABBrotherLabel;
extern NSString * const kABChildLabel;
extern NSString * const kABFriendLabel;
extern NSString * const kABSpouseLabel;
extern NSString * const kABPartnerLabel;
extern NSString * const kABAssistantLabel;
extern NSString * const kABManagerLabel;
extern NSString * const kABHomePageProperty;

Discussion

These constants are described in “Constants” in “ABPerson”.

Generic Labels

Labels that can be used to match all work, home, or other labels.

extern NSString * const kABWorkLabel;
extern NSString * const kABHomeLabel;
extern NSString * const kABOtherLabel;

Discussion

These constants are described in “Constants” in “ABPerson”.

Constants

kABMultiValueMask

Indicates a multi-value property type.

#define kABMultiValueMask 0x100

Discussion

Used by ABPropertyType to specify a multi-value property.

Person Flags

The ABPersonFlags property (“Person Properties”) is used in conjunction with the following symbols:

#define kABShowAsPerson 000000
#define kABShowAsCompany 000001
#define kABShowAsMask 000007
#define kABDefaultNameOrdering 000000
#define kABFirstNameFirst 000040
#define kABLastNameFirst 000020
#define kABNameOrderingMask 000070

Discussion

These symbols are explained in the “Constants” section of ABPerson.

Notifications

kABDatabaseChangedNotification

Notification sent when the Address Book database has changed.

extern NSString * const kABDatabaseChangedNotification;

Discussion

This notification is described in the “Notifications” section of ABAddressBook.

kABDatabaseChangedExternallyNotification

Notification sent when the Address Book database changes from an external application.

extern NSString * const kABDatabaseChangedExternallyNotification;

Discussion

This notification is described in the “Notifications” section of ABAddressBook.

---