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 method was deprecated in API level 5. see ContactsContract

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 method was deprecated in API level 5.
see ContactsContract

Mark a person as having been contacted.

Parameters
resolver ContentResolver: the ContentResolver to use
personId long: the person who was contacted

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.

Hooray!

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.