RoutedEventHandler Delegato

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Rappresenta il metodo che gestirà i diversi eventi indirizzati che non hanno dati di evento specifici oltre ai dati comuni per tutti gli eventi indirizzati.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);

public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);

type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit

Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Parametri

sender

Object

Oggetto a cui è associato il gestore eventi.

e

RoutedEventArgs

Dati dell'evento.

Commenti

Il RoutedEventHandler delegato viene usato per qualsiasi evento indirizzato che non segnala informazioni specifiche dell'evento nei dati dell'evento. Ci sono molti eventi indirizzati di questo tipo; esempi di rilievo includono Click e Loaded.

La differenza più significativa tra la scrittura di un gestore per un evento indirizzato anziché un evento CLR (Common Language Runtime) generale è che l'oggetto sender dell'evento (l'elemento in cui il gestore è collegato e richiamato) non può essere considerato necessariamente l'origine dell'evento. L'origine viene segnalata come proprietà nei dati dell'evento (Source). Una differenza tra sender e Source è il risultato dell'instradamento dell'evento a elementi diversi, durante l'attraversamento dell'evento indirizzato attraverso una struttura ad albero degli elementi.

È possibile usare sender o Source per un riferimento a un oggetto se si è deliberatamente non interessati al comportamento di routing di un evento indirizzato diretto o bubbling e si intende gestire solo gli eventi indirizzati sugli elementi in cui vengono generati per la prima volta. In questa circostanza e senderSource sono lo stesso oggetto.

Se si intende sfruttare le funzionalità intrinseche degli eventi indirizzati e scrivere i gestori di conseguenza, le due proprietà più importanti dei dati dell'evento che verranno usati durante la scrittura di gestori eventi sono Source e Handled.

Per determinate combinazioni di eventi di input e classi di controllo WPF, l'elemento che genera l'evento non è il primo elemento che ha la possibilità di gestirlo. Se l'evento di input ha una versione preview dell'evento, la radice dell'albero degli elementi ha la prima opportunità, può essere impostata su Handledtrue nei dati dell'evento condiviso e può influenzare il modo in cui l'evento di input viene segnalato agli elementi rimanenti nella route dell'evento. Il comportamento di gestione dell'anteprima può dare l'aspetto che un determinato evento indirizzato non venga generato come previsto. Per altre informazioni, vedere Preview Events and Input Overview.For more information, see Preview Events and Input Overview.

Metodi di estensione