Intent.ActionGetContent Champ

Définition

Espace de noms:

Android.Content

Assembly:

Mono.Android.dll

Action d’activité : autoriser l’utilisateur à sélectionner un type particulier de données et à le retourner.

[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;

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

Valeur de champ

String

Implémente

ContentsFileDescriptor

Attributs

RegisterAttribute

Remarques

Action d’activité : autoriser l’utilisateur à sélectionner un type particulier de données et à le retourner. Ceci est différent de #ACTION_PICK celui ici, nous disons simplement quel type de données est souhaité, et non pas un URI de données existantes à partir duquel l’utilisateur peut choisir. Une ACTION_GET_CONTENT peut permettre à l’utilisateur de créer les données à mesure qu’il s’exécute (par exemple, prendre une image ou enregistrer un son), leur permettre de parcourir le web et de télécharger les données souhaitées, etc.

Il existe deux façons principales d’utiliser cette action : si vous souhaitez un type spécifique de données, tel qu’un contact de personne, vous définissez le type MIME sur le type de données souhaité et le lancez avec Context#startActivity(Intent). Le système lance ensuite la meilleure application pour sélectionner ce type de données pour vous.

Vous pouvez également être intéressé par un ensemble de types de contenu que l’utilisateur peut choisir. Par exemple, une application de messagerie qui souhaite permettre à l’utilisateur d’ajouter une pièce jointe à un message électronique peut utiliser cette action pour afficher la liste de tous les types de contenu que l’utilisateur peut joindre.

Dans ce cas, vous devez encapsuler l’intention de GET_CONTENT avec un sélecteur (via #createChooser), qui donnera à l’utilisateur l’interface appropriée pour choisir comment envoyer vos données et vous permettre de spécifier une invite indiquant ce qu’ils font. Vous spécifiez généralement un type MIME large (par exemple, image/* ou */*), ce qui entraîne un large éventail de types de contenu que l’utilisateur peut sélectionner.

Lorsque vous utilisez une action de GET_CONTENT aussi large, il est souvent souhaitable de choisir uniquement des données qui peuvent être représentées en tant que flux. Pour ce faire, vous devez exiger l’intention #CATEGORY_OPENABLE .

Les appelants peuvent éventuellement spécifier #EXTRA_LOCAL_ONLY pour demander que le sélecteur de contenu lancé retourne uniquement les résultats représentant les données disponibles localement sur l’appareil. Par exemple, si cet élément supplémentaire est défini sur true, un sélecteur d’images ne doit pas afficher d’images disponibles à partir d’un serveur distant, mais pas déjà sur l’appareil local (ce qui nécessite qu’ils soient téléchargés lors de l’ouverture).

Si l’appelant peut gérer plusieurs éléments retournés (l’utilisateur effectuant plusieurs sélections), il peut spécifier #EXTRA_ALLOW_MULTIPLE pour indiquer cela.

Entrée : #getType est le type MIME souhaité à récupérer. Notez qu’aucun URI n’est fourni dans l’intention, car il n’existe aucune contrainte sur l’origine des données retournées. Vous pouvez également inclure si #CATEGORY_OPENABLE vous pouvez accepter uniquement les données qui peuvent être ouvertes en tant que flux. Vous pouvez utiliser #EXTRA_LOCAL_ONLY pour limiter la sélection de contenu aux données locales. Vous pouvez utiliser #EXTRA_ALLOW_MULTIPLE pour permettre à l’utilisateur de sélectionner plusieurs éléments.

Sortie : URI de l’élément sélectionné. Il doit s’agir d’un contenu : URI pour que n’importe quel récepteur puisse y accéder.

Documentation Java pour android.content.Intent.ACTION_GET_CONTENT.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.