cutout

fun Modifier.cutout(shape: Shape = CircleShape, padding: PaddingValues = PaddingValues(horizontal = 3.dp, vertical = 3.dp), enabled: Boolean = true, state: CutoutState? = null): Modifier

Регистрирует composable как источник выреза для ближайшей cutout-цели.

Модификатор отслеживает фактические координаты composable после layout и передаёт их в общее CutoutState. Цель, отмеченная Modifier.cutoutTarget, использует эти данные, чтобы вырезать отверстие точно по текущим bounds элемента.

Типичный сценарий использования:

  • базовый компонент рисуется с Modifier.cutoutTarget

  • overlay-элемент рисуется поверх него

  • overlay-элемент получает Modifier.cutout, чтобы его границы превратились в вырез

Параметр shape определяет форму отверстия, а padding позволяет сделать вырез чуть больше самого overlay-элемента.

Если state не передан явно, будет использовано значение из ProvideCutoutState. Если состояние недоступно, модификатор не оказывает эффекта.

Parameters

shape

форма вырезаемой области

padding

дополнительное расширение выреза по горизонтали и вертикали

enabled

включает или выключает регистрацию выреза

state

состояние cutout-системы; по умолчанию берётся из локального контекста