Intent.ActionOpenDocument Feld
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Aktivitätsaktion: Zulassen, dass der Benutzer ein oder mehrere vorhandene Dokumente auswählen und zurückgeben kann.
[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;
[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : string
Feldwert
Implementiert
- Attribute
Hinweise
Aktivitätsaktion: Zulassen, dass der Benutzer ein oder mehrere vorhandene Dokumente auswählen und zurückgeben kann. Beim Aufrufen zeigt das System die verschiedenen DocumentsProvider auf dem Gerät installierten Instanzen an, sodass der Benutzer interaktiv durch sie navigieren kann. Zu diesen Dokumenten gehören lokale Medien wie Fotos und Videos sowie Dokumente, die von installierten Cloudspeicheranbietern bereitgestellt werden.
Jedes Dokument wird als content:// URI dargestellt, der von einem DocumentsProviderURI unterstützt wird, der als Datenstrom mit ContentResolver#openFileDescriptor(Uri, String)oder nach android.provider.DocumentsContract.Document Metadaten abgefragt werden kann.
Alle ausgewählten Dokumente werden an die aufrufende Anwendung mit dauerhaften Lese- und Schreibberechtigungserteilungen zurückgegeben. Wenn Sie den Zugriff auf die Dokumente über Geräteneustarts hinweg beibehalten möchten, müssen Sie explizit die dauerhaften Berechtigungen verwenden ContentResolver#takePersistableUriPermission(Uri, int).
Aufrufer müssen die zulässigen DOKUMENT-MIME-Typen durch #setType(String)angeben. Um beispielsweise Fotos auszuwählen, verwenden Sie image/*. Wenn mehrere nicht zusammenhängende MIME-Typen akzeptabel sind, definieren Sie sie in #EXTRA_MIME_TYPES und #setType(String) in */*.
Wenn der Aufrufer mehrere zurückgegebene Elemente verarbeiten kann (der Benutzer, der mehrere Auswahl durchführt), können Sie angeben #EXTRA_ALLOW_MULTIPLE , dass dies angegeben werden soll.
Aufrufer müssen in der Absicht enthalten #CATEGORY_OPENABLE sein, URIs abzurufen, die mit ContentResolver#openFileDescriptor(Uri, String)geöffnet werden können.
Aufrufer können einen Dokument-URI so festlegen, dass DocumentsContract#EXTRA_INITIAL_URI er den ursprünglichen Speicherort des Dokumentnavigators angibt. Das System führt das Beste aus, um den Navigator im angegebenen Dokument zu starten, wenn es sich um einen Ordner oder den Ordner handelt, der das angegebene Dokument enthält, wenn nicht.
Ausgabe: Der URI des ausgewählten Elements, das zurückgegeben wurde #getData(). Dies muss ein content:// URI sein, damit jeder Empfänger darauf zugreifen kann. Wenn mehrere Dokumente ausgewählt wurden, werden sie zurückgegeben in #getClipData().
Java Dokumentation für android.content.Intent.ACTION_OPEN_DOCUMENT.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.