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

Definición

Registra un nuevo evento enrutado en el sistema de eventos del Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF).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

Parámetros

name
String String String

Nombre del evento enrutado.The name of the routed event. El nombre debe ser único en el tipo de propietario y no puede ser null ni una cadena vacía.The name must be unique within the owner type and cannot be null or an empty string.

routingStrategy
RoutingStrategy RoutingStrategy RoutingStrategy

Estrategia de enrutamiento del evento como valor de la enumeración.The routing strategy of the event as a value of the enumeration.

handlerType
Type Type Type

Tipo del controlador de eventos.The type of the event handler. Se debe tratar de un tipo de delegado y no puede ser null.This must be a delegate type and cannot be null.

ownerType
Type Type Type

Tipo de clase de propietario del evento enrutado.The owner class type of the routed event. No puede ser null.This cannot be null.

Devoluciones

Identificador del evento enrutado recién registrado.The identifier for the newly registered routed event. Este objeto de identificador puede almacenarse como un campo estático en una clase y, a continuación, usarse como parámetro para los métodos que asocian controladores al evento.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. El identificador del evento enrutado también se usa para otras APIAPIs del sistema de eventos.The routed event identifier is also used for other event system APIAPIs.

Comentarios

Use el valor devuelto de este método para crear la declaración estática para un RoutedEvent campo de identificador único.Use the return value of this method to create the static declaration for a unique RoutedEvent identifier field. Este campo debe almacenarse en el tipo de propietario.This field should be stored within the owner type.

Hay un número considerable de convenciones y procedimientos recomendados asociados a cómo los eventos enrutados se deben denominar, registrar y exponer en una clase.There are a considerable number of conventions and best practices associated with how routed events should be named, registered, and exposed in a class. Para obtener más información, vea información general sobre eventosenrutados.For more information, see Routed Events Overview.

Se aplica a