UIElement.StartDragAsync(PointerPoint) Méthode

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Démarre une opération de glisser-déplacer.

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)

Paramètres

pointerPoint: PointerPoint

Coordonnées du pointeur où l’utilisateur interagit avec l’écran et où le visuel glisser est attaché.

Retours

IAsyncOperation<DataPackageOperation>

Valeur DataPackageOperation qui indique le type d’opération de glisser-déplacer et si l’opération a réussi.

Attributs: RemoteAsyncAttribute

Exemples

Cet exemple montre comment gérer l’événement PointerPressed sur un élément Image pour lancer une opération de glissement.

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

Remarques

Si vous implémentez la détection de mouvement personnalisée pour lancer une opération de glissement, vous pouvez appeler la méthode StartDragAsync pour lancer par programmation une opération de glisser sur n’importe quel UIElement. L’appel de cette méthode entraîne la levée de l’événement DragStarting . Gérez l’événement DragStarting pour spécifier d’autres propriétés de l’opération, telles que le package de données et le visuel glisser.

Le paramètre pointerPoint est le point auquel l’utilisateur interagit avec l’écran à l’aide d’un périphérique d’entrée (tactile, souris ou stylet). Le visuel glisser qui s’affiche pendant l’opération de glisser est attaché au pointeur indiqué dans le Pointeur fourni par l’appelant.

Le DataPackageOperation retourné par cette méthode indique si l’opération de glisser est un déplacement, une copie ou un lien ; et si c’est un succès ou non. Il s’agit de la même valeur que celle fournie par la propriété DropResult dans les arguments d’événement DropCompleted .

S’applique à