ContentElement.OnPreviewDragEnter(DragEventArgs) Metodo

Definizione

Viene richiamato ogni qualvolta un evento PreviewDragEnter connesso non gestito raggiunge un elemento nella propria route derivato da questa classe. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.

protected public:
 virtual void OnPreviewDragEnter(System::Windows::DragEventArgs ^ e);
protected internal virtual void OnPreviewDragEnter (System.Windows.DragEventArgs e);
abstract member OnPreviewDragEnter : System.Windows.DragEventArgs -> unit
override this.OnPreviewDragEnter : System.Windows.DragEventArgs -> unit
Protected Friend Overridable Sub OnPreviewDragEnter (e As DragEventArgs)

Parametri

e
DragEventArgs

Oggetto DragEventArgs che contiene i dati dell'evento.

Commenti

Questo metodo non ha alcuna implementazione predefinita. Poiché una classe intermedia nell'ereditarietà potrebbe implementare questo metodo, è consigliabile chiamare l'implementazione di base nell'implementazione.

Lo scopo di questo metodo è simile ai metodi CLR (Common Language Runtime): questo metodo fornisce i mezzi per gestire l'evento corrispondente da classi derivate creando un gestore di classi anziché un gestore di istanze. In questo caso l'evento corrispondente è un evento instradato. Il modello di implementazione dei metodi On* è diverso per gli eventi indirizzati perché un evento indirizzato può essere generato da un elemento figlio, che non è necessariamente l'elemento che richiama gestori. Pertanto, l'implementazione deve esaminare le proprietà di origine dei dati dell'evento. Non dovrebbe provare a riraizzare l'evento nella maggior parte dei casi.

Eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandlerclassi derivate di ContentElement può chiamare i metodi del gestore della classe privata quando l'evento viene ricevuto lungo la route dell'evento. Uno scenario in cui la gestione delle classi è appropriata consiste nel modificare i dati dell'evento e contrassegnare l'evento indirizzato come gestito. Un altro scenario specifico per gli eventi di anteprima consiste nel contrassegnarli gestiti in modo che i gestori di classi bubbling corrispondenti non vengano richiamati.

Si applica a

Vedi anche