Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Small DocumentsProvider doc improvements." into klp-dev

Browse Source
This commit is contained in:
Jeff Sharkey
2013-11-13 22:31:01 +00:00
committed by Android (Google) Code Review
parent 3714473f1a 3b945405cf
commit 711d390be9
1 changed files with 6 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
core/java/android/provider/DocumentsProvider.java
View File

@@ -62,7 +62,8 @@ import java.io.FileNotFoundException;
* android:authorities="com.example.mycloudprovider" * android:authorities="com.example.mycloudprovider"
* android:exported="true" * android:exported="true"
* android:grantUriPermissions="true" * android:grantUriPermissions="true"
* android:permission="android.permission.MANAGE_DOCUMENTS"> * android:permission="android.permission.MANAGE_DOCUMENTS"
* android:enabled="@bool/isAtLeastKitKat">
* <intent-filter> * <intent-filter>
* <action android:name="android.content.action.DOCUMENTS_PROVIDER" /> * <action android:name="android.content.action.DOCUMENTS_PROVIDER" />
* </intent-filter> * </intent-filter>
@@ -252,7 +253,8 @@ public abstract class DocumentsProvider extends ContentProvider {
* {@link DocumentsContract#EXTRA_LOADING} on the Cursor to indicate that * {@link DocumentsContract#EXTRA_LOADING} on the Cursor to indicate that
* you are still fetching additional data. Then, when the network data is * you are still fetching additional data. Then, when the network data is
* available, you can send a change notification to trigger a requery and * available, you can send a change notification to trigger a requery and
* return the complete contents. * return the complete contents. To return a Cursor with extras, you need to
* extend and override {@link Cursor#getExtras()}.
* <p> * <p>
* To support change notifications, you must * To support change notifications, you must
* {@link Cursor#setNotificationUri(ContentResolver, Uri)} with a relevant * {@link Cursor#setNotificationUri(ContentResolver, Uri)} with a relevant
@@ -362,7 +364,7 @@ public abstract class DocumentsProvider extends ContentProvider {
* @param documentId the document to return. * @param documentId the document to return.
* @param mode the mode to open with, such as 'r', 'w', or 'rw'. * @param mode the mode to open with, such as 'r', 'w', or 'rw'.
* @param signal used by the caller to signal if the request should be * @param signal used by the caller to signal if the request should be
* cancelled. * cancelled. May be null.
* @see ParcelFileDescriptor#open(java.io.File, int, android.os.Handler, * @see ParcelFileDescriptor#open(java.io.File, int, android.os.Handler,
* OnCloseListener) * OnCloseListener)
* @see ParcelFileDescriptor#createReliablePipe() * @see ParcelFileDescriptor#createReliablePipe()
@@ -386,7 +388,7 @@ public abstract class DocumentsProvider extends ContentProvider {
* @param documentId the document to return. * @param documentId the document to return.
* @param sizeHint hint of the optimal thumbnail dimensions. * @param sizeHint hint of the optimal thumbnail dimensions.
* @param signal used by the caller to signal if the request should be * @param signal used by the caller to signal if the request should be
* cancelled. * cancelled. May be null.
* @see Document#FLAG_SUPPORTS_THUMBNAIL * @see Document#FLAG_SUPPORTS_THUMBNAIL
*/ */
@SuppressWarnings("unused") @SuppressWarnings("unused")