public static final class ContactsContract.CommonDataKinds.Photo extends Object implements ContactsContract.DataColumnsWithJoins
A data kind representing a photo for the contact.
Some sync adapters will choose to download photos in a separate
pass. A common pattern is to use columns ContactsContract.DataColumns.SYNC1
through ContactsContract.DataColumns.SYNC4
to store temporary
data, e.g. the image URL or ID, state of download, server-side version
of the image. It is allowed for the PHOTO
to be null.
You can use all columns defined for ContactsContract.Data
as
well as the following aliases.
Type | Alias | Data column | |
---|---|---|---|
NUMBER | PHOTO_FILE_ID |
ContactsContract.DataColumns.DATA14 |
ID of the hi-res photo file. |
BLOB | PHOTO |
ContactsContract.DataColumns.DATA15 |
By convention, binary data is stored in DATA15. The thumbnail of the photo is stored in this column. |
Modifier and Type | Field and Description |
---|---|
static String |
CONTENT_ITEM_TYPE
MIME type used when storing this in data table.
|
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 |
PHOTO
Thumbnail photo of the raw contact.
|
static String |
PHOTO_FILE_ID
Photo file ID for the display photo of the raw contact.
|
_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_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
public static final String CONTENT_ITEM_TYPE
public static final String PHOTO_FILE_ID
ContactsContract.DisplayPhoto
.
Type: NUMBER
public static final String PHOTO
BitmapFactory
.
Type: BLOB
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[]