ComponentActivity

Added in 1.0.0

Kotlin |Java

open class ComponentActivity : Activity, LifecycleOwner, ContextAware, ViewModelStoreOwner, HasDefaultViewModelProviderFactory, SavedStateRegistryOwner, OnBackPressedDispatcherOwner, NavigationEventDispatcherOwner, ActivityResultRegistryOwner, ActivityResultCaller, OnConfigurationChangedProvider, OnTrimMemoryProvider, OnNewIntentProvider, OnMultiWindowModeChangedProvider, OnPictureInPictureModeChangedProvider, OnUserLeaveHintProvider, MenuHost, FullyDrawnReporterOwner

kotlin.Any
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.view.ContextThemeWrapper
			↳	android.app.Activity
				↳	androidx.activity.ComponentActivity

Known direct subclasses

FragmentActivity, PreviewActivity, SubspaceTestingActivity

`FragmentActivity`	Base class for activities that want to use the support-based `Fragments`.
`PreviewActivity`	Activity used to run `@Composable` previews from Android Studio.
`SubspaceTestingActivity`	Custom test class that should be used for testing `SubspaceComposable` content.

Known indirect subclasses

AppCompatActivity, BaseCarAppActivity, CarAppActivity, LauncherActivity

`AppCompatActivity`	Base class for activities that wish to use some of the newer platform features on older Android devices.
`BaseCarAppActivity`	Core logic for CarAppLibrary Activity interaction with a host.
`CarAppActivity`	The class representing a car app activity in the main display.
`LauncherActivity`	This class handles providing the right launcher activity when running native applications and Car App Library applications.

Base class for activities that enables composition of higher level components.

Rather than all functionality being built directly into this class, only the minimal set of lower level building blocks are included. Higher level components can then be used as needed without enforcing a deep Activity class hierarchy or strong coupling between components.

Summary

Public constructors
`ComponentActivity()`
`@ContentView ComponentActivity(contentLayoutId: @LayoutRes Int)` Alternate constructor that can be used to provide a default layout that will be inflated as part of `super.onCreate(savedInstanceState)`.

Public functions
`open Unit`	`addContentView(view: View?, params: ViewGroup.LayoutParams?)`
`open Unit`	`addMenuProvider(provider: MenuProvider)` Adds the given `MenuProvider` to this `MenuHost`.
`open Unit`	`addMenuProvider(provider: MenuProvider, owner: LifecycleOwner)` Adds the given `MenuProvider` to this `MenuHost`.
`open Unit`	`addMenuProvider( provider: MenuProvider, owner: LifecycleOwner, state: Lifecycle.State )` Adds the given `MenuProvider` to this `MenuHost` once the given `LifecycleOwner` reaches the given `Lifecycle.State`.
`final Unit`	`addOnConfigurationChangedListener(listener: Consumer<Configuration>)` Add a new listener that will get a callback associated with ComponentCallbacks.onConfigurationChanged with the new `Configuration`.
`final Unit`	`addOnContextAvailableListener(listener: OnContextAvailableListener)` {@inheritDoc}
`final Unit`	`addOnMultiWindowModeChangedListener( listener: Consumer<MultiWindowModeChangedInfo> )` Add a new listener that will get a callback associated with `Activity.onMultiWindowModeChanged` with the new `MultiWindowModeChangedInfo`.
`final Unit`	`addOnNewIntentListener(listener: Consumer<Intent>)` Add a new listener that will get a callback associated with `Activity.onNewIntent` with the new `Intent`.
`final Unit`	`addOnPictureInPictureModeChangedListener( listener: Consumer<PictureInPictureModeChangedInfo> )` Add a new listener that will get a callback associated with `Activity.onPictureInPictureModeChanged` with the new `PictureInPictureModeChangedInfo`.
`final Unit`	`addOnTrimMemoryListener(listener: Consumer<Int>)` Add a new listener that will get a callback associated with ComponentCallbacks2.onTrimMemory with the `int` representing the level of trimming.
`final Unit`	`addOnUserLeaveHintListener(listener: Runnable)` Add a new listener that will get a callback associated with `Activity.onUserLeaveHint`
`open Unit`	`@CallSuper initializeViewTreeOwners()` Sets the view tree owners before setting the content view so that the inflation process and attach listeners will see them already present.
`open Unit`	`invalidateMenu()` Invalidates the `android.view.Menu` to ensure that what is displayed matches the current internal state of the menu.
`open Unit`	`@MainThread @CallSuper onBackPressed()` This function is deprecated. This method has been deprecated in favor of using the {@link OnBackPressedDispatcher} via {@link #getOnBackPressedDispatcher()}.
`open Unit`	`@CallSuper onConfigurationChanged(newConfig: Configuration)` {@inheritDoc}
`open Boolean`	`onCreatePanelMenu(featureId: Int, menu: Menu)`
`open Boolean`	`onMenuItemSelected(featureId: Int, item: MenuItem)`
`open Unit`	`@CallSuper onMultiWindowModeChanged(isInMultiWindowMode: Boolean)` This function is deprecated. Deprecated in android.app.Activity
`open Unit`	`@RequiresApi(api = 26) @CallSuper onMultiWindowModeChanged( isInMultiWindowMode: Boolean, newConfig: Configuration )` {@inheritDoc}
`open Unit`	`onPanelClosed(featureId: Int, menu: Menu)`
`open Unit`	`@CallSuper onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean)` This function is deprecated. Deprecated in android.app.Activity
`open Unit`	`@RequiresApi(api = 26) @CallSuper onPictureInPictureModeChanged( isInPictureInPictureMode: Boolean, newConfig: Configuration )` {@inheritDoc}
`open Boolean`	`onPreparePanel(featureId: Int, view: View?, menu: Menu)`
`open Unit`	`@CallSuper onRequestPermissionsResult( requestCode: Int, permissions: Array<String>, grantResults: IntArray )` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`open Any?`	`onRetainCustomNonConfigurationInstance()` This function is deprecated. Use a {@link androidx.lifecycle.ViewModel} to store non config state.
`final Any?`	`onRetainNonConfigurationInstance()` Retain all appropriate non-config state.
`open Unit`	`@CallSuper onTrimMemory(level: Int)` {@inheritDoc}
`open Context?`	`peekAvailableContext()` Get the `Context` if it is currently available.
`final 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`.
`final 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`.
`open Unit`	`removeMenuProvider(provider: MenuProvider)` Removes the given `MenuProvider` from this `MenuHost`.
`final Unit`	`removeOnConfigurationChangedListener(listener: Consumer<Configuration>)` Remove a previously added listener.
`final Unit`	`removeOnContextAvailableListener(listener: OnContextAvailableListener)` Remove a `OnContextAvailableListener` previously added via `addOnContextAvailableListener`.
`final Unit`	`removeOnMultiWindowModeChangedListener( listener: Consumer<MultiWindowModeChangedInfo> )` Remove a previously added listener.
`final Unit`	`removeOnNewIntentListener(listener: Consumer<Intent>)` Remove a previously added listener.
`final Unit`	`removeOnPictureInPictureModeChangedListener( listener: Consumer<PictureInPictureModeChangedInfo> )` Remove a previously added listener.
`final Unit`	`removeOnTrimMemoryListener(listener: Consumer<Int>)` Remove a previously added listener.
`final Unit`	`removeOnUserLeaveHintListener(listener: Runnable)` Remove a previously added listener.
`open Unit`	`reportFullyDrawn()`
`open Unit`	`setContentView(layoutResID: @LayoutRes Int)`
`open Unit`	`setContentView(view: View?)`
`open Unit`	`setContentView(view: View?, params: ViewGroup.LayoutParams?)`
`open Unit`	`startActivityForResult(intent: Intent, requestCode: Int)` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`open Unit`	`startActivityForResult(intent: Intent, requestCode: Int, options: Bundle?)` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`open Unit`	`startIntentSenderForResult( intent: IntentSender, requestCode: Int, fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int )` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`open Unit`	`startIntentSenderForResult( intent: IntentSender, requestCode: Int, fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int, options: Bundle? )` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.

Protected functions
`open Unit`	`@CallSuper onActivityResult(requestCode: Int, resultCode: Int, data: Intent?)` This function is deprecated. This method has been deprecated in favor of using the Activity Result API which brings increased type safety via an {@link ActivityResultContract} and the prebuilt contracts for common intents available in {@link androidx.activity.result.contract.ActivityResultContracts}, provides hooks for testing, and allow receiving results in separate, testable classes independent from your activity.
`open Unit`	`onCreate(savedInstanceState: Bundle?)` {@inheritDoc}
`open Unit`	`@CallSuper onNewIntent(intent: Intent)` {@inheritDoc}
`open Unit`	`@CallSuper onSaveInstanceState(outState: Bundle)`
`open Unit`	`@CallSuper onUserLeaveHint()` {@inheritDoc}

Public properties
`final ActivityResultRegistry`	`activityResultRegistry` Get the `ActivityResultRegistry` associated with this activity.
`open CreationExtras`	`defaultViewModelCreationExtras`
`open ViewModelProvider.Factory`	`defaultViewModelProviderFactory`
`open FullyDrawnReporter`	`fullyDrawnReporter` Retrieve the `FullyDrawnReporter` that should handle the independent parts of the UI that separately report that they are fully drawn.
`open Any?`	`lastCustomNonConfigurationInstance`
`open Lifecycle`	`lifecycle` {@inheritDoc}
`open NavigationEventDispatcher`	`navigationEventDispatcher` Lazily provides a `NavigationEventDispatcher` for back navigation handling, including support for predictive back gestures introduced in Android 13 (API 33+).
`final OnBackPressedDispatcher`	`onBackPressedDispatcher` Retrieve the `OnBackPressedDispatcher` that will be triggered when `onBackPressed` is called.
`final SavedStateRegistry`	`savedStateRegistry`
`open ViewModelStore`	`viewModelStore`

Extension functions
`Unit`	`ComponentActivity.setSubspaceContent( content: @Composable @SubspaceComposable () -> Unit )` Composes the provided composable `content` into this activity's subspace.
`Unit`	`@VisibleForTesting ComponentActivity.setSubspaceContent( session: Session, content: @Composable @SubspaceComposable () -> Unit )` Composes the provided composable `content` into this activity's subspace.
`inline Lazy<VM>`	`@MainThread <VM : ViewModel> ComponentActivity.viewModels( noinline extrasProducer: (() -> CreationExtras)?, noinline factoryProducer: (() -> ViewModelProvider.Factory)? )` Returns a `Lazy` delegate to access the ComponentActivity's ViewModel, if `factoryProducer` is specified then `ViewModelProvider.Factory` returned by it will be used to create `ViewModel` first time.
`Unit`	`ComponentActivity.setContent( parent: CompositionContext?, content: @Composable () -> Unit )` Composes the given composable into the given activity.
`Unit`	`ComponentActivity.enableEdgeToEdge( statusBarStyle: SystemBarStyle, navigationBarStyle: SystemBarStyle )` Enables the edge-to-edge display for this `ComponentActivity`.

Inherited functions

From android.app.Activity

`open Unit`	`attachBaseContext(p0: Context)`
`open Unit`	`clearOverrideActivityTransition(p0: Int)`
`open Unit`	`closeContextMenu()`
`open Unit`	`closeOptionsMenu()`
`open PendingIntent`	`createPendingResult(p0: Int, p1: Intent, p2: Int)`
`Unit`	`dismissDialog(p0: Int)` This function is deprecated. Deprecated in Java
`Unit`	`dismissKeyboardShortcutsHelper()`
`open Boolean`	`dispatchGenericMotionEvent(p0: MotionEvent)`
`open Boolean`	`dispatchPopulateAccessibilityEvent(p0: AccessibilityEvent)`
`open Boolean`	`dispatchTouchEvent(p0: MotionEvent)`
`open Boolean`	`dispatchTrackballEvent(p0: MotionEvent)`
`open Unit`	`dump(p0: String, p1: FileDescriptor?, p2: PrintWriter, p3: Array<String>?)`
`open Unit`	`enterPictureInPictureMode()` This function is deprecated. Deprecated in Java
`open Boolean`	`enterPictureInPictureMode(p0: PictureInPictureParams)`
`open T`	`<T : View> findViewById(p0: Int)`
`open Unit`	`finish()`
`open Unit`	`finishActivity(p0: Int)`
`open Unit`	`finishActivityFromChild(p0: Activity, p1: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`finishAffinity()`
`open Unit`	`finishAfterTransition()`
`open Unit`	`finishAndRemoveTask()`
`open Unit`	`finishFromChild(p0: Activity)` This function is deprecated. Deprecated in Java
`open ActionBar?`	`getActionBar()`
`Application`	`getApplication()`
`open ComponentCaller?`	`getCaller()`
`open ComponentName?`	`getCallingActivity()`
`open String?`	`getCallingPackage()`
`open Int`	`getChangingConfigurations()`
`open ComponentName`	`getComponentName()`
`open Scene`	`getContentScene()`
`open TransitionManager`	`getContentTransitionManager()`
`open ComponentCaller`	`getCurrentCaller()`
`open View?`	`getCurrentFocus()`
`open FragmentManager`	`getFragmentManager()` This function is deprecated. Deprecated in Java
`open ComponentCaller`	`getInitialCaller()`
`open Intent`	`getIntent()`
`open Any?`	`getLastNonConfigurationInstance()`
`open String?`	`getLaunchedFromPackage()`
`open Int`	`getLaunchedFromUid()`
`open LayoutInflater`	`getLayoutInflater()`
`open LoaderManager`	`getLoaderManager()` This function is deprecated. Deprecated in Java
`open String`	`getLocalClassName()`
`open Int`	`getMaxNumPictureInPictureActions()`
`MediaController`	`getMediaController()`
`open MenuInflater`	`getMenuInflater()`
`open OnBackInvokedDispatcher`	`getOnBackInvokedDispatcher()`
`Activity`	`getParent()` This function is deprecated. Deprecated in Java
`open Intent?`	`getParentActivityIntent()`
`open SharedPreferences`	`getPreferences(p0: Int)`
`open Uri?`	`getReferrer()`
`open Int`	`getRequestedOrientation()`
`SearchEvent`	`getSearchEvent()`
`SplashScreen`	`getSplashScreen()`
`open Any`	`getSystemService(@RecentlyNonNull p0: String)`
`open Int`	`getTaskId()`
`CharSequence`	`getTitle()`
`Int`	`getTitleColor()`
`open VoiceInteractor`	`getVoiceInteractor()`
`Int`	`getVolumeControlStream()`
`open Window`	`getWindow()`
`open WindowManager`	`getWindowManager()`
`open Boolean`	`hasWindowFocus()`
`open Unit`	`invalidateOptionsMenu()`
`open Boolean`	`isActivityTransitionRunning()`
`open Boolean`	`isChangingConfigurations()`
`Boolean`	`isChild()` This function is deprecated. Deprecated in Java
`open Boolean`	`isDestroyed()`
`open Boolean`	`isFinishing()`
`open Boolean`	`isImmersive()`
`open Boolean`	`isInMultiWindowMode()`
`open Boolean`	`isInPictureInPictureMode()`
`open Boolean`	`isLaunchedFromBubble()`
`open Boolean`	`isLocalVoiceInteractionSupported()`
`open Boolean`	`isTaskRoot()`
`open Boolean`	`isVoiceInteraction()`
`open Boolean`	`isVoiceInteractionRoot()`
`Cursor`	`managedQuery( p0: Uri, p1: Array<String>, p2: String, p3: Array<String>, p4: String )` This function is deprecated. Deprecated in Java
`open Boolean`	`moveTaskToBack(p0: Boolean)`
`open Boolean`	`navigateUpTo(p0: Intent)`
`open Boolean`	`navigateUpToFromChild(p0: Activity, p1: Intent)` This function is deprecated. Deprecated in Java
`open Unit`	`onActionModeFinished(p0: ActionMode)`
`open Unit`	`onActionModeStarted(p0: ActionMode)`
`open Unit`	`onActivityReenter(p0: Int, p1: Intent)`
`open Unit`	`onActivityResult(p0: Int, p1: Int, p2: Intent?, p3: ComponentCaller)`
`open Unit`	`onApplyThemeResource(p0: Resources.Theme, p1: Int, p2: Boolean)`
`open Unit`	`onAttachFragment(p0: Fragment)` This function is deprecated. Deprecated in Java
`open Unit`	`onAttachedToWindow()`
`open Unit`	`onChildTitleChanged(p0: Activity, p1: CharSequence)`
`open Unit`	`onContentChanged()`
`open Boolean`	`onContextItemSelected(p0: MenuItem)`
`open Unit`	`onContextMenuClosed(p0: Menu)`
`open Unit`	`onCreate(p0: Bundle?, p1: PersistableBundle?)`
`open Unit`	`onCreateContextMenu( p0: ContextMenu, p1: View, p2: ContextMenu.ContextMenuInfo )`
`open CharSequence?`	`onCreateDescription()`
`open Dialog`	`onCreateDialog(p0: Int)` This function is deprecated. Deprecated in Java
`open Dialog?`	`onCreateDialog(p0: Int, p1: Bundle)` This function is deprecated. Deprecated in Java
`open Unit`	`onCreateNavigateUpTaskStack(p0: TaskStackBuilder)`
`open Boolean`	`onCreateOptionsMenu(p0: Menu)`
`open View?`	`onCreatePanelView(p0: Int)`
`open Boolean`	`onCreateThumbnail(p0: Bitmap, p1: Canvas)` This function is deprecated. Deprecated in Java
`open View?`	`onCreateView(p0: String, p1: Context, p2: AttributeSet)`
`open View?`	`onCreateView(p0: View?, p1: String, p2: Context, p3: AttributeSet)`
`open Unit`	`onDestroy()`
`open Unit`	`onDetachedFromWindow()`
`open Unit`	`onEnterAnimationComplete()`
`open Boolean`	`onGenericMotionEvent(p0: MotionEvent)`
`open Unit`	`onGetDirectActions( p0: CancellationSignal, p1: Consumer<MutableList<DirectAction>> )`
`open Boolean`	`onKeyDown(p0: Int, p1: KeyEvent)`
`open Boolean`	`onKeyLongPress(p0: Int, p1: KeyEvent)`
`open Boolean`	`onKeyMultiple(p0: Int, p1: Int, p2: KeyEvent)`
`open Boolean`	`onKeyShortcut(p0: Int, p1: KeyEvent)`
`open Boolean`	`onKeyUp(p0: Int, p1: KeyEvent)`
`open Unit`	`onLocalVoiceInteractionStarted()`
`open Unit`	`onLocalVoiceInteractionStopped()`
`open Unit`	`onLowMemory()` This function is deprecated.
`open Boolean`	`onMenuOpened(p0: Int, p1: Menu)`
`open Boolean`	`onNavigateUp()`
`open Boolean`	`onNavigateUpFromChild(p0: Activity)` This function is deprecated. Deprecated in Java
`open Unit`	`onNewIntent(p0: Intent, p1: ComponentCaller)`
`open Boolean`	`onOptionsItemSelected(p0: MenuItem)`
`open Unit`	`onOptionsMenuClosed(p0: Menu)`
`open Unit`	`onPause()`
`open Unit`	`onPerformDirectAction( p0: String, p1: Bundle, p2: CancellationSignal, p3: Consumer<Bundle> )`
`open Boolean`	`onPictureInPictureRequested()`
`open Unit`	`onPictureInPictureUiStateChanged(p0: PictureInPictureUiState)`
`open Unit`	`onPostCreate(p0: Bundle?)`
`open Unit`	`onPostCreate(p0: Bundle?, p1: PersistableBundle?)`
`open Unit`	`onPostResume()`
`open Unit`	`onPrepareDialog(p0: Int, p1: Dialog)` This function is deprecated. Deprecated in Java
`open Unit`	`onPrepareDialog(p0: Int, p1: Dialog, p2: Bundle)` This function is deprecated. Deprecated in Java
`open Unit`	`onPrepareNavigateUpTaskStack(p0: TaskStackBuilder)`
`open Boolean`	`onPrepareOptionsMenu(p0: Menu)`
`open Unit`	`onProvideAssistContent(p0: AssistContent)`
`open Unit`	`onProvideAssistData(p0: Bundle)`
`open Unit`	`onProvideKeyboardShortcuts( p0: MutableList<KeyboardShortcutGroup>, p1: Menu?, p2: Int )`
`open Uri`	`onProvideReferrer()`
`open Unit`	`onRequestPermissionsResult(p0: Int, p1: Array<String>, p2: IntArray, p3: Int)`
`open Unit`	`onRestart()`
`open Unit`	`onRestoreInstanceState(p0: Bundle)`
`open Unit`	`onRestoreInstanceState(p0: Bundle?, p1: PersistableBundle?)`
`open Unit`	`onResume()`
`open Unit`	`onSaveInstanceState(p0: Bundle, p1: PersistableBundle)`
`open Boolean`	`onSearchRequested()`
`open Boolean`	`onSearchRequested(p0: SearchEvent?)`
`open Unit`	`onStart()`
`open Unit`	`onStateNotSaved()` This function is deprecated. Deprecated in Java
`open Unit`	`onStop()`
`open Unit`	`onTitleChanged(p0: CharSequence, p1: Int)`
`open Unit`	`onTopResumedActivityChanged(p0: Boolean)`
`open Boolean`	`onTouchEvent(p0: MotionEvent)`
`open Boolean`	`onTrackballEvent(p0: MotionEvent)`
`open Unit`	`onUserInteraction()`
`open Unit`	`onVisibleBehindCanceled()` This function is deprecated. Deprecated in Java
`open Unit`	`onWindowAttributesChanged(p0: WindowManager.LayoutParams)`
`open Unit`	`onWindowFocusChanged(p0: Boolean)`
`open ActionMode?`	`onWindowStartingActionMode(p0: ActionMode.Callback)`
`open ActionMode?`	`onWindowStartingActionMode(p0: ActionMode.Callback, p1: Int)`
`open Unit`	`openContextMenu(p0: View)`
`open Unit`	`openOptionsMenu()`
`open Unit`	`overrideActivityTransition(p0: Int, p1: Int, p2: Int)`
`open Unit`	`overrideActivityTransition(p0: Int, p1: Int, p2: Int, p3: Int)`
`open Unit`	`overridePendingTransition(p0: Int, p1: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`overridePendingTransition(p0: Int, p1: Int, p2: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`postponeEnterTransition()`
`open Unit`	`recreate()`
`open Unit`	`registerActivityLifecycleCallbacks( p0: Application.ActivityLifecycleCallbacks )`
`open Unit`	`registerComponentCallbacks(p0: ComponentCallbacks)`
`open Unit`	`registerForContextMenu(p0: View)`
`open Unit`	`registerScreenCaptureCallback( p0: Executor, p1: Activity.ScreenCaptureCallback )`
`open Boolean`	`releaseInstance()`
`Unit`	`removeDialog(p0: Int)` This function is deprecated. Deprecated in Java
`open DragAndDropPermissions`	`requestDragAndDropPermissions(p0: DragEvent)`
`open Unit`	`requestFullscreenMode(p0: Int, p1: OutcomeReceiver<Void, Throwable>?)`
`Unit`	`requestOpenInBrowserEducation()`
`Unit`	`requestPermissions(p0: Array<String>, p1: Int)`
`Unit`	`requestPermissions(p0: Array<String>, p1: Int, p2: Int)`
`Unit`	`requestShowKeyboardShortcuts()`
`open Boolean`	`requestVisibleBehind(p0: Boolean)` This function is deprecated. Deprecated in Java
`Boolean`	`requestWindowFeature(p0: Int)`
`T`	`<T : View> requireViewById(p0: Int)`
`Unit`	`runOnUiThread(p0: Runnable)`
`open Unit`	`setActionBar(p0: Toolbar?)`
`open Unit`	`setAllowCrossUidActivitySwitchFromBelow(p0: Boolean)`
`open Unit`	`setContentTransitionManager(p0: TransitionManager)`
`Unit`	`setDefaultKeyMode(p0: Int)`
`open Unit`	`setEnterSharedElementCallback(p0: SharedElementCallback)`
`open Unit`	`setExitSharedElementCallback(p0: SharedElementCallback)`
`Unit`	`setFeatureDrawable(p0: Int, p1: Drawable)`
`Unit`	`setFeatureDrawableAlpha(p0: Int, p1: Int)`
`Unit`	`setFeatureDrawableResource(p0: Int, p1: Int)`
`Unit`	`setFeatureDrawableUri(p0: Int, p1: Uri)`
`open Unit`	`setFinishOnTouchOutside(p0: Boolean)`
`open Unit`	`setImmersive(p0: Boolean)`
`open Unit`	`setInheritShowWhenLocked(p0: Boolean)`
`open Unit`	`setIntent(p0: Intent)`
`open Unit`	`setIntent(p0: Intent?, p1: ComponentCaller?)`
`open Unit`	`setLocusContext(p0: LocusId?, p1: Bundle?)`
`Unit`	`setMediaController(p0: MediaController)`
`open Unit`	`setPictureInPictureParams(p0: PictureInPictureParams)`
`Unit`	`setProgress(p0: Int)` This function is deprecated. Deprecated in Java
`Unit`	`setProgressBarIndeterminate(p0: Boolean)` This function is deprecated. Deprecated in Java
`Unit`	`setProgressBarIndeterminateVisibility(p0: Boolean)` This function is deprecated. Deprecated in Java
`Unit`	`setProgressBarVisibility(p0: Boolean)` This function is deprecated. Deprecated in Java
`open Unit`	`setRecentsScreenshotEnabled(p0: Boolean)`
`open Unit`	`setRequestedOrientation(p0: Int)`
`Unit`	`setResult(p0: Int)`
`Unit`	`setResult(p0: Int, p1: Intent)`
`Unit`	`setSecondaryProgress(p0: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`setShouldDockBigOverlays(p0: Boolean)`
`open Unit`	`setShowWhenLocked(p0: Boolean)`
`open Unit`	`setTaskDescription(p0: ActivityManager.TaskDescription)`
`open Unit`	`setTheme(p0: Int)`
`open Unit`	`setTitle(p0: CharSequence)`
`open Unit`	`setTitle(p0: Int)`
`open Unit`	`setTitleColor(p0: Int)` This function is deprecated. Deprecated in Java
`open Boolean`	`setTranslucent(p0: Boolean)`
`open Unit`	`setTurnScreenOn(p0: Boolean)`
`open Unit`	`setVisible(p0: Boolean)`
`Unit`	`setVolumeControlStream(p0: Int)`
`open Unit`	`setVrModeEnabled(p0: Boolean, p1: ComponentName)`
`open Boolean`	`shouldDockBigOverlays()`
`open Boolean`	`shouldShowRequestPermissionRationale(p0: String)`
`open Boolean`	`shouldShowRequestPermissionRationale(p0: String, p1: Int)`
`open Boolean`	`shouldUpRecreateTask(p0: Intent)`
`open Boolean`	`showAssist(p0: Bundle)`
`Unit`	`showDialog(p0: Int)` This function is deprecated. Deprecated in Java
`Boolean`	`showDialog(p0: Int, p1: Bundle)` This function is deprecated. Deprecated in Java
`open Unit`	`showLockTaskEscapeMessage()`
`open ActionMode?`	`startActionMode(p0: ActionMode.Callback)`
`open ActionMode?`	`startActionMode(p0: ActionMode.Callback, p1: Int)`
`open Unit`	`startActivities(p0: Array<Intent>)`
`open Unit`	`startActivities(p0: Array<Intent>, p1: Bundle?)`
`open Unit`	`startActivity(p0: Intent)`
`open Unit`	`startActivity(p0: Intent, p1: Bundle?)`
`open Unit`	`startActivityFromChild(p0: Activity, p1: Intent, p2: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`startActivityFromChild(p0: Activity, p1: Intent, p2: Int, p3: Bundle?)` This function is deprecated. Deprecated in Java
`open Unit`	`startActivityFromFragment(p0: Fragment, p1: Intent, p2: Int)` This function is deprecated. Deprecated in Java
`open Unit`	`startActivityFromFragment(p0: Fragment, p1: Intent, p2: Int, p3: Bundle?)` This function is deprecated. Deprecated in Java
`open Boolean`	`startActivityIfNeeded(p0: Intent, p1: Int)`
`open Boolean`	`startActivityIfNeeded(p0: Intent, p1: Int, p2: Bundle?)`
`open Unit`	`startIntentSender(p0: IntentSender, p1: Intent?, p2: Int, p3: Int, p4: Int)`
`open Unit`	`startIntentSender( p0: IntentSender, p1: Intent?, p2: Int, p3: Int, p4: Int, p5: Bundle? )`
`open Unit`	`startIntentSenderFromChild( p0: Activity, p1: IntentSender, p2: Int, p3: Intent, p4: Int, p5: Int, p6: Int )` This function is deprecated. Deprecated in Java
`open Unit`	`startIntentSenderFromChild( p0: Activity, p1: IntentSender, p2: Int, p3: Intent, p4: Int, p5: Int, p6: Int, p7: Bundle? )` This function is deprecated. Deprecated in Java
`open Unit`	`startLocalVoiceInteraction(p0: Bundle)`
`open Unit`	`startLockTask()`
`open Unit`	`startManagingCursor(p0: Cursor)` This function is deprecated. Deprecated in Java
`open Boolean`	`startNextMatchingActivity(p0: Intent)`
`open Boolean`	`startNextMatchingActivity(p0: Intent, p1: Bundle?)`
`open Unit`	`startPostponedEnterTransition()`
`open Unit`	`startSearch(p0: String?, p1: Boolean, p2: Bundle?, p3: Boolean)`
`open Unit`	`stopLocalVoiceInteraction()`
`open Unit`	`stopLockTask()`
`open Unit`	`stopManagingCursor(p0: Cursor)` This function is deprecated. Deprecated in Java
`open Unit`	`takeKeyEvents(p0: Boolean)`
`open Unit`	`triggerSearch(p0: String, p1: Bundle?)`
`open Unit`	`unregisterActivityLifecycleCallbacks( p0: Application.ActivityLifecycleCallbacks )`
`open Unit`	`unregisterComponentCallbacks(p0: ComponentCallbacks)`
`open Unit`	`unregisterForContextMenu(p0: View)`
`open Unit`	`unregisterScreenCaptureCallback(p0: Activity.ScreenCaptureCallback)`

From android.content.Context

`open Boolean`	`bindIsolatedService( p0: Intent, p1: Context.BindServiceFlags, p2: String, p3: Executor, p4: ServiceConnection )`
`Int`	`getColor(p0: Int)`
`ColorStateList`	`getColorStateList(p0: Int)`
`Drawable?`	`getDrawable(p0: Int)`
`String`	`getString(p0: Int)`
`String`	`getString(p0: Int, vararg p1: Any)`
`T`	`<T : Any> getSystemService(p0: Class<T>)`
`CharSequence`	`getText(p0: Int)`
`TypedArray`	`obtainStyledAttributes(p0: IntArray)`
`TypedArray`	`obtainStyledAttributes(p0: AttributeSet?, p1: IntArray)`
`TypedArray`	`obtainStyledAttributes(p0: Int, p1: IntArray)`
`TypedArray`	`obtainStyledAttributes(p0: AttributeSet?, p1: IntArray, p2: Int, p3: Int)`
`open Unit`	`revokeSelfPermissionOnKill(p0: String)`
`open Unit`	`sendBroadcastWithMultiplePermissions(p0: Intent, p1: Array<String>)`

From android.view.ContextThemeWrapper

`open Unit`	`applyOverrideConfiguration(p0: Configuration)`
`open AssetManager`	`getAssets()`
`open Resources`	`getResources()`
`open Resources.Theme`	`getTheme()`
`open Unit`	`setTheme(p0: Resources.Theme?)`

From android.content.ContextWrapper

`open Boolean`	`bindIsolatedService( p0: Intent, p1: Int, p2: String, p3: Executor, p4: ServiceConnection )`
`open Boolean`	`bindService( p0: Intent, p1: ServiceConnection, p2: Context.BindServiceFlags )`
`open Boolean`	`bindService(p0: Intent, p1: ServiceConnection, p2: Int)`
`open Boolean`	`bindService( p0: Intent, p1: Context.BindServiceFlags, p2: Executor, p3: ServiceConnection )`
`open Boolean`	`bindService(p0: Intent, p1: Int, p2: Executor, p3: ServiceConnection)`
`open Boolean`	`bindServiceAsUser( p0: Intent, p1: ServiceConnection, p2: Context.BindServiceFlags, p3: UserHandle )`
`open Boolean`	`bindServiceAsUser(p0: Intent, p1: ServiceConnection, p2: Int, p3: UserHandle)`
`open Int`	`checkCallingOrSelfPermission(p0: String)`
`open Int`	`checkCallingOrSelfUriPermission(p0: Uri, p1: Int)`
`open IntArray`	`checkCallingOrSelfUriPermissions(p0: MutableList<Uri>, p1: Int)`
`open Int`	`checkCallingPermission(p0: String)`
`open Int`	`checkCallingUriPermission(p0: Uri, p1: Int)`
`open IntArray`	`checkCallingUriPermissions(p0: MutableList<Uri>, p1: Int)`
`open Int`	`checkContentUriPermissionFull(p0: Uri, p1: Int, p2: Int, p3: Int)`
`open Int`	`checkPermission(p0: String, p1: Int, p2: Int)`
`open Int`	`checkSelfPermission(p0: String)`
`open Int`	`checkUriPermission(p0: Uri, p1: Int, p2: Int, p3: Int)`
`open Int`	`checkUriPermission(p0: Uri?, p1: String?, p2: String?, p3: Int, p4: Int, p5: Int)`
`open IntArray`	`checkUriPermissions(p0: MutableList<Uri>, p1: Int, p2: Int, p3: Int)`
`open Unit`	`clearWallpaper()` This function is deprecated. Deprecated in Java
`open Context`	`createAttributionContext(p0: String?)`
`open Context`	`createConfigurationContext(p0: Configuration)`
`open Context`	`createContext(p0: ContextParams)`
`open Context`	`createContextForSplit(p0: String)`
`open Context`	`createDeviceContext(p0: Int)`
`open Context`	`createDeviceProtectedStorageContext()`
`open Context`	`createDisplayContext(p0: Display)`
`open Context`	`createPackageContext(p0: String, p1: Int)`
`open Context`	`createWindowContext(p0: Int, p1: Bundle?)`
`open Context`	`createWindowContext(p0: Display, p1: Int, p2: Bundle?)`
`open Array<String>`	`databaseList()`
`open Boolean`	`deleteDatabase(p0: String)`
`open Boolean`	`deleteFile(p0: String)`
`open Boolean`	`deleteSharedPreferences(p0: String)`
`open Unit`	`enforceCallingOrSelfPermission(p0: String, p1: String?)`
`open Unit`	`enforceCallingOrSelfUriPermission(p0: Uri, p1: Int, p2: String)`
`open Unit`	`enforceCallingPermission(p0: String, p1: String?)`
`open Unit`	`enforceCallingUriPermission(p0: Uri, p1: Int, p2: String)`
`open Unit`	`enforcePermission(p0: String, p1: Int, p2: Int, p3: String?)`
`open Unit`	`enforceUriPermission(p0: Uri, p1: Int, p2: Int, p3: Int, p4: String)`
`open Unit`	`enforceUriPermission( p0: Uri?, p1: String?, p2: String?, p3: Int, p4: Int, p5: Int, p6: String? )`
`open Array<String>`	`fileList()`
`open Context`	`getApplicationContext()`
`open ApplicationInfo`	`getApplicationInfo()`
`open AttributionSource`	`getAttributionSource()`
`open String?`	`getAttributionTag()`
`open Context`	`getBaseContext()`
`open File`	`getCacheDir()`
`open ClassLoader`	`getClassLoader()`
`open File`	`getCodeCacheDir()`
`open ContentResolver`	`getContentResolver()`
`open File`	`getDataDir()`
`open File`	`getDatabasePath(p0: String)`
`open Int`	`getDeviceId()`
`open File`	`getDir(p0: String, p1: Int)`
`open Display?`	`getDisplay()`
`open File?`	`getExternalCacheDir()`
`open Array<File>`	`getExternalCacheDirs()`
`open File?`	`getExternalFilesDir(p0: String?)`
`open Array<File>`	`getExternalFilesDirs(p0: String)`
`open Array<File>`	`getExternalMediaDirs()`
`open File`	`getFileStreamPath(p0: String)`
`open File`	`getFilesDir()`
`open Executor`	`getMainExecutor()`
`open Looper`	`getMainLooper()`
`open File`	`getNoBackupFilesDir()`
`open File`	`getObbDir()`
`open Array<File>`	`getObbDirs()`
`open String`	`getOpPackageName()`
`open String`	`getPackageCodePath()`
`open PackageManager`	`getPackageManager()`
`open String`	`getPackageName()`
`open String`	`getPackageResourcePath()`
`open ContextParams?`	`getParams()`
`open SharedPreferences`	`getSharedPreferences(p0: String, p1: Int)`
`open String?`	`getSystemServiceName(p0: Class<*>)`
`open Drawable`	`getWallpaper()` This function is deprecated. Deprecated in Java
`open Int`	`getWallpaperDesiredMinimumHeight()` This function is deprecated. Deprecated in Java
`open Int`	`getWallpaperDesiredMinimumWidth()` This function is deprecated. Deprecated in Java
`open Unit`	`grantUriPermission(p0: String, p1: Uri, p2: Int)`
`open Boolean`	`isDeviceProtectedStorage()`
`open Boolean`	`isRestricted()`
`open Boolean`	`isUiContext()`
`open Boolean`	`moveDatabaseFrom(p0: Context, p1: String)`
`open Boolean`	`moveSharedPreferencesFrom(p0: Context, p1: String)`
`open FileInputStream`	`openFileInput(p0: String)`
`open FileOutputStream`	`openFileOutput(p0: String, p1: Int)`
`open SQLiteDatabase`	`openOrCreateDatabase(p0: String, p1: Int, p2: SQLiteDatabase.CursorFactory)`
`open SQLiteDatabase`	`openOrCreateDatabase( p0: String, p1: Int, p2: SQLiteDatabase.CursorFactory, p3: DatabaseErrorHandler? )`
`open Drawable`	`peekWallpaper()` This function is deprecated. Deprecated in Java
`open Unit`	`registerDeviceIdChangeListener(p0: Executor, p1: IntConsumer)`
`open Intent?`	`registerReceiver(p0: BroadcastReceiver?, p1: IntentFilter)`
`open Intent?`	`registerReceiver(p0: BroadcastReceiver?, p1: IntentFilter, p2: Int)`
`open Intent?`	`registerReceiver( p0: BroadcastReceiver?, p1: IntentFilter, p2: String?, p3: Handler? )`
`open Intent?`	`registerReceiver( p0: BroadcastReceiver?, p1: IntentFilter, p2: String?, p3: Handler?, p4: Int )`
`open Unit`	`removeStickyBroadcast(p0: Intent)` This function is deprecated. Deprecated in Java
`open Unit`	`removeStickyBroadcastAsUser(p0: Intent, p1: UserHandle)` This function is deprecated. Deprecated in Java
`open Unit`	`revokeSelfPermissionsOnKill(p0: MutableCollection<String>)`
`open Unit`	`revokeUriPermission(p0: Uri, p1: Int)`
`open Unit`	`revokeUriPermission(p0: String, p1: Uri, p2: Int)`
`open Unit`	`sendBroadcast(p0: Intent)`
`open Unit`	`sendBroadcast(p0: Intent, p1: String?)`
`open Unit`	`sendBroadcast(p0: Intent, p1: String?, p2: Bundle?)`
`open Unit`	`sendBroadcastAsUser(p0: Intent, p1: UserHandle)`
`open Unit`	`sendBroadcastAsUser(p0: Intent, p1: UserHandle, p2: String?)`
`open Unit`	`sendOrderedBroadcast(p0: Intent, p1: String?)`
`open Unit`	`sendOrderedBroadcast(p0: Intent, p1: String?, p2: Bundle?)`
`open Unit`	`sendOrderedBroadcast( p0: Intent, p1: String?, p2: BroadcastReceiver?, p3: Handler?, p4: Int, p5: String?, p6: Bundle? )`
`open Unit`	`sendOrderedBroadcast( p0: Intent, p1: String?, p2: Bundle?, p3: BroadcastReceiver?, p4: Handler?, p5: Int, p6: String?, p7: Bundle? )`
`open Unit`	`sendOrderedBroadcast( p0: Intent, p1: String?, p2: String?, p3: BroadcastReceiver?, p4: Handler?, p5: Int, p6: String?, p7: Bundle? )`
`open Unit`	`sendOrderedBroadcast( p0: Intent, p1: Int, p2: String?, p3: String?, p4: BroadcastReceiver?, p5: Handler?, p6: String?, p7: Bundle?, p8: Bundle? )`
`open Unit`	`sendOrderedBroadcastAsUser( p0: Intent, p1: UserHandle, p2: String?, p3: BroadcastReceiver?, p4: Handler?, p5: Int, p6: String?, p7: Bundle? )`
`open Unit`	`sendStickyBroadcast(p0: Intent)` This function is deprecated. Deprecated in Java
`open Unit`	`sendStickyBroadcast(p0: Intent, p1: Bundle?)` This function is deprecated. Deprecated in Java
`open Unit`	`sendStickyBroadcastAsUser(p0: Intent, p1: UserHandle)` This function is deprecated. Deprecated in Java
`open Unit`	`sendStickyOrderedBroadcast( p0: Intent, p1: BroadcastReceiver?, p2: Handler?, p3: Int, p4: String?, p5: Bundle? )` This function is deprecated. Deprecated in Java
`open Unit`	`sendStickyOrderedBroadcastAsUser( p0: Intent, p1: UserHandle, p2: BroadcastReceiver?, p3: Handler?, p4: Int, p5: String?, p6: Bundle? )` This function is deprecated. Deprecated in Java
`open Unit`	`setWallpaper(p0: Bitmap)` This function is deprecated. Deprecated in Java
`open Unit`	`setWallpaper(p0: InputStream)` This function is deprecated. Deprecated in Java
`open ComponentName?`	`startForegroundService(p0: Intent)`
`open Boolean`	`startInstrumentation(p0: ComponentName, p1: String?, p2: Bundle?)`
`open ComponentName?`	`startService(p0: Intent)`
`open Boolean`	`stopService(p0: Intent)`
`open Unit`	`unbindService(p0: ServiceConnection)`
`open Unit`	`unregisterDeviceIdChangeListener(p0: IntConsumer)`
`open Unit`	`unregisterReceiver(p0: BroadcastReceiver)`
`open Unit`	`updateServiceGroup(p0: ServiceConnection, p1: Int, p2: Int)`

From android.view.Window.Callback

open Unit

onPointerCaptureChanged(p0: Boolean)

Public constructors

ComponentActivity

Added in 1.0.0

ComponentActivity()

ComponentActivity

Added in 1.0.0

@ContentView
ComponentActivity(contentLayoutId: @LayoutRes Int)

Alternate constructor that can be used to provide a default layout that will be inflated as part of super.onCreate(savedInstanceState).

This should generally be called from your constructor that takes no parameters, as is required for API 27 and lower or when using the default android.app.AppComponentFactory.

Public functions

addContentView

open fun addContentView(view: View?, params: ViewGroup.LayoutParams?): Unit

addMenuProvider

Added in 1.4.0

open fun addMenuProvider(provider: MenuProvider): Unit

Adds the given MenuProvider to this MenuHost. If using this method, you must manually remove the provider when necessary.

Parameters
`provider: MenuProvider`	the MenuProvider to be added

See also
`removeMenuProvider`

addMenuProvider

Added in 1.4.0

open fun addMenuProvider(provider: MenuProvider, owner: LifecycleOwner): Unit

Adds the given MenuProvider to this MenuHost. This MenuProvider will be removed once the given LifecycleOwner receives an Lifecycle.Event.ON_DESTROY event.

Parameters
`provider: MenuProvider`	the MenuProvider to be added
`owner: LifecycleOwner`	the Lifecycle owner whose state will determine the removal of the provider

addMenuProvider

Added in 1.4.0

open fun addMenuProvider(
    provider: MenuProvider,
    owner: LifecycleOwner,
    state: Lifecycle.State
): Unit

Adds the given MenuProvider to this MenuHost once the given LifecycleOwner reaches the given Lifecycle.State. This MenuProvider will be removed once the given LifecycleOwner goes down from the given Lifecycle.State.

Parameters
`provider: MenuProvider`	the MenuProvider to be added
`owner: LifecycleOwner`	the Lifecycle owner whose state will be used for automated addition/removal
`state: Lifecycle.State`	the Lifecycle.State to check for automated addition/removal

addOnConfigurationChangedListener

Added in 1.5.0

final fun addOnConfigurationChangedListener(listener: Consumer<Configuration>): Unit

Add a new listener that will get a callback associated with ComponentCallbacks.onConfigurationChanged with the new Configuration.

Parameters
`listener: Consumer<Configuration>`	The listener that should be called whenever {ComponentCallbacks.onConfigurationChanged was called.

addOnContextAvailableListener

final fun addOnContextAvailableListener(listener: OnContextAvailableListener): Unit

{@inheritDoc}

Any listener added here will receive a callback as part of super.onCreate(), but importantly before any other logic is done (including calling through to the framework Activity.onCreate with the exception of restoring the state of the savedStateRegistry for use in your listener.

addOnMultiWindowModeChangedListener

Added in 1.5.0

final fun addOnMultiWindowModeChangedListener(
    listener: Consumer<MultiWindowModeChangedInfo>
): Unit

Add a new listener that will get a callback associated with Activity.onMultiWindowModeChanged with the new MultiWindowModeChangedInfo.

Parameters
`listener: Consumer<MultiWindowModeChangedInfo>`	The listener that should be called whenever Activity#onMultiWindowModeChanged was called.

addOnNewIntentListener

Added in 1.5.0

final fun addOnNewIntentListener(listener: Consumer<Intent>): Unit

Add a new listener that will get a callback associated with Activity.onNewIntent with the new Intent.

Parameters
`listener: Consumer<Intent>`	The listener that should be called whenever android.app.Activity#onNewIntent was called.

addOnPictureInPictureModeChangedListener

Added in 1.5.0

final fun addOnPictureInPictureModeChangedListener(
    listener: Consumer<PictureInPictureModeChangedInfo>
): Unit

Add a new listener that will get a callback associated with Activity.onPictureInPictureModeChanged with the new PictureInPictureModeChangedInfo.

Parameters
`listener: Consumer<PictureInPictureModeChangedInfo>`	The listener that should be called whenever `Activity.onPictureInPictureModeChanged` was called.

addOnTrimMemoryListener

Added in 1.5.0

final fun addOnTrimMemoryListener(listener: Consumer<Int>): Unit

Add a new listener that will get a callback associated with ComponentCallbacks2.onTrimMemory with the int representing the level of trimming.

Parameters
`listener: Consumer<Int>`	The listener that should be called whenever ComponentCallbacks2.onTrimMemory was called.

addOnUserLeaveHintListener

Added in 1.9.0

final fun addOnUserLeaveHintListener(listener: Runnable): Unit

Add a new listener that will get a callback associated with Activity.onUserLeaveHint

Parameters
`listener: Runnable`	The listener that should be called whenever `Activity.onUserLeaveHint` was called.

initializeViewTreeOwners

Added in 1.8.0

@CallSuper
open fun initializeViewTreeOwners(): Unit

Sets the view tree owners before setting the content view so that the inflation process and attach listeners will see them already present.

invalidateMenu

Added in 1.4.0

open fun invalidateMenu(): Unit

Invalidates the android.view.Menu to ensure that what is displayed matches the current internal state of the menu. This should be called whenever the state of the menu is changed, such as items being removed or disabled based on some user event.

onBackPressed

Added in 1.6.0

@MainThread
@CallSuper
open fun onBackPressed(): Unit

Called when the activity has detected the user's press of the back key. The onBackPressedDispatcher will be given a chance to handle the back button before the default behavior of android.app.Activity.onBackPressed is invoked.

See also
`onBackPressedDispatcher`

onConfigurationChanged

@CallSuper
open fun onConfigurationChanged(newConfig: Configuration): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnConfigurationChangedListener.

open fun onCreatePanelMenu(featureId: Int, menu: Menu): Boolean

onMenuItemSelected

open fun onMenuItemSelected(featureId: Int, item: MenuItem): Boolean

onMultiWindowModeChanged

Added in 1.5.0

@CallSuper
open fun onMultiWindowModeChanged(isInMultiWindowMode: Boolean): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnMultiWindowModeChangedListener.

onMultiWindowModeChanged

@RequiresApi(api = 26)
@CallSuper
open fun onMultiWindowModeChanged(
    isInMultiWindowMode: Boolean,
    newConfig: Configuration
): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnMultiWindowModeChangedListener.

open fun onPanelClosed(featureId: Int, menu: Menu): Unit

onPictureInPictureModeChanged

Added in 1.5.0

@CallSuper
open fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnPictureInPictureModeChangedListener.

onPictureInPictureModeChanged

@RequiresApi(api = 26)
@CallSuper
open fun onPictureInPictureModeChanged(
    isInPictureInPictureMode: Boolean,
    newConfig: Configuration
): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnPictureInPictureModeChangedListener.

open fun onPreparePanel(featureId: Int, view: View?, menu: Menu): Boolean

onRequestPermissionsResult

Added in 1.2.0

Deprecated in 1.2.0

@CallSuper
open fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<String>,
    grantResults: IntArray
): Unit

{@inheritDoc}

onRetainCustomNonConfigurationInstance

Added in 1.0.0

Deprecated in 1.0.0

open fun onRetainCustomNonConfigurationInstance(): Any?

Use this instead of onRetainNonConfigurationInstance. Retrieve later with lastCustomNonConfigurationInstance.

onRetainNonConfigurationInstance

Added in 1.0.0

final fun onRetainNonConfigurationInstance(): Any?

Retain all appropriate non-config state. You can NOT override this yourself! Use a androidx.lifecycle.ViewModel if you want to retain your own non config state.

onTrimMemory

@CallSuper
open fun onTrimMemory(level: Int): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnTrimMemoryListener.

peekAvailableContext

open fun peekAvailableContext(): Context?

Get the Context if it is currently available. If this returns null, you can use addOnContextAvailableListener to receive a callback for when it available.

Returns
`Context?`	the Context if it is currently available.

registerForActivityResult

final 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

final 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.

removeMenuProvider

Added in 1.4.0

open fun removeMenuProvider(provider: MenuProvider): Unit

Removes the given MenuProvider from this MenuHost.

Parameters
`provider: MenuProvider`	the MenuProvider to be removed

removeOnConfigurationChangedListener

Added in 1.5.0

final fun removeOnConfigurationChangedListener(listener: Consumer<Configuration>): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Consumer<Configuration>`	The listener previously added with `addOnConfigurationChangedListener` that should be removed.

removeOnContextAvailableListener

final fun removeOnContextAvailableListener(listener: OnContextAvailableListener): Unit

Remove a OnContextAvailableListener previously added via addOnContextAvailableListener.

Parameters
`listener: OnContextAvailableListener`	The listener that should be removed.

See also
`addOnContextAvailableListener`

removeOnMultiWindowModeChangedListener

Added in 1.5.0

final fun removeOnMultiWindowModeChangedListener(
    listener: Consumer<MultiWindowModeChangedInfo>
): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Consumer<MultiWindowModeChangedInfo>`	The listener previously added with `addOnMultiWindowModeChangedListener` that should be removed.

removeOnNewIntentListener

Added in 1.5.0

final fun removeOnNewIntentListener(listener: Consumer<Intent>): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Consumer<Intent>`	The listener previously added with `addOnNewIntentListener` that should be removed.

removeOnPictureInPictureModeChangedListener

Added in 1.5.0

final fun removeOnPictureInPictureModeChangedListener(
    listener: Consumer<PictureInPictureModeChangedInfo>
): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Consumer<PictureInPictureModeChangedInfo>`	The listener previously added with `addOnPictureInPictureModeChangedListener` that should be removed.

removeOnTrimMemoryListener

Added in 1.5.0

final fun removeOnTrimMemoryListener(listener: Consumer<Int>): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Consumer<Int>`	The listener previously added with .addOnTrimMemoryListener that should be removed.

removeOnUserLeaveHintListener

Added in 1.9.0

final fun removeOnUserLeaveHintListener(listener: Runnable): Unit

Remove a previously added listener. It will not receive any future callbacks.

Parameters
`listener: Runnable`	The listener previously added with `addOnUserLeaveHintListener` that should be removed.

reportFullyDrawn

open fun reportFullyDrawn(): Unit

setContentView

open fun setContentView(layoutResID: @LayoutRes Int): Unit

setContentView

open fun setContentView(view: View?): Unit

setContentView

open fun setContentView(view: View?, params: ViewGroup.LayoutParams?): Unit

startActivityForResult

Added in 1.2.0

Deprecated in 1.2.0

open fun startActivityForResult(intent: Intent, requestCode: Int): Unit

{@inheritDoc}

startActivityForResult

Added in 1.2.0

Deprecated in 1.2.0

open fun startActivityForResult(intent: Intent, requestCode: Int, options: Bundle?): Unit

{@inheritDoc}

startIntentSenderForResult

Added in 1.2.0

Deprecated in 1.2.0

open fun startIntentSenderForResult(
    intent: IntentSender,
    requestCode: Int,
    fillInIntent: Intent?,
    flagsMask: Int,
    flagsValues: Int,
    extraFlags: Int
): Unit

{@inheritDoc}

startIntentSenderForResult

Added in 1.2.0

Deprecated in 1.2.0

open fun startIntentSenderForResult(
    intent: IntentSender,
    requestCode: Int,
    fillInIntent: Intent?,
    flagsMask: Int,
    flagsValues: Int,
    extraFlags: Int,
    options: Bundle?
): Unit

{@inheritDoc}

Protected functions

onActivityResult

Added in 1.2.0

Deprecated in 1.2.0

@CallSuper
protected open fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?): Unit

{@inheritDoc}

onCreate

protected open fun onCreate(savedInstanceState: Bundle?): Unit

{@inheritDoc}

If your ComponentActivity is annotated with ContentView, this will call setContentView for you.

onNewIntent

@CallSuper
protected open fun onNewIntent(intent: Intent): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnNewIntentListener.

onSaveInstanceState

@CallSuper
protected open fun onSaveInstanceState(outState: Bundle): Unit

onUserLeaveHint

@CallSuper
protected open fun onUserLeaveHint(): Unit

{@inheritDoc}

Dispatches this call to all listeners added via addOnUserLeaveHintListener.

Public properties

activityResultRegistry

final val activityResultRegistry: ActivityResultRegistry

Get the ActivityResultRegistry associated with this activity.

Returns
`ActivityResultRegistry`	the `ActivityResultRegistry`

defaultViewModelCreationExtras

open val defaultViewModelCreationExtras: CreationExtras

defaultViewModelProviderFactory

Added in 1.1.0

open val defaultViewModelProviderFactory: ViewModelProvider.Factory

fullyDrawnReporter

open val fullyDrawnReporter: FullyDrawnReporter

Retrieve the FullyDrawnReporter that should handle the independent parts of the UI that separately report that they are fully drawn.

lastCustomNonConfigurationInstance

Added in 1.0.0

Deprecated in 1.0.0

open val lastCustomNonConfigurationInstance: Any?

lifecycle

Added in 1.0.0

open val lifecycle: Lifecycle

{@inheritDoc}

Overriding this method is no longer supported and this method will be made final in a future version of ComponentActivity. If you do override this method, you must:

Return an instance of LifecycleRegistry
Lazily initialize your LifecycleRegistry object when this is first called.

Note that this method will be called in the super classes' constructor, before any field initialization or object state creation is complete.

navigationEventDispatcher

Added in 1.12.0-alpha04

open val navigationEventDispatcher: NavigationEventDispatcher

Lazily provides a NavigationEventDispatcher for back navigation handling, including support for predictive back gestures introduced in Android 13 (API 33+).

This dispatcher acts as the central point for back navigation events. When a navigation event occurs (e.g., a back gesture), it safely invokes ComponentActivity.onBackPressed.

onBackPressedDispatcher

final val onBackPressedDispatcher: OnBackPressedDispatcher

Retrieve the OnBackPressedDispatcher that will be triggered when onBackPressed is called.

Returns
`OnBackPressedDispatcher`	The `OnBackPressedDispatcher` associated with this ComponentActivity.

savedStateRegistry

Added in 1.0.0

final val savedStateRegistry: SavedStateRegistry

viewModelStore

Added in 1.0.0

open val viewModelStore: ViewModelStore

Extension functions

setSubspaceContent

Artifact: androidx.xr.compose:compose

View Source

fun ComponentActivity.setSubspaceContent(
    content: @Composable @SubspaceComposable () -> Unit
): Unit

Composes the provided composable content into this activity's subspace.

This method only takes effect in Android XR. Calling it will cause the activity to register itself as a subspace, allowing it to control its own panel (i.e. move and resize within its subspace 3D bounds) and show additional spatial content around it.

Parameters
`content: @Composable @SubspaceComposable () -> Unit`	A `@Composable` function declaring the spatial UI content.

setSubspaceContent

Artifact: androidx.xr.compose:compose

View Source

@VisibleForTesting
fun ComponentActivity.setSubspaceContent(
    session: Session,
    content: @Composable @SubspaceComposable () -> Unit
): Unit

Composes the provided composable content into this activity's subspace.

Parameters
`session: Session`	The JXR session to use for this subspace.
`content: @Composable @SubspaceComposable () -> Unit`	A `@Composable` function declaring the spatial UI content.

viewModels

Artifact: androidx.activity:activity

View Source

@MainThread
inline fun <VM : ViewModel> ComponentActivity.viewModels(
    noinline extrasProducer: (() -> CreationExtras)? = null,
    noinline factoryProducer: (() -> ViewModelProvider.Factory)? = null
): Lazy<VM>

Returns a Lazy delegate to access the ComponentActivity's ViewModel, if factoryProducer is specified then ViewModelProvider.Factory returned by it will be used to create ViewModel first time.

class MyComponentActivity : ComponentActivity() {
    val viewmodel: MyViewModel by viewModels()
}

This property can be accessed only after the Activity is attached to the Application, and access prior to that will result in IllegalArgumentException.

setContent

Artifact: androidx.activity:activity-compose

View Source

fun ComponentActivity.setContent(
    parent: CompositionContext? = null,
    content: @Composable () -> Unit
): Unit

Composes the given composable into the given activity. The content will become the root view of the given activity.

This is roughly equivalent to calling ComponentActivity.setContentView with a ComposeView i.e.:

setContentView(
  ComposeView(this).apply {
    setContent {
      MyComposableContent()
    }
  }
)

Parameters
`parent: CompositionContext? = null`	The parent composition reference to coordinate scheduling of composition updates
`content: @Composable () -> Unit`	A `@Composable` function declaring the UI contents

enableEdgeToEdge

Artifact: androidx.activity:activity

View Source

fun ComponentActivity.enableEdgeToEdge(
    statusBarStyle: SystemBarStyle = SystemBarStyle.auto(Color.TRANSPARENT, Color.TRANSPARENT),
    navigationBarStyle: SystemBarStyle = SystemBarStyle.auto(DefaultLightScrim, DefaultDarkScrim)
): Unit

Enables the edge-to-edge display for this ComponentActivity.

To set it up with the default style, call this method in your Activity's onCreate method:

    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)
        ...
    }

The default style configures the system bars with a transparent background when contrast can be enforced by the system (API 29 or above). On older platforms (which only have 3-button/2-button navigation modes), an equivalent scrim is applied to ensure contrast with the system bars.

See SystemBarStyle for more customization options.

Parameters
`statusBarStyle: SystemBarStyle = SystemBarStyle.auto(Color.TRANSPARENT, Color.TRANSPARENT)`	The `SystemBarStyle` for the status bar.
`navigationBarStyle: SystemBarStyle = SystemBarStyle.auto(DefaultLightScrim, DefaultDarkScrim)`	The `SystemBarStyle` for the navigation bar.