доработана winUI реализация
This commit is contained in:
@@ -1,7 +1,8 @@
|
||||
using Lattice.Core.DragDrop.Abstractions;
|
||||
using Lattice.Core.DragDrop.Models;
|
||||
using Lattice.Core.DragDrop.Models;
|
||||
using Lattice.Core.DragDrop.Services;
|
||||
using Lattice.Core.Geometry;
|
||||
using Lattice.UI.DragDrop.Abstractions;
|
||||
using Lattice.UI.DragDrop.Behaviors;
|
||||
using Lattice.UI.DragDrop.WinUI.Services;
|
||||
using Microsoft.UI.Xaml;
|
||||
using Microsoft.UI.Xaml.Input;
|
||||
@@ -13,29 +14,54 @@ namespace Lattice.UI.DragDrop.WinUI.Behaviors;
|
||||
|
||||
/// <summary>
|
||||
/// Реализация поведения источника перетаскивания для элементов WinUI.
|
||||
/// Наследуется от <see cref="DragSourceBehaviorBase{FrameworkElement}"/> для использования
|
||||
/// общей логики управления операциями перетаскивания и интеграции с системой <see cref="Core.DragDrop"/>.
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// Этот класс обрабатывает события мыши/тач и преобразует их в операции перетаскивания.
|
||||
/// Он реализует интерфейс <see cref="IDragSource"/> для интеграции с системой перетаскивания.
|
||||
/// Этот класс предоставляет конкретную реализацию для платформы WinUI, обрабатывая события
|
||||
/// указателя (мышь, тач, перо) и преобразуя их в операции перетаскивания через центральный
|
||||
/// сервис <see cref="IDragDropService"/>.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Поведение автоматически отслеживает начало перемещения мыши, проверяет порог
|
||||
/// перетаскивания и инициирует операцию через <see cref="IDragDropService"/>.
|
||||
/// Основные функции:
|
||||
/// <list type="bullet">
|
||||
/// <item>Обработка событий PointerPressed, PointerMoved, PointerReleased</item>
|
||||
/// <item>Автоматическое отслеживание порога начала перетаскивания</item>
|
||||
/// <item>Создание информации о перетаскивании на основе данных элемента</item>
|
||||
/// <item>Интеграция с визуальной обратной связью через <see cref="WinUIDragDropHost"/></item>
|
||||
/// <item>Преобразование координат между локальной системой элемента и экранными координатами</item>
|
||||
/// </list>
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Для использования необходимо:
|
||||
/// <list type="number">
|
||||
/// <item>Создать экземпляр поведения через фабрику <see cref="Factories.WinUIDragDropFactory.CreateDragSourceBehavior"/></item>
|
||||
/// <item>Прикрепить к элементу с помощью метода <see cref="Attach"/></item>
|
||||
/// <item>Указать данные для перетаскивания (опционально, по умолчанию используется DataContext)</item>
|
||||
/// </list>
|
||||
/// </para>
|
||||
/// <example>
|
||||
/// <code>
|
||||
/// // Создание поведения
|
||||
/// var behavior = WinUIDragDropFactory.CreateDragSourceBehavior(dragDropService, host);
|
||||
///
|
||||
/// // Прикрепление к элементу
|
||||
/// behavior.Attach(myElement, myData);
|
||||
///
|
||||
/// // Или через attached properties
|
||||
/// <Border x:Name="DragElement"
|
||||
/// local:DragDropProperties.IsDragSource="True"
|
||||
/// local:DragDropProperties.DragData="{Binding MyData}" />
|
||||
/// </code>
|
||||
/// </example>
|
||||
/// </remarks>
|
||||
public sealed class WinUIDragSourceBehavior : IDragSource
|
||||
public sealed class WinUIDragSourceBehavior : DragSourceBehaviorBase<FrameworkElement>
|
||||
{
|
||||
#region Поля
|
||||
|
||||
private readonly IDragDropService _dragDropService;
|
||||
private readonly WinUIDragDropHost _host;
|
||||
|
||||
private FrameworkElement? _element;
|
||||
private readonly IDragDropHost _host;
|
||||
private object? _dragData;
|
||||
private Point _dragStartPosition;
|
||||
private bool _isDragging;
|
||||
private CancellationTokenSource? _cancellationTokenSource;
|
||||
|
||||
#endregion
|
||||
|
||||
@@ -44,14 +70,27 @@ public sealed class WinUIDragSourceBehavior : IDragSource
|
||||
/// <summary>
|
||||
/// Инициализирует новый экземпляр класса <see cref="WinUIDragSourceBehavior"/>.
|
||||
/// </summary>
|
||||
/// <param name="dragDropService">Сервис для управления операциями перетаскивания.</param>
|
||||
/// <param name="host">Хост для отображения визуальных элементов.</param>
|
||||
/// <param name="dragDropService">
|
||||
/// Сервис управления операциями перетаскивания. Используется для координации
|
||||
/// между источниками и целями перетаскивания.
|
||||
/// </param>
|
||||
/// <param name="host">
|
||||
/// Хост для управления визуальными элементами перетаскивания. Обеспечивает
|
||||
/// отображение визуальной обратной связи во время операции.
|
||||
/// </param>
|
||||
/// <exception cref="ArgumentNullException">
|
||||
/// Выбрасывается, если любой из параметров равен null.
|
||||
/// Выбрасывается, если <paramref name="dragDropService"/> или <paramref name="host"/>
|
||||
/// равны null.
|
||||
/// </exception>
|
||||
public WinUIDragSourceBehavior(IDragDropService dragDropService, WinUIDragDropHost host)
|
||||
/// <remarks>
|
||||
/// Конструктор инициализирует базовый класс <see cref="DragSourceBehaviorBase{FrameworkElement}"/>
|
||||
/// и сохраняет ссылки на необходимые сервисы для последующего использования.
|
||||
/// </remarks>
|
||||
public WinUIDragSourceBehavior(
|
||||
Core.DragDrop.Services.IDragDropService dragDropService,
|
||||
WinUIDragDropHost host)
|
||||
: base(dragDropService)
|
||||
{
|
||||
_dragDropService = dragDropService ?? throw new ArgumentNullException(nameof(dragDropService));
|
||||
_host = host ?? throw new ArgumentNullException(nameof(host));
|
||||
}
|
||||
|
||||
@@ -60,207 +99,202 @@ public sealed class WinUIDragSourceBehavior : IDragSource
|
||||
#region Публичные методы
|
||||
|
||||
/// <summary>
|
||||
/// Прикрепляет поведение к указанному элементу.
|
||||
/// Прикрепляет поведение к указанному элементу WinUI.
|
||||
/// </summary>
|
||||
/// <param name="element">Элемент, к которому прикрепляется поведение.</param>
|
||||
/// <param name="dragData">Данные для перетаскивания. Если не указано, используются
|
||||
/// DataContext или Tag элемента.</param>
|
||||
/// <param name="element">
|
||||
/// Элемент <see cref="FrameworkElement"/>, который должен стать источником перетаскивания.
|
||||
/// Не может быть null.
|
||||
/// </param>
|
||||
/// <param name="dragData">
|
||||
/// Данные, которые будут перетаскиваться. Может быть null.
|
||||
/// Если не указано, используется <see cref="FrameworkElement.DataContext"/> или
|
||||
/// <see cref="FrameworkElement.Tag"/> элемента.
|
||||
/// </param>
|
||||
/// <exception cref="ArgumentNullException">
|
||||
/// Выбрасывается, если <paramref name="element"/> равен null.
|
||||
/// </exception>
|
||||
/// <remarks>
|
||||
/// После вызова этого метода элемент начинает обрабатывать события перетаскивания.
|
||||
/// <para>
|
||||
/// После вызова этого метода:
|
||||
/// <list type="bullet">
|
||||
/// <item>Элементу автоматически подписываются обработчики событий указателя</item>
|
||||
/// <item>Поведение начинает отслеживать взаимодействия с элементом</item>
|
||||
/// <item>При превышении порога перетаскивания инициируется операция через <see cref="Core.DragDrop.Services.IDragDropService"/></item>
|
||||
/// </list>
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Для открепления поведения используйте метод <see cref="Detach"/>.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public void Attach(FrameworkElement element, object? dragData = null)
|
||||
{
|
||||
Detach();
|
||||
if (element == null)
|
||||
throw new ArgumentNullException(nameof(element));
|
||||
|
||||
_element = element ?? throw new ArgumentNullException(nameof(element));
|
||||
_dragData = dragData ?? element.DataContext ?? element.Tag;
|
||||
|
||||
SubscribeToEvents();
|
||||
AssociatedElement = element;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Открепляет поведение от элемента.
|
||||
/// Открепляет поведение от текущего элемента.
|
||||
/// </summary>
|
||||
public void Detach()
|
||||
/// <remarks>
|
||||
/// <para>
|
||||
/// Этот метод выполняет следующие действия:
|
||||
/// <list type="bullet">
|
||||
/// <item>Отписывается от всех событий элемента</item>
|
||||
/// <item>Сбрасывает внутреннее состояние</item>
|
||||
/// <item>Освобождает ссылки на связанные объекты</item>
|
||||
/// </list>
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// Если в момент вызова активна операция перетаскивания, она будет автоматически отменена.
|
||||
/// </para>
|
||||
/// <para>
|
||||
/// После вызова этого метода поведение может быть повторно прикреплено к другому элементу.
|
||||
/// </para>
|
||||
/// </remarks>
|
||||
public new void Detach()
|
||||
{
|
||||
if (_element == null) return;
|
||||
|
||||
UnsubscribeFromEvents();
|
||||
|
||||
if (_isDragging)
|
||||
{
|
||||
_dragDropService.CancelDragAsync().ConfigureAwait(false);
|
||||
}
|
||||
|
||||
_element = null;
|
||||
base.Detach();
|
||||
_dragData = null;
|
||||
_isDragging = false;
|
||||
|
||||
_cancellationTokenSource?.Dispose();
|
||||
_cancellationTokenSource = null;
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region Обработчики событий
|
||||
#region Реализация абстрактных методов DragSourceBehaviorBase<FrameworkElement>
|
||||
|
||||
private void SubscribeToEvents()
|
||||
/// <inheritdoc/>
|
||||
protected override void SubscribeToEvents(FrameworkElement element)
|
||||
{
|
||||
if (_element == null) return;
|
||||
if (element == null) return;
|
||||
|
||||
_element.PointerPressed += OnPointerPressed;
|
||||
_element.PointerMoved += OnPointerMoved;
|
||||
_element.PointerReleased += OnPointerReleased;
|
||||
_element.PointerCanceled += OnPointerCanceled;
|
||||
_element.PointerCaptureLost += OnPointerCaptureLost;
|
||||
element.PointerPressed += OnPointerPressed;
|
||||
element.PointerMoved += OnPointerMoved;
|
||||
element.PointerReleased += OnPointerReleased;
|
||||
element.PointerCanceled += OnPointerCanceled;
|
||||
element.PointerCaptureLost += OnPointerCaptureLost;
|
||||
}
|
||||
|
||||
private void UnsubscribeFromEvents()
|
||||
/// <inheritdoc/>
|
||||
protected override void UnsubscribeFromEvents(FrameworkElement element)
|
||||
{
|
||||
if (_element == null) return;
|
||||
if (element == null) return;
|
||||
|
||||
_element.PointerPressed -= OnPointerPressed;
|
||||
_element.PointerMoved -= OnPointerMoved;
|
||||
_element.PointerReleased -= OnPointerReleased;
|
||||
_element.PointerCanceled -= OnPointerCanceled;
|
||||
_element.PointerCaptureLost -= OnPointerCaptureLost;
|
||||
element.PointerPressed -= OnPointerPressed;
|
||||
element.PointerMoved -= OnPointerMoved;
|
||||
element.PointerReleased -= OnPointerReleased;
|
||||
element.PointerCanceled -= OnPointerCanceled;
|
||||
element.PointerCaptureLost -= OnPointerCaptureLost;
|
||||
}
|
||||
|
||||
private void OnPointerPressed(object sender, PointerRoutedEventArgs e)
|
||||
/// <inheritdoc/>
|
||||
protected override Point ConvertToScreenCoordinates(Point point)
|
||||
{
|
||||
if (_element == null || _isDragging) return;
|
||||
|
||||
var point = e.GetCurrentPoint(_element);
|
||||
_dragStartPosition = new Point(point.Position.X, point.Position.Y);
|
||||
|
||||
_cancellationTokenSource?.Dispose();
|
||||
_cancellationTokenSource = new CancellationTokenSource();
|
||||
}
|
||||
|
||||
private async void OnPointerMoved(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
if (_element == null || _isDragging || _cancellationTokenSource?.IsCancellationRequested == true)
|
||||
return;
|
||||
|
||||
var point = e.GetCurrentPoint(_element);
|
||||
var currentPosition = new Point(point.Position.X, point.Position.Y);
|
||||
|
||||
var distance = CalculateDistance(_dragStartPosition, currentPosition);
|
||||
if (distance > _dragDropService.DragStartThreshold)
|
||||
{
|
||||
await StartDragAsync(currentPosition);
|
||||
}
|
||||
}
|
||||
|
||||
private void OnPointerReleased(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
ResetState();
|
||||
}
|
||||
|
||||
private void OnPointerCanceled(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
ResetState();
|
||||
}
|
||||
|
||||
private void OnPointerCaptureLost(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
ResetState();
|
||||
}
|
||||
|
||||
private double CalculateDistance(Point p1, Point p2)
|
||||
{
|
||||
var dx = p2.X - p1.X;
|
||||
var dy = p2.Y - p1.Y;
|
||||
return Math.Sqrt(dx * dx + dy * dy);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Преобразует координаты элемента в экранные координаты.
|
||||
/// </summary>
|
||||
/// <param name="point">Точка в координатах элемента.</param>
|
||||
/// <returns>Точка в экранных координатах.</returns>
|
||||
private Point ConvertToScreenCoordinates(Point point)
|
||||
{
|
||||
if (_element == null) return point;
|
||||
|
||||
try
|
||||
{
|
||||
var transform = _element.TransformToVisual(Window.Current.Content);
|
||||
var screenPoint = transform.TransformPoint(new Windows.Foundation.Point(point.X, point.Y));
|
||||
return new Point(screenPoint.X, screenPoint.Y);
|
||||
}
|
||||
catch
|
||||
{
|
||||
if (AssociatedElement == null)
|
||||
return point;
|
||||
}
|
||||
}
|
||||
|
||||
private async Task StartDragAsync(Point position)
|
||||
{
|
||||
if (_element == null || _dragData == null || _isDragging) return;
|
||||
|
||||
try
|
||||
{
|
||||
var screenPosition = ConvertToScreenCoordinates(position);
|
||||
var started = await _dragDropService.StartDragAsync(this, screenPosition);
|
||||
_isDragging = started;
|
||||
}
|
||||
catch
|
||||
{
|
||||
ResetState();
|
||||
}
|
||||
}
|
||||
|
||||
private void ResetState()
|
||||
{
|
||||
_isDragging = false;
|
||||
_dragStartPosition = default;
|
||||
|
||||
_cancellationTokenSource?.Cancel();
|
||||
_cancellationTokenSource?.Dispose();
|
||||
_cancellationTokenSource = null;
|
||||
return WinUIWindowHelper.ConvertToScreenCoordinates(AssociatedElement, point);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region IDragSource Implementation
|
||||
#region Реализация интерфейса IDragSource
|
||||
|
||||
public async Task<DragInfo?> TryStartDragAsync(Point startPosition, CancellationToken cancellationToken = default)
|
||||
/// <inheritdoc/>
|
||||
public override async Task<DragInfo?> TryStartDragAsync(
|
||||
Point startPosition,
|
||||
CancellationToken cancellationToken = default)
|
||||
{
|
||||
if (_element == null || _dragData == null)
|
||||
if (AssociatedElement == null || _dragData == null)
|
||||
return null;
|
||||
|
||||
try
|
||||
{
|
||||
// Создаем информацию о перетаскивании
|
||||
var dragInfo = new DragInfo(
|
||||
data: _dragData,
|
||||
allowedEffects: Core.DragDrop.Enums.DragDropEffects.Copy |
|
||||
Core.DragDrop.Enums.DragDropEffects.Move,
|
||||
Core.DragDrop.Enums.DragDropEffects.Move |
|
||||
Core.DragDrop.Enums.DragDropEffects.Link,
|
||||
startPosition: startPosition,
|
||||
source: this
|
||||
);
|
||||
|
||||
return dragInfo;
|
||||
// Добавляем дополнительные параметры
|
||||
dragInfo.SetParameter("SourceElement", AssociatedElement);
|
||||
dragInfo.SetParameter("SourceType", AssociatedElement.GetType().Name);
|
||||
|
||||
return await Task.FromResult(dragInfo);
|
||||
}
|
||||
catch
|
||||
catch (Exception ex)
|
||||
{
|
||||
// Логирование ошибки создания информации о перетаскивании
|
||||
System.Diagnostics.Debug.WriteLine(
|
||||
$"Ошибка создания DragInfo: {ex.Message}");
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
public Task OnDragCompletedAsync(DragInfo dragInfo, Core.DragDrop.Enums.DragDropEffects effects, CancellationToken cancellationToken = default)
|
||||
#endregion
|
||||
|
||||
#region Обработчики событий WinUI
|
||||
|
||||
private async void OnPointerPressed(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
_isDragging = false;
|
||||
return Task.CompletedTask;
|
||||
if (AssociatedElement == null) return;
|
||||
|
||||
var point = e.GetCurrentPoint(AssociatedElement);
|
||||
var position = new Point(point.Position.X, point.Position.Y);
|
||||
|
||||
await OnInteractionStarted(position);
|
||||
}
|
||||
|
||||
public Task OnDragCancelledAsync(DragInfo dragInfo, CancellationToken cancellationToken = default)
|
||||
private async void OnPointerMoved(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
_isDragging = false;
|
||||
return Task.CompletedTask;
|
||||
if (AssociatedElement == null) return;
|
||||
|
||||
var point = e.GetCurrentPoint(AssociatedElement);
|
||||
var position = new Point(point.Position.X, point.Position.Y);
|
||||
|
||||
await OnInteractionMoved(position);
|
||||
}
|
||||
|
||||
private async void OnPointerReleased(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
await OnInteractionEnded();
|
||||
}
|
||||
|
||||
private async void OnPointerCanceled(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
await OnInteractionCancelled();
|
||||
}
|
||||
|
||||
private async void OnPointerCaptureLost(object sender, PointerRoutedEventArgs e)
|
||||
{
|
||||
await OnInteractionCancelled();
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region Переопределение виртуальных методов
|
||||
|
||||
/// <inheritdoc/>
|
||||
protected override void OnDragCompleted(DragInfo dragInfo, Core.DragDrop.Enums.DragDropEffects effects)
|
||||
{
|
||||
base.OnDragCompleted(dragInfo, effects);
|
||||
|
||||
// Дополнительная логика для WinUI может быть добавлена здесь
|
||||
// Например, обновление состояния элемента после успешного перетаскивания
|
||||
}
|
||||
|
||||
/// <inheritdoc/>
|
||||
protected override void OnDragCancelled(DragInfo dragInfo)
|
||||
{
|
||||
base.OnDragCancelled(dragInfo);
|
||||
|
||||
// Дополнительная логика для WinUI может быть добавлена здесь
|
||||
// Например, восстановление визуального состояния элемента после отмены
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
Reference in New Issue
Block a user