DragEventArgs Classe

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

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

Condividi tramite