Ler em inglês

Compartilhar via

UIElement.StartDragAsync(PointerPoint) Método

  • Referência

Definição

Namespace:
Windows.UI.Xaml
Editar

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

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

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.

XAML 
<Image x:Name="myImage" Source="ms-appx:///Assets/Logo.png" 
       PointerPressed="myImage_PointerPressed" />
C# 
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.

Aplica-se a

Produto Versões
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Confira também