EventSetter EventSetter EventSetter EventSetter Class

Definición

Representa un establecedor de eventos en un estilo.Represents an event setter in a style. Los establecedores de eventos invocan los controladores de eventos especificados en respuesta a eventos.Event setters invoke the specified event handlers in response to events.

public ref class EventSetter : System::Windows::SetterBase
public class EventSetter : System.Windows.SetterBase
type EventSetter = class
    inherit SetterBase
Public Class EventSetter
Inherits SetterBase
Herencia
EventSetterEventSetterEventSetterEventSetter

Ejemplos

El siguiente ejemplo establece una sola EventSetter dentro de un estilo de nivel de página.The following example establishes a single EventSetter within a page-level style.

<StackPanel
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.EventOvw2"
  Name="dpanel2"
  Initialized="PrimeHandledToo"
>
  <StackPanel.Resources>
    <Style TargetType="{x:Type Button}">
      <EventSetter Event="Click" Handler="b1SetColor"/>
    </Style>
  </StackPanel.Resources>
  <Button>Click me</Button>
  <Button Name="ThisButton" Click="HandleThis">
    Raise event, handle it, use handled=true handler to get it anyway.
  </Button>
</StackPanel>

La siguiente muestra el ejemplo de controladores de eventos:The following shows the example event handlers:

void b1SetColor(object sender, RoutedEventArgs e)
{
  Button b = e.Source as Button;
  b.Background = new SolidColorBrush(Colors.Azure);
}

void HandleThis(object sender, RoutedEventArgs e)
{
  e.Handled=true;
}
 Private Sub b1SetColor(ByVal sender As Object, ByVal e As RoutedEventArgs)
Dim b As Button = TryCast(e.Source, Button)
b.Background = New SolidColorBrush(Colors.Azure)
 End Sub

 Private Sub HandleThis(ByVal sender As Object, ByVal e As RoutedEventArgs)
e.Handled=True
 End Sub

Comentarios

Establecedores de eventos invocan los controladores de eventos especificados en respuesta a eventos enrutados, que se aplican a todos los elementos que hacen referencia a la Style en lugar de requerir adjuntar controladores de instancia a cada elemento individual.Event setters invoke the specified event handlers in response to routed events, which apply to all elements that reference the Style rather than requiring you to attach instance handlers to each individual element. Solo Style.Setters admite EventSetter objetos.Only Style.Setters support EventSetter objects.

Solo puede declarar establecedores de eventos para los eventos que son eventos enrutados.You can only declare event setters for events that are routed events. Puede declarar establecedores de eventos para los eventos enrutados con una estrategia de enrutamiento directo, propagación de eventos o eventos de tunelización.You can declare event setters for routed events with a direct routing strategy, bubbling events, or tunneling events.

Las instancias de la EventSetter clase normalmente se crean a través de Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML), tal como se define un elemento de objeto dentro de un estilo a través de XAMLXAML.Instances of the EventSetter class are usually created through Lenguaje XAML (Extensible Application Markup Language)Extensible Application Markup Language (XAML), as an object element within a style defined through XAMLXAML. Un EventSetter también se puede crear instancias del código.An EventSetter might also be instantiated from code.

No se puede usar los establecedores de eventos en un estilo que se encuentra en un diccionario de recursos de tema.Event setters cannot be used in a style that is contained in a theme resource dictionary. Esto es porque un diccionario de recursos de tema en tiempo de ejecución a menudo es flexible XAML binario (BAML)binary XAML (BAML) archivos y no tiene ningún ámbito define donde puede existir el código subyacente que define los controladores adjunto.This is because a theme resource dictionary at run time is often loose XAML binario (BAML)binary XAML (BAML) files, and does not have any scope defined where accompanying code-behind that defines the handlers can exist.

Los controladores adjuntos a través de establecedores de eventos se invocan después de cualquier controlador de clase para un evento y también cualquier controlador de instancias.Handlers attached through event setters are invoked after any class handlers for an event, and also after any instance handlers. Como resultado, si un controlador de clase o un controlador de instancia se marca un evento como controlado en sus argumentos, a continuación, invoca el controlador declarado por un establecedor de eventos no es, a menos que el establecedor de eventos se establece específicamente HandledEventsToo true.As a result, if a class handler or instance handler marks an event handled in its arguments, then the handler declared by an event setter is not invoked, unless the event setter specifically sets HandledEventsToo true.

Los establecedores de eventos también pueden proceder de BasedOn estilos.Event setters may also come from BasedOn styles. Los controladores de establecedores de eventos desde el estilo especificado como BasedOn se invocará después de los controladores en el estilo de inmediato.The event setter handlers from the style specified as BasedOn will be invoked after the handlers on the immediate style.

Tenga en cuenta que solo Style.Setters admite EventSetter objetos.Note that only Style.Setters supports EventSetter objects. Desencadenadores (TriggerBase y sus clases derivadas) no admiten EventSetter.Triggers (TriggerBase and derived classes) do not support EventSetter.

Constructores

EventSetter() EventSetter() EventSetter() EventSetter()

Inicializa una nueva instancia de la clase EventSetter.Initializes a new instance of the EventSetter class.

EventSetter(RoutedEvent, Delegate) EventSetter(RoutedEvent, Delegate) EventSetter(RoutedEvent, Delegate) EventSetter(RoutedEvent, Delegate)

Inicializa una nueva instancia de la clase EventSetter, utilizando los parámetros de evento y controlador proporcionados.Initializes a new instance of the EventSetter class, using the provided event and handler parameters.

Propiedades

Event Event Event Event

Obtiene o establece el evento enrutado determinado al que responde este EventSetter.Gets or sets the particular routed event that this EventSetter responds to.

HandledEventsToo HandledEventsToo HandledEventsToo HandledEventsToo

Obtiene o establece un valor que determina si se debe invocar el controlador asignado al establecedor, incluso si el evento está marcado como controlado en sus datos de evento.Gets or sets a value that determines whether the handler assigned to the setter should still be invoked, even if the event is marked handled in its event data.

Handler Handler Handler Handler

Obtiene o establece la referencia a un controlador para un evento enrutado del establecedor.Gets or sets the reference to a handler for a routed event in the setter.

IsSealed IsSealed IsSealed IsSealed

Obtiene un valor que indica si este objeto se encuentra en un estado inmutable.Gets a value that indicates whether this object is in an immutable state.

(Inherited from SetterBase)

Métodos

CheckSealed() CheckSealed() CheckSealed() CheckSealed()

Comprueba si este objeto es de sólo lectura y no se puede cambiar.Checks whether this object is read-only and cannot be changed.

(Inherited from SetterBase)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: