added in API level 5

Summary: Constants | Inherited Constants | Fields | Inherited Methods | [Expand All]

ContactsContract.PhoneLookup

public static final class ContactsContract.PhoneLookup
extends Object implements BaseColumns, ContactsContract.PhoneLookupColumns, ContactsContract.ContactsColumns, ContactsContract.ContactOptionsColumns, ContactsContract.ContactNameColumns

java.lang.Object
↳	android.provider.ContactsContract.PhoneLookup

A table that represents the result of looking up a phone number, for example for caller ID. To perform a lookup you must append the number you want to find to CONTENT_FILTER_URI. This query is highly optimized.

 Uri uri = Uri.withAppendedPath(PhoneLookup.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
 resolver.query(uri, new String[]{PhoneLookup.DISPLAY_NAME,...

Columns

PhoneLookup
String	`NUMBER`	read-only	Phone number.
String	`TYPE`	read-only	Phone number type. See `ContactsContract.CommonDataKinds.Phone`.
String	`LABEL`	read-only	Custom label for the phone number. See `ContactsContract.CommonDataKinds.Phone`.

Columns from the Contacts table are also available through a join.

Join with `Contacts`
long	`_ID`	read-only	Contact ID.
long	`CONTACT_ID`	read-only	Contact ID.
long	`DATA_ID`	read-only	Data ID.
String	`LOOKUP_KEY`	read-only	See `ContactsContract.Contacts`
String	`DISPLAY_NAME`	read-only	See `ContactsContract.Contacts`
long	`PHOTO_ID`	read-only	See `ContactsContract.Contacts`.
int	`IN_VISIBLE_GROUP`	read-only	See `ContactsContract.Contacts`.
int	`HAS_PHONE_NUMBER`	read-only	See `ContactsContract.Contacts`.
int	`TIMES_CONTACTED`	read-only	See `ContactsContract.Contacts`.
long	`LAST_TIME_CONTACTED`	read-only	See `ContactsContract.Contacts`.
int	`STARRED`	read-only	See `ContactsContract.Contacts`.
String	`CUSTOM_RINGTONE`	read-only	See `ContactsContract.Contacts`.
int	`SEND_TO_VOICEMAIL`	read-only	See `ContactsContract.Contacts`.

Summary

Constants
`String`	`QUERY_PARAMETER_SIP_ADDRESS` If this boolean parameter is set to true, then the appended query is treated as a SIP address and the lookup will be performed against SIP addresses in the user's contacts.

Inherited constants

From interface


    android.provider.BaseColumns

From interface


    android.provider.ContactsContract.PhoneLookupColumns

From interface


    android.provider.ContactsContract.ContactsColumns

From interface


    android.provider.ContactsContract.ContactOptionsColumns

From interface


    android.provider.ContactsContract.ContactNameColumns

Fields
`public static final Uri`	`CONTENT_FILTER_URI` The content:// style URI for this table.
`public static final Uri`	`ENTERPRISE_CONTENT_FILTER_URI` URI used for the "enterprise caller-id".

Fields


    public
    static
    final
    Uri

CONTENT_FILTER_URI

The content:// style URI for this table.


    public
    static
    final
    Uri

ENTERPRISE_CONTENT_FILTER_URI

URI used for the "enterprise caller-id".

Inherited methods

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Constants

QUERY_PARAMETER_SIP_ADDRESS

added in API level 21

String QUERY_PARAMETER_SIP_ADDRESS

If this boolean parameter is set to true, then the appended query is treated as a SIP address and the lookup will be performed against SIP addresses in the user's contacts.

Constant Value: "sip"

Fields

CONTENT_FILTER_URI

added in API level 5

Uri CONTENT_FILTER_URI

The content:// style URI for this table. Append the phone number you want to lookup to this URI and query it to perform a lookup. For example:

 Uri lookupUri = Uri.withAppendedPath(PhoneLookup.CONTENT_FILTER_URI,
         Uri.encode(phoneNumber));

ENTERPRISE_CONTENT_FILTER_URI

added in API level 21

Uri ENTERPRISE_CONTENT_FILTER_URI

URI used for the "enterprise caller-id".

It supports the same semantics as CONTENT_FILTER_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_FILTER_URI. If there is a corp profile linked to the current profile, it first queries against the personal contact database, and if no matching contacts are found there, then queries against the corp contacts database.

If a result is from the corp profile, it makes the following changes to the data:

PHOTO_THUMBNAIL_URI and PHOTO_URI will be rewritten to special URIs. Use openAssetFileDescriptor(Uri, String) or its siblings to load pictures from them. PHOTO_ID and PHOTO_FILE_ID will be set to null. Do not use them.
Corp contacts will get artificial _IDs. In order to tell whether a contact is from the corp profile, use isEnterpriseContactId(long).
Corp contacts will get artificial LOOKUP_KEYs too.
Returned work contact IDs and lookup keys are not accepted in places that not explicitly say to accept them.

A contact lookup URL built by getLookupUri(long, String) with an _ID and a LOOKUP_KEY returned by this API can be passed to showQuickContact(Context, Rect, Uri, int, String[]) even if a contact is from the corp profile.

 Uri lookupUri = Uri.withAppendedPath(PhoneLookup.ENTERPRISE_CONTENT_FILTER_URI,
         Uri.encode(phoneNumber));

Oct	NOV	Dec
	11
2016	2017	2018

Most visited

Recently visited

Results for

ContactsContract.PhoneLookup

Columns

Summary

Constants

Inherited constants

Fields

Inherited methods

Constants

QUERY_PARAMETER_SIP_ADDRESS

Fields

CONTENT_FILTER_URI

ENTERPRISE_CONTENT_FILTER_URI

Interfaces

Classes

Exceptions