Added in API level 5

Summary: Constants | Ctors | Methods | Inherited Methods

ContactsContract.QuickContact

---

Kotlin |Java

public static final class ContactsContract.QuickContact
extends Object

java.lang.Object
↳	android.provider.ContactsContract.QuickContact

---

Helper methods to display QuickContact dialogs that display all the information belonging to a specific Contacts entry.

Summary

Constants
String	ACTION_QUICK_CONTACT Action used to launch the system contacts application and bring up a QuickContact dialog for the provided Contacts entry.
String	EXTRA_EXCLUDE_MIMES Extra used to indicate a list of specific MIME-types to exclude and not display in the QuickContacts dialog.
String	EXTRA_MODE Extra used to specify size of QuickContacts.
String	EXTRA_PRIORITIZED_MIMETYPE Extra used to specify which mimetype should be prioritized in the QuickContacts UI.
int	MODE_LARGE Large QuickContact mode, includes actions and larger, card-like summary of the Contacts entry being shown.
int	MODE_MEDIUM Medium QuickContact mode, includes actions and light summary describing the Contacts entry being shown.
int	MODE_SMALL Small QuickContact mode, usually presented with minimal actions.

Public constructors
QuickContact()

Public methods
static void	showQuickContact(Context context, View target, Uri lookupUri, String[] excludeMimes, String prioritizedMimeType) Trigger a dialog that lists the various methods of interacting with the requested Contacts entry.
static void	showQuickContact(Context context, Rect target, Uri lookupUri, int mode, String[] excludeMimes) Trigger a dialog that lists the various methods of interacting with the requested Contacts entry.
static void	showQuickContact(Context context, View target, Uri lookupUri, int mode, String[] excludeMimes) Trigger a dialog that lists the various methods of interacting with the requested Contacts entry.
static void	showQuickContact(Context context, Rect target, Uri lookupUri, String[] excludeMimes, String prioritizedMimeType) Trigger a dialog that lists the various methods of interacting with the requested Contacts entry.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ACTION_QUICK_CONTACT

Added in API level 21

public static final String ACTION_QUICK_CONTACT

Action used to launch the system contacts application and bring up a QuickContact dialog for the provided Contacts entry.

Constant Value: "android.provider.action.QUICK_CONTACT"

EXTRA_EXCLUDE_MIMES

Added in API level 21

public static final String EXTRA_EXCLUDE_MIMES

Extra used to indicate a list of specific MIME-types to exclude and not display in the QuickContacts dialog. Stored as a String array.

Constant Value: "android.provider.extra.EXCLUDE_MIMES"

EXTRA_MODE

Added in API level 23

public static final String EXTRA_MODE

Extra used to specify size of QuickContacts. Not all implementations of QuickContacts will respect this extra's value. One of MODE_SMALL, MODE_MEDIUM, or MODE_LARGE.

Constant Value: "android.provider.extra.MODE"

EXTRA_PRIORITIZED_MIMETYPE

Added in API level 23

public static final String EXTRA_PRIORITIZED_MIMETYPE

Extra used to specify which mimetype should be prioritized in the QuickContacts UI. For example, passing the value ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE can cause phone numbers to be displayed more prominently in QuickContacts.

Constant Value: "android.provider.extra.PRIORITIZED_MIMETYPE"

MODE_LARGE

Added in API level 5

public static final int MODE_LARGE

Large QuickContact mode, includes actions and larger, card-like summary of the Contacts entry being shown. This may include detailed information, such as a photo.

Constant Value: 3 (0x00000003)

MODE_MEDIUM

Added in API level 5

public static final int MODE_MEDIUM

Medium QuickContact mode, includes actions and light summary describing the Contacts entry being shown. This may include social status and presence details.

Constant Value: 2 (0x00000002)

MODE_SMALL

Added in API level 5

public static final int MODE_SMALL

Small QuickContact mode, usually presented with minimal actions.

Constant Value: 1 (0x00000001)

Public constructors

QuickContact

public QuickContact ()

Public methods

showQuickContact

Added in API level 23

public static void showQuickContact (Context context, 
                View target, 
                Uri lookupUri, 
                String[] excludeMimes, 
                String prioritizedMimeType)

Trigger a dialog that lists the various methods of interacting with the requested Contacts entry. This may be based on available ContactsContract.Data rows under that contact, and may also include social status and presence details.

Parameters
context	Context: The parent Context that may be used as the parent for this dialog.
target	View: Specific View from your layout that this dialog should be centered around. In particular, if the dialog has a "callout" arrow, it will be pointed and centered around this View.
lookupUri	Uri: A ContactsContract.Contacts#CONTENT_LOOKUP_URI style Uri that describes a specific contact to feature in this dialog. A managed profile lookup uri is supported here, see ContactsContract.CommonDataKinds.Email.ENTERPRISE_CONTENT_LOOKUP_URI and PhoneLookup#ENTERPRISE_CONTENT_FILTER_URI.
excludeMimes	String: Optional list of Data#MIMETYPE MIME-types to exclude when showing this dialog. For example, when already viewing the contact details card, this can be used to omit the details entry from the dialog.
prioritizedMimeType	String: This mimetype should be prioritized in the QuickContacts UI. For example, passing the value ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE can cause phone numbers to be displayed more prominently in QuickContacts.

showQuickContact

Added in API level 5

public static void showQuickContact (Context context, 
                Rect target, 
                Uri lookupUri, 
                int mode, 
                String[] excludeMimes)

Trigger a dialog that lists the various methods of interacting with the requested Contacts entry. This may be based on available ContactsContract.Data rows under that contact, and may also include social status and presence details.

Parameters
context	Context: The parent Context that may be used as the parent for this dialog.
target	Rect: Specific Rect that this dialog should be centered around, in screen coordinates. In particular, if the dialog has a "callout" arrow, it will be pointed and centered around this Rect. If you are running at a non-native density, you need to manually adjust using DisplayMetrics#density before calling.
lookupUri	Uri: A ContactsContract.Contacts#CONTENT_LOOKUP_URI style Uri that describes a specific contact to feature in this dialog. A managed profile lookup uri is supported here, see ContactsContract.CommonDataKinds.Email.ENTERPRISE_CONTENT_LOOKUP_URI and PhoneLookup#ENTERPRISE_CONTENT_FILTER_URI.
mode	int: Any of MODE_SMALL, MODE_MEDIUM, or MODE_LARGE, indicating the desired dialog size, when supported.
excludeMimes	String: Optional list of Data#MIMETYPE MIME-types to exclude when showing this dialog. For example, when already viewing the contact details card, this can be used to omit the details entry from the dialog.

showQuickContact

Added in API level 5

public static void showQuickContact (Context context, 
                View target, 
                Uri lookupUri, 
                int mode, 
                String[] excludeMimes)

Trigger a dialog that lists the various methods of interacting with the requested Contacts entry. This may be based on available ContactsContract.Data rows under that contact, and may also include social status and presence details.

Parameters
context	Context: The parent Context that may be used as the parent for this dialog.
target	View: Specific View from your layout that this dialog should be centered around. In particular, if the dialog has a "callout" arrow, it will be pointed and centered around this View.
lookupUri	Uri: A ContactsContract.Contacts#CONTENT_LOOKUP_URI style Uri that describes a specific contact to feature in this dialog. A managed profile lookup uri is supported here, see ContactsContract.CommonDataKinds.Email.ENTERPRISE_CONTENT_LOOKUP_URI and PhoneLookup#ENTERPRISE_CONTENT_FILTER_URI.
mode	int: Any of MODE_SMALL, MODE_MEDIUM, or MODE_LARGE, indicating the desired dialog size, when supported.
excludeMimes	String: Optional list of Data#MIMETYPE MIME-types to exclude when showing this dialog. For example, when already viewing the contact details card, this can be used to omit the details entry from the dialog.

showQuickContact

Added in API level 23

public static void showQuickContact (Context context, 
                Rect target, 
                Uri lookupUri, 
                String[] excludeMimes, 
                String prioritizedMimeType)

Trigger a dialog that lists the various methods of interacting with the requested Contacts entry. This may be based on available ContactsContract.Data rows under that contact, and may also include social status and presence details.

Parameters
context	Context: The parent Context that may be used as the parent for this dialog.
target	Rect: Specific Rect that this dialog should be centered around, in screen coordinates. In particular, if the dialog has a "callout" arrow, it will be pointed and centered around this Rect. If you are running at a non-native density, you need to manually adjust using DisplayMetrics#density before calling.
lookupUri	Uri: A ContactsContract.Contacts#CONTENT_LOOKUP_URI style Uri that describes a specific contact to feature in this dialog. A managed profile lookup uri is supported here, see ContactsContract.CommonDataKinds.Email.ENTERPRISE_CONTENT_LOOKUP_URI and PhoneLookup#ENTERPRISE_CONTENT_FILTER_URI.
excludeMimes	String: Optional list of Data#MIMETYPE MIME-types to exclude when showing this dialog. For example, when already viewing the contact details card, this can be used to omit the details entry from the dialog.
prioritizedMimeType	String: This mimetype should be prioritized in the QuickContacts UI. For example, passing the value ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE can cause phone numbers to be displayed more prominently in QuickContacts.