DragEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml
Modifica

Fornisce i dati per gli eventi di trascinamento della selezione.

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
Ereditarietà
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

DragEventArgs viene usato come dati dell'evento per questi eventi:

Questi eventi sono eventi indirizzati. La modifica del valore della proprietà Handled di DragEventArgs da un gestore eventi può influire sul comportamento di un evento indirizzato. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.

La classe Control include gestori eventi pre-cablati che i tipi derivati di Control possono eseguire l'override per fornire la gestione basata sulla classe per gli eventi di trascinamento e questi metodi usano anche DragEventArgs come parametro. Questi metodi sono:

L'implementazione Windows Runtime dei concetti di trascinamento consente solo determinati controlli e azioni di input per avviare un'azione di trascinamento. Non esiste alcun metodo DoDragDrop generalizzato che consenta a qualsiasi elemento dell'interfaccia utente di avviare un'azione di trascinamento. L'origine principale di un'azione di trascinamento è quando si trascinano gli elementi di un elenco, ad esempio GridView. Per un'azione di trascinamento dell'elemento di elenco, il valore Dati nei dati degli eventi può essere potenzialmente modificato dai dati predefiniti definiti dal controllo sull'elemento. Questa operazione viene eseguita gestendo l'evento DragItemsStarting e usando l'oggetto DataPackage ottenuto dalla proprietà DragItemsStartingEventArgs.Data nei dati dell'evento.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 AllowedOperations

Proprietà

AcceptedOperation

Ottiene o imposta un valore che specifica quali operazioni (nessuna, spostare, copiare e/o collegamento) possono essere accettate dalla destinazione dell'evento di trascinamento.
AllowedOperations

Ottiene un valore che specifica quali operazioni (nessuna, spostare, copiare e/o collegamento) sono consentite dall'origine dell'evento di trascinamento.
Data

Ottiene o imposta un oggetto dati (DataPackage) che contiene i dati associati all'evento di trascinamento corrispondente. Questo valore non è utile in tutti i casi eventi; in particolare, l'evento deve essere gestito da una destinazione di rilascio valida.
DataView

Ottiene una copia di sola lettura dell'oggetto Data .
DragUIOverride

Ottiene la rappresentazione visiva dei dati trascinati.
Handled

Ottiene o imposta un valore che indica lo stato presente della gestione degli eventi per un evento indirizzato quando percorre la route.
Modifiers

Ottiene un'enumerazione di flag indicante lo stato corrente dei tasti MAIUSC, CTRL e ALT, nonché lo stato dei pulsanti del mouse.
OriginalSource

Ottiene un riferimento all'oggetto che ha generato l'evento. Questa è spesso una parte del modello di un controllo anziché un elemento dichiarato nell'interfaccia utente dell'app.

(Ereditato da RoutedEventArgs)

Metodi

GetDeferral()

Supporta operazioni di trascinamento asincrone creando e restituendo un oggetto DragOperationDeferral .
GetPosition(UIElement)

Restituisce un punto di rilascio relativo a un UIElement specificato.

Si applica a

Vedi anche