ContactsContract.Contacts

CONTENT_ITEM_TYPE

String CONTENT_ITEM_TYPE

The MIME type of a CONTENT_URI subdirectory of a single person.

Constant Value: "vnd.android.cursor.item/contact"

CONTENT_TYPE

String CONTENT_TYPE

The MIME type of CONTENT_URI providing a directory of people.

Constant Value: "vnd.android.cursor.dir/contact"

CONTENT_VCARD_TYPE

String CONTENT_VCARD_TYPE

The MIME type of a CONTENT_URI subdirectory of a single person.

Constant Value: "text/x-vcard"

EXTRA_ADDRESS_BOOK_INDEX

String EXTRA_ADDRESS_BOOK_INDEX

Add this query parameter to a URI to get back row counts grouped by the address book index as cursor extras. For most languages it is the first letter of the sort key. This parameter does not affect the main content of the cursor.

 Example:

 import android.provider.ContactsContract.Contacts;

 Uri uri = Contacts.CONTENT_URI.buildUpon()
          .appendQueryParameter(Contacts.EXTRA_ADDRESS_BOOK_INDEX, "true")
          .build();
 Cursor cursor = getContentResolver().query(uri,
          new String[] {Contacts.DISPLAY_NAME},
          null, null, null);
 Bundle bundle = cursor.getExtras();
 if (bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES) &&
         bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS)) {
     String sections[] =
             bundle.getStringArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES);
     int counts[] = bundle.getIntArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS);
 }
 

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

EXTRA_ADDRESS_BOOK_INDEX_COUNTS

String EXTRA_ADDRESS_BOOK_INDEX_COUNTS

The array of group counts for the corresponding group. Contains the same number of elements as the EXTRA_ADDRESS_BOOK_INDEX_TITLES array.

TYPE: int[]

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

EXTRA_ADDRESS_BOOK_INDEX_TITLES

String EXTRA_ADDRESS_BOOK_INDEX_TITLES

The array of address book index titles, which are returned in the same order as the data in the cursor.

TYPE: String[]

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

QUERY_PARAMETER_VCARD_NO_PHOTO

String QUERY_PARAMETER_VCARD_NO_PHOTO

Boolean parameter that may be used with CONTENT_VCARD_URI and CONTENT_MULTI_VCARD_URI to indicate that the returned vcard should not contain a photo. This is useful for obtaining a space efficient vcard.

Constant Value: "no_photo"

CONTENT_FILTER_URI

Uri CONTENT_FILTER_URI

The content:// style URI used for "type-to-filter" functionality on the CONTENT_URI URI. The filter string will be used to match various parts of the contact name. The filter argument should be passed as an additional path segment after this URI.

CONTENT_FREQUENT_URI

Uri CONTENT_FREQUENT_URI

The content:// style URI for showing a list of frequently contacted people.

CONTENT_GROUP_URI

Uri CONTENT_GROUP_URI

CONTENT_LOOKUP_URI

Uri CONTENT_LOOKUP_URI

A content:// style URI for this table that should be used to create shortcuts or otherwise create long-term links to contacts. This URI should always be followed by a "/" and the contact's LOOKUP_KEY. It can optionally also have a "/" and last known contact ID appended after that. This "complete" format is an important optimization and is highly recommended.

As long as the contact's row ID remains the same, this URI is equivalent to CONTENT_URI. If the contact's row ID changes as a result of a sync or aggregation, this URI will look up the contact using indirect information (sync IDs or constituent raw contacts).

Lookup key should be appended unencoded - it is stored in the encoded form, ready for use in a URI.

CONTENT_MULTI_VCARD_URI

Uri CONTENT_MULTI_VCARD_URI

Base Uri for referencing multiple Contacts entry, created by appending LOOKUP_KEY using withAppendedPath(Uri, String). The lookup keys have to be joined with the colon (":") separator, and the resulting string encoded. Provides OpenableColumns columns when queried, or returns the referenced contact formatted as a vCard when opened through openAssetFileDescriptor(Uri, String).

Usage example:

The following code snippet creates a multi-vcard URI that references all the contacts in a user's database.

 public Uri getAllContactsVcardUri() {
     Cursor cursor = getActivity().getContentResolver().query(Contacts.CONTENT_URI,
         new String[] {Contacts.LOOKUP_KEY}, null, null, null);
     if (cursor == null) {
         return null;
     }
     try {
         StringBuilder uriListBuilder = new StringBuilder();
         int index = 0;
         while (cursor.moveToNext()) {
             if (index != 0) uriListBuilder.append(':');
             uriListBuilder.append(cursor.getString(0));
             index++;
         }
         return Uri.withAppendedPath(Contacts.CONTENT_MULTI_VCARD_URI,
                 Uri.encode(uriListBuilder.toString()));
     } finally {
         cursor.close();
     }
 }
 

CONTENT_STREQUENT_FILTER_URI

Uri CONTENT_STREQUENT_FILTER_URI

The content:// style URI used for "type-to-filter" functionality on the CONTENT_STREQUENT_URI URI. The filter string will be used to match various parts of the contact name. The filter argument should be passed as an additional path segment after this URI.

CONTENT_STREQUENT_URI

Uri CONTENT_STREQUENT_URI

The content:// style URI for this table joined with useful data from ContactsContract.Data, filtered to include only starred contacts and the most frequently contacted contacts.

CONTENT_URI

Uri CONTENT_URI

The content:// style URI for this table

CONTENT_VCARD_URI

Uri CONTENT_VCARD_URI

Base Uri for referencing a single Contacts entry, created by appending LOOKUP_KEY using withAppendedPath(Uri, String). Provides OpenableColumns columns when queried, or returns the referenced contact formatted as a vCard when opened through openAssetFileDescriptor(Uri, String).

ENTERPRISE_CONTENT_FILTER_URI

Uri ENTERPRISE_CONTENT_FILTER_URI

It supports the similar semantics as CONTENT_FILTER_URI and returns the same columns. This URI requires DIRECTORY_PARAM_KEY in parameters, otherwise it will throw IllegalArgumentException.

getLookupUri

Uri getLookupUri (ContentResolver resolver, 
                Uri contactUri)

Builds a CONTENT_LOOKUP_URI style Uri describing the requested Contacts entry.

getLookupUri

Uri getLookupUri (long contactId, 
                String lookupKey)

Build a CONTENT_LOOKUP_URI lookup Uri using the given _ID and LOOKUP_KEY.

Returns null if unable to construct a valid lookup URI from the provided parameters.

isEnterpriseContactId

boolean isEnterpriseContactId (long contactId)

Return TRUE if a contact ID is from the contacts provider on the enterprise profile. ENTERPRISE_CONTENT_FILTER_URI may return such a contact.

lookupContact

Uri lookupContact (ContentResolver resolver, 
                Uri lookupUri)

Computes a content URI (see CONTENT_URI) given a lookup URI.

Returns null if the contact cannot be found.

markAsContacted

void markAsContacted (ContentResolver resolver, 
                long contactId)

This method was deprecated in API level 16.
The class DataUsageStatUpdater of the Android support library should be used instead.

Mark a contact as having been contacted. Updates two fields: TIMES_CONTACTED and LAST_TIME_CONTACTED. The TIMES_CONTACTED field is incremented by 1 and the LAST_TIME_CONTACTED field is populated with the current system time.

openContactPhotoInputStream

InputStream openContactPhotoInputStream (ContentResolver cr, 
                Uri contactUri)

Opens an InputStream for the contacts's thumbnail photo and returns the photo as a byte stream.

openContactPhotoInputStream

InputStream openContactPhotoInputStream (ContentResolver cr, 
                Uri contactUri, 
                boolean preferHighres)

Opens an InputStream for the contacts's photo and returns the photo as a byte stream.