UIElement.StartDragAsync(PointerPoint) Метод

Определение

Пространство имен:

Windows.UI.Xaml

Инициирует операцию перетаскивания.

public:
 virtual IAsyncOperation<DataPackageOperation> ^ StartDragAsync(PointerPoint ^ pointerPoint) = StartDragAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<DataPackageOperation> StartDragAsync(PointerPoint const& pointerPoint);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<DataPackageOperation> StartDragAsync(PointerPoint pointerPoint);

function startDragAsync(pointerPoint)

Public Function StartDragAsync (pointerPoint As PointerPoint) As IAsyncOperation(Of DataPackageOperation)

Параметры

pointerPoint

PointerPoint

Координаты указателя, в котором пользователь взаимодействует с экраном и где прикреплен визуальный элемент перетаскивания.

Возвращаемое значение

IAsyncOperation<DataPackageOperation>

Значение DataPackageOperation , указывающее тип операции перетаскивания и успешность операции.

Атрибуты

RemoteAsyncAttribute

Примеры

В этом примере показано, как обработать событие PointerPressed в элементе Image , чтобы инициировать операцию перетаскивания.

<Image x:Name="myImage" Source="ms-appx:///Assets/Logo.png" 
       PointerPressed="myImage_PointerPressed" />

private async void myImage_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    var pointerPoint = e.GetCurrentPoint(sender as UIElement);
    var dropStatus = await myImage.StartDragAsync(pointerPoint);
    if (dropStatus == DataPackageOperation.Move)
    {
        // App specific code for a "move" operation.
    }
}

Комментарии

При реализации пользовательского обнаружения жестов для инициации операции перетаскивания можно вызвать метод StartDragAsync, чтобы программно инициировать операцию перетаскивания для любого элемента UIElement. Вызов этого метода приводит к возникновению события DragStarting . Обработайте событие DragStarting , чтобы указать другие свойства операции, такие как пакет данных и визуальный элемент перетаскивания.

Параметр pointerPoint — это точка, в которой пользователь взаимодействует с экраном с помощью устройства ввода (сенсорного ввода, мыши или пера). Визуальный элемент перетаскивания, отображаемый во время операции перетаскивания, прикрепляется к указателю, указанному в предоставленном вызывающей точкой PointerPoint.

Объект DataPackageOperation, возвращаемый этим методом, указывает, является ли операция перетаскивания перемещением, копированием или ссылкой; и является ли это успехом. Это то же значение, которое предоставляется свойством DropResult в аргументах события DropCompleted .

См. также раздел

• DragStarting
• CanDrag
• Пример перетаскивания (Windows 10)