Most visited

Recently visited

Added in API level 5

ContactsContract.CommonDataKinds.Email

public static final class ContactsContract.CommonDataKinds.Email
extends Object implements ContactsContract.DataColumnsWithJoins, ContactsContract.CommonDataKinds.CommonColumns

java.lang.Object
   ↳ android.provider.ContactsContract.CommonDataKinds.Email


代表电子邮件地址的数据类型。

您可以使用为 ContactsContract.Data定义的所有列以及以下别名。

Column aliases

Type Alias Data column
String ADDRESS DATA1 Email address itself.
int TYPE DATA2 Allowed values are:

String LABEL DATA3

Summary

Constants

String ADDRESS

电子邮件地址。

String CONTENT_ITEM_TYPE

将其存储在数据表中时使用的MIME类型。

String CONTENT_TYPE

提供电子邮件地址目录的MIME类型 CONTENT_URI

String DISPLAY_NAME

电子邮件地址的显示名称

类型:TEXT

String EXTRA_ADDRESS_BOOK_INDEX

将这个查询参数添加到一个URI以获取由地址簿索引分组的行计数作为游标额外。

String EXTRA_ADDRESS_BOOK_INDEX_COUNTS

相应组的组计数数组。

String EXTRA_ADDRESS_BOOK_INDEX_TITLES

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

int TYPE_HOME

int TYPE_MOBILE

int TYPE_OTHER

int TYPE_WORK

Inherited constants

From interface android.provider.ContactsContract.CommonDataKinds.CommonColumns
From interface android.provider.BaseColumns
From interface android.provider.ContactsContract.DataColumns
From interface android.provider.ContactsContract.StatusColumns
From interface android.provider.ContactsContract.RawContactsColumns
From interface android.provider.ContactsContract.ContactsColumns
From interface android.provider.ContactsContract.ContactNameColumns
From interface android.provider.ContactsContract.ContactOptionsColumns
From interface android.provider.ContactsContract.ContactStatusColumns
From interface android.provider.ContactsContract.DataUsageStatColumns
From interface android.provider.ContactsContract.CommonDataKinds.BaseTypes

Fields

public static final Uri CONTENT_FILTER_URI

内容://使用过滤器查找电子邮件的样式网址。

public static final Uri CONTENT_LOOKUP_URI

内容://用于通过电子邮件地址查找数据行的样式URL。

public static final Uri CONTENT_URI

内容://样式URI,用于 CONTENT_ITEM_TYPE MIME类型的所有数据记录,以及关联的原始联系人和聚合联系人数据。

public static final Uri ENTERPRISE_CONTENT_FILTER_URI

它支持类似于 CONTENT_FILTER_URI语义,并返回相同的列。

public static final Uri ENTERPRISE_CONTENT_LOOKUP_URI

用于企业电子邮件查找的URI。

Public methods

static final CharSequence getTypeLabel(Resources res, int type, CharSequence label)

返回一个 CharSequence最能描述给定的类型,可能取代定 LABEL的价值 TYPE_CUSTOM

static final int getTypeLabelResource(int type)

返回最能描述给定 TYPE的字符串资源。

Inherited methods

From class java.lang.Object

Constants

ADDRESS

Added in API level 11
String ADDRESS

电子邮件地址。

类型:TEXT

常量值:“data1”

CONTENT_ITEM_TYPE

Added in API level 5
String CONTENT_ITEM_TYPE

将其存储在数据表中时使用的MIME类型。

常量值:“vnd.android.cursor.item / email_v2”

CONTENT_TYPE

Added in API level 5
String CONTENT_TYPE

提供电子邮件地址目录的MIME类型 CONTENT_URI

常量值:“vnd.android.cursor.dir / email_v2”

DISPLAY_NAME

Added in API level 5
String DISPLAY_NAME

电子邮件地址的显示名称

类型:TEXT

常量值:“data4”

EXTRA_ADDRESS_BOOK_INDEX

Added in API level 21
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

Added in API level 21
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

Added in API level 21
String EXTRA_ADDRESS_BOOK_INDEX_TITLES

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

TYPE:String []

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

TYPE_HOME

Added in API level 5
int TYPE_HOME

常数值:1(0x00000001)

TYPE_MOBILE

Added in API level 5
int TYPE_MOBILE

常量值:4(0x00000004)

TYPE_OTHER

Added in API level 5
int TYPE_OTHER

常量值:3(0x00000003)

TYPE_WORK

Added in API level 5
int TYPE_WORK

常量值:2(0x00000002)

Fields

CONTENT_FILTER_URI

Added in API level 5
Uri CONTENT_FILTER_URI

内容://使用过滤器查找电子邮件的样式网址。 过滤器返回MIME类型CONTENT_ITEM_TYPE记录。 该过滤器适用于显示名称以及电子邮件地址。 过滤器参数应该在此URI之后作为附加路径段传递。

以下示例中的查询将返回“Robert Parr(bob@incredibles.com)”以及“Bob Parr(incredible@android.com)”。

 Uri uri = Uri.withAppendedPath(Email.CONTENT_LOOKUP_URI, Uri.encode("bob"));
 Cursor c = getContentResolver().query(uri,
          new String[]{Email.DISPLAY_NAME, Email.DATA},
          null, null, null);
 

CONTENT_LOOKUP_URI

Added in API level 5
Uri CONTENT_LOOKUP_URI

内容://用于通过电子邮件地址查找数据行的样式URL。 查找参数(电子邮件地址)应作为此URI之后的附加路径段传递。

例:

 Uri uri = Uri.withAppendedPath(Email.CONTENT_LOOKUP_URI, Uri.encode(email));
 Cursor c = getContentResolver().query(uri,
          new String[]{Email.CONTACT_ID, Email.DISPLAY_NAME, Email.DATA},
          null, null, null);
 

CONTENT_URI

Added in API level 5
Uri CONTENT_URI

内容://样式URI,用于 CONTENT_ITEM_TYPE MIME类型的所有数据记录,以及关联的原始联系人和聚合联系人数据。

ENTERPRISE_CONTENT_FILTER_URI

Added in API level 24
Uri ENTERPRISE_CONTENT_FILTER_URI

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

ENTERPRISE_CONTENT_LOOKUP_URI

Added in API level 23
Uri ENTERPRISE_CONTENT_LOOKUP_URI

用于企业电子邮件查找的URI。

它支持与CONTENT_LOOKUP_URI相同的语义并返回相同的列。 如果设备没有链接到当前配置文件的corp配置文件,则它的行为方式与CONTENT_LOOKUP_URI 如果有一个corp配置文件链接到当前配置文件,它首先查询个人联系人数据库,如果没有找到匹配的联系人,则查询corp联系人数据库。

如果结果来自corp配置文件,则会对数据进行以下更改:

getLookupUri(long, String)构建的 _IDLOOKUP_KEY由此API返回的联系人查找URL可以传递给 showQuickContact(Context, Rect, Uri, int, String[])即使联系人来自公司配置文件。

 Uri lookupUri = Uri.withAppendedPath(Email.ENTERPRISE_CONTENT_LOOKUP_URI,
         Uri.encode(email));
 

Public methods

getTypeLabel

Added in API level 5
CharSequence getTypeLabel (Resources res, 
                int type, 
                CharSequence label)

返回一个 CharSequence最能描述给定的类型,可能取代定 LABEL的价值 TYPE_CUSTOM

Parameters
res Resources
type int
label CharSequence
Returns
CharSequence

getTypeLabelResource

Added in API level 5
int getTypeLabelResource (int type)

返回最能描述给定的TYPE的字符串资源。 将始终返回有效的资源。

Parameters
type int
Returns
int

Hooray!