UIElement.StartDragAsync(PointerPoint) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um valor DataPackageOperation que indica o tipo de operação de arrastar e soltar e se a operação foi bem-sucedida.
- Atributos
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.