Added in API level 5

ContactsContract.ContactOptionsColumns

protected static interface ContactsContract.ContactOptionsColumns

android.provider.ContactsContract.ContactOptionsColumns


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

Summary

Constants

String CUSTOM_RINGTONE

URI for a custom ringtone associated with the contact.

String LAST_TIME_CONTACTED

This constant was deprecated in API level 29. Contacts affinity information is no longer supported as of Android version Build.VERSION_CODES.Q. This column always contains 0.

String PINNED

The position at which the contact is pinned.

String SEND_TO_VOICEMAIL

Whether the contact should always be sent to voicemail.

String STARRED

Is the contact starred?

Type: INTEGER (boolean)

String TIMES_CONTACTED

This constant was deprecated in API level 29. Contacts affinity information is no longer supported as of Android version Build.VERSION_CODES.Q. This column always contains 0.

Constants

CUSTOM_RINGTONE

Added in API level 5
public static final String CUSTOM_RINGTONE

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

Type: TEXT (URI to the ringtone)

Constant Value: "custom_ringtone"

LAST_TIME_CONTACTED

Added in API level 5
Deprecated in API level 29
public static final String LAST_TIME_CONTACTED

This constant was deprecated in API level 29.
Contacts affinity information is no longer supported as of Android version 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

Constant Value: "last_time_contacted"

PINNED

Added in API level 21
public static final String PINNED

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

Type: INTEGER

Constant Value: "pinned"

SEND_TO_VOICEMAIL

Added in API level 5
public static final String SEND_TO_VOICEMAIL

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

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

Constant Value: "send_to_voicemail"

STARRED

Added in API level 5
public static final String STARRED

Is the contact starred?

Type: INTEGER (boolean)

Constant Value: "starred"

TIMES_CONTACTED

Added in API level 5
Deprecated in API level 29
public static final String TIMES_CONTACTED

This constant was deprecated in API level 29.
Contacts affinity information is no longer supported as of Android version 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

Constant Value: "times_contacted"