EventSetter Klasse

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
EventSetter

Beispiele

Im folgenden Beispiel wird eine einzelne EventSetter innerhalb eines Stils auf Seitenebene festgelegt.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 die 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

Ereignis Setter rufen die angegebenen Ereignishandler als Antwort auf Routing Ereignisse auf, die für alle Elemente gelten, die auf verweisen Style , anstatt dass Sie Instanzhandler an jedes einzelne Element anfügen müssen.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 Objekte EventSetter werden unterstützt.Only Style.Setters support EventSetter objects.

Sie können nur Ereignis Setter für Ereignisse deklarieren, bei denen es sich um Routing Ereignisse handelt.You can only declare event setters for events that are routed events. Sie können Ereignis Setter für Routing Ereignisse mit direkter Routing Strategie, bubblingereignissen oder tunnelingereignissen deklarieren.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 Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)durch erstellt, als Objekt Element innerhalb eines durch XAMLXAMLdefinierten Stils.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. Eine EventSetter kann auch aus dem Code instanziiert werden.An EventSetter might also be instantiated from code.

Ereignis Setter können nicht in einem Stil verwendet werden, der in einem Design Ressourcen Wörterbuch enthalten ist.Event setters cannot be used in a style that is contained in a theme resource dictionary. Dies liegt daran, dass es sich bei einem Design Ressourcen Wörterbuch zur Laufzeit oft um lose Binäre XAML (BAML)binary XAML (BAML) Dateien handelt und kein Bereich definiert ist, in dem begleitende Code-Behind-Dateien vorhanden sein können, die die Handler definieren.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.

Handler, die über Ereignis Setter angefügt werden, werden nach allen Klassen Handlern für ein Ereignis und auch nach beliebigen Instanzhandlern aufgerufen.Handlers attached through event setters are invoked after any class handlers for an event, and also after any instance handlers. Wenn ein Klassen Handler oder Instanzhandler ein Ereignis kennzeichnet, das in den Argumenten behandelt wird, wird der von einem Ereignis Setter deklarierte Handler nicht aufgerufen, es sei denn, der HandledEventsToo Ereignis Setter legt trueausdrücklich fest.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.

Ereignis Setter können auch aus BasedOn Stilen stammen.Event setters may also come from BasedOn styles. Die Ereignis Setter-Handler aus dem Format, das BasedOn als angegeben ist, werden nach den Handlern im unmittelbaren Stil aufgerufen.The event setter handlers from the style specified as BasedOn will be invoked after the handlers on the immediate style.

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

Konstruktoren

EventSetter()

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

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

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

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

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

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

(Geerbt von SetterBase)

Methoden

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.

(Geerbt von SetterBase)
Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Gilt für:

Siehe auch