Summary: Nested Classes | Constants | Ctors | Inherited Methods | [Expand All]

public static final class

Contacts.Intents

extends Object

java.lang.Object
↳	android.provider.Contacts.Intents

Class Overview

Contains helper classes used to create or manage Intents that involve contacts.

Summary

Nested Classes
public static final class	Contacts.Intents.Insert	Convenience class that contains string constants used to create contact Intents.
public static final class	Contacts.Intents.UI	Intents related to the Contacts app UI.

Constants
String	ATTACH_IMAGE	Starts an Activity that lets the user pick a contact to attach an image to.
String	EXTRA_CREATE_DESCRIPTION	Used with SHOW_OR_CREATE_CONTACT to specify an exact description to be shown when prompting user about creating a new contact.
String	EXTRA_FORCE_CREATE	Used with SHOW_OR_CREATE_CONTACT to force creating a new contact if no matching contact found.
String	SEARCH_SUGGESTION_CLICKED	This is the intent that is fired when a search suggestion is clicked on.
String	SEARCH_SUGGESTION_CREATE_CONTACT_CLICKED	This is the intent that is fired when a search suggestion for creating a contact is clicked on.
String	SEARCH_SUGGESTION_DIAL_NUMBER_CLICKED	This is the intent that is fired when a search suggestion for dialing a number is clicked on.
String	SHOW_OR_CREATE_CONTACT	Takes as input a data URI with a mailto: or tel: scheme.

Public Constructors
	Contacts.Intents()

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Is called before the object's memory is being reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of Class which represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.

Constants

public static final String ATTACH_IMAGE

Starts an Activity that lets the user pick a contact to attach an image to. After picking the contact it launches the image cropper in face detection mode.

Constant Value: "com.android.contacts.action.ATTACH_IMAGE"

public static final String EXTRA_CREATE_DESCRIPTION

Used with SHOW_OR_CREATE_CONTACT to specify an exact description to be shown when prompting user about creating a new contact.

Type: STRING

Constant Value: "com.android.contacts.action.CREATE_DESCRIPTION"

public static final String EXTRA_FORCE_CREATE

Used with SHOW_OR_CREATE_CONTACT to force creating a new contact if no matching contact found. Otherwise, default behavior is to prompt user with dialog before creating.

Type: BOOLEAN

Constant Value: "com.android.contacts.action.FORCE_CREATE"

public static final String SEARCH_SUGGESTION_CLICKED

This is the intent that is fired when a search suggestion is clicked on.

Constant Value: "android.provider.Contacts.SEARCH_SUGGESTION_CLICKED"

public static final String SEARCH_SUGGESTION_CREATE_CONTACT_CLICKED

This is the intent that is fired when a search suggestion for creating a contact is clicked on.

Constant Value: "android.provider.Contacts.SEARCH_SUGGESTION_CREATE_CONTACT_CLICKED"

public static final String SEARCH_SUGGESTION_DIAL_NUMBER_CLICKED

This is the intent that is fired when a search suggestion for dialing a number is clicked on.

Constant Value: "android.provider.Contacts.SEARCH_SUGGESTION_DIAL_NUMBER_CLICKED"

public static final String SHOW_OR_CREATE_CONTACT

Takes as input a data URI with a mailto: or tel: scheme. If a single contact exists with the given data it will be shown. If no contact exists, a dialog will ask the user if they want to create a new contact with the provided details filled in. If multiple contacts share the data the user will be prompted to pick which contact they want to view.

For mailto: URIs, the scheme specific portion must be a raw email address, such as one built using fromParts(String, String, String).

For tel: URIs, the scheme specific portion is compared to existing numbers using the standard caller ID lookup algorithm. The number must be properly encoded, for example using fromParts(String, String, String).

Any extras from the Contacts.Intents.Insert class will be passed along to the create activity if there are no contacts to show.

Passing true for the EXTRA_FORCE_CREATE extra will skip prompting the user when the contact doesn't exist.

Constant Value: "com.android.contacts.action.SHOW_OR_CREATE_CONTACT"

Interfaces

Classes

Exceptions