Caution: As of January 7, 2019, this field is obsolete. For + * more information, see the + * Contacts Provider + * page.
*Type: INTEGER
* * @deprecated Contacts affinity information is no longer supported as of @@ -880,6 +884,10 @@ public final class ContactsContract { /** * The last time a contact was contacted. + *Caution: As of January 7, 2019, this field is obsolete. For + * more information, see the + * Contacts Provider + * page.
*Type: INTEGER
* * @deprecated Contacts affinity information is no longer supported as of @@ -1682,6 +1690,11 @@ public final class ContactsContract { * TIMES_CONTACTED field is incremented by 1 and the LAST_TIME_CONTACTED * field is populated with the current system time. * + *Caution: As of January 7, 2019, this method is obsolete. For + * more information, see the + * Contacts Provider + * page. + * * @param resolver the ContentResolver to use * @param contactId the person who was contacted * @@ -1715,6 +1728,11 @@ public final class ContactsContract { * {@link ContactsContract.Data}, filtered to include only starred contacts. * Frequent contacts are no longer included in the result as of * Android version {@link android.os.Build.VERSION_CODES#Q}. + * + *
Caution: As of January 7, 2019, this field no longer sorts + * results based on contacts frequency. For more information, see the + * Contacts Provider + * page. */ public static final Uri CONTENT_STREQUENT_URI = Uri.withAppendedPath( CONTENT_URI, "strequent"); @@ -1725,16 +1743,26 @@ public final class ContactsContract { * @deprecated Frequent contacts are no longer supported as of * Android version {@link android.os.Build.VERSION_CODES#Q}. * This URI always returns an empty cursor. + * + *
Caution: As of January 7, 2019, this field no longer sorts + * results based on contacts frequency. For more information, see the + * Contacts Provider + * page. */ @Deprecated public static final Uri CONTENT_FREQUENT_URI = Uri.withAppendedPath( CONTENT_URI, "frequent"); /** - * The content:// style URI used for "type-to-filter" functionality on the + *
The content:// style URI used for "type-to-filter" functionality on the * {@link #CONTENT_STREQUENT_URI} URI. The filter string will be used to match * various parts of the contact name. The filter argument should be passed * as an additional path segment after this URI. + * + *
Caution: As of January 7, 2019, this field no longer sorts + * results based on contacts frequency. For more information, see the + * Contacts Provider + * page. */ public static final Uri CONTENT_STREQUENT_FILTER_URI = Uri.withAppendedPath( CONTENT_STREQUENT_URI, "filter"); @@ -4262,6 +4290,11 @@ public final class ContactsContract { * @deprecated Contacts affinity information is no longer supported as of * Android version {@link android.os.Build.VERSION_CODES#Q}. * This column always contains 0. + * + *
Caution: As of January 7, 2019, this field is obsolete. + * For more information, see the + * Contacts Provider + * page. */ @Deprecated public static final String LAST_TIME_USED = "last_time_used"; @@ -4271,6 +4304,11 @@ public final class ContactsContract { * @deprecated Contacts affinity information is no longer supported as of * Android version {@link android.os.Build.VERSION_CODES#Q}. * This column always contains 0. + * + *
Caution: As of January 7, 2019, this field is obsolete. + * For more information, see the + * Contacts Provider + * page. */ @Deprecated public static final String TIMES_USED = "times_used"; @@ -5218,7 +5256,14 @@ public final class ContactsContract { private PhoneLookup() {} /** - * The content:// style URI for this table. Append the phone number you want to lookup + * The content:// style URI for this table. + * + *
Caution: As of January 7, 2019, this field no longer + * sorts results based on contacts frequency. For more information, see the + * Contacts Provider + * page. + * + * 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,
@@ -5231,6 +5276,11 @@ public final class ContactsContract {
/**
* URI used for the "enterprise caller-id".
*
+ * Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
+ *
*
* It supports the same semantics as {@link #CONTENT_FILTER_URI} and returns the same
* columns. If the device has no corp profile that is linked to the current profile, it
@@ -6023,18 +6073,28 @@ public final class ContactsContract {
Uri.withAppendedPath(Data.ENTERPRISE_CONTENT_URI, "phones");
/**
- * The content:// style URL for phone lookup using a filter. The filter returns
+ *
The content:// style URL for phone lookup using a filter. The filter returns
* records of MIME type {@link #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.
+ *
+ *
Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri CONTENT_FILTER_URI = Uri.withAppendedPath(CONTENT_URI,
"filter");
/**
- * It supports the similar semantics as {@link #CONTENT_FILTER_URI} and returns the same
- * columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in
+ *
It supports the similar semantics as {@link #CONTENT_FILTER_URI} and returns the
+ * same columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in
* parameters, otherwise it will throw IllegalArgumentException.
+ *
+ *
Caution: As of January 7, 2019, this field no longer sorts
+ * results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri ENTERPRISE_CONTENT_FILTER_URI = Uri.withAppendedPath(
CONTENT_URI, "filter_enterprise");
@@ -6202,7 +6262,7 @@ public final class ContactsContract {
*/
public static final class Email implements DataColumnsWithJoins, CommonColumns,
ContactCounts {
- /**
+ /*
* This utility class cannot be instantiated
*/
private Email() {}
@@ -6293,12 +6353,17 @@ public final class ContactsContract {
Uri.withAppendedPath(CONTENT_URI, "lookup_enterprise");
/**
- *
- * The content:// style URL for email lookup using a filter. The filter returns
+ *
The content:// style URL for email lookup using a filter. The filter returns
* records of MIME type {@link #CONTENT_ITEM_TYPE}. The filter is applied
* to display names as well as email addresses. The filter argument should be passed
* as an additional path segment after this URI.
*
+ *
+ * Caution: As of January 7, 2019, this field no longer sorts
+ * results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
+ *
* The query in the following example will return "Robert Parr (bob@incredibles.com)"
* as well as "Bob Parr (incredible@android.com)".
*
@@ -6313,9 +6378,14 @@ public final class ContactsContract {
"filter");
/**
- * It supports the similar semantics as {@link #CONTENT_FILTER_URI} and returns the same
- * columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in
+ * It supports the similar semantics as {@link #CONTENT_FILTER_URI} and returns the
+ * same columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in
* parameters, otherwise it will throw IllegalArgumentException.
+ *
+ *
Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri ENTERPRISE_CONTENT_FILTER_URI = Uri.withAppendedPath(
CONTENT_URI, "filter_enterprise");
@@ -7528,16 +7598,26 @@ public final class ContactsContract {
public static final Uri CONTENT_URI = Uri.withAppendedPath(Data.CONTENT_URI,
"callables");
/**
- * Similar to {@link Phone#CONTENT_FILTER_URI}, but allows users to filter callable
+ *
Similar to {@link Phone#CONTENT_FILTER_URI}, but allows users to filter callable
* data.
+ *
+ *
Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri CONTENT_FILTER_URI = Uri.withAppendedPath(CONTENT_URI,
"filter");
/**
- * Similar to {@link Phone#ENTERPRISE_CONTENT_FILTER_URI}, but allows users to filter
+ *
Similar to {@link Phone#ENTERPRISE_CONTENT_FILTER_URI}, but allows users to filter
* callable data. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in
* parameters, otherwise it will throw IllegalArgumentException.
+ *
+ *
Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri ENTERPRISE_CONTENT_FILTER_URI = Uri.withAppendedPath(
CONTENT_URI, "filter_enterprise");
@@ -7562,8 +7642,13 @@ public final class ContactsContract {
"contactables");
/**
- * The content:// style URI for these data items, which allows for a query parameter to
- * be appended onto the end to filter for data items matching the query.
+ * The content:// style URI for these data items, which allows for a query parameter
+ * to be appended onto the end to filter for data items matching the query.
+ *
+ *
Caution: As of January 7, 2019, this field no longer
+ * sorts results based on contacts frequency. For more information, see the
+ * Contacts Provider
+ * page.
*/
public static final Uri CONTENT_FILTER_URI = Uri.withAppendedPath(
Contactables.CONTENT_URI, "filter");
@@ -8212,6 +8297,11 @@ public final class ContactsContract {
}
/**
+ *
Caution: As of January 7, 2019, this class is obsolete. For
+ * more information, see the
+ * Contacts Provider
+ * page.
+ *
*
* API allowing applications to send usage information for each {@link Data} row to the
* Contacts Provider. Applications can also clear all usage information.