Class

CNContactProperty

An object that represents a property of a contact.

Declaration

@interface CNContactProperty : NSObject

Overview

A contact (that is, an instance of CNContact) has properties, such as givenName, phoneNumbers, and jobTitle. Each property is represented by an instance of CNContactProperty, which provides a tuple that can contain three or five values, depending on whether the property is a member of an array of labeled values. For example, the phoneNumbers property is a member of an array of labeled values, so the CNContactProperty tuple contains the contact, key, value, identifier, and label. For the givenName property, which is not contained in a labeled array, CNContactProperty returns a tuple that contains the contact, key, and value. The CNContactProperty class is used by CNContactPicker to return the user's selected property.

Topics

Getting the Contact Object

contact

The associated contact.

Getting the Property Information

key

The key of the contact property.

value

The value of the property.

label

The label of the labeled value of the property array.

identifier

The identifier of the labeled value in the array of labeled.

Handling Exceptions

CNContactPropertyNotFetchedExceptionName

Exception thrown when an accessed property was not fetched.

Relationships

Inherits From

See Also

Generic Types

CNLabeledValue

An immutable object that combines a contact property value with a label that describes that property.