Bagikan melalui


DragEventArgs Kelas

Definisi

Menyediakan data untuk peristiwa seret dan letakkan.

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DragEventArgs final : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DragEventArgs : RoutedEventArgs
Public NotInheritable Class DragEventArgs
Inherits RoutedEventArgs
Warisan
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

DragEventArgs digunakan sebagai data peristiwa untuk peristiwa ini:

Peristiwa ini adalah peristiwa yang dirutekan. Mengubah nilai properti Yang Ditangani dragEventArgs dari penanganan aktivitas dapat memengaruhi cara kejadian yang dirutekan berperilaku. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Kelas Kontrol memiliki penanganan aktivitas pra-kabel yang dapat diambil alih oleh jenis turunan Kontrol untuk memberikan penanganan berbasis kelas untuk peristiwa seret-letakkan, dan metode ini juga menggunakan DragEventArgs sebagai parameter. Metode ini adalah:

Implementasi Windows Runtime konsep seret-lepas hanya mengizinkan kontrol dan tindakan input tertentu untuk memulai tindakan seret-lepas. Tidak ada metode DoDragDrop umum yang akan mengizinkan elemen UI apa pun untuk memulai tindakan drag-drop. Sumber utama tindakan seret-letakkan adalah saat Anda menyeret item daftar seperti GridView. Untuk tindakan seret-letakkan item daftar, nilai Data dalam data peristiwa berpotensi dimodifikasi dari data default yang ditentukan kontrol tentang item tersebut. Ini dilakukan dengan menangani peristiwa DragItemsStarting , dan bekerja dengan objek DataPackage yang diperoleh dari properti DragItemsStartingEventArgs.Data dalam data peristiwa.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 AllowedOperations

Properti

AcceptedOperation

Mendapatkan atau mengatur nilai yang menentukan operasi mana (tidak ada, pindahkan, salin, dan/atau tautan) yang dapat diterima oleh target peristiwa seret.

AllowedOperations

Mendapatkan nilai yang menentukan operasi mana (tidak ada, pindahkan, salin, dan/atau tautan) yang diizinkan oleh sumber peristiwa seret.

Data

Mendapatkan atau mengatur objek data (DataPackage) yang berisi data yang terkait dengan peristiwa seret yang sesuai. Nilai ini tidak berguna dalam semua kasus peristiwa; secara khusus, peristiwa harus ditangani oleh target penurunan yang valid.

DataView

Mendapatkan salinan baca-saja dari objek Data .

DragUIOverride

Mendapatkan representasi visual data yang diseret.

Handled

Mendapatkan atau menetapkan nilai yang menunjukkan status penanganan peristiwa saat ini untuk peristiwa yang dirutekan saat melakukan perjalanan rute.

Modifiers

Mendapatkan enumerasi bendera yang menunjukkan status tombol SHIFT, CTRL, dan ALT saat ini, serta status tombol mouse.

OriginalSource

Mendapatkan referensi ke objek yang memunculkan peristiwa. Ini sering merupakan bagian templat dari kontrol daripada elemen yang dideklarasikan di UI aplikasi Anda.

(Diperoleh dari RoutedEventArgs)

Metode

GetDeferral()

Mendukung operasi seret dan letakkan asinkron dengan membuat dan mengembalikan objek DragOperationDeferral .

GetPosition(UIElement)

Mengembalikan titik drop yang relatif terhadap UIElement tertentu.

Berlaku untuk

Lihat juga