Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public static final class

ContactsContract.Contacts.AggregationSuggestions

extends Object
implements BaseColumns ContactsContract.ContactOptionsColumns ContactsContract.ContactStatusColumns ContactsContract.ContactsColumns
java.lang.Object
   ↳ android.provider.ContactsContract.Contacts.AggregationSuggestions

Class Overview

A read-only sub-directory of a single contact aggregate that contains all aggregation suggestions (other contacts). The aggregation suggestions are computed based on approximate data matches with this contact.

Note: this query may be expensive! If you need to use it in bulk, make sure the user experience is acceptable when the query runs for a long time.

Usage example:

        Uri uri = Contacts.CONTENT_URI.buildUpon()
          .appendEncodedPath(String.valueOf(contactId))
          .appendPath(Contacts.AggregationSuggestions.CONTENT_DIRECTORY)
          .appendQueryParameter("limit", "3")
          .build()
 Cursor cursor = getContentResolver().query(suggestionsUri,
          new String[] {Contacts.DISPLAY_NAME, Contacts._ID, Contacts.LOOKUP_KEY},
          null, null, null);
       

This directory can be used either with a CONTENT_URI or CONTENT_LOOKUP_URI .

Summary

Constants
String CONTENT_DIRECTORY The directory twig for this sub-table.
[Expand]
Inherited Constants
From interface android.provider.BaseColumns
From interface android.provider.ContactsContract.ContactOptionsColumns
From interface android.provider.ContactsContract.ContactStatusColumns
From interface android.provider.ContactsContract.ContactsColumns
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String CONTENT_DIRECTORY

Added in API level 5

The directory twig for this sub-table. The URI can be followed by an optional type-to-filter, similar to CONTENT_FILTER_URI .

Constant Value: "suggestions"