Framework

Address​Book

Access the centralized database for storing users’ contacts.

Overview

The Address Book is a centralized database for contact and other personal information for people. Users need to enter personal information about themselves and their friends only once, instead of entering it repeatedly whenever the information is used. Applications that support the Address Book framework share this contact information with other applications, include Apple’s Mail and iChat.

Symbols

Classes

ABAddress​Book

The ABAddress​Book class provides a programming interface to the Address Book—a centralized database used by multiple applications to store contact and other personal information about people. The Address Book database also supports the notion of a “group” containing one or more persons. People may belong to multiple groups, and groups may also belong to other groups with some restrictions (for example, no circular references are allowed).

ABAddress​Book

A reference to an ABAddressBook object.

ABGroup

The ABGroup class supports the concept of a “group” containing one or more persons. People may belong to multiple groups, and groups may also belong to other groups unless the relationship causes a circular reference. The only predefined property of a group is its name. However, similar to person records, you can add your own properties to group records. Groups not only help to organize person records, but also allow you to create email distribution lists.

ABGroup​Ref

A reference to an ABGroup object.

ABMulti​Value

The ABMulti​Value and ABMutable​Multi​Value classes are used to represent properties that might have multiple values. Each value in a multivalue list must be of the same type, and must have an associated predefined or user-defined label, and unique identifier. The labels, however, need not be unique. For example, you can have multiple Home phone numbers. Each multivalue object may have a primary identifier—used as a default value when a label is not provided. For example, a person record may have multiple addresses with the labels Home and Work, where Work is designated as the primary value. Instances of this class are immutable, see ABMutable​Multi​Value for methods that manipulate the content of a multivalue list.

ABMulti​Value

A reference to an ABMultiValue or ABMutableMultiValue object.

ABMutable​Multi​Value

The ABMulti​Value and ABMutable​Multi​Value classes are used to represent properties that might have multiple values. Each value in a multivalue list must be of the same type, and must have an associated predefined or user-defined label, and unique identifier. The labels, however, need not be unique. For example, you can have multiple Home phone numbers. Each multivalue object may have a primary identifier—used as a default value when a label is not provided. For example, a person record may have multiple addresses with the labels Home and Work, where Work is designated as the primary value. Instances of ABMutable​Multi​Value are mutable, see ABMulti​Value for additional methods that access the content of a multivalue list.

ABMutable​Multi​Value

A reference to an ABMutableMultiValue object.

ABPeople​Picker​View

The ABPeople​Picker​View class allows you to customize the behavior of people-picker views in an application’s user interface.

ABPerson

The ABPerson class encapsulates all information about a person in the Address Book database—an instance of ABPerson corresponds to a single person record in the database. The ABPerson class defines properties such as the person’s name, company, address, email addresses, and phone numbers.

ABPerson​Ref

A reference to an ABPerson object.

ABPerson​View

The ABPerson​View class provides a view for displaying and editing contacts.

ABRecord

ABRecord is an abstract superclass providing a common interface to, and defining common properties for, all Address Book records. A property is a field in the database record, such as the first or last name of a person record. ABRecord defines the types of properties supported, and basic methods for getting, setting, and removing property values.

ABSearch​Element

The ABSearch​Element class is used to specify a search query for records in the Address Book database.

ABSearch​Element​Ref

A reference to an ABSearchElement object.

Protocols

ABAction​Delegate

The ABActionDelegate informal protocol allows you to populate the rollover menus of Address Book with custom items. You do this by implementing an Address Book action plug-in. The plug-in’s NSBundle must implement action​Property:​, title​For​Person:​identifier:​ and perform​Action​For​Person:​identifier:​.

ABImage​Client

The ABImage​Client protocol is used to handle images loaded from an asynchronous fetch for ABPerson objects.

Extended Types

NSNotification.Name

The type used for the name of a notification.

NSObject

The root class of most Objective-C class hierarchies, from which subclasses inherit a basic interface to the runtime system and the ability to behave as Objective-C objects.