- * Callers can set a document URI through {@link #setData(Uri)} to indicate - * the initial location of documents navigator. System will do its best to - * launch the navigator in the specified document if it's a folder, or the - * folder that contains the specified document if not. + * Callers can set a document URI through + * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial + * location of documents navigator. System will do its best to launch the + * navigator in the specified document if it's a folder, or the folder that + * contains the specified document if not. *
* Output: The URI of the item that was picked, returned in * {@link #getData()}. This must be a {@code content://} URI so that any @@ -3161,10 +3162,11 @@ public class Intent implements Parcelable, Cloneable { * URIs that can be opened with * {@link ContentResolver#openFileDescriptor(Uri, String)}. *
- * Callers can set a document URI through {@link #setData(Uri)} to indicate - * the initial location of documents navigator. System will do its best to - * launch the navigator in the specified document if it's a folder, or the - * folder that contains the specified document if not. + * Callers can set a document URI through + * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial + * location of documents navigator. System will do its best to launch the + * navigator in the specified document if it's a folder, or the folder that + * contains the specified document if not. *
* Output: The URI of the item that was created. This must be a * {@code content://} URI so that any receiver can access it. @@ -3188,10 +3190,11 @@ public class Intent implements Parcelable, Cloneable { * {@link DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)} * with the returned URI. *
- * Callers can set a document URI through {@link #setData(Uri)} to indicate - * the initial location of documents navigator. System will do its best to - * initiate the navigator in the specified document if it's a folder, or - * the folder that contains the specified document if not. + * Callers can set a document URI through + * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial + * location of documents navigator. System will do its best to launch the + * navigator in the specified document if it's a folder, or the folder that + * contains the specified document if not. *
* Output: The URI representing the selected directory tree. * diff --git a/core/java/android/provider/DocumentsContract.java b/core/java/android/provider/DocumentsContract.java index 2dcf220b8ac40..f86193ff1b7c0 100644 --- a/core/java/android/provider/DocumentsContract.java +++ b/core/java/android/provider/DocumentsContract.java @@ -105,6 +105,22 @@ public final class DocumentsContract { /** {@hide} */ public static final String EXTRA_TARGET_URI = "android.content.extra.TARGET_URI"; + /** + * Sets the desired initial location visible to user when file chooser is shown. + * + *
Applicable to {@link Intent} with actions: + *
Location should specify a document URI or a tree URI with document ID. If + * this URI identifies a non-directory, document navigator will attempt to use the parent + * of the document as the initial location. + */ + public static final String EXTRA_INITIAL_URI = "android.provider.extra.INITIAL_URI"; + /** * Set this in a DocumentsUI intent to cause a package's own roots to be * excluded from the roots list.