# TypeBuilders.StringProp.Builder

Artifact: [androidx.wear.protolayout:protolayout](https://developer.android.com/jetpack/androidx/releases/wear-protolayout) [View Source](https://cs.android.com/search?q=file:androidx/wear/protolayout/TypeBuilders.java+class:androidx.wear.protolayout.TypeBuilders.StringProp.Builder) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

*** ** * ** ***


```
public final class TypeBuilders.StringProp.Builder
```

<br />

*** ** * ** ***

Builder for `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp`

## Summary

| ### Public constructors |
|---|
| `[Builder](https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder())()` **This method is deprecated.** use `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String)` <br /> |
| `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/String.html staticValue)` Creates an instance of `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder` from the given static value. |

| ### Public methods |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp` | `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#build()()` Builds an instance from accumulated values. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder` | `@https://developer.android.com/reference/androidx/wear/protolayout/expression/RequiresSchemaVersion(major = 1, minor = 200) https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setDynamicValue(androidx.wear.protolayout.expression.DynamicBuilders.DynamicString)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/wear/protolayout/expression/DynamicBuilders.DynamicString dynamicValue)` Sets the dynamic value. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder` | `@https://developer.android.com/reference/androidx/wear/protolayout/expression/RequiresSchemaVersion(major = 1, minor = 0) https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setValue(java.lang.String)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/java/lang/String.html value)` Sets the static value. |

## Public constructors

### Builder

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0) Deprecated in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

```
public [Builder](https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> use `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String)`

Creates an instance of `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder`.

### Builder

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

```
public Builder(@NonNull String staticValue)
```

Creates an instance of `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder` from the given static value. `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setDynamicValue(androidx.wear.protolayout.expression.DynamicBuilders.DynamicString)` can be used to provide a dynamic value.

## Public methods

### build

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

```
public @NonNull TypeBuilders.StringProp build()
```

Builds an instance from accumulated values.

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException.html` | if a dynamic value is set using `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setDynamicValue(androidx.wear.protolayout.expression.DynamicBuilders.DynamicString)` but neither `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String)` nor `https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setValue(java.lang.String)` is used to provide a static value. |

### setDynamicValue

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

```
@RequiresSchemaVersion(major = 1, minor = 200)
public @NonNull TypeBuilders.StringProp.Builder setDynamicValue(@NonNull DynamicBuilders.DynamicString dynamicValue)
```

Sets the dynamic value. Note that when setting this value, the static value is still required to be set to support older renderers that only read the static value. If `dynamicValue` has an invalid result, the provided static value will be used instead.

### setValue

Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/wear-protolayout#1.0.0)

```
@RequiresSchemaVersion(major = 1, minor = 0)
public @NonNull TypeBuilders.StringProp.Builder setValue(@NonNull String value)
```

Sets the static value. If a dynamic value is also set and the renderer supports dynamic values for the corresponding field, this static value will be ignored. If the static value is not specified, `null` will be used instead.