RoutedEvent Klasse

Definition

public ref class RoutedEvent sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RoutedEvent final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RoutedEvent

Public NotInheritable Class RoutedEvent

Vererbung

Object Platform::Object IInspectable RoutedEvent

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Beispiele

Dieses Beispiel zeigt die grundlegende Syntax zum Verkabeln eines Ereignishandlers mit AddHandler und handledEventsToo as true. In diesem Fall wird auf das Ereignis getippt, und der RoutedEventim Beispiel verwendete Bezeichner "-type" lautet "TappedEvent". Der typische Ort für Drahthandler ist entweder geladen für eine Seite oder OnApplyTemplate für ein vorlagenbasiertes Steuerelement.

void MainPage::pageRoot_Tapped(Platform::Object^ sender, Windows::UI::Xaml::Input::TappedRoutedEventArgs^ e)
{
     //implementation
}
void MainPage::pageRoot_Loaded(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
     this->AddHandler(UIElement::TappedEvent, ref new TappedEventHandler(this, &MainPage::pageRoot_Tapped), true);
}

private void pageRoot_Tapped(object sender, TappedRoutedEventArgs e)
{
    //implementation
}
private void pageRoot_Loaded_1(object sender, RoutedEventArgs e)
{
    this.AddHandler(UIElement.TappedEvent, new TappedEventHandler(pageRoot_Tapped), true);
}

Hinweise

Weitere Informationen zur Funktionsweise von Routingereignissen finden Sie in der Übersicht über Ereignisse und Routingereignisse. Der RoutedEvent Typ ist Teil der Infrastruktur für Routingereignisse, sie wird jedoch nicht direkt in der typischen Windows-Runtime App-Programmierung verwendetRoutedEvent.

Der Zweck des RoutedEvent Typs besteht darin, als Bezeichner für das Windows-Runtime-Ereignissystem zu dienen, ähnlich wie DependencyProperty einen Bezeichnertyp für das Abhängigkeitseigenschaftensystem bereitstellt. UIElement enthält mehrere statische schreibgeschützte Eigenschaften vom Typ RoutedEvent, die mit einem Benennungsmuster benannt werden. Jede RoutedEvent Eigenschaft wird nach einem Ereignis und dem Suffix "Event" benannt. Jede solche Eigenschaft ist der Bezeichner für das Routingereignis, mit dem der Name beginnt. Beispielsweise identifiziert TappedEvent das getippte Routingereignis an das Ereignissystem.

Bei den meisten App-Code-Verwendungen wird das Ereignis einfach anhand des Namens in XAML oder anhand des Codeentitätsnamens im Code referenziert, was erforderlich ist, um auf ein Ereignis für ein Objekt zu verweisen, um Handler hinzuzufügen oder zu entfernen. Die RoutedEvent Bezeichner sind nur erforderlich, wenn Sie Handler anfügen, die auch dann aufgerufen werden sollen, wenn die Routingereignisse zuvor vom System- oder App-Code als behandelt markiert wurden. Die API, die Sie für dieses Szenario verwenden, und die API, die einen RoutedEvent Wert als Parameter verwendet, sind UIElement.AddHandler und UIElement.RemoveHandler. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Ereignisse, die einen RoutedEvent-Bezeichner verwenden

Nachfolgend finden Sie eine Liste der Routingereignisse, die einen RoutedEvent Bezeichner aufweisen und somit die von uns beschriebene Methode "UIElement.AddHandler " verwenden können:

• DoubleTapped
• DragEnter
• DragLeave
• DragOver
• Drop
• Halten
• KeyDown
• KeyUp
• ManipulationCompleted
• ManipulationDelta
• ManipulationInertiaStarting
• ManipulationStarted
• ManipulationStarting
• ZeigerCanceled
• PointerCaptureLost
• PointerEntered
• PointerExited
• ZeigerMoved
• PointerPressed
• PointerReleased
• PointerWheelChanged
• RightTapped
• Getappt

Weitere Informationen

• AddHandler(RoutedEvent, Object, Boolean)
• RemoveHandler(RoutedEvent, Object)
• RoutedEventArgs
• Übersicht über Ereignisse und Routingereignisse