# androidx.glance.action

# androidx.glance.action

## Interfaces

|----------------------------------------------------------------------------------------|------------------------------------------------|
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action) | An Action defines the actions a user can take. |

## Classes

|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)               | Action parameters, used to pass information to an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action). |
| [ActionParameters.Key](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters.Key)       | Key for[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)values.                 |
| [ActionParameters.Pair](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters.Pair)     | Key Value pairs for Parameters.                                                                                                          |
| [MutableActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/MutableActionParameters) | Mutable version of[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters).            |

## Constants summary

|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
| `const @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) | [NoRippleOverride](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#NoRippleOverride())` = 0` Constant. |

## Top-level functions summary

|--------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                   | `@`[Composable](https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable) [action](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#action(kotlin.String,kotlin.Function0))`(key: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`?, block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)`)` Create an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that runs[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#action(kotlin.String,kotlin.Function0))when triggered.                                                                                                                                                                                                                                                                                                             |
| [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)               | [actionParametersOf](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionParametersOf(kotlin.Array))`(vararg pairs: `[ActionParameters.Pair](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters.Pair)`<`[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`>)` Returns a new read-only Parameters, from the specified contents.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `inline `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                          | `<T : `[Activity](https://developer.android.com/reference/android/app/Activity.html)`> `[actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(androidx.glance.action.ActionParameters))`(parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.                                                                                                                                                                                                                                                                                                                                                                                            |
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                   | `<T : `[Activity](https://developer.android.com/reference/android/app/Activity.html)`> `[actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(java.lang.Class,androidx.glance.action.ActionParameters))`(` ` activity: `[Class](https://developer.android.com/reference/java/lang/Class.html)`<T>,` ` parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters) `)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.                                                                                                                                                                                                                                                                              |
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                   | [actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(android.content.ComponentName,androidx.glance.action.ActionParameters))`(` ` componentName: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)`,` ` parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters) `)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the[Activity](https://developer.android.com/reference/android/app/Activity.html)specified by the given[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html).                                                                                                                                                                                                                                       |
| `inline `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                          | `@`[ExperimentalGlanceApi](https://developer.android.com/reference/kotlin/androidx/glance/ExperimentalGlanceApi) `<T : `[Activity](https://developer.android.com/reference/android/app/Activity.html)`> `[actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(androidx.glance.action.ActionParameters,android.os.Bundle))`(` ` parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`,` ` activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`?` `)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.                                                                                                                                                 |
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                   | `@`[ExperimentalGlanceApi](https://developer.android.com/reference/kotlin/androidx/glance/ExperimentalGlanceApi) `<T : `[Activity](https://developer.android.com/reference/android/app/Activity.html)`> `[actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(java.lang.Class,androidx.glance.action.ActionParameters,android.os.Bundle))`(` ` activity: `[Class](https://developer.android.com/reference/java/lang/Class.html)`<T>,` ` parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`,` ` activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`?` `)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.                                        |
| [Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                   | `@`[ExperimentalGlanceApi](https://developer.android.com/reference/kotlin/androidx/glance/ExperimentalGlanceApi) [actionStartActivity](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#actionStartActivity(android.content.ComponentName,androidx.glance.action.ActionParameters,android.os.Bundle))`(` ` componentName: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)`,` ` parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`,` ` activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`?` `)` Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the[Activity](https://developer.android.com/reference/android/app/Activity.html)specified by the given[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html). |
| [MutableActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/MutableActionParameters) | [mutableActionParametersOf](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#mutableActionParametersOf(kotlin.Array))`(vararg pairs: `[ActionParameters.Pair](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters.Pair)`<`[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`>)` Returns a new MutableParameters, from the specified contents.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

## Extension functions summary

|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)                          | `@`[Composable](https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable) [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)`.`[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Function0))`(block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)`)` Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Function0))in response to a user click.                                                                                                                                                                                                                                                                                                                                                         |
| [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)                          | [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)`.`[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(androidx.glance.action.Action))`(onClick: `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)`)` Apply an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action), to be executed in response to a user click.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)                          | [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)`.`[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(androidx.glance.action.Action,kotlin.Int))`(` ` onClick: `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)`,` ` rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html) `)` Apply an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action), to be executed in response to a user click.                                                                                                                                                                                                                                                                         |
| [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)                          | `@`[Composable](https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable) [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)`.`[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Int,kotlin.Function0))`(` ` rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) `)` Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Int,kotlin.Function0))in response to a user click.                                                                                                                           |
| [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)                          | `@`[Composable](https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable) [GlanceModifier](https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier)`.`[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.String,kotlin.Int,kotlin.Function0))`(` ` key: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`?,` ` rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`,` ` block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) `)` Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.String,kotlin.Int,kotlin.Function0))in response to a user click. |
| [MutableActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/MutableActionParameters) | [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`.`[toMutableParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.action.ActionParameters).toMutableParameters())`()` Gets a mutable copy of Parameters, containing all key value pairs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)               | [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)`.`[toParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.action.ActionParameters).toParameters())`()` Gets a read-only copy of Parameters, containing all key value pairs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| [ActionParameters.Key](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters.Key)`<T>`  | `<T : `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`> `[Preferences.Key](https://developer.android.com/reference/kotlin/androidx/datastore/preferences/core/Preferences.Key)`<T>.`[toParametersKey](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.datastore.preferences.core.Preferences.Key).toParametersKey())`()` Creates an action key from a preferences key.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

## Constants

### NoRippleOverride

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+symbol:NoRippleOverride)  
Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/glance#1.1.0)  

```
const val NoRippleOverride = 0: @DrawableRes Int
```

Constant. Tells the system that there is no ripple override. When this is passed, the system will use default behavior for the ripple.

## Top-level functions

### action

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/LambdaAction.kt+function:action)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
@Composable
fun action(key: String? = null, block: () -> Unit): Action
```

Create an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that runs[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#action(kotlin.String,kotlin.Function0))when triggered.  

|                                             Parameters                                             |
|----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `key: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`? = null` | A stable and unique key that identifies this action. This key is saved in the PendingIntent for the UI element, and used to trigger this action when the element is clicked. If not provided we use[currentCompositeKeyHash](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#currentCompositeKeyHash())as the key. Since that key is based on the location within the composition, it will be identical for lambdas generated in a loop (if not using[androidx.compose.runtime.key](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#key(kotlin.Array,kotlin.Function0))). To avoid this, prefer setting explicit keys for your lambdas. |
| `block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)     | the function to be run when this action is triggered.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

### actionParametersOf

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/ActionParameters.kt+function:actionParametersOf)  

```
fun actionParametersOf(vararg pairs: ActionParameters.Pair<Any>): ActionParameters
```

Returns a new read-only Parameters, from the specified contents. The key element in the given pairs will point to the corresponding value element. All values must be either of primitive or Parcelable types.

If multiple pairs have the same key, the resulting map will contain only the value from the last of those pairs.  

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  

```
inline fun <T : Activity> actionStartActivity(
    parameters: ActionParameters = actionParametersOf()
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string. |

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun <T : Activity> actionStartActivity(
    activity: Class<T>,
    parameters: ActionParameters = actionParametersOf()
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `activity: `[Class](https://developer.android.com/reference/java/lang/Class.html)`<T>`                                                            | class of the activity to launch                                                                                                           |
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string. |

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun actionStartActivity(
    componentName: ComponentName,
    parameters: ActionParameters = actionParametersOf()
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the[Activity](https://developer.android.com/reference/android/app/Activity.html)specified by the given[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html).  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `componentName: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)                                      | component of the activity to launch                                                                                                       |
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string. |

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  

```
@ExperimentalGlanceApi
inline fun <T : Activity> actionStartActivity(
    parameters: ActionParameters = actionParametersOf(),
    activityOptions: Bundle? = null
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string.                             |
| `activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`? = null`                                             | Additional options built from an[android.app.ActivityOptions](https://developer.android.com/reference/android/app/ActivityOptions.html)to apply to an activity start. |

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
@ExperimentalGlanceApi
fun <T : Activity> actionStartActivity(
    activity: Class<T>,
    parameters: ActionParameters = actionParametersOf(),
    activityOptions: Bundle? = null
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the specified[Activity](https://developer.android.com/reference/android/app/Activity.html)when triggered.  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `activity: `[Class](https://developer.android.com/reference/java/lang/Class.html)`<T>`                                                            | class of the activity to launch                                                                                                                                       |
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string.                             |
| `activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`? = null`                                             | Additional options built from an[android.app.ActivityOptions](https://developer.android.com/reference/android/app/ActivityOptions.html)to apply to an activity start. |

### actionStartActivity

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/StartActivityAction.kt+function:actionStartActivity)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
@ExperimentalGlanceApi
fun actionStartActivity(
    componentName: ComponentName,
    parameters: ActionParameters = actionParametersOf(),
    activityOptions: Bundle? = null
): Action
```

Creates an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)that launches the[Activity](https://developer.android.com/reference/android/app/Activity.html)specified by the given[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html).  

|                                                                    Parameters                                                                     |
|---------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `componentName: `[ComponentName](https://developer.android.com/reference/android/content/ComponentName.html)                                      | component of the activity to launch                                                                                                                                   |
| `parameters: `[ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters)` = actionParametersOf()` | the parameters associated with the action. Parameter values will be added to the activity intent, keyed by the parameter key name string.                             |
| `activityOptions: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`? = null`                                             | Additional options built from an[android.app.ActivityOptions](https://developer.android.com/reference/android/app/ActivityOptions.html)to apply to an activity start. |

### mutableActionParametersOf

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/ActionParameters.kt+function:mutableActionParametersOf)  

```
fun mutableActionParametersOf(vararg pairs: ActionParameters.Pair<Any>): MutableActionParameters
```

Returns a new MutableParameters, from the specified contents. The key element in the given pairs will point to the corresponding value element. All values must be either of primitive or Parcelable types.

If multiple pairs have the same key, the resulting Parameters will contain only the value from the last of those pairs.

## Extension functions

### clickable

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+function:clickable)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
@Composable
fun GlanceModifier.clickable(block: () -> Unit): GlanceModifier
```

Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Function0))in response to a user click.

The lambda provided to this function will use the[androidx.compose.runtime.currentCompositeKeyHash](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#currentCompositeKeyHash())to set a key for this lambda that will be used to trigger it when the corresponding UI element is clicked. Since that key is based on the location within the composition, it will be identical for lambdas generated in a loop (if not using[androidx.compose.runtime.key](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#key(kotlin.Array,kotlin.Function0))).

To avoid this, prefer setting explicit keys for your lambdas, by using the overload of[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(androidx.glance.action.Action))that accepts a key parameter.  

|                                           Parameters                                           |
|------------------------------------------------------------------------------------------------|--------------------|
| `block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | The action to run. |

### clickable

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+function:clickable)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun GlanceModifier.clickable(onClick: Action): GlanceModifier
```

Apply an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action), to be executed in response to a user click.  

|                                            Parameters                                             |
|---------------------------------------------------------------------------------------------------|--------------------|
| `onClick: `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action) | The action to run. |

### clickable

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+function:clickable)  
Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/glance#1.1.0)  

```
fun GlanceModifier.clickable(
    onClick: Action,
    rippleOverride: @DrawableRes Int = NoRippleOverride
): GlanceModifier
```

Apply an[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action), to be executed in response to a user click.  

|                                                                                                     Parameters                                                                                                      |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `onClick: `[Action](https://developer.android.com/reference/kotlin/androidx/glance/action/Action)                                                                                                                   | The action to run.                                                                                                                                                                                                |
| `rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` = NoRippleOverride` | A drawable resource to use as the onClick ripple. Use[NoRippleOverride](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#NoRippleOverride())if no custom behavior is needed. |

### clickable

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+function:clickable)  
Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/glance#1.1.0)  

```
@Composable
fun GlanceModifier.clickable(
    rippleOverride: @DrawableRes Int = NoRippleOverride,
    block: () -> Unit
): GlanceModifier
```

Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.Int,kotlin.Function0))in response to a user click.

The lambda provided to this function will use the[androidx.compose.runtime.currentCompositeKeyHash](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#currentCompositeKeyHash())to set a key for this lambda that will be used to trigger it when the corresponding UI element is clicked. Since that key is based on the location within the composition, it will be identical for lambdas generated in a loop (if not using[androidx.compose.runtime.key](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#key(kotlin.Array,kotlin.Function0))).

To avoid this, prefer setting explicit keys for your lambdas, by using the overload of[clickable](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(androidx.glance.action.Action))that accepts a key parameter.  

|                                                                                                     Parameters                                                                                                      |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` = NoRippleOverride` | A drawable resource to use as the onClick ripple. Use[NoRippleOverride](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#NoRippleOverride())if no custom behavior is needed. |
| `block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)                                                                                                                      | The action to run.                                                                                                                                                                                                |

### clickable

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/Action.kt+function:clickable)  
Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/glance#1.1.0)  

```
@Composable
fun GlanceModifier.clickable(
    key: String? = null,
    rippleOverride: @DrawableRes Int = NoRippleOverride,
    block: () -> Unit
): GlanceModifier
```

Run[block](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#(androidx.glance.GlanceModifier).clickable(kotlin.String,kotlin.Int,kotlin.Function0))in response to a user click.  

|                                                                                                     Parameters                                                                                                      |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `key: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`? = null`                                                                                                                  | A stable and unique key that identifies this action. This key is saved in the PendingIntent for the UI element, and used to trigger this action when the element is clicked. If not provided we use[androidx.compose.runtime.currentCompositeKeyHash](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#currentCompositeKeyHash())as the key. Since that key is based on the location within the composition, it will be identical for lambdas generated in a loop (if not using[androidx.compose.runtime.key](https://developer.android.com/reference/kotlin/androidx/compose/runtime/package-summary#key(kotlin.Array,kotlin.Function0))). To avoid this, prefer setting explicit keys for your lambdas, e.g. "incrementCount", "openNewYorkWeather", etc. |
| `rippleOverride: @`[DrawableRes](https://developer.android.com/reference/kotlin/androidx/annotation/DrawableRes)` `[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` = NoRippleOverride` | A drawable resource to use as the onClick ripple. Use[NoRippleOverride](https://developer.android.com/reference/kotlin/androidx/glance/action/package-summary#NoRippleOverride())if no custom behavior is needed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `block: () `->` `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html)                                                                                                                      | The action to run.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

### toMutableParameters

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/ActionParameters.kt+function:toMutableParameters)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun ActionParameters.toMutableParameters(): MutableActionParameters
```

Gets a mutable copy of Parameters, containing all key value pairs. This can be used to edit the parameter data without creating a new object.

This is similar to[Map.toMutableMap](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/index.html).  

|                                                         Returns                                                          |
|--------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------|
| [MutableActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/MutableActionParameters) | a MutableParameters with all the same parameters as this Parameters |

### toParameters

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/ActionParameters.kt+function:toParameters)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun ActionParameters.toParameters(): ActionParameters
```

Gets a read-only copy of Parameters, containing all key value pairs.

This is similar to[Map.toMap](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/index.html).  

|                                                  Returns                                                   |
|------------------------------------------------------------------------------------------------------------|---------------------------|
| [ActionParameters](https://developer.android.com/reference/kotlin/androidx/glance/action/ActionParameters) | a copy of this Parameters |

### toParametersKey

Artifact:[androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance)  
[View Source](https://cs.android.com/search?q=file:androidx/glance/action/ActionParameters.kt+function:toParametersKey)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)  

```
fun <T : Any> Preferences.Key<T>.toParametersKey(): ActionParameters.Key<T>
```

Creates an action key from a preferences key.