ActivityResultCaller

Added in 1.2.0

Kotlin |Java

interface ActivityResultCaller

Known direct subclasses

ComponentActivity, Fragment

`ComponentActivity`	Base class for activities that enables composition of higher level components.
`Fragment`	Static library support version of the framework's `android.app.Fragment`.

Known indirect subclasses

AbstractListDetailFragment, AbstractProgressFragment, AmbientModeSupport, AppCompatActivity, AppCompatDialogFragment, BaseCarAppActivity, BaseLeanbackPreferenceFragmentCompat, BaseSupportFragment, BrandedSupportFragment, BrowseSupportFragment, CarAppActivity, ComposableFragment, ComposableNavHostFragment, DefaultProgressFragment, DetailsSupportFragment, DialogFragment, DynamicNavHostFragment, EditTextPreferenceDialogFragmentCompat, ErrorSupportFragment, FragmentActivity, GuidedStepSupportFragment, HeadersSupportFragment, LauncherActivity, LeanbackEditTextPreferenceDialogFragmentCompat, LeanbackListPreferenceDialogFragmentCompat, LeanbackPreferenceDialogFragmentCompat, LeanbackPreferenceFragmentCompat, LeanbackSettingsFragmentCompat, ListFragment, ListPreferenceDialogFragmentCompat, MediaRouteChooserDialogFragment, MediaRouteControllerDialogFragment, MediaRouteDiscoveryFragment, MultiSelectListPreferenceDialogFragmentCompat, NavHostFragment, OnboardingSupportFragment, PdfViewerFragment, PlaybackSupportFragment, PreferenceDialogFragmentCompat, PreferenceFragmentCompat, PreferenceHeaderFragmentCompat, PreviewActivity, RowsSupportFragment, SdkActivity, SearchSupportFragment, VerticalGridSupportFragment, VideoSupportFragment

`AbstractListDetailFragment`	A fragment supports adaptive two-pane layout.
`AbstractProgressFragment`	The base class for `Fragment`s that handle dynamic feature installation.
`AmbientModeSupport`	This class is deprecated. Use `AmbientLifecycleObserver` instead.
`AppCompatActivity`	Base class for activities that wish to use some of the newer platform features on older Android devices.
`AppCompatDialogFragment`	A special version of `DialogFragment` which uses an `AppCompatDialog` in place of a platform-styled dialog.
`BaseCarAppActivity`	Core logic for CarAppLibrary Activity interaction with a host.
`BaseLeanbackPreferenceFragmentCompat`	This fragment provides a preference fragment with leanback-style behavior, suitable for embedding into broader UI elements.
`BaseSupportFragment`	Base class for leanback Fragments.
`BrandedSupportFragment`	Fragment class for managing search and branding using a view that implements `TitleViewAdapter.Provider`.
`BrowseSupportFragment`	A fragment for creating Leanback browse screens.
`CarAppActivity`	The class representing a car app activity in the main display.
`ComposableFragment`	This class provides a `Fragment` wrapper around a composable function that is loaded via reflection.
`ComposableNavHostFragment`	A `NavHostFragment` that adds support for `ComposableFragment` instances via `ComposableFragmentNavigator`.
`DefaultProgressFragment`	The default `androidx.fragment.app.Fragment` to display during installation progress.
`DetailsSupportFragment`	A fragment for creating Leanback details screens.
`DialogFragment`	A fragment that displays a dialog window, floating in the foreground of its activity's window.
`DynamicNavHostFragment`	The `NavHostFragment` for dynamic features.
`EditTextPreferenceDialogFragmentCompat`
`ErrorSupportFragment`	A fragment for displaying an error indication.
`FragmentActivity`	Base class for activities that want to use the support-based `Fragments`.
`GuidedStepSupportFragment`	A GuidedStepSupportFragment is used to guide the user through a decision or series of decisions.
`HeadersSupportFragment`	An fragment containing a list of row headers.
`LauncherActivity`	This class handles providing the right launcher activity when running native applications and Car App Library applications.
`LeanbackEditTextPreferenceDialogFragmentCompat`	Implemented a dialog to input text.
`LeanbackListPreferenceDialogFragmentCompat`	Implemented a dialog to show `ListPreference` or `MultiSelectListPreference`.
`LeanbackPreferenceDialogFragmentCompat`	A fragment that shows `DialogPreference`, for example or `androidx.preference.MultiSelectListPreference`.
`LeanbackPreferenceFragmentCompat`	This fragment provides a fully decorated leanback-style preference fragment, including a list background and header.
`LeanbackSettingsFragmentCompat`	This fragment provides a container for displaying a `LeanbackPreferenceFragmentCompat`
`ListFragment`	Static library support version of the framework's `android.app.ListFragment`.
`ListPreferenceDialogFragmentCompat`
`MediaRouteChooserDialogFragment`	Media route chooser dialog fragment.
`MediaRouteControllerDialogFragment`	Media route controller dialog fragment.
`MediaRouteDiscoveryFragment`	Media route discovery fragment.
`MultiSelectListPreferenceDialogFragmentCompat`
`NavHostFragment`	NavHostFragment provides an area within your layout for self-contained navigation to occur.
`OnboardingSupportFragment`	An OnboardingSupportFragment provides a common and simple way to build onboarding screen for applications.
`PdfViewerFragment`	A Fragment that renders a PDF document.
`PlaybackSupportFragment`	A fragment for displaying playback controls and related content.
`PreferenceDialogFragmentCompat`	Abstract base class which presents a dialog associated with a `DialogPreference`.
`PreferenceFragmentCompat`	A PreferenceFragmentCompat is the entry point to using the Preference library.
`PreferenceHeaderFragmentCompat`	`PreferenceHeaderFragmentCompat` implements a two-pane fragment for preferences.
`PreviewActivity`	Activity used to run `@Composable` previews from Android Studio.
`RowsSupportFragment`	An ordered set of rows of leanback widgets.
`SdkActivity`	Activity to start for SDKs running locally.
`SearchSupportFragment`	A fragment to handle searches.
`VerticalGridSupportFragment`	A fragment for creating leanback vertical grids.
`VideoSupportFragment`	Subclass of `PlaybackSupportFragment` that is responsible for providing a `SurfaceView` and rendering video.

A class that can call Activity.startActivityForResult-style APIs without having to manage request codes, and converting request/response to an Intent

Summary

Public functions
`ActivityResultLauncher<I>`	`<I : Any?, O : Any?> registerForActivityResult( contract: ActivityResultContract<I, O>, callback: ActivityResultCallback<O> )` Register a request to `start an activity for result`, designated by the given `contract`.
`ActivityResultLauncher<I>`	`<I : Any?, O : Any?> registerForActivityResult( contract: ActivityResultContract<I, O>, registry: ActivityResultRegistry, callback: ActivityResultCallback<O> )` Register a request to `start an activity for result`, designated by the given `contract`.

Extension functions
`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.

Public functions

registerForActivityResult

Added in 1.2.0

fun <I : Any?, O : Any?> registerForActivityResult(
    contract: ActivityResultContract<I, O>,
    callback: ActivityResultCallback<O>
): ActivityResultLauncher<I>

This creates a record in the registry associated with this caller, managing request code, as well as conversions to/from Intent under the hood.

This must be called unconditionally, as part of initialization path, typically as a field initializer of an Activity or Fragment.

Parameters
`<I : Any?>`	the type of the input(if any) required to call the activity
`<O : Any?>`	the type of output returned as an activity result
`contract: ActivityResultContract<I, O>`	the contract, specifying conversions to/from `Intent`s
`callback: ActivityResultCallback<O>`	the callback to be called on the main thread when activity result is available

Returns
`ActivityResultLauncher<I>`	the launcher that can be used to start the activity or dispose of the prepared call.

registerForActivityResult

Added in 1.2.0

fun <I : Any?, O : Any?> registerForActivityResult(
    contract: ActivityResultContract<I, O>,
    registry: ActivityResultRegistry,
    callback: ActivityResultCallback<O>
): ActivityResultLauncher<I>

This creates a record in the given registry, managing request code, as well as conversions to/from Intent under the hood.

This must be called unconditionally, as part of initialization path, typically as a field initializer of an Activity or Fragment.

Parameters
`<I : Any?>`	the type of the input(if any) required to call the activity
`<O : Any?>`	the type of output returned as an activity result
`contract: ActivityResultContract<I, O>`	the contract, specifying conversions to/from `Intent`s
`registry: ActivityResultRegistry`	the registry where to hold the record.
`callback: ActivityResultCallback<O>`	the callback to be called on the main thread when activity result is available

Returns
`ActivityResultLauncher<I>`	the launcher that can be used to start the activity or dispose of the prepared call.

Extension functions

registerForActivityResult

Artifact: androidx.activity:activity

View Source

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

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`