public static final class

ContactsContract.CommonDataKinds.Email

extends Object
implements ContactsContract.CommonDataKinds.CommonColumns ContactsContract.DataColumnsWithJoins

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

Class Overview

A data kind representing an email address.

You can use all columns defined for ContactsContract.Data as well as the following aliases.

Column aliases

Type Alias Data column

String ADDRESS DATA1 Email address itself.

int

Type	Alias	Data column
String	`ADDRESS`	`DATA1`	Email address itself.
int	`TYPE`	`DATA2`	Allowed values are: `TYPE_CUSTOM` . Put the actual type in `LABEL` . `TYPE_HOME` `TYPE_WORK` `TYPE_OTHER` `TYPE_MOBILE`
String	`LABEL`	`DATA3`


          
           TYPE


          
           DATA2

Allowed values are:

TYPE_CUSTOM . Put the actual type in LABEL .
TYPE_HOME
TYPE_WORK
TYPE_OTHER
TYPE_MOBILE

String LABEL DATA3

Summary

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
int	TYPE_HOME
int	TYPE_MOBILE
int	TYPE_OTHER
int	TYPE_WORK

[Expand]

Inherited Constants

From interface android.provider.BaseColumns

From interface android.provider.ContactsContract.CommonDataKinds.BaseTypes

From interface android.provider.ContactsContract.CommonDataKinds.CommonColumns

From interface android.provider.ContactsContract.ContactNameColumns

String	DISPLAY_NAME_ALTERNATIVE	An alternative representation of the display name, such as "family name first" instead of "given name first" for Western names.
String	DISPLAY_NAME_PRIMARY	The standard text shown as the contact's display name, based on the best available information for the contact (for example, it might be the email address if the name is not available).
String	DISPLAY_NAME_SOURCE	The kind of data that is used as the display name for the contact, such as structured name or email address.
String	PHONETIC_NAME	Pronunciation of the full name in the phonetic alphabet specified by `PHONETIC_NAME_STYLE` .
String	PHONETIC_NAME_STYLE	The phonetic alphabet used to represent the `PHONETIC_NAME` .
String	SORT_KEY_ALTERNATIVE	Sort key based on the alternative representation of the full name, `DISPLAY_NAME_ALTERNATIVE` .
String	SORT_KEY_PRIMARY	Sort key that takes into account locale-based traditions for sorting names in address books.

From interface android.provider.ContactsContract.ContactOptionsColumns

From interface android.provider.ContactsContract.ContactStatusColumns

From interface android.provider.ContactsContract.ContactsColumns

From interface android.provider.ContactsContract.DataColumns

String	DATA1	Generic data column, the meaning is `MIMETYPE` specific
String	DATA10	Generic data column, the meaning is `MIMETYPE` specific
String	DATA11	Generic data column, the meaning is `MIMETYPE` specific
String	DATA12	Generic data column, the meaning is `MIMETYPE` specific
String	DATA13	Generic data column, the meaning is `MIMETYPE` specific
String	DATA14	Generic data column, the meaning is `MIMETYPE` specific
String	DATA15	Generic data column, the meaning is `MIMETYPE` specific.
String	DATA2	Generic data column, the meaning is `MIMETYPE` specific
String	DATA3	Generic data column, the meaning is `MIMETYPE` specific
String	DATA4	Generic data column, the meaning is `MIMETYPE` specific
String	DATA5	Generic data column, the meaning is `MIMETYPE` specific
String	DATA6	Generic data column, the meaning is `MIMETYPE` specific
String	DATA7	Generic data column, the meaning is `MIMETYPE` specific
String	DATA8	Generic data column, the meaning is `MIMETYPE` specific
String	DATA9	Generic data column, the meaning is `MIMETYPE` specific
String	DATA_VERSION	The version of this data record.
String	IS_PRIMARY	Whether this is the primary entry of its kind for the raw contact it belongs to.
String	IS_READ_ONLY	The "read-only" flag: "0" by default, "1" if the row cannot be modified or deleted except by a sync adapter.
String	IS_SUPER_PRIMARY	Whether this is the primary entry of its kind for the aggregate contact it belongs to.
String	MIMETYPE	The MIME type of the item represented by this row.
String	RAW_CONTACT_ID	A reference to the `_ID` that this data belongs to.
String	SYNC1	Generic column for use by sync adapters.
String	SYNC2	Generic column for use by sync adapters.
String	SYNC3	Generic column for use by sync adapters.
String	SYNC4	Generic column for use by sync adapters.

From interface android.provider.ContactsContract.DataUsageStatColumns

From interface android.provider.ContactsContract.RawContactsColumns

From interface android.provider.ContactsContract.StatusColumns

Fields
public static final Uri	CONTENT_FILTER_URI	The content:// style URL for email lookup using a filter.
public static final Uri	CONTENT_LOOKUP_URI	The content:// style URL for looking up data rows by email address.
public static final Uri	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
final static CharSequence	getTypeLabel ( Resources res, int type, CharSequence label) Return a `CharSequence` that best describes the given type, possibly substituting the given `LABEL` value for `TYPE_CUSTOM` .
final static int	getTypeLabelResource (int type) Return the string resource that best describes the given `TYPE` .

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Constants

public static final String ADDRESS

Added in API level 11

The email address.

Type: TEXT

Constant Value: "data1"

public static final String CONTENT_ITEM_TYPE

Added in API level 5

MIME type used when storing this in data table.

Constant Value: "vnd.android.cursor.item/email_v2"

public static final String CONTENT_TYPE

Added in API level 5

The MIME type of CONTENT_URI providing a directory of email addresses.

Constant Value: "vnd.android.cursor.dir/email_v2"

public static final String DISPLAY_NAME

Added in API level 5

The display name for the email address

Type: TEXT

Constant Value: "data4"

public static final int TYPE_HOME

Added in API level 5

Constant Value: 1 (0x00000001)

public static final int TYPE_MOBILE

Added in API level 5

Constant Value: 4 (0x00000004)

public static final int TYPE_OTHER

Added in API level 5

Constant Value: 3 (0x00000003)

public static final int TYPE_WORK

Added in API level 5

Constant Value: 2 (0x00000002)

Fields

public static final Uri CONTENT_FILTER_URI

Added in API level 5

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 ([email protected])" as well as "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);

public static final Uri CONTENT_LOOKUP_URI

Added in API level 5

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);

public static final Uri CONTENT_URI

Added in API level 5

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

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

Added in API level 5

Return a CharSequence that best describes the given type, possibly substituting the given LABEL value for TYPE_CUSTOM .

public static final int getTypeLabelResource (int type)

Added in API level 5

Return the string resource that best describes the given TYPE . Will always return a valid resource.

Results

Interfaces

Classes

Exceptions

ContactsContract.CommonDataKinds.Email

Class Overview

Column aliases

Summary

Constants

public static final String ADDRESS

public static final String CONTENT_ITEM_TYPE

public static final String CONTENT_TYPE

public static final String DISPLAY_NAME

public static final int TYPE_HOME

public static final int TYPE_MOBILE

public static final int TYPE_OTHER

public static final int TYPE_WORK

Fields

public static final Uri CONTENT_FILTER_URI

public static final Uri CONTENT_LOOKUP_URI

public static final Uri CONTENT_URI

Public Methods

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

public static final int getTypeLabelResource (int type)