UIElement.StartDragAsync(PointerPoint) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Inizia un’operazione di trascinamento della selezione.

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)

Parametri

pointerPoint: PointerPoint

Le coordinate del puntatore in cui l'utente interagisce con lo schermo e dove è collegato l'oggetto visivo di trascinamento.

Restituisce

IAsyncOperation<DataPackageOperation>

Valore DataPackageOperation che indica il tipo di operazione di trascinamento e rilascio e se l'operazione ha avuto esito positivo.

Attributi: RemoteAsyncAttribute

Esempio

In questo esempio viene illustrato come gestire l'evento PointerPressed in un elemento Image per avviare un'operazione di trascinamento.

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

Commenti

Se si implementa il rilevamento dei movimenti personalizzati per avviare un'operazione di trascinamento, è possibile chiamare il metodo StartDragAsync per avviare a livello di codice un'operazione di trascinamento in qualsiasi UIElement. La chiamata a questo metodo comporta la generazione dell'evento DragStarting . Gestire l'evento DragStarting per specificare altre proprietà dell'operazione, ad esempio il pacchetto dati e trascinare l'oggetto visivo.

Il parametro pointerPoint è il punto in cui l'utente interagisce con lo schermo usando un dispositivo di input (tocco, mouse o penna). L'oggetto visivo di trascinamento visualizzato durante l'operazione di trascinamento viene collegato al puntatore indicato nel puntatore fornito dal chiamante PointerPoint.

DataPackageOperation restituito da questo metodo indica se l'operazione di trascinamento è uno spostamento, una copia o un collegamento; e se è un successo o meno. Si tratta dello stesso valore fornito dalla proprietà DropResult nell'args dell'evento DropCompleted .

Si applica a