Condividi tramite


UIElement.StartDragAsync(PointerPoint) Metodo

Definizione

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

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

Attributi

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

Vedi anche