Intent.ActionGetContent 字段

定义

活动操作:允许用户选择特定类型的数据并返回它。

[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;
[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : string

字段值

实现

属性

注解

活动操作:允许用户选择特定类型的数据并返回它。 这不同于 #ACTION_PICK 此处,我们只是说需要哪种类型的数据,而不是用户可以从中选取的现有数据的 URI。 ACTION_GET_CONTENT可以允许用户在运行数据时创建数据(例如拍摄照片或录制声音),让他们浏览 Web 并下载所需的数据等。

可以使用此操作有两种主要方法:如果需要特定类型的数据(例如人员联系人),请将 MIME 类型设置为所需的数据类型,并使用它启动。Context#startActivity(Intent) 然后,系统会启动最佳应用程序,为你选择此类数据。

你可能还对用户可以选取的任何一组内容类型感兴趣。 例如,希望允许用户向电子邮件添加附件的电子邮件应用程序可以使用此操作来显示用户可以附加的所有内容类型的列表。

在这种情况下,应使用选择器(通过 #createChooser)包装GET_CONTENT意向,这将为用户提供适当的界面来选取如何发送数据,并允许你指定一个提示来指示他们正在执行的操作。 通常可以指定广泛的 MIME 类型(例如 image/* 或 */*),从而生成用户可以从中选择的各种内容类型。

使用如此广泛的GET_CONTENT操作时,通常需要仅从可表示为流的数据中进行选择。 这可以通过要求 #CATEGORY_OPENABLE 在意向中完成。

调用方可以选择指定 #EXTRA_LOCAL_ONLY 请求启动的内容选择器仅返回表示设备上本地可用的数据的结果。 例如,如果此额外内容设置为 true,则图像选取器不应显示从远程服务器提供但尚未在本地设备上使用的任何图片(因此需要在打开时下载它们)。

如果调用方可以处理多个返回的项(执行多个选择的用户),则可以指定 #EXTRA_ALLOW_MULTIPLE 以指示此项。

输入: #getType 是检索所需的 MIME 类型。 请注意,意向中未提供 URI,因为返回的数据最初来自何处没有约束。 还可以包含 #CATEGORY_OPENABLE 仅接受可作为流打开的数据。 可用于 #EXTRA_LOCAL_ONLY 将内容选择限制为本地数据。 可用于 #EXTRA_ALLOW_MULTIPLE 允许用户选择多个项。

输出:已选取的项的 URI。 这必须是内容:URI,以便任何接收方都可以访问它。

适用于 . 的 android.content.Intent.ACTION_GET_CONTENTJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于