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
定义的所有列以及以下别名。
Type | Alias | Data column | |
---|---|---|---|
String | ADDRESS |
DATA1 |
Email address itself. |
int | TYPE |
DATA2 |
Allowed values are:
|
String | LABEL |
DATA3 |
Constants |
|
---|---|
String |
ADDRESS 电子邮件地址。 |
String |
CONTENT_ITEM_TYPE 将其存储在数据表中时使用的MIME类型。 |
String |
CONTENT_TYPE 提供电子邮件地址目录的MIME类型 |
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,用于 |
public static final Uri |
ENTERPRISE_CONTENT_FILTER_URI 它支持类似于 |
public static final Uri |
ENTERPRISE_CONTENT_LOOKUP_URI 用于企业电子邮件查找的URI。 |
Public methods |
|
---|---|
static final CharSequence |
getTypeLabel(Resources res, int type, CharSequence label) 返回一个 |
static final int |
getTypeLabelResource(int type) 返回最能描述给定 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
String CONTENT_ITEM_TYPE
将其存储在数据表中时使用的MIME类型。
常量值:“vnd.android.cursor.item / email_v2”
String CONTENT_TYPE
提供电子邮件地址目录的MIME类型 CONTENT_URI
。
常量值:“vnd.android.cursor.dir / email_v2”
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”
String EXTRA_ADDRESS_BOOK_INDEX_COUNTS
相应组的组计数数组。 包含与EXTRA_ADDRESS_BOOK_INDEX_TITLES数组相同数量的元素。
TYPE:int []
常量值:“android.provider.extra.ADDRESS_BOOK_INDEX_COUNTS”
String EXTRA_ADDRESS_BOOK_INDEX_TITLES
地址簿索引标题数组,按照与游标中的数据相同的顺序返回。
TYPE:String []
常量值:“android.provider.extra.ADDRESS_BOOK_INDEX_TITLES”
Uri CONTENT_FILTER_URI
内容://使用过滤器查找电子邮件的样式网址。 过滤器返回MIME类型CONTENT_ITEM_TYPE
记录。 该过滤器适用于显示名称以及电子邮件地址。 过滤器参数应该在此URI之后作为附加路径段传递。
以下示例中的查询将返回“Robert Parr([email protected])”以及“Bob Parr([email protected])”。
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);
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);
Uri CONTENT_URI
内容://样式URI,用于 CONTENT_ITEM_TYPE
MIME类型的所有数据记录,以及关联的原始联系人和聚合联系人数据。
Uri ENTERPRISE_CONTENT_FILTER_URI
它支持类似于CONTENT_FILTER_URI
语义并返回相同的列。 该URI需要参数DIRECTORY_PARAM_KEY
,否则会抛出IllegalArgumentException。
Uri ENTERPRISE_CONTENT_LOOKUP_URI
用于企业电子邮件查找的URI。
它支持与CONTENT_LOOKUP_URI
相同的语义并返回相同的列。 如果设备没有链接到当前配置文件的corp配置文件,则它的行为方式与CONTENT_LOOKUP_URI
。 如果有一个corp配置文件链接到当前配置文件,它首先查询个人联系人数据库,如果没有找到匹配的联系人,则查询corp联系人数据库。
如果结果来自corp配置文件,则会对数据进行以下更改:
PHOTO_THUMBNAIL_URI
and PHOTO_URI
will be rewritten to special URIs. Use openAssetFileDescriptor(Uri, String)
or its siblings to load pictures from them. PHOTO_ID
and PHOTO_FILE_ID
will be set to null. Do not use them. CONTACT_ID
s. In order to tell whether a contact is from the corp profile, use isEnterpriseContactId(long)
. LOOKUP_KEY
s too. 由 getLookupUri(long, String)
构建的 _ID
和 LOOKUP_KEY
由此API返回的联系人查找URL可以传递给 showQuickContact(Context, Rect, Uri, int, String[])
即使联系人来自公司配置文件。
Uri lookupUri = Uri.withAppendedPath(Email.ENTERPRISE_CONTENT_LOOKUP_URI, Uri.encode(email));
CharSequence getTypeLabel (Resources res, int type, CharSequence label)
返回一个 CharSequence
最能描述给定的类型,可能取代定 LABEL
的价值 TYPE_CUSTOM
。
Parameters | |
---|---|
res |
Resources
|
type |
int
|
label |
CharSequence
|
Returns | |
---|---|
CharSequence |
int getTypeLabelResource (int type)
返回最能描述给定的TYPE
的字符串资源。 将始终返回有效的资源。
Parameters | |
---|---|
type |
int
|
Returns | |
---|---|
int |