UIElement.StartDragAsync(PointerPoint) Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Leitet einen Drag & Drop-Vorgang ein.

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)

Parameter

pointerPoint: PointerPoint

Die Koordinaten des Zeigers, in dem der Benutzer mit dem Bildschirm interagiert und an dem das Visual zum Ziehen angefügt ist.

Gibt zurück

IAsyncOperation<DataPackageOperation>

Ein DataPackageOperation-Wert , der den Typ des Drag-and-Drop-Vorgangs angibt und angibt, ob der Vorgang erfolgreich war.

Attribute: RemoteAsyncAttribute

Beispiele

In diesem Beispiel wird gezeigt, wie das PointerPressed-Ereignis für ein Image-Element behandelt wird, um einen Ziehvorgang zu initiieren.

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

Hinweise

Wenn Sie die benutzerdefinierte Gestenerkennung implementieren, um einen Ziehvorgang zu initiieren, können Sie die StartDragAsync-Methode aufrufen, um programmgesteuert einen Ziehvorgang für ein beliebiges UIElement zu initiieren. Das Aufrufen dieser Methode führt dazu, dass das DragStarting-Ereignis ausgelöst wird. Behandeln Sie das DragStarting-Ereignis , um andere Eigenschaften des Vorgangs anzugeben, z. B. das Datenpaket und das Visual ziehen.

Der pointerPoint-Parameter ist der Punkt, an dem der Benutzer mit einem Eingabegerät (Toucheingabe, Maus oder Stift) mit dem Bildschirm interagiert. Das Visual zum Ziehen, das während des Ziehvorgangs angezeigt wird, wird an den Zeiger angefügt, der im vom Aufrufer bereitgestellten PointerPoint angegeben ist.

Das von dieser Methode zurückgegebene DataPackageOperation gibt an, ob es sich bei dem Ziehvorgang um ein Verschieben, Kopieren oder Verknüpfen handelt. und ob es ein Erfolg ist oder nicht. Dies ist der gleiche Wert, der von der DropResult-Eigenschaft in den DropCompleted-Ereignisargumenten bereitgestellt wird .

Gilt für: