public static final class ContactsContract.CommonDataKinds.Phone extends Object implements ContactsContract.DataColumnsWithJoins, ContactsContract.CommonDataKinds.CommonColumns
A data kind representing a telephone number.
You can use all columns defined for ContactsContract.Data
as
well as the following aliases.
Modifier and Type | Field and Description |
---|---|
static Uri |
CONTENT_FILTER_URI
The content:// style URL for phone lookup using a filter.
|
static String |
CONTENT_ITEM_TYPE
MIME type used when storing this in data table.
|
static String |
CONTENT_TYPE
The MIME type of
CONTENT_URI providing a directory of
phones. |
static 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. |
static Uri |
ENTERPRISE_CONTENT_FILTER_URI
It supports the similar semantics as
CONTENT_FILTER_URI and returns the same
columns. |
static Uri |
ENTERPRISE_CONTENT_URI
URI used for getting all contacts from primary and managed profile.
|
static 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.
|
static String |
EXTRA_ADDRESS_BOOK_INDEX_COUNTS
The array of group counts for the corresponding group.
|
static 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.
|
static String |
NORMALIZED_NUMBER
The phone number's E164 representation.
|
static String |
NUMBER
The phone number as the user entered it.
|
static String |
SEARCH_DISPLAY_NAME_KEY
A boolean query parameter that can be used with
CONTENT_FILTER_URI . |
static String |
SEARCH_PHONE_NUMBER_KEY
A boolean query parameter that can be used with
CONTENT_FILTER_URI . |
static int |
TYPE_ASSISTANT |
static int |
TYPE_CALLBACK |
static int |
TYPE_CAR |
static int |
TYPE_COMPANY_MAIN |
static int |
TYPE_FAX_HOME |
static int |
TYPE_FAX_WORK |
static int |
TYPE_HOME |
static int |
TYPE_ISDN |
static int |
TYPE_MAIN |
static int |
TYPE_MMS |
static int |
TYPE_MOBILE |
static int |
TYPE_OTHER |
static int |
TYPE_OTHER_FAX |
static int |
TYPE_PAGER |
static int |
TYPE_RADIO |
static int |
TYPE_TELEX |
static int |
TYPE_TTY_TDD |
static int |
TYPE_WORK |
static int |
TYPE_WORK_MOBILE |
static int |
TYPE_WORK_PAGER |
_COUNT, _ID
CARRIER_PRESENCE, CARRIER_PRESENCE_VT_CAPABLE, DATA_VERSION, DATA1, DATA10, DATA11, DATA12, DATA13, DATA14, DATA15, DATA2, DATA3, DATA4, DATA5, DATA6, DATA7, DATA8, DATA9, HASH_ID, IS_PRIMARY, IS_READ_ONLY, IS_SUPER_PRIMARY, MIMETYPE, RAW_CONTACT_ID, RES_PACKAGE, SYNC1, SYNC2, SYNC3, SYNC4
AVAILABLE, AWAY, CAPABILITY_HAS_CAMERA, CAPABILITY_HAS_VIDEO, CAPABILITY_HAS_VOICE, CHAT_CAPABILITY, DO_NOT_DISTURB, IDLE, INVISIBLE, OFFLINE, PRESENCE, PRESENCE_CUSTOM_STATUS, PRESENCE_STATUS, STATUS, STATUS_ICON, STATUS_LABEL, STATUS_RES_PACKAGE, STATUS_TIMESTAMP
ACCOUNT_TYPE_AND_DATA_SET, AGGREGATION_MODE, BACKUP_ID, CONTACT_ID, DATA_SET, DELETED, METADATA_DIRTY, RAW_CONTACT_IS_READ_ONLY, RAW_CONTACT_IS_USER_PROFILE
CONTACT_LAST_UPDATED_TIMESTAMP, DISPLAY_NAME, HAS_PHONE_NUMBER, IN_DEFAULT_DIRECTORY, IN_VISIBLE_GROUP, IS_USER_PROFILE, LOOKUP_KEY, NAME_RAW_CONTACT_ID, PHOTO_FILE_ID, PHOTO_ID, PHOTO_THUMBNAIL_URI, PHOTO_URI
DISPLAY_NAME_ALTERNATIVE, DISPLAY_NAME_PRIMARY, DISPLAY_NAME_SOURCE, PHONETIC_NAME, PHONETIC_NAME_STYLE, SORT_KEY_ALTERNATIVE, SORT_KEY_PRIMARY
CUSTOM_RINGTONE, LAST_TIME_CONTACTED, PINNED, SEND_TO_VOICEMAIL, STARRED, TIMES_CONTACTED
CONTACT_CHAT_CAPABILITY, CONTACT_PRESENCE, CONTACT_STATUS, CONTACT_STATUS_ICON, CONTACT_STATUS_LABEL, CONTACT_STATUS_RES_PACKAGE, CONTACT_STATUS_TIMESTAMP
LAST_TIME_USED, TIMES_USED
DATA, LABEL, TYPE
TYPE_CUSTOM
Modifier and Type | Method and Description |
---|---|
static CharSequence |
getDisplayLabel(Context context,
int type,
CharSequence label)
Deprecated.
use
getTypeLabel(Resources, int, CharSequence) instead. |
static CharSequence |
getDisplayLabel(Context context,
int type,
CharSequence label,
CharSequence[] labelArray)
Deprecated.
use
getTypeLabel(Resources, int, CharSequence) instead. |
static CharSequence |
getTypeLabel(Resources res,
int type,
CharSequence label)
Return a
CharSequence that best describes the given type,
possibly substituting the given ContactsContract.CommonDataKinds.CommonColumns.LABEL value
for ContactsContract.CommonDataKinds.BaseTypes.TYPE_CUSTOM . |
static int |
getTypeLabelResource(int type)
Return the string resource that best describes the given
ContactsContract.CommonDataKinds.CommonColumns.TYPE . |
public static final String CONTENT_ITEM_TYPE
public static final String CONTENT_TYPE
CONTENT_URI
providing a directory of
phones.public static final Uri CONTENT_URI
CONTENT_ITEM_TYPE
MIME type, combined with the
associated raw contact and aggregate contact data.public static final Uri ENTERPRISE_CONTENT_URI
CONTENT_URI
and returns the same
columns. If the device has no corp profile that is linked to the current profile, it
behaves in the exact same way as CONTENT_URI
. If there is a corp profile
linked to the current profile, it will merge corp profile and current profile's
results and returnpublic static final Uri CONTENT_FILTER_URI
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.public static final Uri ENTERPRISE_CONTENT_FILTER_URI
CONTENT_FILTER_URI
and returns the same
columns. This URI requires ContactsContract.DIRECTORY_PARAM_KEY
in
parameters, otherwise it will throw IllegalArgumentException.public static final String SEARCH_DISPLAY_NAME_KEY
CONTENT_FILTER_URI
.
If "1" or "true", display names are searched. If "0" or "false", display names
are not searched. Default is "1".public static final String SEARCH_PHONE_NUMBER_KEY
CONTENT_FILTER_URI
.
If "1" or "true", phone numbers are searched. If "0" or "false", phone numbers
are not searched. Default is "1".public static final int TYPE_HOME
public static final int TYPE_MOBILE
public static final int TYPE_WORK
public static final int TYPE_FAX_WORK
public static final int TYPE_FAX_HOME
public static final int TYPE_PAGER
public static final int TYPE_OTHER
public static final int TYPE_CALLBACK
public static final int TYPE_CAR
public static final int TYPE_COMPANY_MAIN
public static final int TYPE_ISDN
public static final int TYPE_MAIN
public static final int TYPE_OTHER_FAX
public static final int TYPE_RADIO
public static final int TYPE_TELEX
public static final int TYPE_TTY_TDD
public static final int TYPE_WORK_MOBILE
public static final int TYPE_WORK_PAGER
public static final int TYPE_ASSISTANT
public static final int TYPE_MMS
public static final String NUMBER
Type: TEXT
public static final String NORMALIZED_NUMBER
NUMBER
has to be set as well (it will be ignored otherwise).
Type: TEXT
public static final String EXTRA_ADDRESS_BOOK_INDEX
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); }
public static final String EXTRA_ADDRESS_BOOK_INDEX_TITLES
TYPE: String[]
public static final String EXTRA_ADDRESS_BOOK_INDEX_COUNTS
TYPE: int[]
@Deprecated public static final CharSequence getDisplayLabel(Context context, int type, CharSequence label, CharSequence[] labelArray)
getTypeLabel(Resources, int, CharSequence)
instead.@Deprecated public static final CharSequence getDisplayLabel(Context context, int type, CharSequence label)
getTypeLabel(Resources, int, CharSequence)
instead.public static final int getTypeLabelResource(int type)
ContactsContract.CommonDataKinds.CommonColumns.TYPE
. Will always return a valid resource.public static final CharSequence getTypeLabel(Resources res, int type, CharSequence label)
CharSequence
that best describes the given type,
possibly substituting the given ContactsContract.CommonDataKinds.CommonColumns.LABEL
value
for ContactsContract.CommonDataKinds.BaseTypes.TYPE_CUSTOM
.