Share via

UIElement.StartDragAsync Methode

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml

Überlädt

StartDragAsync(ExpPointerPoint)
StartDragAsync(PointerPoint)

Leitet einen Drag & Drop-Vorgang ein.

Wichtig

Wird nicht unterstützt, wenn ein Benutzer die App als Administrator im Modus mit erhöhten Rechten ausführt.

StartDragAsync(ExpPointerPoint) 

public:
 virtual IAsyncOperation<DataPackageOperation> ^ StartDragAsync(ExpPointerPoint ^ pointerPoint) = StartDragAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<DataPackageOperation> StartDragAsync(ExpPointerPoint const& pointerPoint);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<DataPackageOperation> StartDragAsync(ExpPointerPoint pointerPoint);
function startDragAsync(pointerPoint)
Public Function StartDragAsync (pointerPoint As ExpPointerPoint) As IAsyncOperation(Of DataPackageOperation)

Parameter

pointerPoint
ExpPointerPoint

Gibt zurück

IAsyncOperation<DataPackageOperation>
Attribute
RemoteAsyncAttribute

Gilt für:

StartDragAsync(PointerPoint)

Bearbeiten

Leitet einen Drag & Drop-Vorgang ein.

Wichtig

Wird nicht unterstützt, wenn ein Benutzer die App als Administrator im Modus mit erhöhten Rechten ausführt.

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 Windows.ApplicationModel.DataTransfer.DataPackageOperation Wert, der den Typ des Drag-and-Drop-Vorgangs angibt und ob der Vorgang erfolgreich war.

Attribute
RemoteAsyncAttribute

Hinweise

Wenn Sie die benutzerdefinierte Gestenerkennung implementieren, um einen Ziehvorgang zu initiieren, können Sie die UIElement.StartDragAsync(PointerPoint) -Methode aufrufen, um programmgesteuert einen Ziehvorgang für ein beliebiges UIElement zu initiieren. Das Aufrufen dieser Methode führt dazu, dass das UIElement.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 angegebenen PointerPointangezeigt wird.

Der UIElement.StartDragAsync(PointerPoint) von dieser Methode zurückgegebene gibt an, ob der Ziehvorgang ein Verschieben, Kopieren oder Verknüpfen ist und ob er erfolgreich ist. Dies ist der gleiche Wert, der von der DropCompletedEventArgs.DropResult -Eigenschaft bereitgestellt wird.

Gilt für: