MediaStore.ExtraPickerPreSelectionUris Field

[Android.Runtime.Register("EXTRA_PICKER_PRE_SELECTION_URIS", ApiSince=36)]
public const string ExtraPickerPreSelectionUris;

[<Android.Runtime.Register("EXTRA_PICKER_PRE_SELECTION_URIS", ApiSince=36)>]
val mutable ExtraPickerPreSelectionUris : string

Field Value

Attributes

RegisterAttribute

Remarks

The name of an optional intent-extra used to specify URIs for pre-selection in photo picker opened with MediaStore#ACTION_PICK_IMAGES in multi-select mode.

Only MediaStore content URI(s) of the item(s) received as a result of MediaStore#ACTION_PICK_IMAGES action are accepted. The value of this intent-extra should be an ArrayList of type URIs. Default value is null. Maximum number of URIs that can be accepted is limited by the value passed in MediaStore#EXTRA_PICK_IMAGES_MAX as part of the MediaStore#ACTION_PICK_IMAGES intent. In case the count of input URIs is greater than the limit then IllegalArgumentException is thrown.

The provided list will be checked for permissions and authority. Any URI that is inaccessible, doesn't match the current authorities(local or cloud) or is invalid will be filtered out.

The items corresponding to the URIs will appear selected when the photo picker is opened. In the case of MediaStore#EXTRA_PICK_IMAGES_IN_ORDER the chronological order of the input list will be used for ordered selection of the pre-selected items.

This is not a mechanism to revoke permissions for items, i.e. de-selection of a pre-selected item by the user will not result in revocation of the grant.

Java documentation for android.provider.MediaStore.EXTRA_PICKER_PRE_SELECTION_URIS.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.