Added in API level 5

ContactOptionsColumns


protected interface ContactOptionsColumns
ContactsContract.Contacts

Constants for the contacts table, which contains a record per aggregate of raw contacts representing the same person.

ContactsContract.Contacts.AggregationSuggestions

A read-only sub-directory of a single contact aggregate that contains all aggregation suggestions (other contacts).

ContactsContract.Contacts.Entity

A sub-directory of a contact that contains all of its ContactsContract.RawContacts as well as ContactsContract.Data rows.

ContactsContract.DataColumnsWithJoins

Combines all columns returned by ContactsContract.Data table queries.

ContactsContract.PhoneLookup

A table that represents the result of looking up a phone number, for example for caller ID.

ContactsContract.Profile

Constants for the user's profile data, which is represented as a single contact on the device that represents the user.

ContactsContract.RawContacts

Constants for the raw contacts table, which contains one row of contact information for each person in each synced account.

ContactsContract.CommonDataKinds.Callable

Convenient functionalities for "callable" data.

ContactsContract.CommonDataKinds.Contactables

A special class of data items, used to refer to types of data that can be used to attempt to start communicating with a person (Phone and Email).

ContactsContract.CommonDataKinds.Email

A data kind representing an email address.

ContactsContract.CommonDataKinds.Event

A data kind representing an event.

ContactsContract.CommonDataKinds.GroupMembership

Group Membership.

ContactsContract.CommonDataKinds.Identity

A data kind representing an Identity related to the contact.

ContactsContract.CommonDataKinds.Im

A data kind representing an IM address

ContactsContract.CommonDataKinds.Nickname

A data kind representing the contact's nickname.

ContactsContract.CommonDataKinds.Note

Notes about the contact.

ContactsContract.CommonDataKinds.Organization

A data kind representing an organization.

ContactsContract.CommonDataKinds.Phone

A data kind representing a telephone number.

ContactsContract.CommonDataKinds.Photo

A data kind representing a photo for the contact.

ContactsContract.CommonDataKinds.Relation

A data kind representing a relation.

ContactsContract.CommonDataKinds.SipAddress

A data kind representing a SIP address for the contact.

ContactsContract.CommonDataKinds.StructuredName

A data kind representing the contact's proper name.

ContactsContract.CommonDataKinds.StructuredPostal

A data kind representing a postal addresses.

ContactsContract.CommonDataKinds.Website

A data kind representing a website related to the contact.

ContactsContract.Contacts.Photo

A read-only sub-directory of a single contact that contains the contact's primary photo.

ContactsContract.Data

Constants for the data table, which contains data points tied to a raw contact.

Columns of ContactsContract.Contacts that track the user's preferences for, or interactions with, the contact.

Summary

Constants
static String

URI for a custom ringtone associated with the contact.

static String

The last time a contact was contacted.

static String

The position at which the contact is pinned.

static String

Whether the contact should always be sent to voicemail.

static String

Is the contact starred?

static String

The number of times a contact has been contacted.

Constants

CUSTOM_RINGTONE

Added in API level 5
static val CUSTOM_RINGTONE: String

URI for a custom ringtone associated with the contact. If null or missing, the default ringtone is used.

Type: TEXT (URI to the ringtone)

Value: "custom_ringtone"

LAST_TIME_CONTACTED

Added in API level 5
Deprecated in API level 29
static val LAST_TIME_CONTACTED: String

Deprecated: Contacts affinity information is no longer supported as of Android version android.os.Build.VERSION_CODES#Q. This column always contains 0.

The last time a contact was contacted.

Caution: If you publish your app to the Google Play Store, this field is obsolete, regardless of Android version. For more information, see the Contacts Provider page.

Type: INTEGER

Value: "last_time_contacted"

PINNED

Added in API level 21
static val PINNED: String

The position at which the contact is pinned. If PinnedPositions.UNPINNED, the contact is not pinned. Also see PinnedPositions.

Type: INTEGER

Value: "pinned"

SEND_TO_VOICEMAIL

Added in API level 5
static val SEND_TO_VOICEMAIL: String

Whether the contact should always be sent to voicemail. If missing, defaults to false.

Type: INTEGER (0 for false, 1 for true)

Value: "send_to_voicemail"

STARRED

Added in API level 5
static val STARRED: String

Is the contact starred?

Type: INTEGER (boolean)

Value: "starred"

TIMES_CONTACTED

Added in API level 5
Deprecated in API level 29
static val TIMES_CONTACTED: String

Deprecated: Contacts affinity information is no longer supported as of Android version android.os.Build.VERSION_CODES#Q. This column always contains 0.

The number of times a contact has been contacted.

Caution: If you publish your app to the Google Play Store, this field is obsolete, regardless of Android version. For more information, see the Contacts Provider page.

Type: INTEGER

Value: "times_contacted"