# TypeBuilders.StringProp.Builder

# 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)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/wear/protolayout/TypeBuilders.StringProp.Builder "View this page in Java")

<br />

```
class TypeBuilders.StringProp.Builder
```

<br />

*** ** * ** ***

Builder for[StringProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp)

## Summary

|                                                                                                                                                                                                 ### Public constructors                                                                                                                                                                                                 |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ~~[Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder())~~`()` **This function is deprecated.** use[Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String)) <br />                                                                                          |
| [Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String))`(staticValue: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` Creates an instance of[Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder)from the given static value. |

|                                                            ### Public functions                                                             |
|---------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [TypeBuilders.StringProp](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp)                 | [build](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#build())`()` Builds an instance from accumulated values.                                                                                                                                                                                                                                                                                                                                                                                                     |
| [TypeBuilders.StringProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder) | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 200)` [setDynamicValue](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setDynamicValue(androidx.wear.protolayout.expression.DynamicBuilders.DynamicString))`(dynamicValue: `[DynamicBuilders.DynamicString](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/DynamicBuilders.DynamicString)`)` Sets the dynamic value. |
| [TypeBuilders.StringProp.Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder) | `@`[RequiresSchemaVersion](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/expression/RequiresSchemaVersion)`(major = 1, minor = 0)` [setValue](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setValue(java.lang.String))`(value: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`)` 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)  

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

Creates an instance of[Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder).  

### Builder

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

```
Builder(staticValue: String)
```

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

## Public functions

### build

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

```
fun build(): TypeBuilders.StringProp
```

Builds an instance from accumulated values.  

|                                                     Throws                                                      |
|-----------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [java.lang.IllegalStateException](https://developer.android.com/reference/java/lang/IllegalStateException.html) | if a dynamic value is set using[setDynamicValue](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#setDynamicValue(androidx.wear.protolayout.expression.DynamicBuilders.DynamicString))but neither[Builder](https://developer.android.com/reference/kotlin/androidx/wear/protolayout/TypeBuilders.StringProp.Builder#Builder(java.lang.String))nor[setValue](https://developer.android.com/reference/kotlin/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)
fun setDynamicValue(dynamicValue: DynamicBuilders.DynamicString): TypeBuilders.StringProp.Builder
```

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)
fun setValue(value: String): TypeBuilders.StringProp.Builder
```

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.