This table contains people.
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
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
Object
clone ()
Creates and returns a copy of this object.
boolean
equals (Object obj)
Indicates whether some other object is "equal to" this one.
void
finalize ()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
final
Class <?>
getClass ()
Returns the runtime class of this Object
.
int
hashCode ()
Returns a hash code value for the object.
final
void
notify ()
Wakes up a single thread that is waiting on this object's
monitor.
final
void
notifyAll ()
Wakes up all threads that are waiting on this object's monitor.
String
toString ()
Returns a string representation of the object.
final
void
wait (long millis, int nanos)
Causes the current thread to wait until another thread invokes the
notify()
method or the
notifyAll()
method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
final
void
wait (long millis)
Causes the current thread to wait until either another thread invokes the
notify()
method or the
notifyAll()
method for this object, or a
specified amount of time has elapsed.
final
void
wait ()
Causes the current thread to wait until another thread invokes the
notify()
method or the
notifyAll()
method for this object.
Constants
CONTENT_ITEM_TYPE
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
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
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
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
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
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
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
Uri CONTENT_URI
This field was deprecated
in API level 5.
see ContactsContract
The content:// style URL for this table
DELETED_CONTENT_URI
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
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
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
addToMyContactsGroup
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
createPersonInMyContactsGroup
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
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
markAsContacted
void markAsContacted (ContentResolver resolver,
long personId)
This API is no longer supported as of O.
Parameters
resolver
ContentResolver
personId
long
openContactPhotoInputStream
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
setPhotoData
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
Interfaces
Classes
Exceptions
This site uses cookies to store your preferences for site-specific language and display options.
OK
You have successfully signed up for the latest Android developer news and tips.
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.
(April 2018 — Developer Survey)