Intent.ActionOpenDocument Campo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Azione attività: consente all'utente di selezionare e restituire uno o più documenti esistenti.
[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string
Valore del campo
Implementazioni
- Attributi
Commenti
Azione attività: consente all'utente di selezionare e restituire uno o più documenti esistenti. Quando viene richiamato, il sistema visualizzerà le varie DocumentsProvider
istanze installate nel dispositivo, consentendo all'utente di spostarsi in modo interattivo tra di esse. Questi documenti includono supporti locali, ad esempio foto e video, e documenti forniti dai provider di archiviazione cloud installati.
Ogni documento è rappresentato come un content://
URI supportato da un DocumentsProvider
oggetto , che può essere aperto come flusso con ContentResolver#openFileDescriptor(Uri, String)
o sottoposto a query per android.provider.DocumentsContract.Document
i metadati.
Tutti i documenti selezionati vengono restituiti all'applicazione chiamante con concessioni di autorizzazioni di lettura e scrittura persistenti. Se si vuole mantenere l'accesso ai documenti tra i riavvii del dispositivo, è necessario accettare in modo esplicito le autorizzazioni persistenti usando ContentResolver#takePersistableUriPermission(Uri, int)
.
I chiamanti devono indicare i tipi MIME di documenti accettabili tramite #setType(String)
. Ad esempio, per selezionare le foto, usare image/*
. Se più tipi MIME non contigui sono accettabili, definirli in #EXTRA_MIME_TYPES
e #setType(String)
in */*.
Se il chiamante può gestire più elementi restituiti (l'utente che esegue più selezioni), è possibile specificare #EXTRA_ALLOW_MULTIPLE
per indicare questo valore.
I chiamanti devono includere #CATEGORY_OPENABLE
nella finalità per ottenere gli URI che possono essere aperti con ContentResolver#openFileDescriptor(Uri, String)
.
I chiamanti possono impostare un URI del documento tramite DocumentsContract#EXTRA_INITIAL_URI
per indicare la posizione iniziale dello strumento di navigazione dei documenti. Il sistema farà del suo meglio per avviare lo strumento di navigazione nel documento specificato se si tratta di una cartella o la cartella che contiene il documento specificato, se non lo è.
Output: URI dell'elemento selezionato, restituito in #getData()
. Deve trattarsi di un content://
URI in modo che qualsiasi ricevitore possa accedervi. Se sono stati selezionati più documenti, vengono restituiti in #getClipData()
.
Documentazione java per android.content.Intent.ACTION_OPEN_DOCUMENT
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.