Most visited

Recently visited

Added in API level 5

ContactsContract

public final class ContactsContract
extends Object

java.lang.Object
   ↳ android.provider.ContactsContract


联系人提供商与应用程序之间的合同。 包含支持的URI和列的定义。 这些API取代ContactsContract.Contacts

概述

ContactsContract定义了与联系人相关的信息的可扩展数据库。 联系人信息存储在三层数据模型中:

其他表格包括:

Summary

Nested classes

class ContactsContract.AggregationExceptions

联系人聚合异常表的常量,其中包含聚合规则,覆盖自动聚合使用的聚合规则。

interface ContactsContract.BaseSyncColumns

适用于同步适配器的通用列。

class ContactsContract.CommonDataKinds

容器,用于存储在ContactsContract.Data表中的常见数据类型的定义。

interface ContactsContract.ContactNameColumns

联系人名称和联系人姓名元数据列在RawContacts表中。

interface ContactsContract.ContactOptionsColumns

跟踪用户对联系人的偏好或与联系人的交互的ContactsContract.Contacts列。

interface ContactsContract.ContactStatusColumns

 

class ContactsContract.Contacts

联系人表的常量,其中包含表示同一个人的每个原始联系人汇总的记录。

interface ContactsContract.ContactsColumns

ContactsContract.Contacts引用该接触的固有特性,而不是在找到的用户指定的选项ContactsContract.ContactOptionsColumns

class ContactsContract.Data

数据表的常量,其中包含绑定到原始联系人的数据点。

interface ContactsContract.DataColumns

数据表中的列。

interface ContactsContract.DataColumnsWithJoins

组合由ContactsContract.Data表查询返回的所有列。

class ContactsContract.DataUsageFeedback

API允许应用程序将每个ContactsContract.Contacts.Data行的使用信息发送到联系人提供程序。

interface ContactsContract.DataUsageStatColumns

Data_Usage_Stat表中的列

class ContactsContract.DeletedContacts

已删除的联系人表的常量。

interface ContactsContract.DeletedContactsColumns

 

class ContactsContract.Directory

目录代表联系人语料库,例如

interface ContactsContract.DisplayNameSources

用于生成联系人显示名称的数据类型。

class ContactsContract.DisplayPhoto

帮助者类用照片文件ID访问全尺寸照片。

interface ContactsContract.FullNameStyle

各种不同风格的常量,包括名字,姓氏等全名。

class ContactsContract.Groups

组表的常量。

interface ContactsContract.GroupsColumns

 

class ContactsContract.Intents

包含用于创建或管理涉及联系人的Intents帮助器类。

class ContactsContract.PhoneLookup

代表查找电话号码结果的表格,例如来电号码。

interface ContactsContract.PhoneLookupColumns

 

interface ContactsContract.PhoneticNameStyle

捕捉一个人姓名发音的各种风格的常量。

class ContactsContract.PinnedPositions

关于联系人是否被系统联系人应用程序的用户界面中的特定位置处的用户固定的联系人特定信息。

class ContactsContract.Presence

这个类在API级别5中已被弃用。这个旧名称从未打算公开。 不使用。

interface ContactsContract.PresenceColumns

其他数据与ContactsContract.StatusColumns混合以链接回特定的_ID条目。

class ContactsContract.Profile

用户配置文件数据的常量,表示为代表用户的设备上的单个联系人。

class ContactsContract.ProfileSyncState

为同步适配器提供的表格用于存储用户个人配置文件的专用同步状态数据。

class ContactsContract.ProviderStatus

用于查询提供者的一般状态的API。

class ContactsContract.QuickContact

显示QuickContact对话框的辅助方法,显示属于特定Contacts条目的所有信息。

class ContactsContract.RawContacts

原始联系人表的常量,其中包含每个已同步帐户中每个人的一行联系信息。

interface ContactsContract.RawContactsColumns

 

class ContactsContract.RawContactsEntity

原始联系人实体表的常量,可以将其视为raw_contacts表与数据表的外部联接。

class ContactsContract.SearchSnippets

Contacts.CONTENT_FILTER_URI返回的附加列解释了过滤器匹配联系人的原因。

class ContactsContract.Settings

针对各种Account的特定于联系人的设置。

interface ContactsContract.SettingsColumns

 

interface ContactsContract.StatusColumns

社交状态更新列。

class ContactsContract.StatusUpdates

状态更新链接到ContactsContract.Data行,并通过相应的源捕获用户的最新状态更新,例如

interface ContactsContract.SyncColumns

当表格的每一行属于特定帐户时显示的列,包括帐户可能需要的同步信息。

class ContactsContract.SyncState

为同步适配器提供的表格用于存储联系人的专用同步状态数据。

Constants

String AUTHORITY

联系人提供商的权限

String CALLER_IS_SYNCADAPTER

用于插入,更新或删除查询的可选URI参数,允许调用方指定它是同步适配器。

String DEFERRED_SNIPPETING

游标“额外”包中布尔值的一个键。

String DEFERRED_SNIPPETING_QUERY

检索客户端游标原始延迟片段的关键。

String DIRECTORY_PARAM_KEY

查询参数,客户端应使用该参数来访问特定的 ContactsContract.Directory

String LIMIT_PARAM_KEY

限制返回结果数量的查询参数。

String PRIMARY_ACCOUNT_NAME

查询参数,指定主帐户。

String PRIMARY_ACCOUNT_TYPE

查询参数,指定主帐户。

String REMOVE_DUPLICATE_ENTRIES

对于布尔参数 Phone.CONTENT_URIEmail.CONTENT_URI ,并 StructuredPostal.CONTENT_URI

String STREQUENT_PHONE_ONLY

CONTENT_STREQUENT_URICONTENT_STREQUENT_FILTER_URI布尔参数,它要求ContactsProvider仅返回与电话相关的结果。

Fields

public static final Uri AUTHORITY_URI

content:// style uri给联系人提供者的权限

Public constructors

ContactsContract()

Public methods

static boolean isProfileId(long id)

此方法可用于识别给定ID是否与配置文件数据相关联。

Inherited methods

From class java.lang.Object

Constants

AUTHORITY

Added in API level 5
String AUTHORITY

联系人提供商的权限

常量值:“com.android.contacts”

CALLER_IS_SYNCADAPTER

Added in API level 5
String CALLER_IS_SYNCADAPTER

用于插入,更新或删除查询的可选URI参数,允许调用方指定它是同步适配器。 默认值是false。 如果真DIRTY不会自动设置和调用当“syncToNetwork”参数设置为false notifyChange(android.net.Uri, android.database.ContentObserver, boolean) 这可以防止不必要的额外同步,请参阅ContactsContract.RawContacts中有关删除操作的讨论。

常量值:“caller_is_syncadapter”

DEFERRED_SNIPPETING

Added in API level 21
String DEFERRED_SNIPPETING

游标“额外”包中布尔值的一个键。 布尔值表示提供者没有创建片段,并且请求片段的客户端应该这样做(true表示片段延迟到客户端)。

也可以看看:

常量值:“deferred_snippeting”

DEFERRED_SNIPPETING_QUERY

Added in API level 21
String DEFERRED_SNIPPETING_QUERY

检索客户端游标原始延迟片段的关键。

也可以看看:

常量值:“deferred_snippeting_query”

DIRECTORY_PARAM_KEY

Added in API level 11
String DIRECTORY_PARAM_KEY

查询参数,客户端应使用该参数来访问特定的ContactsContract.Directory 参数值应该是相应目录的_ID,例如content://com.android.contacts/data/emails/filter/acme?directory=3

常量值:“目录”

LIMIT_PARAM_KEY

Added in API level 11
String LIMIT_PARAM_KEY

限制返回结果数量的查询参数。 参数值应该是一个整数。

常数值:“限制”

PRIMARY_ACCOUNT_NAME

Added in API level 14
String PRIMARY_ACCOUNT_NAME

查询参数,指定主帐户。 该参数应与PRIMARY_ACCOUNT_TYPE一起使用。 处理查询的联系人提供程序可能依赖此信息来优化其查询结果。 例如,在电子邮件撰写屏幕中,其实施可以在获取可能的收件人时指定帐户,让提供者知道在撰写期间选择了哪个帐户。 提供者可以使用“主帐户”信息来优化搜索结果。

常量值:“name_for_primary_account”

PRIMARY_ACCOUNT_TYPE

Added in API level 14
String PRIMARY_ACCOUNT_TYPE

查询参数,指定主帐户。 该参数应与PRIMARY_ACCOUNT_NAME一起使用。 请参阅PRIMARY_ACCOUNT_NAME的文档。

常量值:“type_for_primary_account”

REMOVE_DUPLICATE_ENTRIES

Added in API level 21
String REMOVE_DUPLICATE_ENTRIES

对于布尔参数Phone.CONTENT_URIEmail.CONTENT_URI ,并StructuredPostal.CONTENT_URI 这使内容提供者能够删除结果中的重复条目。

常量值:“remove_duplicate_entries”

STREQUENT_PHONE_ONLY

Added in API level 21
String STREQUENT_PHONE_ONLY

CONTENT_STREQUENT_URICONTENT_STREQUENT_FILTER_URI布尔参数,它要求ContactsProvider仅返回与电话相关的结果。 例如,经常联系人列表应该包括通过电话联系的人(不是电子邮件,短信等)

常量值:“strequent_phone_only”

Fields

AUTHORITY_URI

Added in API level 5
Uri AUTHORITY_URI

content:// style uri给联系人提供者的权限

Public constructors

ContactsContract

Added in API level 5
ContactsContract ()

Public methods

isProfileId

Added in API level 14
boolean isProfileId (long id)

此方法可用于识别给定ID是否与配置文件数据相关联。 它并不一定表示该ID与有效数据绑定,只是使用此ID访问数据将导致配置文件访问检查,并且只会从配置文件返回数据。

Parameters
id long: The ID to check.
Returns
boolean Whether the ID is associated with profile data.

Hooray!