java.lang.Object | |
↳ | android.provider.ContactsContract.CommonDataKinds.Email |
A data kind representing an email address.
You can use all columns defined for ContactsContract.Data
as
well as the following aliases.
Type | Alias | Data column | |
---|---|---|---|
String | ADDRESS |
DATA1 |
Email address itself. |
int | TYPE |
DATA2 |
Allowed values are:
|
String | LABEL |
DATA3 |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | ADDRESS | The email address. | |||||||||
String | CONTENT_ITEM_TYPE | MIME type used when storing this in data table. | |||||||||
String | CONTENT_TYPE |
The MIME type of CONTENT_URI providing a directory of email addresses.
|
|||||||||
String | DISPLAY_NAME |
The display name for the email address
Type: TEXT |
|||||||||
String | EXTRA_ADDRESS_BOOK_INDEX | Add this query parameter to a URI to get back row counts grouped by the address book index as cursor extras. | |||||||||
String | EXTRA_ADDRESS_BOOK_INDEX_COUNTS | The array of group counts for the corresponding group. | |||||||||
String | EXTRA_ADDRESS_BOOK_INDEX_TITLES | The array of address book index titles, which are returned in the same order as the data in the cursor. | |||||||||
int | TYPE_HOME | ||||||||||
int | TYPE_MOBILE | ||||||||||
int | TYPE_OTHER | ||||||||||
int | TYPE_WORK |
[Expand]
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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CONTENT_FILTER_URI |
The content:// style URL for email lookup using a filter. |
||||||||||
CONTENT_LOOKUP_URI |
The content:// style URL for looking up data rows by email address. |
||||||||||
CONTENT_URI |
The content:// style URI for all data records of the
CONTENT_ITEM_TYPE MIME type, combined with the
associated raw contact and aggregate contact data.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Return a
CharSequence that best describes the given type,
possibly substituting the given LABEL value
for TYPE_CUSTOM .
| |||||||||||
Return the string resource that best describes the given
TYPE .
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
The email address.
Type: TEXT
MIME type used when storing this in data table.
The MIME type of CONTENT_URI
providing a directory of email addresses.
The display name for the email address
Type: TEXT
Add this query parameter to a URI to get back row counts grouped by the address book index as cursor extras. For most languages it is the first letter of the sort key. This parameter does not affect the main content of the cursor.
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); }
The array of group counts for the corresponding group. Contains the same number of elements as the EXTRA_ADDRESS_BOOK_INDEX_TITLES array.
TYPE: int[]
The array of address book index titles, which are returned in the same order as the data in the cursor.
TYPE: String[]
The content:// style URL for email lookup using a filter. The filter returns
records of MIME type CONTENT_ITEM_TYPE
. The filter is applied
to display names as well as email addresses. The filter argument should be passed
as an additional path segment after this URI.
The query in the following example will return "Robert Parr (bob@incredibles.com)" as well as "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);
The content:// style URL for looking up data rows by email address. The lookup argument, an email address, should be passed as an additional path segment after this URI.
Example:
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);
The content:// style URI for all data records of the
CONTENT_ITEM_TYPE
MIME type, combined with the
associated raw contact and aggregate contact data.
Return a CharSequence
that best describes the given type,
possibly substituting the given LABEL
value
for TYPE_CUSTOM
.
Return the string resource that best describes the given
TYPE
. Will always return a valid resource.