RoutedEventArgs Classe
Definizione
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.
Contiene informazioni sullo stato e dati evento associati a un evento indirizzato.
/// [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 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 class RoutedEventArgs
Public Class RoutedEventArgs
- Ereditarietà
- Derivato
- Attributi
Commenti
RoutedEventArgs
è un tipo di dati di evento comune usato per gli eventi degli elementi di base nelle app Windows App SDK usando C++ o C#. In genere RoutedEventArgs
, il tipo di dati dell'evento indica che l'evento con questi dati di evento è un evento instradato, anche se sono presenti alcune eccezioni. Per altre informazioni sugli eventi indirizzati e su come gestirli, vedere Panoramica degli eventi e degli eventi indirizzati.
L'API che RoutedEventArgs
aggiunge a un set di dati eventi generalizzato è OriginalSource.
OriginalSource
può essere utile per determinare l'elemento che ha generato prima l'evento per gli scenari di hit testing e routing eventi, ma ci sono anche momenti in cui il mittente dalla firma delegato è il riferimento all'oggetto di origine più utile per un gestore. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.
RoutedEventArgs e la proprietà Handled
Se si ha familiarità con Windows Presentation Foundation (WPF), è possibile che WPF dichiari una proprietà denominata Handled
nella RoutedEventArgs
classe . Alcune classi di dati evento indirizzate nella Windows Runtime definiscono anche una Handled
proprietà e la si usa nello stesso modo in WPF (influenza la route degli eventi dall'interno del gestore). Tuttavia, per Windows App SDK questo comportamento è specifico solo per determinati eventi indirizzati anziché per tutti gli eventi indirizzati (come è true in WPF). Ad esempio, è possibile impostare Handled se si gestisce un evento puntatore e la classe di dati di evento è PointerRoutedEventArgs, ma non è possibile impostare Handled
per un evento caricato in cui i dati dell'evento sono un'istanza di RoutedEventArgs.
Classi derivate routedEventArgs
RoutedEventArgs
è la classe padre per diverse classi derivate immediatamente che definiscono i dati degli eventi per Windows Runtime eventi che coinvolgono gli elementi dell'interfaccia utente. Non tutti gli eventi in cui le classi forniscono i dati sono necessariamente instradati come definito nella panoramica degli eventi e degli eventi indirizzati. Ma molti sono. Quelli che a volte non hanno i dati dell'evento derivati da RoutedEventArgs
per motivi di compatibilità.
- Drageventargs
- ExceptionRoutedEventArgs
- SizeChangedEventArgs
- CleanUpVirtualizedItemEventArgs
- ContextMenuEventArgs
- ItemClickEventArgs
- Selectionchangedeventargs
- Textchangedeventargs
- DragCompletedEventArgs
- DragDeltaEventArgs
- DragStartedEventArgs
- RangeBaseValueChangedEventArgs
- Scrolleventargs
- HyperlinkClickEventArgs
- DoubleTappedRoutedEventArgs
- HoldingRoutedEventArgs
- KeyRoutedEventArgs
- ManipulationCompletedRoutedEventArgs
- ManipulationDeltaRoutedEventArgs
- ManipulationInertiaStartingRoutedEventArgs
- ManipulationStartedRoutedEventArgs
- ManipulationStartingRoutedEventArgs
- PointerRoutedEventArgs
- RightTappedRoutedEventArgs
- TappedRoutedEventArgs
Costruttori
RoutedEventArgs() |
Inizializza una nuova istanza della classe RoutedEventArgs . |
Proprietà
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. |