Поделиться через


UIElement.StartDragAsync(PointerPoint) Метод

Определение

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

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

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

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

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

Атрибуты

Примеры

В этом примере показано, как обработать событие 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 .

Применяется к

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