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.

XAML

<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 à

Produit	Versions
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

Partager via