androidx.activity.result

Kotlin |Java

Interfaces

`ActivityResultCallback`	A type-safe callback to be called when an `activity result` is available.
`ActivityResultCaller`	A class that can call `Activity.startActivityForResult`-style APIs without having to manage request codes, and converting request/response to an `Intent`
`ActivityResultRegistryOwner`	A class that has an `ActivityResultRegistry` that allows you to register a `ActivityResultCallback` for handling an `androidx.activity.result.contract.ActivityResultContract`.

Classes

`ActivityResult`	A container for an activity result as obtained from `Activity.onActivityResult`
`ActivityResultLauncher`	A launcher for a previously-`prepared call` to start the process of executing an `ActivityResultContract` that takes an `I` as its required input.
`ActivityResultRegistry`	A registry that stores `activity result callbacks` for `registered calls`.
`IntentSenderRequest`	A request for a `androidx.activity.result.contract.ActivityResultContracts.StartIntentSenderForResult` Activity Contract.
`IntentSenderRequest.Builder`	A builder for constructing `IntentSenderRequest` instances.
`PickVisualMediaRequest`	A request for a `androidx.activity.result.contract.ActivityResultContracts.PickMultipleVisualMedia` or `androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia` Activity Contract.
`PickVisualMediaRequest.Builder`	A builder for constructing `PickVisualMediaRequest` instances.

Top-level functions summary

PickVisualMediaRequest

PickVisualMediaRequest(
    mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType,
    maxItems: @IntRange(from = 2) Int,
    isOrderedSelection: Boolean,
    defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab
)

Creates a request for a androidx.activity.result.contract.ActivityResultContracts.PickMultipleVisualMedia or androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia Activity Contract.

PickVisualMediaRequest

PickVisualMediaRequest(
    accentColor: Long,
    mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType,
    maxItems: @IntRange(from = 2) Int,
    isOrderedSelection: Boolean,
    defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab
)

Extension functions summary

`operator Int`	`ActivityResult.component1()` Destructuring declaration for `ActivityResult` to provide the requestCode
`operator Intent?`	`ActivityResult.component2()` Destructuring declaration for `ActivityResult` to provide the intent
`Unit`	`ActivityResultLauncher<Void?>.launch(options: ActivityOptionsCompat?)` Convenience method to launch a no-argument registered call without needing to pass in `null`.
`Unit`	`ActivityResultLauncher<Unit>.launch(options: ActivityOptionsCompat?)` Convenience method to launch a no-argument registered call without needing to pass in `Unit`.
`ActivityResultLauncher<Unit>`	`<I : Any?, O : Any?> ActivityResultCaller.registerForActivityResult( contract: ActivityResultContract<I, O>, input: I, callback: (O) -> Unit )` A version of `ActivityResultCaller.registerForActivityResult` that additionally takes an input right away, producing a launcher that doesn't take any additional input when called.
`ActivityResultLauncher<Unit>`	`<I : Any?, O : Any?> ActivityResultCaller.registerForActivityResult( contract: ActivityResultContract<I, O>, input: I, registry: ActivityResultRegistry, callback: (O) -> Unit )` A version of `ActivityResultCaller.registerForActivityResult` that additionally takes an input right away, producing a launcher that doesn't take any additional input when called.

Top-level functions

PickVisualMediaRequest

Artifact: androidx.activity:activity

View Source

Added in 1.10.0-alpha01

fun PickVisualMediaRequest(
    mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType = ImageAndVideo,
    maxItems: @IntRange(from = 2) Int = PickMultipleVisualMedia.getMaxItems(),
    isOrderedSelection: Boolean = false,
    defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab = DefaultTab.PhotosTab
): PickVisualMediaRequest

Parameters
`mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType = ImageAndVideo`	type to go into the PickVisualMediaRequest
`maxItems: @IntRange(from = 2) Int = PickMultipleVisualMedia.getMaxItems()`	limit the number of selectable items when using `PickMultipleVisualMedia`
`isOrderedSelection: Boolean = false`	whether the user can control the order of selected media when using `PickMultipleVisualMedia` (defaults to false)
`defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab = DefaultTab.PhotosTab`	the tab to initially open in the picker (defaults to `DefaultTab.PhotosTab`)

Returns
`PickVisualMediaRequest`	a PickVisualMediaRequest that contains the given input

PickVisualMediaRequest

Artifact: androidx.activity:activity

View Source

Added in 1.10.0-alpha01

fun PickVisualMediaRequest(
    accentColor: Long,
    mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType = ImageAndVideo,
    maxItems: @IntRange(from = 2) Int = PickMultipleVisualMedia.getMaxItems(),
    isOrderedSelection: Boolean = false,
    defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab = DefaultTab.PhotosTab
): PickVisualMediaRequest

Parameters
`accentColor: Long`	color long to customize picker accent color
`mediaType: ActivityResultContracts.PickVisualMedia.VisualMediaType = ImageAndVideo`	type to go into the PickVisualMediaRequest
`maxItems: @IntRange(from = 2) Int = PickMultipleVisualMedia.getMaxItems()`	limit the number of selectable items when using `PickMultipleVisualMedia`
`isOrderedSelection: Boolean = false`	whether the user can control the order of selected media when using `PickMultipleVisualMedia` (defaults to false)
`defaultTab: ActivityResultContracts.PickVisualMedia.DefaultTab = DefaultTab.PhotosTab`	the tab to initially open in the picker (defaults to `DefaultTab.PhotosTab`)

Returns
`PickVisualMediaRequest`	a PickVisualMediaRequest that contains the given input

Extension functions

component1

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

operator fun ActivityResult.component1(): Int

Destructuring declaration for ActivityResult to provide the requestCode

Returns
`Int`	the resultCode of the `ActivityResult`

component2

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

operator fun ActivityResult.component2(): Intent?

Destructuring declaration for ActivityResult to provide the intent

Returns
`Intent?`	the intent of the `ActivityResult`

launch

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

fun ActivityResultLauncher<Void?>.launch(
    options: ActivityOptionsCompat? = null
): Unit

Convenience method to launch a no-argument registered call without needing to pass in null.

launch

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

fun ActivityResultLauncher<Unit>.launch(
    options: ActivityOptionsCompat? = null
): Unit

Convenience method to launch a no-argument registered call without needing to pass in Unit.

registerForActivityResult

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

fun <I : Any?, O : Any?> ActivityResultCaller.registerForActivityResult(
    contract: ActivityResultContract<I, O>,
    input: I,
    callback: (O) -> Unit
): ActivityResultLauncher<Unit>

A version of ActivityResultCaller.registerForActivityResult that additionally takes an input right away, producing a launcher that doesn't take any additional input when called.

See also
`registerForActivityResult`

registerForActivityResult

Artifact: androidx.activity:activity

View Source

Added in 1.2.0

fun <I : Any?, O : Any?> ActivityResultCaller.registerForActivityResult(
    contract: ActivityResultContract<I, O>,
    input: I,
    registry: ActivityResultRegistry,
    callback: (O) -> Unit
): ActivityResultLauncher<Unit>

A version of ActivityResultCaller.registerForActivityResult that additionally takes an input right away, producing a launcher that doesn't take any additional input when called.

See also
`registerForActivityResult`