EventManager.RegisterRoutedEvent(String, RoutingStrategy, Type, Type) Метод

Определение

Регистрирует новое маршрутизируемое событие в системе событий 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

Параметры

name
String

Имя маршрутизируемого события.The name of the routed event. Имя должно быть уникальным для данного типа владельца и не может быть пустой строкой или иметь значение null.The name must be unique within the owner type and cannot be null or an empty string.

routingStrategy
RoutingStrategy

Стратегия маршрутизации события как значения перечисления.The routing strategy of the event as a value of the enumeration.

handlerType
Type

Тип обработчика событий.The type of the event handler. Должен быть типом делегата. Не может иметь значение null.This must be a delegate type and cannot be null.

ownerType
Type

Тип класса владельца маршрутизируемого события.The owner class type of the routed event. Не может иметь значение null.This cannot be null.

Возвраты

Идентификатор вновь зарегистрированного маршрутизируемого события.The identifier for the newly registered routed event. Этот объект-идентификатор теперь может храниться в виде статического поля в классе и использоваться в качестве параметра для методов, присоединяющих обработчики событий к событиям.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. Идентификатор маршрутизируемого события также используется для других API систем событий.The routed event identifier is also used for other event system APIs.

Комментарии

Используйте возвращаемое значение этого метода, чтобы создать статическое объявление для уникального поля идентификатора RoutedEvent.Use the return value of this method to create the static declaration for a unique RoutedEvent identifier field. Это поле должно храниться в типе владельца.This field should be stored within the owner type.

Существует значительное количество соглашений и рекомендаций, связанных с тем, как перенаправляемые события должны называться, регистрироваться и предоставляться в классе.There are a considerable number of conventions and best practices associated with how routed events should be named, registered, and exposed in a class. Дополнительные сведения см. в разделе Общие сведения о перенаправленных событиях.For more information, see Routed Events Overview.

Применяется к