See Also: ABPeoplePickerNavigationController Members
With the introduction of iOS 8.0, it is possible to filter the information displayed by setting one or more of the Predicate properties in this class.
The predicates are: AddressBookUI.ABPeoplePickerNavigationController.PredicateForEnablingPerons, AddressBookUI.ABPeoplePickerNavigationController.PredicateForSelectionOfPerson and AddressBookUI.ABPeoplePickerNavigationController.PredicateForSelectionOfProperty.
The predicates can use the various members in AddressBookUI.ABPersonPredicateKey as constants in the above predicates, or you can use the hardcoded strings shown below.
Each one of these properties has either a native type (like a string), an array of elements or is a structured type that contains elements that you can access from the predicate expression.
| Structured Type Name | Property Contents | |
|---|---|---|
| LabeledValue | 'label' and 'value'. | |
| PhoneNumber | 'stringValue', 'countryCode', 'formattedStringValue' and 'normalizedStringValue' | |
| InstantMessageAddress | 'username' and 'service' | |
| SocialProfile | 'username' and 'service' | |
| PostalAddress | 'street' property, 'subLocality' property, 'city' property, 'subAdministrativeArea' property, 'state' property, 'postalCode' property, 'country' and 'ISOCountryCode'. |
| ABPersonPredicateKey | String Name | Key value |
|---|---|---|
| NamePrefix | "namePrefix" | string |
| GivenName | "givenName" | string |
| MiddleName | "middleName" | string |
| FamilyName | "familyName" | string |
| NameSuffix | "nameSuffix" | string |
| PreviousFamilyName | "previousFamilyName" | string |
| Nickname | "nickname" | string |
| PhoneticGivenName | "phoneticGivenName" | string |
| PhoneticMiddleName | "phoneticMiddleName" | string |
| PhoneticFamilyName | "phoneticFamilyName" | string |
| OrganizationName | "organizationName" | string |
| DepartmentName | "departmentName" | string |
| JobTitle | "jobTitle" | string |
| Birthday | "birthday" | NSDateComponents |
| Note | "note" | string |
| PhoneNumbers | "phoneNumbers" | Array of LabeledValue with PhoneNumber values |
| EmailAddresses | "emailAddresses" | array of LabeledValue with string values |
| UrlAddresses | "urlAddresses" | array of LabeledValue with string values |
| Dates | "dates" | array of LabeledValue with NSDateComponents values |
| InstantMessageAddresses | "instantMessageAddresses" | array of LabeledValue with InstantMessageAddress values |
| RelatedNames | "relatedNames" | array of LabeledValue with string values |
| SocialProfiles | "socialProfiles" | array of LabeledValue with SocialProfile values |
| PostalAddresses | "postalAddresses" | array of LabeledValue with PostalAddress values |