public static final class ContactsContract.Intents.Insert extends Object
Intents
.Modifier and Type | Field and Description |
---|---|
static String |
ACTION
The action code to use when adding a contact
|
static String |
COMPANY
The extra field for the contact company.
|
static String |
DATA
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 |
EMAIL
The extra field for the contact email address.
|
static String |
EMAIL_ISPRIMARY
The extra field for the email isprimary flag.
|
static String |
EMAIL_TYPE
The extra field for the contact email type.
|
static String |
EXTRA_ACCOUNT
Used to specify the account in which to create the new contact.
|
static String |
EXTRA_DATA_SET
Used to specify the data set within the account in which to create the
new contact.
|
static String |
FULL_MODE
If present, forces a bypass of quick insert mode.
|
static String |
IM_HANDLE
The extra field for an IM handle.
|
static String |
IM_ISPRIMARY
The extra field for the IM isprimary flag.
|
static String |
IM_PROTOCOL
The extra field for the IM protocol
|
static String |
JOB_TITLE
The extra field for the contact job title.
|
static String |
NAME
The extra field for the contact name.
|
static String |
NOTES
The extra field for the contact notes.
|
static String |
PHONE
The extra field for the contact phone number.
|
static String |
PHONE_ISPRIMARY
The extra field for the phone isprimary flag.
|
static String |
PHONE_TYPE
The extra field for the contact phone number type.
|
static String |
PHONETIC_NAME
The extra field for the contact phonetic name.
|
static String |
POSTAL
The extra field for the contact postal address.
|
static String |
POSTAL_ISPRIMARY
The extra field for the postal isprimary flag.
|
static String |
POSTAL_TYPE
The extra field for the contact postal address type.
|
static String |
SECONDARY_EMAIL
The extra field for an optional second contact email address.
|
static String |
SECONDARY_EMAIL_TYPE
The extra field for an optional second contact email type.
|
static String |
SECONDARY_PHONE
The extra field for an optional second contact phone number.
|
static String |
SECONDARY_PHONE_TYPE
The extra field for an optional second contact phone number type.
|
static String |
TERTIARY_EMAIL
The extra field for an optional third contact email address.
|
static String |
TERTIARY_EMAIL_TYPE
The extra field for an optional third contact email type.
|
static String |
TERTIARY_PHONE
The extra field for an optional third contact phone number.
|
static String |
TERTIARY_PHONE_TYPE
The extra field for an optional third contact phone number type.
|
Constructor and Description |
---|
Insert() |
public static final String ACTION
public static final String FULL_MODE
public static final String NAME
Type: String
public static final String PHONETIC_NAME
Type: String
public static final String COMPANY
Type: String
public static final String JOB_TITLE
Type: String
public static final String NOTES
Type: String
public static final String PHONE
Type: String
public static final String PHONE_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Phone
,
or a string specifying a custom label.
public static final String PHONE_ISPRIMARY
Type: boolean
public static final String SECONDARY_PHONE
Type: String
public static final String SECONDARY_PHONE_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Phone
,
or a string specifying a custom label.
public static final String TERTIARY_PHONE
Type: String
public static final String TERTIARY_PHONE_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Phone
,
or a string specifying a custom label.
public static final String EMAIL
Type: String
public static final String EMAIL_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Email
or a string specifying a custom label.
public static final String EMAIL_ISPRIMARY
Type: boolean
public static final String SECONDARY_EMAIL
Type: String
public static final String SECONDARY_EMAIL_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Email
or a string specifying a custom label.
public static final String TERTIARY_EMAIL
Type: String
public static final String TERTIARY_EMAIL_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.Email
or a string specifying a custom label.
public static final String POSTAL
Type: String
public static final String POSTAL_TYPE
Type: Either an integer value from
ContactsContract.CommonDataKinds.StructuredPostal
or a string specifying a custom label.
public static final String POSTAL_ISPRIMARY
Type: boolean
public static final String IM_HANDLE
Type: String
public static final String IM_PROTOCOL
public static final String IM_ISPRIMARY
Type: boolean
public static final String DATA
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 ContactsContract.Contacts.Data
table,
except the user gets a chance to see and edit them before saving.
Each ContentValues object must have a value for ContactsContract.DataColumns.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);
public static final String EXTRA_ACCOUNT
If this value is not provided, the user is presented with a disambiguation dialog to chose an account
Type: Account
public static final String EXTRA_DATA_SET
This value is optional - if it is not specified, the contact will be created in the base account, with no data set.
Type: String