# DeviceActions

*** ** * ** ***


```
public final class DeviceActions
```

<br />

*** ** * ** ***

## Summary

| ### Public methods |
|---|---|
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setBookMode()()` Set device screen to be folded with the hinge in the vertical position. |
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setClosedMode()()` Set device screen to be closed. |
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setDisplaySize(androidx.test.espresso.device.sizeclass.WidthSizeClass,androidx.test.espresso.device.sizeclass.HeightSizeClass)( @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/sizeclass/WidthSizeClass widthSizeClass, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/sizeclass/HeightSizeClass heightSizeClass )` Set device's window size. |
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setFlatMode()()` Set device screen to be completely flat, like a tablet. |
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setScreenOrientation(androidx.test.espresso.device.action.ScreenOrientation)(@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/ScreenOrientation orientation)` Set device's screen orientation. |
| `static final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceAction` | `https://developer.android.com/reference/androidx/test/espresso/device/action/DeviceActions#setTabletopMode()()` Set device screen to be folded with the hinge in the horizontal position. |

## Public methods

### setBookMode

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setBookMode)

```
public static final @NonNull DeviceAction setBookMode()
```

Set device screen to be folded with the hinge in the vertical position. For details on foldable postures, see https://developer.android.com/guide/topics/large-screens/learn-about-foldables#foldable_postures

This action is for foldable devices only. Currently only supported for tests run on Android Emulators.

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/test/platform/device/UnsupportedDeviceOperationException` | if used on a real device. |
| `https://developer.android.com/reference/androidx/test/espresso/device/controller/DeviceControllerOperationException` | when called on a non-foldable Emulator. |

### setClosedMode

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setClosedMode)

```
public static final @NonNull DeviceAction setClosedMode()
```

Set device screen to be closed.

This action is for foldable devices only. Currently only supported for tests run on Android Emulators.

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/test/platform/device/UnsupportedDeviceOperationException` | if used on a real device. |
| `https://developer.android.com/reference/androidx/test/espresso/device/controller/DeviceControllerOperationException` | when called on a non-foldable Emulator. |

### setDisplaySize

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setDisplaySize)

```
public static final @NonNull DeviceAction setDisplaySize(
    @NonNull WidthSizeClass widthSizeClass,
    @NonNull HeightSizeClass heightSizeClass
)
```

Set device's window size.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/sizeclass/WidthSizeClass widthSizeClass` | the window width to set the device to |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/sizeclass/HeightSizeClass heightSizeClass` | the window height to set the device to |

### setFlatMode

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setFlatMode)

```
public static final @NonNull DeviceAction setFlatMode()
```

Set device screen to be completely flat, like a tablet. For details on foldable postures, see https://developer.android.com/guide/topics/large-screens/learn-about-foldables#foldable_postures

This action is for foldable devices only. Currently only supported for tests run on Android Emulators.

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/test/platform/device/UnsupportedDeviceOperationException` | if used on a real device. |
| `https://developer.android.com/reference/androidx/test/espresso/device/controller/DeviceControllerOperationException` | when called on a non-foldable Emulator. |

### setScreenOrientation

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setScreenOrientation)

```
public static final @NonNull DeviceAction setScreenOrientation(@NonNull ScreenOrientation orientation)
```

Set device's screen orientation.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/test/espresso/device/action/ScreenOrientation orientation` | the orientation to set the device to (portait or landscape) |

### setTabletopMode

Artifact: [androidx.test.espresso:espresso-device](https://developer.android.com/jetpack/androidx/releases/test-espresso) [View Source](https://cs.android.com/search?q=file:androidx/test/espresso/device/action/DeviceActions.kt+function:setTabletopMode)

```
public static final @NonNull DeviceAction setTabletopMode()
```

Set device screen to be folded with the hinge in the horizontal position. For details on foldable postures, see https://developer.android.com/guide/topics/large-screens/learn-about-foldables#foldable_postures

This action is for foldable devices only. Currently only supported for tests run on Android Emulators.

| Throws |
|---|---|
| `https://developer.android.com/reference/androidx/test/platform/device/UnsupportedDeviceOperationException` | if used on a real device. |
| `https://developer.android.com/reference/androidx/test/espresso/device/controller/DeviceControllerOperationException` | when called on a non-foldable Emulator. |