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

定義

新しいルーティング イベントを 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 String 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 RoutingStrategy RoutingStrategy

列挙体の値としてのイベントのルーティング方法。The routing strategy of the event as a value of the enumeration.

handlerType
Type Type Type

イベント ハンドラーの型。The type of the event handler. これはデリゲートの型である必要があり、null を指定することはできません。This must be a delegate type and cannot be null.

ownerType
Type Type 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. ルーティング イベント識別子は、他のイベント システム APIAPIs にも使用されます。The routed event identifier is also used for other event system APIAPIs.

注釈

このメソッドの戻り値を使用して、一意の静的な宣言を作成する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.

適用対象