# Dimension

Artifact: [androidx.constraintlayout:constraintlayout-core](https://developer.android.com/jetpack/androidx/releases/constraintlayout) [View Source](https://cs.android.com/search?q=file:androidx/constraintlayout/core/state/Dimension.java+class:androidx.constraintlayout.core.state.Dimension) Added in [1.1.2](https://developer.android.com/jetpack/androidx/releases/constraintlayout#1.1.2)

*** ** * ** ***


```
class Dimension
```

<br />

*** ** * ** ***

Represents a dimension (width or height) of a constrained widget

## Summary

| ### Nested types |
|---|
| `enum https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension.Type` |

| ### Constants |
|---|---|
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#FIXED_DIMENSION()` |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#PARENT_DIMENSION()` |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#PERCENT_DIMENSION()` |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#RATIO_DIMENSION()` |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#SPREAD_DIMENSION()` |
| `const https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#WRAP_DIMENSION()` |

| ### Public functions |
|---|---|
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Fixed](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Fixed(java.lang.Object))(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(java.lang.Object)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Fixed](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Fixed(int))(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(int)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Parent](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Parent())()` **This function is deprecated.** Use createParent instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Percent](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Percent(java.lang.Object,float))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createPercent(java.lang.Object,float)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Ratio](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Ratio(java.lang.String))(ratio: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createRatio(java.lang.String)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Spread](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Spread())()` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSpread()` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Suggested](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Suggested(java.lang.Object))(startValue: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(java.lang.Object)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Suggested](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Suggested(int))(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(int)` instead <br /> |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `[Wrap](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Wrap())()` **This function is deprecated.** Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createWrap()` instead <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#apply(androidx.constraintlayout.core.state.State,androidx.constraintlayout.core.widgets.ConstraintWidget,int)(state: https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/State!, constraintWidget: https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/widgets/ConstraintWidget!, orientation: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Apply the dimension to the given constraint widget |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(java.lang.Object)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createParent()()` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createPercent(java.lang.Object,float)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createRatio(java.lang.String)(ratio: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSpread()()` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(java.lang.Object)(startValue: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `java-static https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createWrap()()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#equalsFixedValue(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` Returns true if the dimension is a fixed dimension of the same given value |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#fixed(java.lang.Object)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#fixed(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#max(java.lang.Object)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#max(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#min(java.lang.Object)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#min(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#percent(java.lang.Object,float)(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#ratio(java.lang.String)(ratio: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#suggested(java.lang.Object)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)` |
| `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension!` | `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#suggested(int)(value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)` |

## Constants

### FIXED_DIMENSION

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

```
const val FIXED_DIMENSION: Any!
```

### PARENT_DIMENSION

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

```
const val PARENT_DIMENSION: Any!
```

### PERCENT_DIMENSION

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

```
const val PERCENT_DIMENSION: Any!
```

### RATIO_DIMENSION

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

```
const val RATIO_DIMENSION: Any!
```

### SPREAD_DIMENSION

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

```
const val SPREAD_DIMENSION: Any!
```

### WRAP_DIMENSION

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

```
const val WRAP_DIMENSION: Any!
```

## Public functions

### Fixed

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

```
java-static fun [Fixed](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Fixed(java.lang.Object))(value: Any!): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(java.lang.Object)` instead

### Fixed

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

```
java-static fun [Fixed](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Fixed(int))(value: Int): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createFixed(int)` instead

### Parent

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

```
java-static fun [Parent](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Parent())(): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use createParent instead

### Percent

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

```
java-static fun [Percent](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Percent(java.lang.Object,float))(key: Any!, value: Float): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createPercent(java.lang.Object,float)` instead

### Ratio

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

```
java-static fun [Ratio](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Ratio(java.lang.String))(ratio: String!): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createRatio(java.lang.String)` instead

### Spread

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

```
java-static fun [Spread](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Spread())(): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSpread()` instead

### Suggested

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

```
java-static fun [Suggested](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Suggested(java.lang.Object))(startValue: Any!): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(java.lang.Object)` instead

### Suggested

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

```
java-static fun [Suggested](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Suggested(int))(value: Int): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createSuggested(int)` instead

### Wrap

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

```
java-static fun [Wrap](https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#Wrap())(): Dimension!
```

> [!CAUTION]
> **This function is deprecated.**   
>
> Use `https://developer.android.com/reference/kotlin/androidx/constraintlayout/core/state/Dimension#createWrap()` instead

### apply

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

```
fun apply(state: State!, constraintWidget: ConstraintWidget!, orientation: Int): Unit
```

Apply the dimension to the given constraint widget

### createFixed

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

```
java-static fun createFixed(value: Any!): Dimension!
```

### createFixed

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

```
java-static fun createFixed(value: Int): Dimension!
```

### createParent

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

```
java-static fun createParent(): Dimension!
```

### createPercent

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

```
java-static fun createPercent(key: Any!, value: Float): Dimension!
```

### createRatio

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

```
java-static fun createRatio(ratio: String!): Dimension!
```

### createSpread

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

```
java-static fun createSpread(): Dimension!
```

### createSuggested

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

```
java-static fun createSuggested(startValue: Any!): Dimension!
```

### createSuggested

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

```
java-static fun createSuggested(value: Int): Dimension!
```

### createWrap

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

```
java-static fun createWrap(): Dimension!
```

### equalsFixedValue

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

```
fun equalsFixedValue(value: Int): Boolean
```

Returns true if the dimension is a fixed dimension of the same given value

### fixed

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

```
fun fixed(value: Any!): Dimension!
```

### fixed

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

```
fun fixed(value: Int): Dimension!
```

### max

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

```
fun max(value: Any!): Dimension!
```

### max

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

```
fun max(value: Int): Dimension!
```

### min

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

```
fun min(value: Any!): Dimension!
```

### min

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

```
fun min(value: Int): Dimension!
```

### percent

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

```
fun percent(key: Any!, value: Float): Dimension!
```

### ratio

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

```
fun ratio(ratio: String!): Dimension!
```

### suggested

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

```
fun suggested(value: Any!): Dimension!
```

### suggested

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

```
fun suggested(value: Int): Dimension!
```