Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

EventSetter-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen Ereignissetter in einem Format dar. Ereignissetter rufen in Reaktion auf Ereignisse die angegebenen Ereignishandler auf.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

System.Object
  System.Windows.SetterBase
    System.Windows.EventSetter

public class EventSetter : SetterBase

NameBeschreibung
System_CAPS_pubmethodEventSetter()

Initialisiert eine neue Instanz der EventSetter-Klasse.

System_CAPS_pubmethodEventSetter(RoutedEvent, Delegate)

Initialisiert eine neue Instanz der EventSetter-Klasse unter Verwendung des angegebenen Ereignisses und von Handlerparametern.

NameBeschreibung
System_CAPS_pubpropertyEvent

Ruft das bestimmte Routingereignis ab, auf das dieser EventSetter reagiert, oder legt es fest.

System_CAPS_pubpropertyHandledEventsToo

Ruft ab oder legt einen Wert, der bestimmt, ob der dem Setter zugewiesene Handler aufgerufen werden soll, auch wenn das Ereignis in den Ereignisdaten markiert wird.

System_CAPS_pubpropertyHandler

Ruft ab oder legt den Verweis auf einen Handler für ein Routingereignis im Setter.

System_CAPS_pubpropertyIsSealed

Ruft einen Wert ab, der angibt, ob dieses Objekt einen unveränderlichen Zustand aufweist.(Geerbt von „SetterBase“.)

NameBeschreibung
System_CAPS_protmethodCheckSealed()

Überprüft, ob dieses Objekt schreibgeschützt ist und kann nicht geändert werden.(Geerbt von „SetterBase“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Event setters invoke the specified event handlers in response to routed events, which apply to all elements that reference the T:System.Windows.Style rather than requiring you to attach instance handlers to each individual element. Only P:System.Windows.Style.Setters support T:System.Windows.EventSetter objects.

You can only declare event setters for events that are routed events. You can declare event setters for routed events with a direct routing strategy, bubbling events, or tunneling events.

Instances of the T:System.Windows.EventSetter class are usually created through TLA#tla_xaml, as an object element within a style defined through TLA2#tla_xaml. An T:System.Windows.EventSetter might also be instantiated from code.

Event setters cannot be used in a style that is contained in a theme resource dictionary. This is because a theme resource dictionary at run time is often loose TLA#tla_baml files, and does not have any scope defined where accompanying code-behind that defines the handlers can exist.

Handlers attached through event setters are invoked after any class handlers for an event, and also after any instance handlers. 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 P:System.Windows.EventSetter.HandledEventsToo true.

Event setters may also come from P:System.Windows.Style.BasedOn styles. The event setter handlers from the style specified as P:System.Windows.Style.BasedOn will be invoked after the handlers on the immediate style.

Note that only P:System.Windows.Style.Setters supports T:System.Windows.EventSetter objects. Triggers (T:System.Windows.TriggerBase and derived classes) do not support T:System.Windows.EventSetter.

The following example establishes a single T:System.Windows.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>

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;
}

.NET Framework
Verfügbar seit 3.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: