UIElement.StartDragAsync(PointerPoint) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Valor dataPackageOperation que indica el tipo de operación de arrastrar y colocar y si la operación se realizó correctamente.
- Atributos
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 .