EventSetter EventSetter EventSetter EventSetter Class

Definition

Stellt einen Ereignissetter in einem Format dar.Represents an event setter in a style. Ereignissetter rufen in Reaktion auf Ereignisse die angegebenen Ereignishandler auf.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
Vererbung
EventSetterEventSetterEventSetterEventSetter

Beispiele

Im folgende Beispiel wird ein einziger EventSetter innerhalb eines Stils auf Seitenebene.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>

Das folgende Beispiel zeigt das Beispiel-Ereignishandler: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

Hinweise

Ereignissetter rufen die angegebenen Ereignishandler als Reaktion auf Routingereignisse, die auf alle Elemente angewendet wird, die auf verweisen die Style und Sie müssen keine Instanzhandler an jedes einzelne Element angefügt.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. Nur Style.Setters unterstützen EventSetter Objekte.Only Style.Setters support EventSetter objects.

Sie können nur Ereignissetter für Ereignisse deklarieren, die weitergeleitete Ereignisse sind.You can only declare event setters for events that are routed events. Sie können Ereignissetter für Routingereignisse mit einer direkten Routingstrategie deklarieren, Ereignisse bubbling und Tunneling-Ereignisse.You can declare event setters for routed events with a direct routing strategy, bubbling events, or tunneling events.

Instanzen der EventSetter -Klasse werden in der Regel über erstellt Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), wie Sie über ein Object-Element innerhalb eines Stils definiert XAMLXAML.Instances of the EventSetter class are usually created through Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), as an object element within a style defined through XAMLXAML. Ein EventSetter möglicherweise auch vom Code instanziiert werden.An EventSetter might also be instantiated from code.

Ereignissetter können nicht in einem Stil verwendet werden, die in einem Ressourcenverzeichnis des Designs enthalten ist.Event setters cannot be used in a style that is contained in a theme resource dictionary. Dies ist, da ein Ressourcenverzeichnis des Designs zur Laufzeit häufig lose ist Binäre XAML (BAML)binary XAML (BAML) Dateien und verfügt über keine Bereich definiert, in dem zugehörigen Code-Behind, die definiert, die Handler vorhanden sein kann.This is because a theme resource dictionary at run time is often loose Binäre XAML (BAML)binary XAML (BAML) files, and does not have any scope defined where accompanying code-behind that defines the handlers can exist.

Über Ereignissetter angefügte Handlern werden nach jeder Klassenhandler für ein Ereignis, und nach dem keine Instanzhandler aufgerufen.Handlers attached through event setters are invoked after any class handlers for an event, and also after any instance handlers. Daher Wenn ein Klassen- oder Instanzhandler ein Ereignis in den Argumenten behandelt kennzeichnet, klicken Sie dann die Handler durch einen Ereignissetter deklariert wird nicht aufgerufen, es sei denn, der Ereignissetter speziell legt diese fest 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.

Ereignissetter auch stammen dürfen BasedOn Stile.Event setters may also come from BasedOn styles. Die Setter-Ereignishandler aus dem Stil, angegeben als BasedOn wird aufgerufen, nachdem die Handler für das sofortige Format.The event setter handlers from the style specified as BasedOn will be invoked after the handlers on the immediate style.

Beachten Sie, dass nur Style.Setters unterstützt EventSetter Objekte.Note that only Style.Setters supports EventSetter objects. Trigger (TriggerBase und abgeleitete Klassen) unterstützen keine EventSetter.Triggers (TriggerBase and derived classes) do not support EventSetter.

Konstruktoren

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

Initialisiert eine neue Instanz der EventSetter-Klasse.Initializes a new instance of the EventSetter class.

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

Initialisiert eine neue Instanz der EventSetter-Klasse unter Verwendung des angegebenen Ereignisses und von Handlerparametern.Initializes a new instance of the EventSetter class, using the provided event and handler parameters.

Eigenschaften

Event Event Event Event

Ruft das bestimmte Routingereignis ab, auf das dieser EventSetter reagiert, oder legt es fest.Gets or sets the particular routed event that this EventSetter responds to.

HandledEventsToo HandledEventsToo HandledEventsToo HandledEventsToo

Ruft einen Wert ab, der bestimmt, ob der dem Setter zugewiesene Handler auch dann aufgerufen werden soll, wenn das Ereignis in den zugehörigen Ereignisdaten als behandelt markiert ist, oder legt diesen fest.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

Ruft den Verweis auf einen Handler für ein Routingereignis im Setter ab oder legt diesen fest.Gets or sets the reference to a handler for a routed event in the setter.

IsSealed IsSealed IsSealed IsSealed

Ruft einen Wert ab, der angibt, ob dieses Objekt einen unveränderlichen Zustand aufweist.Gets a value that indicates whether this object is in an immutable state.

(Inherited from SetterBase)

Methoden

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

Überprüft, ob dieses Objekt schreibgeschützt ist und nicht geändert werden kann.Checks whether this object is read-only and cannot be changed.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch