Condividi tramite


UIElement.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:
 virtual void OnPreviewDragEnter(System::Windows::DragEventArgs ^ e);
protected virtual void OnPreviewDragEnter (System.Windows.DragEventArgs e);
abstract member OnPreviewDragEnter : System.Windows.DragEventArgs -> unit
override this.OnPreviewDragEnter : System.Windows.DragEventArgs -> unit
Protected 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 On* di Common Language Runtime (Common Language Runtime): questo metodo fornisce i mezzi per gestire l'evento corrispondente dalle classi derivate stabilendo un gestore di classi anziché un gestore di istanze. In questo caso l'evento corrispondente è un evento indirizzato. 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 richiamerà i gestori. Pertanto, l'implementazione deve esaminare le proprietà di origine dei dati dell'evento. Non dovrebbe tentare di riramettere l'evento nella maggior parte dei casi.

Eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandler, le classi derivate di UIElement possono chiamare metodi del gestore di classi private 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