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 |
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 | |
---|---|
Insert() |
Constants
ACTION
static val ACTION: String
The action code to use when adding a contact
Value: "android.intent.action.INSERT"
COMPANY
static val COMPANY: String
The extra field for the contact company.
Type: String
Value: "company"
DATA
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"
static val EMAIL: String
The extra field for the contact email address.
Type: String
Value: "email"
EMAIL_ISPRIMARY
static val EMAIL_ISPRIMARY: String
The extra field for the email isprimary flag.
Type: boolean
Value: "email_isprimary"
EMAIL_TYPE
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
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
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
static val FULL_MODE: String
If present, forces a bypass of quick insert mode.
Value: "full_mode"
IM_HANDLE
static val IM_HANDLE: String
The extra field for an IM handle.
Type: String
Value: "im_handle"
IM_ISPRIMARY
static val IM_ISPRIMARY: String
The extra field for the IM isprimary flag.
Type: boolean
Value: "im_isprimary"
IM_PROTOCOL
static val IM_PROTOCOL: String
The extra field for the IM protocol
Value: "im_protocol"
JOB_TITLE
static val JOB_TITLE: String
The extra field for the contact job title.
Type: String
Value: "job_title"
NAME
static val NAME: String
The extra field for the contact name.
Type: String
Value: "name"
NOTES
static val NOTES: String
The extra field for the contact notes.
Type: String
Value: "notes"
PHONE
static val PHONE: String
The extra field for the contact phone number.
Type: String
Value: "phone"
PHONETIC_NAME
static val PHONETIC_NAME: String
The extra field for the contact phonetic name.
Type: String
Value: "phonetic_name"
PHONE_ISPRIMARY
static val PHONE_ISPRIMARY: String
The extra field for the phone isprimary flag.
Type: boolean
Value: "phone_isprimary"
PHONE_TYPE
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
static val POSTAL: String
The extra field for the contact postal address.
Type: String
Value: "postal"
POSTAL_ISPRIMARY
static val POSTAL_ISPRIMARY: String
The extra field for the postal isprimary flag.
Type: boolean
Value: "postal_isprimary"
POSTAL_TYPE
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
static val SECONDARY_EMAIL: String
The extra field for an optional second contact email address.
Type: String
Value: "secondary_email"
SECONDARY_EMAIL_TYPE
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
static val SECONDARY_PHONE: String
The extra field for an optional second contact phone number.
Type: String
Value: "secondary_phone"
SECONDARY_PHONE_TYPE
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
static val TERTIARY_EMAIL: String
The extra field for an optional third contact email address.
Type: String
Value: "tertiary_email"
TERTIARY_EMAIL_TYPE
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
static val TERTIARY_PHONE: String
The extra field for an optional third contact phone number.
Type: String
Value: "tertiary_phone"
TERTIARY_PHONE_TYPE
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()