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
java.lang.Object
   ↳ android.provider.Contacts.People

This class was deprecated in API level 5.
see ContactsContract

Class Overview

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 NON_SYNCABLE_ACCOUNT Used to indicate that this account is not synced
String NON_SYNCABLE_ACCOUNT_TYPE Used to indicate that this account is not synced
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
String _SYNC_ACCOUNT The account that was used to sync the entry to the device.
String _SYNC_ACCOUNT_TYPE The type of the account that was used to sync the entry to the device.
String _SYNC_DIRTY Used to indicate that local, unsynced, changes are present.
String _SYNC_ID The unique ID for a row assigned by the sync source.
String _SYNC_LOCAL_ID Used in temporary provider while syncing, always NULL for rows in persistent providers.
String _SYNC_MARK Used only in persistent providers, and only during merging.
String _SYNC_TIME The last time, from the sync source's point of view, that this row has been synchronized.
String _SYNC_VERSION The version of the row, as assigned by the server.
[Expand]
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
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String CONTENT_ITEM_TYPE

Added in API level 1

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"

public static final String CONTENT_TYPE

Added in API level 1

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"

public static final String DEFAULT_SORT_ORDER

Added in API level 1

This constant was deprecated in API level 5.
see ContactsContract

The default sort order for this table

Constant Value: "name ASC"

public static final String NON_SYNCABLE_ACCOUNT

Used to indicate that this account is not synced

Constant Value: "non_syncable"

public static final String NON_SYNCABLE_ACCOUNT_TYPE

Used to indicate that this account is not synced

Constant Value: "android.local"

public static final String PRIMARY_EMAIL_ID

Added in API level 1

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"

public static final String PRIMARY_ORGANIZATION_ID

Added in API level 1

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"

public static final String PRIMARY_PHONE_ID

Added in API level 1

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"

public static final String _SYNC_ACCOUNT

The account that was used to sync the entry to the device.

Type: TEXT

Constant Value: "_sync_account"

public static final String _SYNC_ACCOUNT_TYPE

The type of the account that was used to sync the entry to the device.

Type: TEXT

Constant Value: "_sync_account_type"

public static final String _SYNC_DIRTY

Used to indicate that local, unsynced, changes are present.

Type: INTEGER (long)

Constant Value: "_sync_dirty"

public static final String _SYNC_ID

The unique ID for a row assigned by the sync source. NULL if the row has never been synced.

Type: TEXT

Constant Value: "_sync_id"

public static final String _SYNC_LOCAL_ID

Used in temporary provider while syncing, always NULL for rows in persistent providers.

Type: INTEGER (long)

Constant Value: "_sync_local_id"

public static final String _SYNC_MARK

Used only in persistent providers, and only during merging.

Type: INTEGER (long)

Constant Value: "_sync_mark"

public static final String _SYNC_TIME

The last time, from the sync source's point of view, that this row has been synchronized.

Type: INTEGER (long)

Constant Value: "_sync_time"

public static final String _SYNC_VERSION

The version of the row, as assigned by the server.

Type: TEXT

Constant Value: "_sync_version"

Fields

public static final Uri CONTENT_FILTER_URI

Added in API level 1

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.

public static final Uri CONTENT_URI

Added in API level 1

This field was deprecated in API level 5.
see ContactsContract

The content:// style URL for this table

public static final Uri DELETED_CONTENT_URI

Added in API level 1

This field was deprecated in API level 5.
see ContactsContract

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

Public Methods

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

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

Adds a person to a group.

Parameters
resolver the resolver to use
personId the person to add to the group
groupId the group to add the person to
Returns
  • the URI of the group membership row

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

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

Adds a person to a group referred to by name.

Parameters
resolver the resolver to use
personId the person to add to the group
groupName the name of the group to add the contact to
Returns
  • the URI of the group membership row
Throws
IllegalStateException if the group can't be found

public static Uri addToMyContactsGroup ( ContentResolver resolver, long personId)

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

Adds a person to the My Contacts group.

Parameters
resolver the resolver to use
personId the person to add to the group
Returns
  • the URI of the group membership row
Throws
IllegalStateException if the My Contacts group can't be found

public static Uri createPersonInMyContactsGroup ( ContentResolver resolver, ContentValues values)

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

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

Parameters
resolver the ContentResolver to use
values the values to use when creating the contact
Returns
  • the URI of the contact, or null if the operation fails

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

Added in API level 1

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 the Context
person the person whose photo should be used
placeholderImageResource the image resource to use if the person doesn't have a photo
options the decoding options, can be set to null

public static void markAsContacted ( ContentResolver resolver, long personId)

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

Mark a person as having been contacted.

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

public static InputStream openContactPhotoInputStream ( ContentResolver cr, Uri person)

Added in API level 1

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
person the person whose photo should be used

public static Cursor queryGroups ( ContentResolver resolver, long person)

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

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

Added in API level 1

This method was deprecated in API level 5.
see ContactsContract

Set the photo for this person. data may be null

Parameters
cr the ContentResolver to use
person the Uri of the person whose photo is to be updated
data the byte[] that represents the photo