Intent.ActionGetContent Campo

Definizione

Spazio dei nomi:

Android.Content

Assembly:

Mono.Android.dll

Azione attività: consente all'utente di selezionare un particolare tipo di dati e restituirlo.

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

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

Valore del campo

String

Implementazioni

ContentsFileDescriptor

Attributi

RegisterAttribute

Commenti

Azione attività: consente all'utente di selezionare un particolare tipo di dati e restituirlo. Questo comportamento è diverso da #ACTION_PICK quello in cui si dice solo il tipo di dati desiderato, non un URI dei dati esistenti da cui l'utente può scegliere. Un ACTION_GET_CONTENT potrebbe consentire all'utente di creare i dati durante l'esecuzione (ad esempio scattare un'immagine o registrare un suono), consentire loro di esplorare il Web e scaricare i dati desiderati e così via.

Esistono due modi principali per usare questa azione: se si vuole un tipo specifico di dati, ad esempio un contatto di persona, impostare il tipo MIME sul tipo di dati desiderato e avviarlo con Context#startActivity(Intent). Il sistema avvierà quindi l'applicazione migliore per selezionare il tipo di dati desiderato.

Potresti anche essere interessato a un set di tipi di contenuto che l'utente può scegliere. Ad esempio, un'applicazione di posta elettronica che desidera consentire all'utente di aggiungere un allegato a un messaggio di posta elettronica può utilizzare questa azione per visualizzare un elenco di tutti i tipi di contenuto che l'utente può allegare.

In questo caso, è necessario eseguire il wrapping della finalità GET_CONTENT con un selettore (tramite #createChooser), che fornirà all'utente l'interfaccia appropriata per scegliere come inviare i dati e consentire di specificare una richiesta che indica le operazioni eseguite. In genere si specifica un tipo MIME ampio (ad esempio image/* o */*), con un'ampia gamma di tipi di contenuto tra cui l'utente può selezionare.

Quando si usa un'azione di GET_CONTENT così ampia, è spesso consigliabile scegliere solo i dati che possono essere rappresentati come flusso. Questa operazione viene eseguita richiedendo nella #CATEGORY_OPENABLE finalità .

I chiamanti possono facoltativamente specificare #EXTRA_LOCAL_ONLY di richiedere che il selezionatore di contenuto avviato restituisca solo i risultati che rappresentano i dati disponibili localmente nel dispositivo. Ad esempio, se questo extra è impostato su true, una selezione immagini non dovrebbe mostrare le immagini disponibili da un server remoto ma non già nel dispositivo locale (quindi richiede che vengano scaricate all'apertura).

Se il chiamante può gestire più elementi restituiti (l'utente che esegue più selezioni), può specificare #EXTRA_ALLOW_MULTIPLE per indicare questo.

Input: #getType è il tipo MIME desiderato da recuperare. Si noti che non viene fornito alcun URI nella finalità, poiché non esistono vincoli sulla provenienza dei dati restituiti. È anche possibile includere se #CATEGORY_OPENABLE è possibile accettare solo i dati che possono essere aperti come flusso. È possibile usare #EXTRA_LOCAL_ONLY per limitare la selezione del contenuto ai dati locali. È possibile usare #EXTRA_ALLOW_MULTIPLE per consentire all'utente di selezionare più elementi.

Output: URI dell'elemento selezionato. Deve trattarsi di un contenuto: URI in modo che qualsiasi ricevitore possa accedervi.

Documentazione java per android.content.Intent.ACTION_GET_CONTENT.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.