# TitleBar

## Functions summary

|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/glance/appwidget/components/TitleBar.composable#TitleBar(androidx.glance.ImageProvider,kotlin.String,androidx.glance.unit.ColorProvider,androidx.glance.unit.ColorProvider,androidx.glance.GlanceModifier,androidx.glance.text.FontFamily,kotlin.Function1)( startIcon: https://developer.android.com/reference/kotlin/androidx/glance/ImageProvider, title: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html, iconColor: https://developer.android.com/reference/kotlin/androidx/glance/unit/ColorProvider?, textColor: https://developer.android.com/reference/kotlin/androidx/glance/unit/ColorProvider, modifier: https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier, fontFamily: https://developer.android.com/reference/kotlin/androidx/glance/text/FontFamily?, actions: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/glance/layout/RowScope.() -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html )` A Title Bar. |

## Functions

### TitleBar

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

```
@Composable
fun TitleBar(
    startIcon: ImageProvider,
    title: String,
    iconColor: ColorProvider? = GlanceTheme.colors.onSurface,
    textColor: ColorProvider = GlanceTheme.colors.onSurface,
    modifier: GlanceModifier = GlanceModifier,
    fontFamily: FontFamily? = null,
    actions: @Composable RowScope.() -> Unit = {}
): Unit
```

A Title Bar. Contains an Icon, Text, and actions. Intended to be placed at the top of a widget.

| Parameters |
|---|---|
| `startIcon: https://developer.android.com/reference/kotlin/androidx/glance/ImageProvider` | A tintable icon representing your app or brand. |
| `title: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | Text to be displayed. Generally the name of your widget or app. Title should be shortened or omitted when the widget's width is narrow. The width can be checked using `LocalSize.current.width` |
| `iconColor: https://developer.android.com/reference/kotlin/androidx/glance/unit/ColorProvider? = GlanceTheme.colors.onSurface` | The color which `https://developer.android.com/reference/kotlin/androidx/glance/appwidget/components/package-summary#TitleBar(androidx.glance.ImageProvider,kotlin.String,androidx.glance.unit.ColorProvider,androidx.glance.unit.ColorProvider,androidx.glance.GlanceModifier,androidx.glance.text.FontFamily,kotlin.Function1)` will be tinted. |
| `textColor: https://developer.android.com/reference/kotlin/androidx/glance/unit/ColorProvider = GlanceTheme.colors.onSurface` | The color which `https://developer.android.com/reference/kotlin/androidx/glance/appwidget/components/package-summary#TitleBar(androidx.glance.ImageProvider,kotlin.String,androidx.glance.unit.ColorProvider,androidx.glance.unit.ColorProvider,androidx.glance.GlanceModifier,androidx.glance.text.FontFamily,kotlin.Function1)` will be tinted. |
| `modifier: https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier = GlanceModifier` | GlanceModifier. |
| `fontFamily: https://developer.android.com/reference/kotlin/androidx/glance/text/FontFamily? = null` | Optional override for `https://developer.android.com/reference/kotlin/androidx/glance/appwidget/components/package-summary#TitleBar(androidx.glance.ImageProvider,kotlin.String,androidx.glance.unit.ColorProvider,androidx.glance.unit.ColorProvider,androidx.glance.GlanceModifier,androidx.glance.text.FontFamily,kotlin.Function1)`'s font family. Leave null to use the default. |
| `actions: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/glance/layout/RowScope.() -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html = {}` | A slot api for buttons. Use `https://developer.android.com/reference/kotlin/androidx/glance/appwidget/components/CircleIconButton.composable#CircleIconButton(androidx.glance.ImageProvider,kotlin.String,kotlin.Function0,androidx.glance.GlanceModifier,kotlin.Boolean,androidx.glance.unit.ColorProvider,androidx.glance.unit.ColorProvider,kotlin.String)` with backgroundColor = null. Buttons will be placed in a `https://developer.android.com/reference/kotlin/androidx/glance/layout/Row.composable#Row(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment.Horizontal,androidx.glance.layout.Alignment.Vertical,kotlin.Function1)`. |