UIElement.StartDragAsync(PointerPoint) Metode

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Memulai operasi seret dan letakkan.

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

Koordinat penunjuk tempat pengguna berinteraksi dengan layar, dan di mana visual seret dilampirkan.

Mengembalikan

IAsyncOperation<DataPackageOperation>

Nilai DataPackageOperation yang menunjukkan jenis operasi seret dan letakkan, dan apakah operasi berhasil.

Atribut: RemoteAsyncAttribute

Contoh

Contoh ini menunjukkan cara menangani peristiwa PointerPressed pada elemen Gambar untuk memulai operasi seret.

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

Keterangan

Jika Anda menerapkan deteksi gerakan kustom untuk memulai operasi seret, Anda dapat memanggil metode StartDragAsync untuk memulai operasi seret secara terprogram pada UIElement apa pun. Memanggil metode ini menghasilkan peristiwa DragStarting dinaikkan. Tangani peristiwa DragStarting untuk menentukan properti operasi lainnya, seperti paket data dan seret visual.

Parameter pointerPoint adalah titik di mana pengguna berinteraksi dengan layar menggunakan perangkat input (sentuhan, mouse, atau pena). Visual seret yang ditampilkan selama operasi seret dilampirkan ke penunjuk yang ditunjukkan di PointerPoint yang disediakan pemanggil.

DataPackageOperation yang dikembalikan oleh metode ini menunjukkan apakah operasi seret adalah pemindahan, penyalinan, atau tautan; dan apakah itu sukses atau tidak. Ini adalah nilai yang sama yang disediakan oleh properti DropResult di args peristiwa DropCompleted .

Berlaku untuk