EventManager.RegisterRoutedEvent(String, RoutingStrategy, Type, Type) EventManager.RegisterRoutedEvent(String, RoutingStrategy, Type, Type) EventManager.RegisterRoutedEvent(String, RoutingStrategy, Type, Type) Method

Definition

Registriert ein neues Routingereignis beim Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Ereignissystem.Registers a new routed event with the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) event system.

public:
 static System::Windows::RoutedEvent ^ RegisterRoutedEvent(System::String ^ name, System::Windows::RoutingStrategy routingStrategy, Type ^ handlerType, Type ^ ownerType);
public static System.Windows.RoutedEvent RegisterRoutedEvent (string name, System.Windows.RoutingStrategy routingStrategy, Type handlerType, Type ownerType);
static member RegisterRoutedEvent : string * System.Windows.RoutingStrategy * Type * Type -> System.Windows.RoutedEvent

Parameter

name
String String String

Der Name des Routingereignisses.The name of the routed event. Der Name muss im Besitzertyp eindeutig sein und darf nicht null oder eine leere Zeichenfolge sein.The name must be unique within the owner type and cannot be null or an empty string.

routingStrategy
RoutingStrategy RoutingStrategy RoutingStrategy

Die Routingstrategie des Ereignisses als Wert der Enumeration.The routing strategy of the event as a value of the enumeration.

handlerType
Type Type Type

Der Typ des Ereignishandlers.The type of the event handler. Dies muss ein Delegattyp sein und darf nicht null sein.This must be a delegate type and cannot be null.

ownerType
Type Type Type

Der Besitzerklassentyp des Routingereignisses.The owner class type of the routed event. Darf nicht null sein.This cannot be null.

Gibt zurück

Der Bezeichner für das neu registrierte Routingereignis.The identifier for the newly registered routed event. Dieses Bezeichnerobjekt kann jetzt als statisches Feld in einer Klasse gespeichert und dann als Parameter für Methoden verwendet werden, die Handler an das Ereignis anfügen.This identifier object can now be stored as a static field in a class and then used as a parameter for methods that attach handlers to the event. Der Routingereignisbezeichner wird auch für andere APIsAPIs des Ereignissystems verwendet.The routed event identifier is also used for other event system APIsAPIs.

Hinweise

Den Rückgabewert dieser Methode verwenden, erstellen Sie die statische Deklaration für eine eindeutige RoutedEvent Feld "ID".Use the return value of this method to create the static declaration for a unique RoutedEvent identifier field. Dieses Feld muss im Besitzertyp gespeichert werden.This field should be stored within the owner type.

Es gibt eine beträchtliche Anzahl von Konventionen und bewährte Methoden wie Routingereignisse zu sollte mit dem Namen, registriert und in einer Klasse verfügbar gemacht werden.There are a considerable number of conventions and best practices associated with how routed events should be named, registered, and exposed in a class. Weitere Informationen finden Sie unter Übersicht über Routingereignisse.For more information, see Routed Events Overview.

Gilt für: