# showContactsParams

Dictionary of options for the showContacts method.

Availability

0.8

9.2.0

Extends

Object

NOTE

This is an abstract type. Any object of this structure can be used where this type is used.

# Properties

# animated

Availability

0.8

9.2.0

animated :Boolean

Determines whether to animate the show/hide of the contacts picker (iPhone, iPad only.)

Default: true

# cancel

Availability

0.8

9.2.0

cancel :Callback<Object>

Function to call when selection is canceled.

# fields

Availability

0.8

9.2.0

fields :Array<String>

Field names to show when selecting properties. By default, shows all available.

# selectedPerson

Availability

0.8

9.2.0

selectedPerson :Callback<Object>

Function to call when a person is selected. Must not be used with selectedProperty property.

# selectedProperty

Availability

0.8

9.2.0

selectedProperty :Callback<Object>

Function to call when a property is selected. Must not be used with selectedPerson property. Note: If ringtone or texttone is selected, null values are returned, since these are unsupported by Apple. Since iOS 9.0, there is a native apple issue whereby it may return null if the birthday property is selected on certain device models. The callback contains the selected property and a 'person' object of type Titanium.Contacts.Person. Since iOS 9.0, apple only returns the person object with partial information. Currently it is known to at least contain the selected property and fullName.