UIElement.StartDragAsync(PointerPoint) Método

Definição

Namespace:

Windows.UI.Xaml

Inicia uma operação do tipo "arrastar e soltar".

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)

Parâmetros

pointerPoint

PointerPoint

As coordenadas do ponteiro em que o usuário interage com a tela e onde o visual de arrastar está anexado.

Retornos

IAsyncOperation<DataPackageOperation>

Um valor DataPackageOperation que indica o tipo de operação de arrastar e soltar e se a operação foi bem-sucedida.

Atributos

RemoteAsyncAttribute

Exemplos

Este exemplo mostra como lidar com o evento PointerPressed em um elemento Image para iniciar uma operação de arrastar.

<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.
    }
}

Comentários

Se você implementar a detecção de gestos personalizada para iniciar uma operação de arrastar, poderá chamar o método StartDragAsync para iniciar programaticamente uma operação de arrastar em qualquer UIElement. Chamar esse método faz com que o evento DragStarting seja gerado. Manipule o evento DragStarting para especificar outras propriedades da operação, como o pacote de dados e arraste o visual.

O parâmetro pointerPoint é o ponto no qual o usuário interage com a tela usando um dispositivo de entrada (toque, mouse ou caneta). O visual de arrastar mostrado durante a operação de arrastar é anexado ao ponteiro indicado no PointerPoint fornecido pelo chamador.

O DataPackageOperation retornado por esse método indica se a operação de arrastar é uma movimentação, cópia ou link; e se é ou não um sucesso. Esse é o mesmo valor fornecido pela propriedade DropResult no evento DropCompleted args.

Confira também

• DragStarting
• CanDrag
• Exemplo de arrastar e soltar (Windows 10)