# FragmentController

Artifact: [androidx.fragment:fragment](https://developer.android.com/jetpack/androidx/releases/fragment) [View Source](https://cs.android.com/search?q=file:androidx/fragment/app/FragmentController.java+class:androidx.fragment.app.FragmentController) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

*** ** * ** ***

<br />

```
class FragmentController
```

<br />

*** ** * ** ***

Provides integration points with a `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager` for a fragment host.

It is the responsibility of the host to take care of the Fragment's lifecycle. The methods provided by `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController` are for that purpose.

## Summary

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#attachHost(androidx.fragment.app.Fragment)(parent: https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment?)` Attaches the host to the FragmentManager for this controller. |
| `java-static https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#createController(androidx.fragment.app.FragmentHostCallback<?>)(callbacks: https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback<*>)` Returns a `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchActivityCreated()()` Moves all Fragments managed by the controller's FragmentManager into the activity created state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchConfigurationChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchConfigurationChanged(android.content.res.Configuration))(newConfig: https://developer.android.com/reference/android/content/res/Configuration.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/content/OnConfigurationChangedProvider` to automatically dispatch configuration changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchContextItemSelected(android.view.MenuItem)(item: https://developer.android.com/reference/android/view/MenuItem.html)` Sends a context item selection event to the Fragments managed by the controller's FragmentManager. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchCreate()()` Moves all Fragments managed by the controller's FragmentManager into the create state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `[dispatchCreateOptionsMenu](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchCreateOptionsMenu(android.view.Menu,android.view.MenuInflater))(menu: https://developer.android.com/reference/android/view/Menu.html, inflater: https://developer.android.com/reference/android/view/MenuInflater.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchDestroy()()` Moves Fragments managed by the controller's FragmentManager into the destroy state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchDestroyView()()` Moves all Fragments managed by the controller's FragmentManager into the destroy view state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchLowMemory](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchLowMemory())()` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/content/OnTrimMemoryProvider` to automatically dispatch low memory callbacks to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchMultiWindowModeChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchMultiWindowModeChanged(boolean))(isInMultiWindowMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/app/OnMultiWindowModeChangedProvider` to automatically dispatch multi-window mode changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `[dispatchOptionsItemSelected](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchOptionsItemSelected(android.view.MenuItem))(item: https://developer.android.com/reference/android/view/MenuItem.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchOptionsMenuClosed](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchOptionsMenuClosed(android.view.Menu))(menu: https://developer.android.com/reference/android/view/Menu.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchPause()()` Moves all Fragments managed by the controller's FragmentManager into the pause state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchPictureInPictureModeChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchPictureInPictureModeChanged(boolean))(isInPictureInPictureMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/app/OnPictureInPictureModeChangedProvider` to automatically dispatch picture-in-picture mode changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `[dispatchPrepareOptionsMenu](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchPrepareOptionsMenu(android.view.Menu))(menu: https://developer.android.com/reference/android/view/Menu.html)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dispatchReallyStop](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchReallyStop())()` **This function is deprecated.** This functionality has been rolled into `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchStop()`. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchResume()()` Moves all Fragments managed by the controller's FragmentManager into the resume state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchStart()()` Moves all Fragments managed by the controller's FragmentManager into the start state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchStop()()` Moves all Fragments managed by the controller's FragmentManager into the stop state. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[doLoaderDestroy](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderDestroy())()` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[doLoaderRetain](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderRetain())()` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[doLoaderStart](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderStart())()` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[doLoaderStop](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderStop(boolean))(retain: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[dumpLoaders](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dumpLoaders(java.lang.String,java.io.FileDescriptor,java.io.PrintWriter,java.lang.String[]))( prefix: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html, fd: https://developer.android.com/reference/java/io/FileDescriptor.html?, writer: https://developer.android.com/reference/java/io/PrintWriter.html, args: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!>? )` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#execPendingActions()()` Execute any pending actions for the Fragments managed by the controller's FragmentManager. |
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment?` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#findFragmentByWho(java.lang.String)(who: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)` Returns a fragment with the given identifier. |
| `(https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment!>` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#getActiveFragments(java.util.List<androidx.fragment.app.Fragment>)(actives: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment!>!)` Returns the list of active fragments. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#getActiveFragmentsCount()()` Returns the number of active fragments. |
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#getSupportFragmentManager()()` Returns a `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager` for this controller. |
| `https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager!` | `[getSupportLoaderManager](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#getSupportLoaderManager())()` **This function is deprecated.** Loaders are managed separately from FragmentController and this now throws an `https://developer.android.com/reference/java/lang/UnsupportedOperationException.html`. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#noteStateNotSaved()()` Marks the fragment state as unsaved. |
| `https://developer.android.com/reference/android/view/View.html?` | `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#onCreateView(android.view.View,java.lang.String,android.content.Context,android.util.AttributeSet)( parent: https://developer.android.com/reference/android/view/View.html?, name: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html, context: https://developer.android.com/reference/android/content/Context.html, attrs: https://developer.android.com/reference/android/util/AttributeSet.html )` Instantiates a Fragment's view. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[reportLoaderStart](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#reportLoaderStart())()` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[restoreAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreAllState(android.os.Parcelable,androidx.fragment.app.FragmentManagerNonConfig))(state: https://developer.android.com/reference/android/os/Parcelable.html?, nonConfig: https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManagerNonConfig?)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically restore the Fragment's non configuration state and use `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable)` to restore the Fragment's save state. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[restoreAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreAllState(android.os.Parcelable,java.util.List<androidx.fragment.app.Fragment>))( state: https://developer.android.com/reference/android/os/Parcelable.html?, nonConfigList: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment!>? )` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically restore the Fragment's non configuration state and use `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable)` to restore the Fragment's save state. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[restoreLoaderNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreLoaderNonConfig(androidx.collection.SimpleArrayMap<java.lang.String,androidx.loader.app.LoaderManager>))( loaderManagers: https://developer.android.com/reference/kotlin/androidx/collection/SimpleArrayMap<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager!>! )` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `[restoreSaveState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable))(state: https://developer.android.com/reference/android/os/Parcelable.html?)` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/savedstate/SavedStateRegistryOwner` to automatically restore the saved state via the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager`. <br /> |
| `https://developer.android.com/reference/kotlin/androidx/collection/SimpleArrayMap<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager!>?` | `[retainLoaderNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainLoaderNonConfig())()` **This function is deprecated.** Loaders are managed separately from FragmentController <br /> |
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManagerNonConfig?` | `[retainNestedNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainNestedNonConfig())()` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically retain the Fragment's non configuration state. <br /> |
| `(https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment!>?` | `[retainNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainNonConfig())()` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically retain the Fragment's non configuration state. <br /> |
| `https://developer.android.com/reference/android/os/Parcelable.html?` | `[saveAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#saveAllState())()` **This function is deprecated.** Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/savedstate/SavedStateRegistryOwner` to automatically save state via the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager`. <br /> |

## Public functions

### attachHost

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun attachHost(parent: Fragment?): Unit
```

Attaches the host to the FragmentManager for this controller. The host must be attached before the FragmentManager can be used to manage Fragments.

### createController

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
java-static fun createController(callbacks: FragmentHostCallback<*>): FragmentController
```

Returns a `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController`.

### dispatchActivityCreated

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchActivityCreated(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the activity created state.

Call when Fragments should be informed their host has been created.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment` |   |

### dispatchConfigurationChanged

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchConfigurationChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchConfigurationChanged(android.content.res.Configuration))(newConfig: Configuration): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/content/OnConfigurationChangedProvider` to automatically dispatch configuration changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know a configuration change occurred.

Call when there is a configuration change.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onConfigurationChanged(android.content.res.Configuration)` |   |

### dispatchContextItemSelected

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchContextItemSelected(item: MenuItem): Boolean
```

Sends a context item selection event to the Fragments managed by the controller's FragmentManager. Once the event has been consumed, no additional handling will be performed.

Call immediately after an options menu item has been selected

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `true` if the context menu selection event was consumed |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onContextItemSelected(android.view.MenuItem)` |   |

### dispatchCreate

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchCreate(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the create state.

Call when Fragments should be created.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment` |   |

### dispatchCreateOptionsMenu

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchCreateOptionsMenu](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchCreateOptionsMenu(android.view.Menu,android.view.MenuInflater))(menu: Menu, inflater: MenuInflater): Boolean
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know they should create an options menu.

Call when the Fragment should create an options menu.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `true` if the options menu contains items to display |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onCreateOptionsMenu(android.view.Menu,android.view.MenuInflater)` |   |

### dispatchDestroy

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchDestroy(): Unit
```

Moves Fragments managed by the controller's FragmentManager into the destroy state.

If the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` is an instance of `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner`, then retained Fragments and any other non configuration state such as any `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModel` attached to Fragments will only be destroyed if `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStore#clear()` is called prior to this method.

Otherwise, the FragmentManager will look to see if the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` Context is an `https://developer.android.com/reference/android/app/Activity.html` and if `https://developer.android.com/reference/android/app/Activity.html#isChangingConfigurations()` returns true. In only that case will non configuration state be retained.

Call when Fragments should be destroyed.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onDestroy()` |   |

### dispatchDestroyView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchDestroyView(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the destroy view state.

Call when the Fragment's views should be destroyed.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onDestroyView()` |   |

### dispatchLowMemory

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchLowMemory](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchLowMemory())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/content/OnTrimMemoryProvider` to automatically dispatch low memory callbacks to fragments.

Lets all Fragments managed by the controller's FragmentManager know the device is in a low memory condition.

Call when the device is low on memory and Fragment's should trim their memory usage.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onLowMemory()` |   |

### dispatchMultiWindowModeChanged

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchMultiWindowModeChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchMultiWindowModeChanged(boolean))(isInMultiWindowMode: Boolean): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/app/OnMultiWindowModeChangedProvider` to automatically dispatch multi-window mode changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know the multi-window mode of the activity changed.

Call when the multi-window mode of the activity changed.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onMultiWindowModeChanged(boolean)` |   |

### dispatchOptionsItemSelected

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchOptionsItemSelected](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchOptionsItemSelected(android.view.MenuItem))(item: MenuItem): Boolean
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments.

Sends an option item selection event to the Fragments managed by the controller's FragmentManager. Once the event has been consumed, no additional handling will be performed.

Call immediately after an options menu item has been selected

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `true` if the options menu selection event was consumed |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onOptionsItemSelected(android.view.MenuItem)` |   |

### dispatchOptionsMenuClosed

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchOptionsMenuClosed](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchOptionsMenuClosed(android.view.Menu))(menu: Menu): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know their options menu has closed.

Call immediately after closing the Fragment's options menu.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onOptionsMenuClosed(android.view.Menu)` |   |

### dispatchPause

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchPause(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the pause state.

Call when Fragments should be paused.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onPause()` |   |

### dispatchPictureInPictureModeChanged

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchPictureInPictureModeChanged](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchPictureInPictureModeChanged(boolean))(isInPictureInPictureMode: Boolean): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/app/OnPictureInPictureModeChangedProvider` to automatically dispatch picture-in-picture mode changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know the picture-in-picture mode of the activity changed.

Call when the picture-in-picture mode of the activity changed.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onPictureInPictureModeChanged(boolean)` |   |

### dispatchPrepareOptionsMenu

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.5.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.5.0)

```
fun [dispatchPrepareOptionsMenu](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchPrepareOptionsMenu(android.view.Menu))(menu: Menu): Boolean
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/core/view/MenuHost` to automatically dispatch menu changes to fragments.

Lets all Fragments managed by the controller's FragmentManager know they should prepare their options menu for display.

Call immediately before displaying the Fragment's options menu.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `true` if the options menu contains items to display |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onPrepareOptionsMenu(android.view.Menu)` |   |

### dispatchReallyStop

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [dispatchReallyStop](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchReallyStop())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> This functionality has been rolled into `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dispatchStop()`.

### dispatchResume

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchResume(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the resume state.

Call when Fragments should be resumed.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onResume()` |   |

### dispatchStart

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchStart(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the start state.

Call when Fragments should be started.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onStart()` |   |

### dispatchStop

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun dispatchStop(): Unit
```

Moves all Fragments managed by the controller's FragmentManager into the stop state.

Call when Fragments should be stopped.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/Fragment#onStop()` |   |

### doLoaderDestroy

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [doLoaderDestroy](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderDestroy())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Destroys the loaders and, if their state is not being retained, removes them.

### doLoaderRetain

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [doLoaderRetain](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderRetain())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Retains the state of each of the loaders.

### doLoaderStart

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [doLoaderStart](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderStart())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Starts the loaders.

### doLoaderStop

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [doLoaderStop](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#doLoaderStop(boolean))(retain: Boolean): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Stops the loaders, optionally retaining their state. This is useful for keeping the loader state across configuration changes.

| Parameters |
|---|---|
| `retain: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | When `true`, the loaders aren't stopped, but, their instances are retained in a started state |

### dumpLoaders

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [dumpLoaders](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#dumpLoaders(java.lang.String,java.io.FileDescriptor,java.io.PrintWriter,java.lang.String[]))(
    prefix: String,
    fd: FileDescriptor?,
    writer: PrintWriter,
    args: Array<String!>?
): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Dumps the current state of the loaders.

### execPendingActions

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun execPendingActions(): Boolean
```

Execute any pending actions for the Fragments managed by the controller's FragmentManager.

Call when queued actions can be performed \[eg when the Fragment moves into a start or resume state\].

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `true` if queued actions were performed |

### findFragmentByWho

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun findFragmentByWho(who: String): Fragment?
```

Returns a fragment with the given identifier.

### getActiveFragments

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun getActiveFragments(actives: (Mutable)List<Fragment!>!): (Mutable)List<Fragment!>
```

Returns the list of active fragments.

### getActiveFragmentsCount

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun getActiveFragmentsCount(): Int
```

Returns the number of active fragments.

### getSupportFragmentManager

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun getSupportFragmentManager(): FragmentManager
```

Returns a `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager` for this controller.

### getSupportLoaderManager

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [getSupportLoaderManager](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#getSupportLoaderManager())(): LoaderManager!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController and this now throws an `https://developer.android.com/reference/java/lang/UnsupportedOperationException.html`. Use `https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager#getInstance(T)` to obtain a LoaderManager.

Returns a `https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager`.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/loader/app/LoaderManager#getInstance(T)` |   |

### noteStateNotSaved

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun noteStateNotSaved(): Unit
```

Marks the fragment state as unsaved. This allows for "state loss" detection.

### onCreateView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun onCreateView(
    parent: View?,
    name: String,
    context: Context,
    attrs: AttributeSet
): View?
```

Instantiates a Fragment's view.

| Parameters |
|---|---|
| `parent: https://developer.android.com/reference/android/view/View.html?` | The parent that the created view will be placed in; *note that this may be null*. |
| `name: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | Tag name to be inflated. |
| `context: https://developer.android.com/reference/android/content/Context.html` | The context the view is being created in. |
| `attrs: https://developer.android.com/reference/android/util/AttributeSet.html` | Inflation attributes as specified in XML file. |

| Returns |
|---|---|
| `https://developer.android.com/reference/android/view/View.html?` | view the newly created view |

### reportLoaderStart

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [reportLoaderStart](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#reportLoaderStart())(): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Lets the loaders know the host is ready to receive notifications.

### restoreAllState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [restoreAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreAllState(android.os.Parcelable,androidx.fragment.app.FragmentManagerNonConfig))(state: Parcelable?, nonConfig: FragmentManagerNonConfig?): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically restore the Fragment's non configuration state and use `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable)` to restore the Fragment's save state.

Restores the saved state for all Fragments. The given FragmentManagerNonConfig are Fragment instances retained across configuration changes, including nested fragments

### restoreAllState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [restoreAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreAllState(android.os.Parcelable,java.util.List<androidx.fragment.app.Fragment>))(
    state: Parcelable?,
    nonConfigList: (Mutable)List<Fragment!>?
): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically restore the Fragment's non configuration state and use `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable)` to restore the Fragment's save state.

Restores the saved state for all Fragments. The given Fragment list are Fragment instances retained across configuration changes.

### restoreLoaderNonConfig

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [restoreLoaderNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreLoaderNonConfig(androidx.collection.SimpleArrayMap<java.lang.String,androidx.loader.app.LoaderManager>))(
    loaderManagers: SimpleArrayMap<String!, LoaderManager!>!
): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Restores the saved state for all LoaderManagers. The given LoaderManager list are LoaderManager instances retained across configuration changes.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainLoaderNonConfig()` |   |

### restoreSaveState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.4.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.4.0)

```
fun [restoreSaveState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable))(state: Parcelable?): Unit
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/savedstate/SavedStateRegistryOwner` to automatically restore the saved state via the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager`.

Restores the saved state for all Fragments.

| Parameters |
|---|---|
| `state: https://developer.android.com/reference/android/os/Parcelable.html?` | the saved state containing the Parcelable returned by `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#saveAllState()` |

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#saveAllState()` |   |

### retainLoaderNonConfig

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [retainLoaderNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainLoaderNonConfig())(): SimpleArrayMap<String!, LoaderManager!>?
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Loaders are managed separately from FragmentController

Returns a list of LoaderManagers that have opted to retain their instance across configuration changes.

### retainNestedNonConfig

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [retainNestedNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainNestedNonConfig())(): FragmentManagerNonConfig?
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically retain the Fragment's non configuration state.

Returns a nested tree of Fragments that have opted to retain their instance across configuration changes.

### retainNonConfig

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0)

```
fun [retainNonConfig](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#retainNonConfig())(): (Mutable)List<Fragment!>?
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/lifecycle/ViewModelStoreOwner` to automatically retain the Fragment's non configuration state.

Returns a list of Fragments that have opted to retain their instance across configuration changes.

### saveAllState

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.1.0) Deprecated in [1.4.0](https://developer.android.com/jetpack/androidx/releases/fragment#1.4.0)

```
fun [saveAllState](https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#saveAllState())(): Parcelable?
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Have your `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentHostCallback` implement `https://developer.android.com/reference/kotlin/androidx/savedstate/SavedStateRegistryOwner` to automatically save state via the `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentManager`.

Saves the state for all Fragments.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/fragment/app/FragmentController#restoreSaveState(android.os.Parcelable)` |   |