public static final class ContactsContract.CommonDataKinds.Phone
extends Object
implements ContactsContract.DataColumnsWithJoins, ContactsContract.CommonDataKinds.CommonColumns
java.lang.Object | |
↳ | android.provider.ContactsContract.CommonDataKinds.Phone |
A data kind representing a telephone number.
You can use all columns defined for ContactsContract.Data
as well as the following aliases.
Type | Alias | Data column | |
---|---|---|---|
String | NUMBER |
DATA1 |
|
int | TYPE |
DATA2 |
Allowed values are:
|
String | LABEL |
DATA3 |
Constants |
|
---|---|
String |
CONTENT_ITEM_TYPE MIME type used when storing this in data table. |
String |
CONTENT_TYPE The MIME type of |
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. |
String |
NORMALIZED_NUMBER The phone number's E164 representation. |
String |
NUMBER The phone number as the user entered it. |
String |
SEARCH_DISPLAY_NAME_KEY A boolean query parameter that can be used with |
String |
SEARCH_PHONE_NUMBER_KEY A boolean query parameter that can be used with |
int |
TYPE_ASSISTANT
|
int |
TYPE_CALLBACK
|
int |
TYPE_CAR
|
int |
TYPE_COMPANY_MAIN
|
int |
TYPE_FAX_HOME
|
int |
TYPE_FAX_WORK
|
int |
TYPE_HOME
|
int |
TYPE_ISDN
|
int |
TYPE_MAIN
|
int |
TYPE_MMS
|
int |
TYPE_MOBILE
|
int |
TYPE_OTHER
|
int |
TYPE_OTHER_FAX
|
int |
TYPE_PAGER
|
int |
TYPE_RADIO
|
int |
TYPE_TELEX
|
int |
TYPE_TTY_TDD
|
int |
TYPE_WORK
|
int |
TYPE_WORK_MOBILE
|
int |
TYPE_WORK_PAGER
|
Inherited constants |
---|
![]() android.provider.ContactsContract.CommonDataKinds.CommonColumns
|
![]() android.provider.BaseColumns
|
![]() android.provider.ContactsContract.DataColumns
|
![]() android.provider.ContactsContract.StatusColumns
|
![]() android.provider.ContactsContract.RawContactsColumns
|
![]() android.provider.ContactsContract.ContactsColumns
|
![]() android.provider.ContactsContract.ContactNameColumns
|
![]() android.provider.ContactsContract.ContactOptionsColumns
|
![]() android.provider.ContactsContract.ContactStatusColumns
|
![]() android.provider.ContactsContract.DataUsageStatColumns
|
![]() android.provider.ContactsContract.CommonDataKinds.BaseTypes
|
Fields |
|
---|---|
public static final Uri |
CONTENT_FILTER_URI The content:// style URL for phone lookup using a filter. |
public static final Uri |
CONTENT_URI The content:// style URI for all data records of the |
public static final Uri |
ENTERPRISE_CONTENT_FILTER_URI It supports the similar semantics as |
Public methods |
|
---|---|
static final CharSequence |
getTypeLabel(Resources res, int type, CharSequence label) Return a |
static final int |
getTypeLabelResource(int type) Return the string resource that best describes the given |
Inherited methods |
|
---|---|
![]() java.lang.Object
|
String CONTENT_ITEM_TYPE
MIME type used when storing this in data table.
Constant Value: "vnd.android.cursor.item/phone_v2"
String CONTENT_TYPE
The MIME type of CONTENT_URI
providing a directory of phones.
Constant Value: "vnd.android.cursor.dir/phone_v2"
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. 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); }
Constant Value: "android.provider.extra.ADDRESS_BOOK_INDEX"
String 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[]
Constant Value: "android.provider.extra.ADDRESS_BOOK_INDEX_COUNTS"
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.
TYPE: String[]
Constant Value: "android.provider.extra.ADDRESS_BOOK_INDEX_TITLES"
String NORMALIZED_NUMBER
The phone number's E164 representation. This value can be omitted in which case the provider will try to automatically infer it. (It'll be left null if the provider fails to infer.) If present, NUMBER
has to be set as well (it will be ignored otherwise).
Type: TEXT
Constant Value: "data4"
String NUMBER
The phone number as the user entered it.
Type: TEXT
Constant Value: "data1"
String SEARCH_DISPLAY_NAME_KEY
A boolean query parameter that can be used with CONTENT_FILTER_URI
. If "1" or "true", display names are searched. If "0" or "false", display names are not searched. Default is "1".
Constant Value: "search_display_name"
String SEARCH_PHONE_NUMBER_KEY
A boolean query parameter that can be used with CONTENT_FILTER_URI
. If "1" or "true", phone numbers are searched. If "0" or "false", phone numbers are not searched. Default is "1".
Constant Value: "search_phone_number"
Uri CONTENT_FILTER_URI
The content:// style URL for phone lookup using a filter. The filter returns records of MIME type CONTENT_ITEM_TYPE
. The filter is applied to display names as well as phone numbers. The filter argument should be passed as an additional path segment after this URI.
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.
Uri ENTERPRISE_CONTENT_FILTER_URI
It supports the similar semantics as CONTENT_FILTER_URI
and returns the same columns. This URI requires DIRECTORY_PARAM_KEY
in parameters, otherwise it will throw IllegalArgumentException.
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
.
Parameters | |
---|---|
res |
Resources
|
type |
int
|
label |
CharSequence
|
Returns | |
---|---|
CharSequence |
int getTypeLabelResource (int type)
Return the string resource that best describes the given TYPE
. Will always return a valid resource.
Parameters | |
---|---|
type |
int
|
Returns | |
---|---|
int |