Intent.ActionGetContent Поле

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

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

Значение поля

Реализации

Атрибуты

RegisterAttribute

Комментарии

Действие действия. Разрешить пользователю выбрать определенный тип данных и вернуть его. Это отличается от #ACTION_PICK того, что здесь мы просто говорим, какой тип данных необходим, а не URI существующих данных, из которых пользователь может выбрать. ACTION_GET_CONTENT может позволить пользователю создавать данные по мере его выполнения (например, с изображением или записью звука), позволить им просматривать интернет и скачивать нужные данные и т. д.

Это действие можно использовать двумя основными способами: если требуется определенный тип данных, например контакт пользователя, вы настроите тип MIME для типа данных, с которыми вы хотите, и запустите его.Context#startActivity(Intent) Затем система запустит лучшее приложение, чтобы выбрать этот тип данных для вас.

Вы также можете быть заинтересованы в любом из набора типов контента, который пользователь может выбрать. Например, приложение электронной почты, которое хочет разрешить пользователю добавлять вложение в сообщение электронной почты, может использовать это действие для создания списка всех типов содержимого, которое пользователь может присоединить.

В этом случае необходимо упаковать намерение GET_CONTENT с помощью селера (через #createChooser), который даст пользователю правильный интерфейс, чтобы выбрать способ отправки данных и разрешить указать запрос, указывающий, что они делают. Обычно вы указываете широкий тип MIME (например, image/* или */*), что приводит к широкому спектру типов контента, которые пользователь может выбрать.

При использовании такого широкого GET_CONTENT действия часто желательно выбирать только из данных, которые могут быть представлены в виде потока. Это достигается путем требования #CATEGORY_OPENABLE в намерении.

Вызывающие серверы могут дополнительно указать #EXTRA_LOCAL_ONLY запрос на то, что запущенный выбор содержимого возвращает только результаты, представляющие данные, доступные локально на устройстве. Например, если этот дополнительный параметр имеет значение true, средство выбора изображений не должно отображать изображения, доступные на удаленном сервере, но еще не на локальном устройстве (поэтому требуется скачать их при открытии).

Если вызывающий объект может обрабатывать несколько возвращаемых элементов (пользователь, выполняющий несколько выбора), он может указать #EXTRA_ALLOW_MULTIPLE это.

Входные данные: #getType это требуемый тип MIME для извлечения. Обратите внимание, что в намерении не предоставляется универсальный код ресурса (URI), так как нет ограничений на то, откуда изначально приходят возвращаемые данные. Вы также можете включить #CATEGORY_OPENABLE , если вы можете принимать только данные, которые можно открыть в виде потока. Можно использовать #EXTRA_LOCAL_ONLY для ограничения выделения содержимого локальными данными. Вы можете использовать #EXTRA_ALLOW_MULTIPLE , чтобы разрешить пользователю выбирать несколько элементов.

Выходные данные: URI выбранного элемента. Это должно быть содержимое: URI, чтобы любой получатель смог получить к нему доступ.

Документация по Java для android.content.Intent.ACTION_GET_CONTENT.

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к