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

Definizione

Registra un nuovo evento indirizzato nel sistema di eventi 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

Parametri

name
String

Nome dell'evento indirizzato.The name of the routed event. Il nome deve essere univoco all'interno del tipo di proprietario e non può essere null o una stringa vuota.The name must be unique within the owner type and cannot be null or an empty string.

routingStrategy
RoutingStrategy

Strategia di routing dell'evento come valore dell'enumerazione.The routing strategy of the event as a value of the enumeration.

handlerType
Type

Tipo del gestore dell'evento.The type of the event handler. Deve trattarsi di un tipo delegato e non può essere null.This must be a delegate type and cannot be null.

ownerType
Type

Tipo di classe proprietario dell'evento indirizzato.The owner class type of the routed event. Non può essere null.This cannot be null.

Restituisce

Identificatore dell'evento indirizzato appena registrato.The identifier for the newly registered routed event. Questo oggetto identificatore può ora essere archiviato come campo statico in una classe e poi usato come parametro per i metodi che associano i gestori all'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. L'identificatore di evento indirizzato viene usato anche per altre API del sistema di eventi.The routed event identifier is also used for other event system APIs.

Commenti

Usare il valore restituito di questo metodo per creare la dichiarazione statica per un campo identificatore RoutedEvent univoco.Use the return value of this method to create the static declaration for a unique RoutedEvent identifier field. Questo campo deve essere archiviato all'interno del tipo di proprietario.This field should be stored within the owner type.

Esistono un numero considerevole di convenzioni e procedure consigliate associate al modo in cui gli eventi indirizzati devono essere denominati, registrati ed esposti in una 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. Per ulteriori informazioni, vedere Cenni preliminari sugli eventi indirizzati.For more information, see Routed Events Overview.

Si applica a