Intent.ActionGetContent Feld

Definition

Namespace:

Android.Content

Assembly:

Mono.Android.dll

Aktivitätsaktion: Zulassen, dass der Benutzer eine bestimmte Art von Daten auswählt und zurückgibt.

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

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

Feldwert

String

Implementiert

ContentsFileDescriptor

Attribute

RegisterAttribute

Hinweise

Aktivitätsaktion: Zulassen, dass der Benutzer eine bestimmte Art von Daten auswählt und zurückgibt. Dies unterscheidet sich davon #ACTION_PICK , dass wir hier nur sagen, welche Art von Daten gewünscht wird, nicht ein URI vorhandener Daten, aus denen der Benutzer auswählen kann. Ein ACTION_GET_CONTENT könnte es dem Benutzer ermöglichen, die Daten während der Ausführung zu erstellen (z. B. ein Bild oder einen Ton aufzunehmen), sie über das Web zu durchsuchen und die gewünschten Daten herunterzuladen usw.

Es gibt zwei Hauptmethoden für die Verwendung dieser Aktion: Wenn Sie eine bestimmte Art von Daten möchten, z. B. einen Personenkontakt, legen Sie den MIME-Typ auf die art der gewünschten Daten fest und starten sie mit Context#startActivity(Intent). Das System startet dann die beste Anwendung, um diese Art von Daten für Sie auszuwählen.

Möglicherweise sind Sie auch an einer Reihe von Inhaltstypen interessiert, die der Benutzer auswählen kann. Beispielsweise kann eine E-Mail-Anwendung, die dem Benutzer das Hinzufügen einer Anlage zu einer E-Mail-Nachricht gestatten möchte, diese Aktion verwenden, um eine Liste aller Inhaltstypen anzuzeigen, die der Benutzer anfügen kann.

In diesem Fall sollten Sie die GET_CONTENT Absicht mit einer Auswahl (durch #createChooser) umschließen, die dem Benutzer die richtige Benutzeroberfläche gibt, um auszuwählen, wie Ihre Daten gesendet werden sollen, und Sie können eine Eingabeaufforderung angeben, die angibt, was sie tun. In der Regel geben Sie einen breiten MIME-Typ (z. B. Image/* oder */*) an, was zu einem breiten Spektrum von Inhaltstypen führt, aus dem der Benutzer auswählen kann.

Bei verwendung einer so breiten GET_CONTENT Aktion ist es häufig wünschenswert, nur aus Daten zu wählen, die als Datenstrom dargestellt werden können. Dies wird erreicht, indem der #CATEGORY_OPENABLE In-Intent-Vorgang erforderlich ist.

Aufrufer können optional angeben #EXTRA_LOCAL_ONLY , dass die gestartete Inhaltsauswahl nur Ergebnisse zurückgibt, die Daten darstellen, die lokal auf dem Gerät verfügbar sind. Wenn dieses Extra beispielsweise auf "true" festgelegt ist, sollte eine Bildauswahl keine Bilder anzeigen, die von einem Remoteserver, aber nicht bereits auf dem lokalen Gerät verfügbar sind (daher müssen sie beim Öffnen heruntergeladen werden).

Wenn der Aufrufer mehrere zurückgegebene Elemente verarbeiten kann (der Benutzer, der mehrere Auswahl durchführt), kann er angeben #EXTRA_ALLOW_MULTIPLE , dass dies angegeben wird.

Eingabe: #getType ist der gewünschte MIME-Typ, der abgerufen werden soll. Beachten Sie, dass in der Absicht kein URI angegeben wird, da es keine Einschränkungen gibt, von denen die zurückgegebenen Daten ursprünglich stammen. Sie können auch einschließen #CATEGORY_OPENABLE , wenn Sie nur Daten akzeptieren können, die als Datenstrom geöffnet werden können. Sie können die #EXTRA_LOCAL_ONLY Inhaltsauswahl auf lokale Daten beschränken. Sie können #EXTRA_ALLOW_MULTIPLE es dem Benutzer ermöglichen, mehrere Elemente auszuwählen.

Ausgabe: Der URI des elements, das ausgewählt wurde. Dies muss ein Inhalt sein: URI, damit jeder Empfänger darauf zugreifen kann.

Java-Dokumentation für android.content.Intent.ACTION_GET_CONTENT.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.