DragAndDrop core

Lattice.Core.DragDrop/Abstractions/IAsyncDragSource.cs

@@ -0,0 +1,28 @@
+namespace Lattice.Core.DragDrop.Abstractions;
+
+/// <summary>
+/// Определяет контракт для объектов, которые могут быть источником данных
+/// в операции перетаскивания с поддержкой асинхронных операций.
+/// </summary>
+public interface IAsyncDragSource : IDragSource
+{
+    /// <summary>
+    /// Определяет, может ли объект начать операцию перетаскивания (асинхронно).
+    /// </summary>
+    Task<(bool CanStart, Models.DragInfo? DragInfo)> CanStartDragAsync();
+
+    /// <summary>
+    /// Начинает операцию перетаскивания (асинхронно).
+    /// </summary>
+    Task<bool> StartDragAsync(Models.DragInfo dragInfo);
+
+    /// <summary>
+    /// Вызывается при завершении операции перетаскивания (асинхронно).
+    /// </summary>
+    Task DragCompletedAsync(Models.DragInfo dragInfo, Enums.DragDropEffects effects);
+
+    /// <summary>
+    /// Вызывается при отмене операции перетаскивания (асинхронно).
+    /// </summary>
+    Task DragCancelledAsync(Models.DragInfo dragInfo);
+}

Lattice.Core.DragDrop/Abstractions/IAsyncDropTarget.cs

@@ -0,0 +1,28 @@
+namespace Lattice.Core.DragDrop.Abstractions;
+
+/// <summary>
+/// Определяет контракт для объектов, которые могут принимать сбрасываемые данные
+/// в операции перетаскивания с поддержкой асинхронных операций.
+/// </summary>
+public interface IAsyncDropTarget : IDropTarget
+{
+    /// <summary>
+    /// Определяет, может ли объект принять сбрасываемые данные (асинхронно).
+    /// </summary>
+    Task<bool> CanAcceptDropAsync(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда перетаскиваемый объект находится над целью (асинхронно).
+    /// </summary>
+    Task DragOverAsync(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда пользователь сбрасывает данные на цель (асинхронно).
+    /// </summary>
+    Task DropAsync(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда перетаскиваемый объект покидает область цели (асинхронно).
+    /// </summary>
+    Task DragLeaveAsync();
+}

Lattice.Core.DragDrop/Abstractions/IDragSource.cs

@@ -0,0 +1,64 @@
+namespace Lattice.Core.DragDrop.Abstractions;
+
+/// <summary>
+/// Определяет контракт для объектов, которые могут быть источником данных
+/// в операции перетаскивания.
+/// </summary>
+/// <remarks>
+/// Объекты, реализующие этот интерфейс, могут инициировать операции перетаскивания
+/// и предоставлять данные для передачи другим элементам через механизм drag-and-drop.
+/// </remarks>
+public interface IDragSource
+{
+    /// <summary>
+    /// Определяет, может ли объект начать операцию перетаскивания.
+    /// </summary>
+    /// <param name="dragInfo">
+    /// Информация о перетаскивании, которая будет заполнена данными, если операция разрешена.
+    /// </param>
+    /// <returns>
+    /// true, если объект может начать перетаскивание; в противном случае — false.
+    /// </returns>
+    /// <remarks>
+    /// Этот метод вызывается системой перетаскивания для проверки возможности
+    /// начала операции. Если метод возвращает true, он должен заполнить
+    /// <paramref name="dragInfo"/> необходимыми данными.
+    /// </remarks>
+    bool CanStartDrag(out Models.DragInfo? dragInfo);
+
+    /// <summary>
+    /// Начинает операцию перетаскивания.
+    /// </summary>
+    /// <param name="dragInfo">Информация о перетаскивании.</param>
+    /// <returns>
+    /// true, если операция перетаскивания успешно начата; в противном случае — false.
+    /// </returns>
+    /// <remarks>
+    /// Этот метод вызывается, когда пользователь начинает перетаскивание элемента.
+    /// Реализация должна подготовить данные для перетаскивания и, возможно,
+    /// создать визуальное представление перетаскиваемого объекта.
+    /// </remarks>
+    bool StartDrag(Models.DragInfo dragInfo);
+
+    /// <summary>
+    /// Вызывается при завершении операции перетаскивания.
+    /// </summary>
+    /// <param name="dragInfo">Исходная информация о перетаскивании.</param>
+    /// <param name="effects">Эффекты, которые были применены при сбросе.</param>
+    /// <remarks>
+    /// Этот метод вызывается после завершения операции перетаскивания
+    /// (успешного или неуспешного). Реализация может выполнить очистку
+    /// или обновить состояние на основе результата операции.
+    /// </remarks>
+    void DragCompleted(Models.DragInfo dragInfo, Enums.DragDropEffects effects);
+
+    /// <summary>
+    /// Вызывается при отмене операции перетаскивания.
+    /// </summary>
+    /// <param name="dragInfo">Исходная информация о перетаскивании.</param>
+    /// <remarks>
+    /// Этот метод вызывается, когда операция перетаскивания была отменена
+    /// пользователем (например, нажатием клавиши Escape).
+    /// </remarks>
+    void DragCancelled(Models.DragInfo dragInfo);
+}

Lattice.Core.DragDrop/Abstractions/IDropTarget.cs

@@ -0,0 +1,55 @@
+namespace Lattice.Core.DragDrop.Abstractions;
+
+/// <summary>
+/// Определяет контракт для объектов, которые могут принимать сбрасываемые данные
+/// в операции перетаскивания.
+/// </summary>
+/// <remarks>
+/// Объекты, реализующие этот интерфейс, могут обрабатывать данные, сброшенные
+/// пользователем, и предоставлять визуальную обратную связь во время перетаскивания.
+/// </remarks>
+public interface IDropTarget
+{
+    /// <summary>
+    /// Определяет, может ли объект принять сбрасываемые данные.
+    /// </summary>
+    /// <param name="dropInfo">Информация о потенциальном сбросе.</param>
+    /// <returns>
+    /// true, если объект может принять данные; в противном случае — false.
+    /// </returns>
+    /// <remarks>
+    /// Этот метод вызывается, когда перетаскиваемый объект находится над целью.
+    /// Реализация должна проверить, совместимы ли данные с целью, и установить
+    /// предлагаемые эффекты в <paramref name="dropInfo"/>.
+    /// </remarks>
+    bool CanAcceptDrop(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда перетаскиваемый объект находится над целью.
+    /// </summary>
+    /// <param name="dropInfo">Информация о текущем положении перетаскивания.</param>
+    /// <remarks>
+    /// Этот метод вызывается постоянно, пока пользователь перемещает объект над целью.
+    /// Реализация может обновить визуальную обратную связь или изменить предлагаемые эффекты.
+    /// </remarks>
+    void DragOver(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда пользователь сбрасывает данные на цель.
+    /// </summary>
+    /// <param name="dropInfo">Информация о сбросе.</param>
+    /// <remarks>
+    /// Этот метод вызывается, когда пользователь отпускает кнопку мыши над целью.
+    /// Реализация должна обработать принятие данных и выполнить соответствующее действие.
+    /// </remarks>
+    void Drop(Models.DropInfo dropInfo);
+
+    /// <summary>
+    /// Вызывается, когда перетаскиваемый объект покидает область цели.
+    /// </summary>
+    /// <remarks>
+    /// Этот метод вызывается, когда пользователь перемещает объект за пределы цели.
+    /// Реализация должна очистить любую визуальную обратную связь, установленную ранее.
+    /// </remarks>
+    void DragLeave();
+}