Intent.ActionOpenDocument Поле
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Действие действия: разрешить пользователю выбирать и возвращать один или несколько существующих документов.
[Android.Runtime.Register("ACTION_OPEN_DOCUMENT")]
public const string ActionOpenDocument;[<Android.Runtime.Register("ACTION_OPEN_DOCUMENT")>]
val mutable ActionOpenDocument : stringЗначение поля
Реализации
- Атрибуты
Комментарии
Действие действия: разрешить пользователю выбирать и возвращать один или несколько существующих документов. При вызове система отображает различные DocumentsProvider экземпляры, установленные на устройстве, позволяя пользователю интерактивно перемещаться по ним. К этим документам относятся локальные носители, например фотографии и видео, а также документы, предоставляемые установленными поставщиками облачных хранилищ.
Каждый документ представлен в виде универсального content:// кода ресурса (URI DocumentsProvider), который можно открыть в виде потока с ContentResolver#openFileDescriptor(Uri, String)или запросить android.provider.DocumentsContract.Document метаданные.
Все выбранные документы возвращаются в вызывающее приложение с разрешениями на чтение и запись. Если вы хотите сохранить доступ к документам при перезагрузке устройства, необходимо явно получить сохраняемые разрешения с помощью ContentResolver#takePersistableUriPermission(Uri, int).
Вызывающие операторы должны указывать допустимые типы MIME документа через #setType(String). Например, чтобы выбрать фотографии, используйте image/*. Если допустимы несколько несвязанных типов MIME, определите их в #EXTRA_MIME_TYPES и #setType(String) в */*.
Если вызывающий объект может обрабатывать несколько возвращаемых элементов (пользователь, выполняющий множественный выбор), можно указать #EXTRA_ALLOW_MULTIPLE , чтобы указать это.
Вызывающие абоненты должны включать #CATEGORY_OPENABLE в намерение, чтобы получить URI, которые можно открыть с помощью ContentResolver#openFileDescriptor(Uri, String).
Вызывающие элементы могут задать URI документа с помощью DocumentsContract#EXTRA_INITIAL_URI , чтобы указать начальное расположение навигатора документов. Система сделает все возможное, чтобы запустить навигатор в указанном документе, если это папка, или папка, содержащая указанный документ, если нет.
Выходные данные: универсальный код ресурса (URI) выбранного элемента, возвращенного в #getData(). Это должен быть универсальный content:// код ресурса (URI), чтобы любой получатель смог получить к нему доступ. Если выбрано несколько документов, они возвращаются в #getClipData().
Документация по Java для android.content.Intent.ACTION_OPEN_DOCUMENT.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.