EventManager.RegisterRoutedEvent(String, RoutingStrategy, Type, Type) Método

Definição

Registra um novo evento roteado com o sistema de eventos 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
Public Shared Function RegisterRoutedEvent (name As String, routingStrategy As RoutingStrategy, handlerType As Type, ownerType As Type) As RoutedEvent

Parâmetros

name
String

O nome do evento roteado.The name of the routed event. O nome deve ser exclusivo dentro do tipo de proprietário e não pode ser null ou uma cadeia de caracteres vazia.The name must be unique within the owner type and cannot be null or an empty string.

routingStrategy
RoutingStrategy

A estratégia de roteamento do evento como um valor da enumeração.The routing strategy of the event as a value of the enumeration.

handlerType
Type

O tipo de manipulador de eventos.The type of the event handler. Esse deve ser um tipo de delegado e não pode ser null.This must be a delegate type and cannot be null.

ownerType
Type

O tipo de classe do proprietário do evento roteado.The owner class type of the routed event. Esse não pode ser null.This cannot be null.

Retornos

RoutedEvent

O identificador para o evento roteado registrado recentemente.The identifier for the newly registered routed event. Esse objeto de identificador agora pode ser armazenado como um campo estático em uma classe e, em seguida, usado como um parâmetro para métodos que anexam manipuladores ao 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. O identificador de evento roteado também é usado para outras APIs do sistema de evento.The routed event identifier is also used for other event system APIs.

Comentários

Use o valor de retorno desse método para criar a declaração estática para um RoutedEvent campo de identificador exclusivo.Use the return value of this method to create the static declaration for a unique RoutedEvent identifier field. Esse campo deve ser armazenado dentro do tipo de proprietário.This field should be stored within the owner type.

Há um número considerável de convenções e práticas recomendadas associadas à forma como os eventos roteados devem ser nomeados, registrados e expostos em uma classe.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 obter mais informações, consulte Visão geral de eventos roteados.For more information, see Routed Events Overview.

Aplica-se a