Intent.ActionOpenDocument Champ

Définition

Espace de noms:: Android.Content

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Action d’activité : autoriser l’utilisateur à sélectionner et retourner un ou plusieurs documents existants.

[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;

[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string

Valeur de champ

String

Implémente

ContentsFileDescriptor

Attributs: RegisterAttribute

Remarques

Action d’activité : autoriser l’utilisateur à sélectionner et retourner un ou plusieurs documents existants. Lorsqu’il est appelé, le système affiche les différentes DocumentsProvider instances installées sur l’appareil, ce qui permet à l’utilisateur de naviguer de manière interactive. Ces documents incluent des médias locaux, tels que des photos et des vidéos, ainsi que des documents fournis par des fournisseurs de stockage cloud installés.

Chaque document est représenté en tant qu’URI content:// soutenu par un DocumentsProvider, qui peut être ouvert en tant que flux avec ContentResolver#openFileDescriptor(Uri, String), ou interrogé pour android.provider.DocumentsContract.Document les métadonnées.

Tous les documents sélectionnés sont retournés à l’application appelante avec des autorisations de lecture et d’écriture persistantes. Si vous souhaitez conserver l’accès aux documents entre les redémarrages de l’appareil, vous devez prendre explicitement les autorisations persistantes à l’aide ContentResolver#takePersistableUriPermission(Uri, int)de .

Les appelants doivent indiquer les types MIME de document acceptables via #setType(String). Par exemple, pour sélectionner des photos, utilisez image/*. Si plusieurs types MIME disjoints sont acceptables, définissez-les dans #EXTRA_MIME_TYPES et #setType(String) sur */*.

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

Les appelants doivent inclure #CATEGORY_OPENABLE dans l’intention d’obtenir des URI qui peuvent être ouverts avec ContentResolver#openFileDescriptor(Uri, String).

Les appelants peuvent définir un URI de document pour DocumentsContract#EXTRA_INITIAL_URI indiquer l’emplacement initial du navigateur de documents. Le système fera de son mieux pour lancer le navigateur dans le document spécifié s’il s’agit d’un dossier, ou du dossier qui contient le document spécifié si ce n’est pas le cas.

Sortie : URI de l’élément sélectionné, retourné dans #getData(). Il doit s’agir d’un content:// URI pour que n’importe quel récepteur puisse y accéder. Si plusieurs documents ont été sélectionnés, ils sont retournés dans #getClipData().

Java documentation pour android.content.Intent.ACTION_OPEN_DOCUMENT.

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

S’applique à