Added in API level 5

Settings


class Settings : ContactsContract.SettingsColumns
kotlin.Any
   ↳ android.provider.ContactsContract.Settings

Contacts-specific settings for various Account's.

A settings entry for an account is created automatically when a raw contact or group is inserted that references it. Settings entries cannot be deleted as long as raw contacts or groups continue to reference it; in order to delete a settings entry all raw contacts and groups referencing the account must be deleted first.

Columns

Settings
String ACCOUNT_NAME read/write-once The name of the account instance to which this row belongs.
String ACCOUNT_TYPE read/write-once The type of account to which this row belongs, which when paired with ACCOUNT_NAME identifies a specific account.
int SHOULD_SYNC read/write Depending on the mode defined by the sync-adapter, this flag controls the top-level sync behavior for this data source.
int UNGROUPED_VISIBLE read/write Flag indicating if contacts without any CommonDataKinds.GroupMembership entries should be visible in any user interface.
int ANY_UNSYNCED read-only Read-only flag indicating if this SHOULD_SYNC or any Groups#SHOULD_SYNC under this account have been marked as unsynced.
int UNGROUPED_COUNT read-only Read-only count of Contacts from a specific source that have no CommonDataKinds.GroupMembership entries.
int UNGROUPED_WITH_PHONES read-only Read-only count of Contacts from a specific source that have no CommonDataKinds.GroupMembership entries, and also have phone numbers.

Summary

Constants
static String

Action used to launch the UI to set the default account for new contacts.

static String

The MIME-type of CONTENT_URI providing a single setting.

static String

The MIME-type of CONTENT_URI providing a directory of settings.

Inherited constants
Public methods
static Account?

Get the account that is set as the default account for new contacts, which should be initially selected when creating a new contact on contact management apps.

Properties
static Uri!

The content:// style URI for this table

Constants

ACTION_SET_DEFAULT_ACCOUNT

Added in API level 33
static val ACTION_SET_DEFAULT_ACCOUNT: String

Action used to launch the UI to set the default account for new contacts.

Value: "android.provider.action.SET_DEFAULT_ACCOUNT"

CONTENT_ITEM_TYPE

Added in API level 5
static val CONTENT_ITEM_TYPE: String

The MIME-type of CONTENT_URI providing a single setting.

Value: "vnd.android.cursor.item/setting"

CONTENT_TYPE

Added in API level 5
static val CONTENT_TYPE: String

The MIME-type of CONTENT_URI providing a directory of settings.

Value: "vnd.android.cursor.dir/setting"

Public methods

getDefaultAccount

Added in API level 33
static fun getDefaultAccount(resolver: ContentResolver): Account?

Get the account that is set as the default account for new contacts, which should be initially selected when creating a new contact on contact management apps. If the setting has not been set by any app, it will return null. Once the setting is set to non-null Account, it can still be set to null in the future.

Parameters
resolver ContentResolver: the ContentResolver to query. This value cannot be null.
Return
Account? the default account for new contacts, or null if it's not set or set to NULL account.

Properties

CONTENT_URI

Added in API level 5
static val CONTENT_URI: Uri!

The content:// style URI for this table