Intent.ActionOpenDocument 字段
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
活动操作:允许用户选择并返回一个或多个现有文档。
[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string
字段值
实现
- 特性
注解
活动操作:允许用户选择并返回一个或多个现有文档。 调用时,系统将显示设备上安装的各种 DocumentsProvider 实例,让用户以交互方式浏览它们。 这些文档包括本地媒体,例如照片和视频,以及已安装的云存储提供商提供的文档。
每个文档都表示为 content:// 支持的 DocumentsProviderURI,该 URI 可以作为流 ContentResolver#openFileDescriptor(Uri, String)打开,也可以查询 android.provider.DocumentsContract.Document 元数据。
所有选定的文档都返回到调用应用程序,并授予可持久读取和写入权限。 如果要在设备重启时保持对文档的访问权限,则需要使用 ContentResolver#takePersistableUriPermission(Uri, int)显式获取可保留的权限。
调用方必须通过 #setType(String)指示可接受的文档 MIME 类型。 例如,若要选择照片,请使用 image/*。 如果可接受多个不相交的 MIME 类型,请在其中定义它们 #EXTRA_MIME_TYPES 并将其 #setType(String) 定义为 */*。
如果调用方可以处理多个返回的项(执行多个选择的用户),则可以指定以指示这一点 #EXTRA_ALLOW_MULTIPLE 。
调用方必须包含在 #CATEGORY_OPENABLE 意向中,才能获取可以使用该 URI 打开 ContentResolver#openFileDescriptor(Uri, String)的 URI。
调用方可以通过设置文档 URI DocumentsContract#EXTRA_INITIAL_URI 来指示文档导航器的初始位置。 如果它是文件夹,则系统将尽最大努力启动指定文档中的导航器;如果不是,则启动包含指定文档的文件夹。
输出:已选取的项的 URI,返回。#getData() 这必须是 URI content:// ,以便任何接收方都可以访问它。 如果选择了多个文档,则返回它们 #getClipData()。
Java文档android.content.Intent.ACTION_OPEN_DOCUMENT。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。