Управление окнами верхнего уровня

Добавление условий

Открывать и закрывать окна можно также с помощью простых условий if. В следующем примере кода окно приложения автоматически закрывается после выполнения задачи:

Запрос подтверждения при закрытии

Если при выходе из приложения нужно выполнить пользовательскую логику, например показать диалоговое окно, можно переопределить действие закрытия с помощью обратного вызова onCloseRequest. В следующем примере вместо императивного подхода (window.close()) используется декларативный: окно закрывается в ответ на изменение состояния (isOpen = false).

Подгонка размера окна под его содержимое

Чтобы задать размер окна в соответствии с его содержимым, не указывая размеры заранее, задайте для одного или обоих измерений окна значение Dp.Unspecified. Compose Multiplatform автоматически подберёт исходный размер окна по его содержимому:

Отслеживание изменений состояния

Чтобы реагировать на изменения состояния и передавать значение в часть приложения, не являющуюся composable-функцией (например, для записи в базу данных), можно использовать функцию snapshotFlow(). Эта функция фиксирует текущее значение состояния composable-функции.

Задание состояния и наблюдение за ним

API v2 явно отделяет задание желаемого состояния от наблюдения за фактическим состоянием.

Чтобы задать начальное состояние окна, передайте поставщики в rememberWindowState():

Чтобы запросить изменение состояния после создания окна, вызовите соответствующий метод у WindowState. Точный размер и положение можно задать напрямую:

windowState.requestScreen { defaultScreen }
windowState.requestSize(DpSize(1024.dp, 768.dp))
windowState.requestPosition(DpOffset(100.dp, 100.dp))

Для относительного позиционирования или динамического вычисления размеров используйте поставщики:

windowState.requestBounds(
    WindowBoundsProvider(
        positionProvider = WindowPositionProvider.CenteredOnScreen,
        sizeProvider = WindowSizeProvider.Fixed(DpSize(1024.dp, 768.dp))
    )
)

Запрос применяется асинхронно. Оконная система может изменить запрошенное состояние, а фактическое состояние может измениться позднее, например при перемещении окна или изменении его размера. Наблюдать за фактическим состоянием окна можно с помощью WindowState.screenId и WindowState.bounds:

if (windowState.isInitialized) {
    Text("Current screen: ${windowState.screenId}")
    Text("Current bounds: ${windowState.bounds}")
}

Та же асинхронная модель доступна для диалоговых окон через DialogState и rememberDialogState().

Выбор экрана

Можно запросить отображение окна на определённом экране, передав initialScreenProvider в rememberWindowState() или вызвав WindowState.requestScreen() позднее. Наблюдать за экраном, на котором фактически размещено окно, можно через WindowState.screenId.

Например, можно запросить размещение окна на экране с доступной шириной не менее 1024.dp, указав экран по умолчанию в качестве запасного варианта:

windowState.requestScreen {
    screens.firstOrNull { it.availableBounds.width >= 1024.dp }
        ?: defaultScreen
}

Задание положения

Чтобы изменить положение окна, передайте initialBoundsProvider в rememberWindowState() или вызовите WindowState.requestBounds() позднее. Наблюдать за фактическими границами окна можно через WindowState.bounds.

API v2 использует WindowPositionProvider для получения информации об экране и геометрии родительского окна.

Для стандартного размещения можно использовать встроенные свойства:

• Default применяет стандартное поведение каскадного размещения операционной системы.

• Current сохраняет текущее положение окна.

• CenteredOnScreen размещает окно по центру экрана.

• CenteredInParentWindow размещает окно по центру родительского окна.

Для более гибкой настройки используйте функции-поставщики положения:

• Absolute() размещает начальный угол окна по заданным координатам x и y.

• AlignedToScreen() выравнивает окно относительно экрана и включает необязательный параметр смещения.

  WindowPositionProvider.AlignedToScreen(
      alignment = Alignment.Center,
      offset = DpOffset(x = 16.dp, y = 16.dp)
  )
  

• AlignedToParentWindow() привязывает окно к родительскому окну и обычно используется для диалоговых окон.

  WindowPositionProvider.AlignedToParentWindow(
      // Anchors to the starting corner of the parent window
      anchor = Alignment.TopStart,
      // Applies alignment relative to the anchor point
      alignment = Alignment.Center
  )
  

Задание размера

Размер также входит в границы окна, поэтому он настраивается с помощью того же механизма initialBoundsProvider/WindowState.requestBounds().

API v2 использует WindowSizeProvider для получения информации о размерах экрана и родительского окна, а также для запроса у содержимого окна его естественных размеров.

К часто используемым встроенным параметрам относятся Fixed() для задания определённого размера окна и Default для стандартного размера 800×600 dp.

Для настройки размера пользовательская лямбда WindowSizeProvider() получает доступ к параметрам экрана, а для диалоговых окон — к параметрам родительского окна:

WindowSizeProvider {
    val height = parentWindowMetrics!!.bounds.height
    DpSize(300.dp, height)
}

API v2 поддерживает один из часто запрашиваемых сценариев: задание размера окна в соответствии с предпочтительным размером его содержимого с возможностью заполнения содержимым всего окна, если пользователь увеличит его. WindowSizeProvider.Unconstrained вычисляет размер содержимого, добавляет отступы окна и ограничивает результат доступным размером экрана. Поскольку размер задаётся независимо от компоновки, содержимое с fillMaxSize() всё равно расширяется, заполняя окно, если пользователь меняет его размер.

WindowBoundsProvider(
    positionProvider = WindowPositionProvider.CenteredOnScreen,
    sizeProvider = WindowSizeProvider.Unconstrained
)

Версии компонуемых функций Window() и DialogWindow() для API v2 принимают параметры minSize и maxSize. Если базовый диспетчер окон поддерживает такую возможность, пользователь не сможет изменить размер окна за пределы этих границ:

DialogWindow(
    onCloseRequest = { showDialog = false },
    state = dialogState,
    minSize = DpSize(250.dp, 250.dp),
    maxSize = DpSize(500.dp, 500.dp)
) {
    // ...
}