Skip to content

Most visited

Recently visited

navigation

Contacts.People

public static final class Contacts.People
extends Object implements BaseColumns, Contacts.PeopleColumns, Contacts.PhonesColumns, Contacts.PresenceColumns

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


This class was deprecated in API level 5.
see ContactsContract

This table contains people.

Summary

Nested classes

class Contacts.People.ContactMethods

This class was deprecated in API level 5. see ContactsContract  

class Contacts.People.Extensions

This class was deprecated in API level 5. see ContactsContract  

class Contacts.People.Phones

This class was deprecated in API level 5. see ContactsContract  

Constants

String CONTENT_ITEM_TYPE

This constant was deprecated in API level 5. see ContactsContract

String CONTENT_TYPE

This constant was deprecated in API level 5. see ContactsContract

String DEFAULT_SORT_ORDER

This constant was deprecated in API level 5. see ContactsContract

String PRIMARY_EMAIL_ID

This constant was deprecated in API level 5. see ContactsContract

String PRIMARY_ORGANIZATION_ID

This constant was deprecated in API level 5. see ContactsContract

String PRIMARY_PHONE_ID

This constant was deprecated in API level 5. see ContactsContract

Inherited constants

From interface android.provider.BaseColumns
From interface android.provider.Contacts.PeopleColumns
From interface android.provider.Contacts.PhonesColumns
From interface android.provider.Contacts.PresenceColumns

Fields

public static final Uri CONTENT_FILTER_URI

This field was deprecated in API level 5. see ContactsContract

public static final Uri CONTENT_URI

This field was deprecated in API level 5. see ContactsContract

public static final Uri DELETED_CONTENT_URI

This field was deprecated in API level 5. see ContactsContract

Public methods

static Uri addToGroup(ContentResolver resolver, long personId, long groupId)

This method was deprecated in API level 5. see ContactsContract

static Uri addToGroup(ContentResolver resolver, long personId, String groupName)

This method was deprecated in API level 5. see ContactsContract

static Uri addToMyContactsGroup(ContentResolver resolver, long personId)

This method was deprecated in API level 5. see ContactsContract

static Uri createPersonInMyContactsGroup(ContentResolver resolver, ContentValues values)

This method was deprecated in API level 5. see ContactsContract

static Bitmap loadContactPhoto(Context context, Uri person, int placeholderImageResource, BitmapFactory.Options options)

This method was deprecated in API level 5. see ContactsContract

static void markAsContacted(ContentResolver resolver, long personId)

This API is no longer supported as of O.

static InputStream openContactPhotoInputStream(ContentResolver cr, Uri person)

This method was deprecated in API level 5. see ContactsContract

static Cursor queryGroups(ContentResolver resolver, long person)

This method was deprecated in API level 5. see ContactsContract

static void setPhotoData(ContentResolver cr, Uri person, byte[] data)

This method was deprecated in API level 5. see ContactsContract

Inherited methods

From class java.lang.Object

Constants

CONTENT_ITEM_TYPE

added in API level 1
String CONTENT_ITEM_TYPE

This constant was deprecated in API level 5.
see ContactsContract

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

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

CONTENT_TYPE

added in API level 1
String CONTENT_TYPE

This constant was deprecated in API level 5.
see ContactsContract

The MIME type of CONTENT_URI providing a directory of people.

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

DEFAULT_SORT_ORDER

added in API level 1
String DEFAULT_SORT_ORDER

This constant was deprecated in API level 5.
see ContactsContract

The default sort order for this table

Constant Value: "name ASC"

PRIMARY_EMAIL_ID

added in API level 1
String PRIMARY_EMAIL_ID

This constant was deprecated in API level 5.
see ContactsContract

The ID of the persons preferred email.

Type: INTEGER (foreign key to contact_methods table on the _ID field)

Constant Value: "primary_email"

PRIMARY_ORGANIZATION_ID

added in API level 1
String PRIMARY_ORGANIZATION_ID

This constant was deprecated in API level 5.
see ContactsContract

The ID of the persons preferred organization.

Type: INTEGER (foreign key to organizations table on the _ID field)

Constant Value: "primary_organization"

PRIMARY_PHONE_ID

added in API level 1
String PRIMARY_PHONE_ID

This constant was deprecated in API level 5.
see ContactsContract

The ID of the persons preferred phone number.

Type: INTEGER (foreign key to phones table on the _ID field)

Constant Value: "primary_phone"

Fields

CONTENT_FILTER_URI

added in API level 1
Uri CONTENT_FILTER_URI

This field was deprecated in API level 5.
see ContactsContract

The content:// style URL for filtering people by name. The filter argument should be passed as an additional path segment after this URI.

CONTENT_URI

added in API level 1
Uri CONTENT_URI

This field was deprecated in API level 5.
see ContactsContract

The content:// style URL for this table

DELETED_CONTENT_URI

added in API level 1
Uri DELETED_CONTENT_URI

This field was deprecated in API level 5.
see ContactsContract

The content:// style URL for the table that holds the deleted contacts.

Public methods

addToGroup

added in API level 1
Uri addToGroup (ContentResolver resolver, 
                long personId, 
                long groupId)

This method was deprecated in API level 5.
see ContactsContract

Adds a person to a group.

Parameters
resolver ContentResolver: the resolver to use

personId long: the person to add to the group

groupId long: the group to add the person to

Returns
Uri the URI of the group membership row

addToGroup

added in API level 1
Uri addToGroup (ContentResolver resolver, 
                long personId, 
                String groupName)

This method was deprecated in API level 5.
see ContactsContract

Adds a person to a group referred to by name.

Parameters
resolver ContentResolver: the resolver to use

personId long: the person to add to the group

groupName String: the name of the group to add the contact to

Returns
Uri the URI of the group membership row

Throws
IllegalStateException if the group can't be found

addToMyContactsGroup

added in API level 1
Uri addToMyContactsGroup (ContentResolver resolver, 
                long personId)

This method was deprecated in API level 5.
see ContactsContract

Adds a person to the My Contacts group.

Parameters
resolver ContentResolver: the resolver to use

personId long: the person to add to the group

Returns
Uri the URI of the group membership row

Throws
IllegalStateException if the My Contacts group can't be found

createPersonInMyContactsGroup

added in API level 1
Uri createPersonInMyContactsGroup (ContentResolver resolver, 
                ContentValues values)

This method was deprecated in API level 5.
see ContactsContract

Creates a new contacts and adds it to the "My Contacts" group.

Parameters
resolver ContentResolver: the ContentResolver to use

values ContentValues: the values to use when creating the contact

Returns
Uri the URI of the contact, or null if the operation fails

loadContactPhoto

added in API level 1
Bitmap loadContactPhoto (Context context, 
                Uri person, 
                int placeholderImageResource, 
                BitmapFactory.Options options)

This method was deprecated in API level 5.
see ContactsContract

Opens an InputStream for the person's photo and returns the photo as a Bitmap. If the person's photo isn't present returns the placeholderImageResource instead.

Parameters
context Context: the Context

person Uri: the person whose photo should be used

placeholderImageResource int: the image resource to use if the person doesn't have a photo

options BitmapFactory.Options: the decoding options, can be set to null

Returns
Bitmap

markAsContacted

added in API level 1
void markAsContacted (ContentResolver resolver, 
                long personId)

This API is no longer supported as of O.

Parameters
resolver ContentResolver

personId long

openContactPhotoInputStream

added in API level 1
InputStream openContactPhotoInputStream (ContentResolver cr, 
                Uri person)

This method was deprecated in API level 5.
see ContactsContract

Opens an InputStream for the person's photo and returns the photo as a Bitmap. If the person's photo isn't present returns the placeholderImageResource instead.

Parameters
cr ContentResolver

person Uri: the person whose photo should be used

Returns
InputStream

queryGroups

added in API level 1
Cursor queryGroups (ContentResolver resolver, 
                long person)

This method was deprecated in API level 5.
see ContactsContract

Parameters
resolver ContentResolver

person long

Returns
Cursor

setPhotoData

added in API level 1
void setPhotoData (ContentResolver cr, 
                Uri person, 
                byte[] data)

This method was deprecated in API level 5.
see ContactsContract

Set the photo for this person. data may be null

Parameters
cr ContentResolver: the ContentResolver to use

person Uri: the Uri of the person whose photo is to be updated

data byte: the byte[] that represents the photo

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)