Condividi tramite


Intent.ActionOpenDocument Campo

Definizione

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 DocumentsProvideroggetto , 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.

Si applica a

Vedi anche