UIElement.StartDragAsync(PointerPoint) Método

Definición

Espacio de nombres:

Windows.UI.Xaml

Inicia una operación de arrastrar y colocar.

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

Coordenadas del puntero donde el usuario interactúa con la pantalla y donde se adjunta el objeto visual de arrastre.

Devoluciones

IAsyncOperation<DataPackageOperation>

Valor dataPackageOperation que indica el tipo de operación de arrastrar y colocar y si la operación se realizó correctamente.

Atributos

RemoteAsyncAttribute

Ejemplos

En este ejemplo se muestra cómo controlar el evento PointerPressed en un elemento Image para iniciar una operación de arrastre.

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

Comentarios

Si implementa la detección de gestos personalizada para iniciar una operación de arrastre, puede llamar al método StartDragAsync para iniciar mediante programación una operación de arrastre en cualquier UIElement. Al llamar a este método, se genera el evento DragStarting . Controle el evento DragStarting para especificar otras propiedades de la operación, como el paquete de datos y el objeto visual de arrastre.

El parámetro pointerPoint es el punto en el que el usuario interactúa con la pantalla mediante un dispositivo de entrada (entrada táctil, mouse o lápiz). El objeto visual de arrastre que se muestra durante la operación de arrastre se adjunta al puntero indicado en el Puntero proporcionado por el autor de la llamada.

El DataPackageOperation devuelto por este método indica si la operación de arrastre es un movimiento, una copia o un vínculo; y si es un éxito o no. Este es el mismo valor proporcionado por la propiedad DropResult en los argumentos del evento DropCompleted .

Consulte también

• DragStarting
• CanDrag
• Ejemplo de arrastrar y colocar (Windows 10)