ContactsContract.Contacts

CONTENT_ITEM_TYPE

String CONTENT_ITEM_TYPE

一个人的 CONTENT_URI子目录的MIME类型。

常量值：“vnd.android.cursor.item / contact”

CONTENT_TYPE

String CONTENT_TYPE

提供人员目录的MIME类型 CONTENT_URI 。

常量值：“vnd.android.cursor.dir / contact”

CONTENT_VCARD_TYPE

String CONTENT_VCARD_TYPE

一个人的 CONTENT_URI子目录的MIME类型。

常数值：“text / x-vcard”

EXTRA_ADDRESS_BOOK_INDEX

String EXTRA_ADDRESS_BOOK_INDEX

将这个查询参数添加到一个URI以获取由地址簿索引分组的行计数作为游标额外。 对于大多数语言来说，它是排序键的第一个字母。 该参数不影响游标的主要内容。

 Example:

 import android.provider.ContactsContract.Contacts;

 Uri uri = Contacts.CONTENT_URI.buildUpon()
          .appendQueryParameter(Contacts.EXTRA_ADDRESS_BOOK_INDEX, "true")
          .build();
 Cursor cursor = getContentResolver().query(uri,
          new String[] {Contacts.DISPLAY_NAME},
          null, null, null);
 Bundle bundle = cursor.getExtras();
 if (bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES) &&
         bundle.containsKey(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS)) {
     String sections[] =
             bundle.getStringArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_TITLES);
     int counts[] = bundle.getIntArray(Contacts.EXTRA_ADDRESS_BOOK_INDEX_COUNTS);
 }
 

常量值：“android.provider.extra.ADDRESS_BOOK_INDEX”

EXTRA_ADDRESS_BOOK_INDEX_COUNTS

String EXTRA_ADDRESS_BOOK_INDEX_COUNTS

相应组的组计数数组。 包含与EXTRA_ADDRESS_BOOK_INDEX_TITLES数组相同数量的元素。

TYPE：int []

常量值：“android.provider.extra.ADDRESS_BOOK_INDEX_COUNTS”

EXTRA_ADDRESS_BOOK_INDEX_TITLES

String EXTRA_ADDRESS_BOOK_INDEX_TITLES

地址簿索引标题数组，按照与游标中的数据相同的顺序返回。

TYPE：String []

常量值：“android.provider.extra.ADDRESS_BOOK_INDEX_TITLES”

QUERY_PARAMETER_VCARD_NO_PHOTO

String QUERY_PARAMETER_VCARD_NO_PHOTO

可用于CONTENT_VCARD_URI和CONTENT_MULTI_VCARD_URI布尔参数，用于指示返回的vcard不应包含照片。 这对于获得节省空间的vcard非常有用。

常数值：“no_photo”

CONTENT_FILTER_URI

Uri CONTENT_FILTER_URI

内容：// style CONTENT_URI URI中用于“type-to-filter”功能的CONTENT_URI URI。 过滤器字符串将用于匹配联系人名称的各个部分。 过滤器参数应该在此URI之后作为附加路径段传递。

CONTENT_FREQUENT_URI

Uri CONTENT_FREQUENT_URI

内容：//风格URI，用于显示经常联系的人员列表。

CONTENT_GROUP_URI

Uri CONTENT_GROUP_URI

CONTENT_LOOKUP_URI

Uri CONTENT_LOOKUP_URI

这个表的content：// style URI，用于创建快捷方式或以其他方式创建联系人的长期链接。 此URI后面应始终加上“/”和联系人LOOKUP_KEY 。 在此之后，它可以选择性地附加一个“/”和最后一个已知的联系人ID。 这种“完整”的格式是一个重要的优化，强烈建议。

只要联系人的行ID保持不变，该URI就相当于CONTENT_URI 。 如果联系人的行ID由于同步或聚合而发生更改，则此URI将使用间接信息（同步ID或组成原始联系人）查找联系人。

查找键应该附加未编码 - 它以编码形式存储，可以在URI中使用。

CONTENT_MULTI_VCARD_URI

Uri CONTENT_MULTI_VCARD_URI

用于引用多个Contacts条目的基本Uri ，通过使用withAppendedPath(Uri, String)附加LOOKUP_KEY创建。 查找键必须与冒号（“：”）分隔符连接，并对结果字符串进行编码。 查询时提供OpenableColumns列，或通过openAssetFileDescriptor(Uri, String)打开时返回格式为vCard的引用联系人。

用法示例：

The following code snippet creates a multi-vcard URI that references all the contacts in a user's database.

 public Uri getAllContactsVcardUri() {
     Cursor cursor = getActivity().getContentResolver().query(Contacts.CONTENT_URI,
         new String[] {Contacts.LOOKUP_KEY}, null, null, null);
     if (cursor == null) {
         return null;
     }
     try {
         StringBuilder uriListBuilder = new StringBuilder();
         int index = 0;
         while (cursor.moveToNext()) {
             if (index != 0) uriListBuilder.append(':');
             uriListBuilder.append(cursor.getString(0));
             index++;
         }
         return Uri.withAppendedPath(Contacts.CONTENT_MULTI_VCARD_URI,
                 Uri.encode(uriListBuilder.toString()));
     } finally {
         cursor.close();
     }
 }
 

CONTENT_STREQUENT_FILTER_URI

Uri CONTENT_STREQUENT_FILTER_URI

用于CONTENT_STREQUENT_URI URI上的“类型到过滤器”功能的content：// style URI。 过滤器字符串将用于匹配联系人名称的各个部分。 过滤器参数应该在此URI之后作为附加路径段传递。

CONTENT_STREQUENT_URI

Uri CONTENT_STREQUENT_URI

该表格的content：// style URI与来自 ContactsContract.Data有用数据结合 ContactsContract.Data ，过滤后只包含加星标的联系人和最常联系的联系人。

CONTENT_URI

Uri CONTENT_URI

该表格的内容：//样式URI

CONTENT_VCARD_URI

Uri CONTENT_VCARD_URI

基准Uri用于引用单个Contacts条目，通过使用withAppendedPath(Uri, String)附加LOOKUP_KEY创建。 查询时提供OpenableColumns列，或通过openAssetFileDescriptor(Uri, String)打开时返回格式为vCard的引用联系人。

ENTERPRISE_CONTENT_FILTER_URI

Uri ENTERPRISE_CONTENT_FILTER_URI

它支持类似于CONTENT_FILTER_URI语义，并返回相同的列。 这个URI需要参数DIRECTORY_PARAM_KEY ，否则会抛出IllegalArgumentException。

getLookupUri

Uri getLookupUri (ContentResolver resolver, 
                Uri contactUri)

建立描述所请求的 Contacts条目的 CONTENT_LOOKUP_URI样式 Uri 。

getLookupUri

Uri getLookupUri (long contactId, 
                String lookupKey)

构建 CONTENT_LOOKUP_URI查找 Uri使用给定 _ID和 LOOKUP_KEY 。

如果无法从提供的参数构造有效的查找URI，则返回null。

isEnterpriseContactId

boolean isEnterpriseContactId (long contactId)

如果联系人ID来自企业档案中的联系人提供商，则返回TRUE。 ENTERPRISE_CONTENT_FILTER_URI可能会返回这样的联系人。

lookupContact

Uri lookupContact (ContentResolver resolver, 
                Uri lookupUri)

在给定查找URI的情况下计算内容URI（请参阅 CONTENT_URI ）。

如果找不到联系人，则返回null。

markAsContacted

void markAsContacted (ContentResolver resolver, 
                long contactId)

此方法在API级别16中已被弃用。
应该使用Android支持库的类DataUsageStatUpdater来代替。

将联系人标记为已联系。 更新两个字段： TIMES_CONTACTED和LAST_TIME_CONTACTED 。 TIMES_CONTACTED字段增加1，LAST_TIME_CONTACTED字段填充当前系统时间。

openContactPhotoInputStream

InputStream openContactPhotoInputStream (ContentResolver cr, 
                Uri contactUri)

打开联系人的缩略图照片的InputStream并将照片作为字节流返回。

openContactPhotoInputStream

InputStream openContactPhotoInputStream (ContentResolver cr, 
                Uri contactUri, 
                boolean preferHighres)

打开联系人照片的InputStream并将照片作为字节流返回。