Открыть диалог из скрипта

IDialogWindowUnstableScriptingApi создаёт Blazor-окно для Razor-компонента. API экспериментальный. Здесь описан контракт EyeAuras 20fd3d4 / PoeEye 0e02c98; старые копии интерфейса с ShowTitleBar и ViewDataContext не подходят для этого среза.

Показать окно и дождаться закрытия

В проект C# Script добавьте файл HelloDialog.razor с публичным компонентом в namespace MyScript:

@namespace MyScript
<h3>Привет из EyeAuras</h3>
<p>Закройте окно крестиком, чтобы продолжить скрипт.</p>

Верхнеуровневый код скрипта выполняется в desktop EyeAuras, где UI-модуль регистрирует dialog API и фабрику IBlazorWindow. Ссылка на assembly сама эти сервисы не создаёт.

using EyeAuras.Shared.Scripting;

{
    var dialogs = GetService<IDialogWindowUnstableScriptingApi>();
    using var window = dialogs.CreateWindow<MyScript.HelloDialog>();
    window.Title = "Пример диалога";
    window.Width = 400;
    window.Height = 300;
    window.ShowDialog(cancellationToken);
    Log.Info("Ожидание диалога завершено");
}

Появится окно с текстом компонента. ShowDialog ждёт его закрытия; реализация WPF поддерживает обработку сообщений dispatcher во время ожидания. Отмена токена обрабатывается внутри этого метода: не рассчитывайте обязательно получить OperationCanceledException снаружи. using освобождает окно и при выходе из скрипта по исключению.

CreateWindow<T>(object dataContext = default) задаёт ViewType, DataContext и AutoOwner = false. Окно также добавляется в ресурсы API. Это не обещает автоматического назначения владельца другому окну приложения. Для немодального окна используйте Show(), но сохраняйте окно живым до завершения работы: using вокруг одного Show() сразу завершит его время жизни.

Передать модель в компонент

Покажем модель в немодальном окне и оставим скрипт работать до его закрытия. Добавьте в тот же проект обычный файл WindowStatus.cs:

namespace MyScript;

public sealed class WindowStatus
{
    public string Text { get; init; }
}

Компонент StatusPanel.razor получает именно эту модель через DataContext:

@namespace MyScript
@using PoeShared.Blazor
@inherits BlazorReactiveComponent<WindowStatus>

@if (DataContext != null)
{
    <p>@DataContext.Text</p>
}

Верхнеуровневый Script.csx создаёт модель и окно, подписывается на закрытие до показа, затем ожидает событие:

using System;
using System.Reactive.Linq;
using System.Reactive.Threading.Tasks;
using EyeAuras.Shared.Scripting;

{
    var runToken = cancellationToken;
    var dialogs = GetService<IDialogWindowUnstableScriptingApi>();
    var model = new MyScript.WindowStatus { Text = "Окно готово" };
    using var window = dialogs.CreateWindow<MyScript.StatusPanel>(model);
    window.Title = "Состояние";
    window.Width = 400;
    window.Height = 240;

    var closed = window.WhenClosed.Take(1).ToTask(runToken);
    window.Show();
    try
    {
        await closed;
        Log.Info("Окно закрыто");
    }
    catch (OperationCanceledException) when (runToken.IsCancellationRequested)
    {
        Log.Info("Показ окна остановлен");
    }
}

В окне появится «Окно готово». Крестик завершает ожидание; остановка скрипта отменяет его. Take(1) завершает подписку после первого закрытия, а токен прерывает её при остановке. using освобождает окно в обоих случаях. Show() возвращает управление сразу, поэтому один вызов без последующего ожидания не задаёт длительность работы скрипта. Hide() не выдаёт закрытие.

Модель здесь неизменяема после создания. Для изменяемого состояния нужны уведомления и обновление UI — см. Blazor. Модель не становится глобальной переменной Razor. ViewDataContext — устаревший псевдоним; используйте DataContext.

Свойства, события, нативные координаты и ограничения окна — в IBlazorWindow. Для выбора файла из Razor нужны отдельные обёртки нативных диалогов, описанные в карте Blazor Windows.