# PickVisualMediaRequestKt Added in 1.6.0 *** ** * ** *** ``` public final class PickVisualMediaRequestKt ```
*** ** * ** *** ## Summary | ### Public methods | |---|---| | `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | `https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequestKt#PickVisualMediaRequest(androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType,kotlin.Int,kotlin.Boolean,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.DefaultTab)( @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType, @https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems, boolean isOrderedSelection, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab )` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | | `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | `https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequestKt#PickVisualMediaRequest(kotlin.Long,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType,kotlin.Int,kotlin.Boolean,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.DefaultTab)( long accentColor, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType, @https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems, boolean isOrderedSelection, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab )` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | | `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | `@https://developer.android.com/reference/androidx/annotation/RequiresApi(value = 33) https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequestKt#PickVisualMediaRequest(androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.MediaCapabilities,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType,kotlin.Int,kotlin.Boolean,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.DefaultTab)( https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType, @https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems, boolean isOrderedSelection, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab )` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | | `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | `@https://developer.android.com/reference/androidx/annotation/RequiresApi(value = 33) https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequestKt#PickVisualMediaRequest(androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.MediaCapabilities,kotlin.Long,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType,kotlin.Int,kotlin.Boolean,androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.DefaultTab)( https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding, long accentColor, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType, @https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems, boolean isOrderedSelection, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab )` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | ## Public methods ### PickVisualMediaRequest Artifact: [androidx.activity:activity](https://developer.android.com/jetpack/androidx/releases/activity) [View Source](https://cs.android.com/search?q=file:androidx/activity/result/PickVisualMediaRequest.kt+function:PickVisualMediaRequest) Added in [1.10.0](https://developer.android.com/jetpack/androidx/releases/activity#1.10.0) ``` public static final @NonNull PickVisualMediaRequest PickVisualMediaRequest(     @NonNull ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType,     @IntRange(from = 2) int maxItems,     boolean isOrderedSelection,     @NonNull ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab ) ``` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | Parameters | |---|---| | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType` | type to go into the PickVisualMediaRequest | | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems` | limit the number of selectable items when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` | | `boolean isOrderedSelection` | whether the user can control the order of selected media when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` (defaults to false) | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab` | the tab to initially open the picker in (defaults to `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab.PhotosTab`). Note that the support for this parameter was added in API level 35 / R ext 12 and applies the default behavior for older versions. Also see `https://developer.android.com/reference/android/provider/MediaStore.html#EXTRA_PICK_IMAGES_LAUNCH_TAB` | | Returns | |---|---| | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | a PickVisualMediaRequest that contains the given input | ### PickVisualMediaRequest Artifact: [androidx.activity:activity](https://developer.android.com/jetpack/androidx/releases/activity) [View Source](https://cs.android.com/search?q=file:androidx/activity/result/PickVisualMediaRequest.kt+function:PickVisualMediaRequest) Added in [1.10.0](https://developer.android.com/jetpack/androidx/releases/activity#1.10.0) ``` public static final @NonNull PickVisualMediaRequest PickVisualMediaRequest(     long accentColor,     @NonNull ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType,     @IntRange(from = 2) int maxItems,     boolean isOrderedSelection,     @NonNull ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab ) ``` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | Parameters | |---|---| | `long accentColor` | color long to customize picker accent color. Note that the support for this parameter was added in API level 35 / R ext 12 and applies the default behavior for older versions. Also see `https://developer.android.com/reference/android/provider/MediaStore.html#EXTRA_PICK_IMAGES_ACCENT_COLOR` | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType` | type to go into the PickVisualMediaRequest | | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems` | limit the number of selectable items when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` | | `boolean isOrderedSelection` | whether the user can control the order of selected media when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` (defaults to false) | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab` | the tab to initially open the picker in (defaults to `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab.PhotosTab`). Note that the support for this parameter was added in API level 35 / R ext 12 and applies the default behavior for older versions. Also see `https://developer.android.com/reference/android/provider/MediaStore.html#EXTRA_PICK_IMAGES_LAUNCH_TAB` | | Returns | |---|---| | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | a PickVisualMediaRequest that contains the given input | ### PickVisualMediaRequest Artifact: [androidx.activity:activity](https://developer.android.com/jetpack/androidx/releases/activity) [View Source](https://cs.android.com/search?q=file:androidx/activity/result/PickVisualMediaRequest.kt+function:PickVisualMediaRequest) Added in [1.11.0](https://developer.android.com/jetpack/androidx/releases/activity#1.11.0) ``` @RequiresApi(value = 33) public static final @NonNull PickVisualMediaRequest PickVisualMediaRequest(     ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding,     @NonNull ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType,     @IntRange(from = 2) int maxItems,     boolean isOrderedSelection,     @NonNull ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab ) ``` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding` | the `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities` that the application can handle. | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType` | type to go into the PickVisualMediaRequest | | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems` | limit the number of selectable items when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` | | `boolean isOrderedSelection` | whether the user can control the order of selected media when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` (defaults to false) | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab` | the tab to initially open in the picker (defaults to `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab.PhotosTab`) | | Returns | |---|---| | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | a PickVisualMediaRequest that contains the given input | ### PickVisualMediaRequest Artifact: [androidx.activity:activity](https://developer.android.com/jetpack/androidx/releases/activity) [View Source](https://cs.android.com/search?q=file:androidx/activity/result/PickVisualMediaRequest.kt+function:PickVisualMediaRequest) Added in [1.11.0](https://developer.android.com/jetpack/androidx/releases/activity#1.11.0) ``` @RequiresApi(value = 33) public static final @NonNull PickVisualMediaRequest PickVisualMediaRequest(     ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding,     long accentColor,     @NonNull ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType,     @IntRange(from = 2) int maxItems,     boolean isOrderedSelection,     @NonNull ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab ) ``` Creates a request for a `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` or `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia` Activity Contract. | Parameters | |---|---| | `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities mediaCapabilitiesForTranscoding` | the `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.MediaCapabilities` that the application can handle. | | `long accentColor` | color long to customize picker accent color | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.VisualMediaType mediaType` | type to go into the PickVisualMediaRequest | | `@https://developer.android.com/reference/androidx/annotation/IntRange(from = 2) int maxItems` | limit the number of selectable items when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` | | `boolean isOrderedSelection` | whether the user can control the order of selected media when using `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickMultipleVisualMedia` (defaults to false) | | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab defaultTab` | the tab to initially open in the picker (defaults to `https://developer.android.com/reference/androidx/activity/result/contract/ActivityResultContracts.PickVisualMedia.DefaultTab.PhotosTab`) | | Returns | |---|---| | `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/activity/result/PickVisualMediaRequest` | a PickVisualMediaRequest that contains the given input |