Condividi tramite

DragEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Fornisce dati per gli eventi di trascinamento della selezione.

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

Commenti

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

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

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

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

Proprietà

AcceptedOperation

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

Ottiene un valore che specifica le operazioni (nessuna, spostamento, copia e/o collegamento) 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 di evento; 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. Si tratta spesso di una parte di modello di un controllo anziché di 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 oggetto UIElement specificato.

Si applica a

Vedi anche