ABPeoplePickerNavigationController Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/AddressBookUI.framework
Availability
Available in iOS 2.0 and later.
Declared in
ABPeoplePickerNavigationController.h
Related sample code

Overview

The ABPeoplePickerNavigationController class (whose instances are known as people-picker navigation controllers) implements a view controller that manages a set of views that allow the user to select a contact or one of its contact-information items from an address book.

Subclassing Notes

The ABPeoplePickerNavigationController class does not support subclassing.

Tasks

Displaying Person Properties

Configuring People Pickers

Properties

addressBook

Optional. The address book from which to obtain the list of contacts.

@property(nonatomic, readwrite) ABAddressBookRef addressBook
Discussion

When unset, an address book is created and assigned to this property when needed.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPeoplePickerNavigationController.h

displayedProperties

Array of NSNumber objects representing ABPropertyID values identifying properties (such as name or telephone number) the picker displays when it shows a person.

@property(nonatomic, copy) NSArray *displayedProperties
Discussion

Name properties are always displayed.

To have the picker display a single property for the person displayed, such as telephone number, set displayedProperties to an array with a single value, such as kABPersonPhoneProperty.

Availability
  • Available in iOS 2.0 and later.
Related Sample Code
Declared In
ABPeoplePickerNavigationController.h

peoplePickerDelegate

The people-picker navigation controller delegate.

@property(nonatomic, assign) id<ABPeoplePickerNavigationControllerDelegate> peoplePickerDelegate
Discussion

The delegate must adopt the ABPeoplePickerNavigationControllerDelegate formal protocol.

Availability
  • Available in iOS 2.0 and later.
Related Sample Code
Declared In
ABPeoplePickerNavigationController.h