Intent.ActionGetContent Campo
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Acción de actividad: permite al usuario seleccionar un tipo determinado de datos y devolverlo.
[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : stringValor de campo
Implementaciones
- Atributos
Comentarios
Acción de actividad: permite al usuario seleccionar un tipo determinado de datos y devolverlo. Esto es diferente de #ACTION_PICK en que aquí solo decimos qué tipo de datos se desea, no un URI de los datos existentes desde los que el usuario puede elegir. Un ACTION_GET_CONTENT podría permitir al usuario crear los datos a medida que se ejecuta (por ejemplo, tomar una imagen o grabar un sonido), permitirle navegar por la web y descargar los datos deseados, etc.
Hay dos formas principales de usar esta acción: si desea un tipo específico de datos, como un contacto de persona, establezca el tipo MIME en el tipo de datos que desea e inicie con Context#startActivity(Intent). A continuación, el sistema iniciará la mejor aplicación para seleccionar ese tipo de datos.
También puede estar interesado en cualquiera de los tipos de contenido que el usuario puede elegir. Por ejemplo, una aplicación de correo electrónico que quiere permitir al usuario agregar datos adjuntos a un mensaje de correo electrónico puede usar esta acción para mostrar una lista de todos los tipos de contenido que el usuario puede adjuntar.
En este caso, debe encapsular la intención GET_CONTENT con un selector (a través #createChooserde ), que proporcionará la interfaz adecuada para que el usuario elija cómo enviar los datos y le permita especificar un mensaje que indique lo que están haciendo. Normalmente, especificará un tipo MIME amplio (como image/* o */*), lo que da lugar a una amplia gama de tipos de contenido entre los que el usuario puede seleccionar.
Cuando se usa una acción de GET_CONTENT tan amplia, a menudo es conveniente elegir solo los datos que se pueden representar como una secuencia. Esto se logra mediante la necesidad de #CATEGORY_OPENABLE en la intención.
Los autores de llamadas pueden especificar #EXTRA_LOCAL_ONLY opcionalmente para solicitar que el selector de contenido iniciado solo devuelva resultados que representan los datos que están disponibles localmente en el dispositivo. Por ejemplo, si este extra se establece en true, un selector de imágenes no debe mostrar imágenes que estén disponibles desde un servidor remoto, pero que aún no estén en el dispositivo local (lo que requiere que se descarguen al abrirse).
Si el autor de la llamada puede controlar varios elementos devueltos (el usuario que realiza varias selecciones), puede especificar #EXTRA_ALLOW_MULTIPLE para indicarlo.
Entrada: #getType es el tipo MIME deseado que se va a recuperar. Tenga en cuenta que no se proporciona ningún URI en la intención, ya que no hay ninguna restricción en la ubicación de la que proceden originalmente los datos devueltos. También puede incluir #CATEGORY_OPENABLE si solo puede aceptar datos que se pueden abrir como una secuencia. Puede usar #EXTRA_LOCAL_ONLY para limitar la selección de contenido a los datos locales. Puede usar #EXTRA_ALLOW_MULTIPLE para permitir que el usuario seleccione varios elementos.
Salida: el URI del elemento que se ha seleccionado. Debe ser un contenido: URI para que cualquier receptor pueda acceder a él.
Documentación de Java para android.content.Intent.ACTION_GET_CONTENT.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.