Added in API level 5

Insert


class Insert
kotlin.Any
   ↳ android.provider.ContactsContract.Intents.Insert

Convenience class that contains string constants used to create contact Intents.

Summary

Constants
static String

The action code to use when adding a contact

static String

The extra field for the contact company.

static String

The extra field that allows the client to supply multiple rows of arbitrary data for a single contact created using the Intent#ACTION_INSERT or edited using Intent#ACTION_EDIT.

static String

The extra field for the contact email address.

static String

The extra field for the email isprimary flag.

static String

The extra field for the contact email type.

static String

Used to specify the account in which to create the new contact.

static String

Used to specify the data set within the account in which to create the new contact.

static String

If present, forces a bypass of quick insert mode.

static String

The extra field for an IM handle.

static String

The extra field for the IM isprimary flag.

static String

The extra field for the IM protocol

static String

The extra field for the contact job title.

static String

The extra field for the contact name.

static String

The extra field for the contact notes.

static String

The extra field for the contact phone number.

static String

The extra field for the contact phonetic name.

static String

The extra field for the phone isprimary flag.

static String

The extra field for the contact phone number type.

static String

The extra field for the contact postal address.

static String

The extra field for the postal isprimary flag.

static String

The extra field for the contact postal address type.

static String

The extra field for an optional second contact email address.

static String

The extra field for an optional second contact email type.

static String

The extra field for an optional second contact phone number.

static String

The extra field for an optional second contact phone number type.

static String

The extra field for an optional third contact email address.

static String

The extra field for an optional third contact email type.

static String

The extra field for an optional third contact phone number.

static String

The extra field for an optional third contact phone number type.

Public constructors

Constants

ACTION

Added in API level 5
static val ACTION: String

The action code to use when adding a contact

Value: "android.intent.action.INSERT"

COMPANY

Added in API level 5
static val COMPANY: String

The extra field for the contact company.

Type: String

Value: "company"

DATA

Added in API level 11
static val DATA: String

The extra field that allows the client to supply multiple rows of arbitrary data for a single contact created using the Intent#ACTION_INSERT or edited using Intent#ACTION_EDIT. It is an ArrayList of ContentValues, one per data row. Supplying this extra is similar to inserting multiple rows into the Data table, except the user gets a chance to see and edit them before saving. Each ContentValues object must have a value for Data#MIMETYPE. If supplied values are not visible in the editor UI, they will be dropped. Duplicate data will dropped. Some fields like Email.TYPE may be automatically adjusted to comply with the constraints of the specific account type. For example, an Exchange contact can only have one phone numbers of type Home, so the contact editor may choose a different type for this phone number to avoid dropping the valueable part of the row, which is the phone number.

Example:

ArrayList<ContentValues> data = new ArrayList<ContentValues>();
 
   ContentValues row1 = new ContentValues();
   row1.put(Data.MIMETYPE, Organization.CONTENT_ITEM_TYPE);
   row1.put(Organization.COMPANY, "Android");
   data.add(row1);
 
   ContentValues row2 = new ContentValues();
   row2.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
   row2.put(Email.TYPE, Email.TYPE_CUSTOM);
   row2.put(Email.LABEL, "Green Bot");
   row2.put(Email.ADDRESS, "android@android.com");
   data.add(row2);
 
   Intent intent = new Intent(Intent.ACTION_INSERT, Contacts.CONTENT_URI);
   intent.putParcelableArrayListExtra(Insert.DATA, data);
 
   startActivity(intent);
  
Value: "data"

EMAIL

Added in API level 5
static val EMAIL: String

The extra field for the contact email address.

Type: String

Value: "email"

EMAIL_ISPRIMARY

Added in API level 5
static val EMAIL_ISPRIMARY: String

The extra field for the email isprimary flag.

Type: boolean

Value: "email_isprimary"

EMAIL_TYPE

Added in API level 5
static val EMAIL_TYPE: String

The extra field for the contact email type.

Type: Either an integer value from CommonDataKinds.Email or a string specifying a custom label.

Value: "email_type"

EXTRA_ACCOUNT

Added in API level 23
static val EXTRA_ACCOUNT: String

Used to specify the account in which to create the new contact.

If this value is not provided, the user is presented with a disambiguation dialog to chose an account

Type: Account

Value: "android.provider.extra.ACCOUNT"

EXTRA_DATA_SET

Added in API level 23
static val EXTRA_DATA_SET: String

Used to specify the data set within the account in which to create the new contact.

This value is optional - if it is not specified, the contact will be created in the base account, with no data set.

Type: String

Value: "android.provider.extra.DATA_SET"

FULL_MODE

Added in API level 5
static val FULL_MODE: String

If present, forces a bypass of quick insert mode.

Value: "full_mode"

IM_HANDLE

Added in API level 5
static val IM_HANDLE: String

The extra field for an IM handle.

Type: String

Value: "im_handle"

IM_ISPRIMARY

Added in API level 5
static val IM_ISPRIMARY: String

The extra field for the IM isprimary flag.

Type: boolean

Value: "im_isprimary"

IM_PROTOCOL

Added in API level 5
static val IM_PROTOCOL: String

The extra field for the IM protocol

Value: "im_protocol"

JOB_TITLE

Added in API level 5
static val JOB_TITLE: String

The extra field for the contact job title.

Type: String

Value: "job_title"

NAME

Added in API level 5
static val NAME: String

The extra field for the contact name.

Type: String

Value: "name"

NOTES

Added in API level 5
static val NOTES: String

The extra field for the contact notes.

Type: String

Value: "notes"

PHONE

Added in API level 5
static val PHONE: String

The extra field for the contact phone number.

Type: String

Value: "phone"

PHONETIC_NAME

Added in API level 5
static val PHONETIC_NAME: String

The extra field for the contact phonetic name.

Type: String

Value: "phonetic_name"

PHONE_ISPRIMARY

Added in API level 5
static val PHONE_ISPRIMARY: String

The extra field for the phone isprimary flag.

Type: boolean

Value: "phone_isprimary"

PHONE_TYPE

Added in API level 5
static val PHONE_TYPE: String

The extra field for the contact phone number type.

Type: Either an integer value from CommonDataKinds.Phone, or a string specifying a custom label.

Value: "phone_type"

POSTAL

Added in API level 5
static val POSTAL: String

The extra field for the contact postal address.

Type: String

Value: "postal"

POSTAL_ISPRIMARY

Added in API level 5
static val POSTAL_ISPRIMARY: String

The extra field for the postal isprimary flag.

Type: boolean

Value: "postal_isprimary"

POSTAL_TYPE

Added in API level 5
static val POSTAL_TYPE: String

The extra field for the contact postal address type.

Type: Either an integer value from CommonDataKinds.StructuredPostal or a string specifying a custom label.

Value: "postal_type"

SECONDARY_EMAIL

Added in API level 5
static val SECONDARY_EMAIL: String

The extra field for an optional second contact email address.

Type: String

Value: "secondary_email"

SECONDARY_EMAIL_TYPE

Added in API level 5
static val SECONDARY_EMAIL_TYPE: String

The extra field for an optional second contact email type.

Type: Either an integer value from CommonDataKinds.Email or a string specifying a custom label.

Value: "secondary_email_type"

SECONDARY_PHONE

Added in API level 5
static val SECONDARY_PHONE: String

The extra field for an optional second contact phone number.

Type: String

Value: "secondary_phone"

SECONDARY_PHONE_TYPE

Added in API level 5
static val SECONDARY_PHONE_TYPE: String

The extra field for an optional second contact phone number type.

Type: Either an integer value from CommonDataKinds.Phone, or a string specifying a custom label.

Value: "secondary_phone_type"

TERTIARY_EMAIL

Added in API level 5
static val TERTIARY_EMAIL: String

The extra field for an optional third contact email address.

Type: String

Value: "tertiary_email"

TERTIARY_EMAIL_TYPE

Added in API level 5
static val TERTIARY_EMAIL_TYPE: String

The extra field for an optional third contact email type.

Type: Either an integer value from CommonDataKinds.Email or a string specifying a custom label.

Value: "tertiary_email_type"

TERTIARY_PHONE

Added in API level 5
static val TERTIARY_PHONE: String

The extra field for an optional third contact phone number.

Type: String

Value: "tertiary_phone"

TERTIARY_PHONE_TYPE

Added in API level 5
static val TERTIARY_PHONE_TYPE: String

The extra field for an optional third contact phone number type.

Type: Either an integer value from CommonDataKinds.Phone, or a string specifying a custom label.

Value: "tertiary_phone_type"

Public constructors

Insert

Insert()