EventSetter Klas

Definitie

public ref class EventSetter : System::Windows::SetterBase

public class EventSetter : System.Windows.SetterBase

type EventSetter = class
    inherit SetterBase

Public Class EventSetter
Inherits SetterBase

Overname

Object

SetterBase

EventSetter

Voorbeelden

In het volgende voorbeeld wordt één EventSetter in een stijl op paginaniveau vastgelegd.

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

Hieronder ziet u de voorbeeld-gebeurtenis-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

Opmerkingen

Gebeurtenissetters roepen de opgegeven gebeurtenis-handlers aan als reactie op gerouteerde gebeurtenissen, die van toepassing zijn op alle elementen die verwijzen naar de Style in plaats van dat u instantie-handlers aan elk afzonderlijk element moet koppelen. Alleen Style.Setters ondersteuning voor EventSetter objecten.

U kunt alleen gebeurtenissetters declareren voor gebeurtenissen die gerouteerde gebeurtenissen zijn. U kunt gebeurtenissetters declareren voor gerouteerde gebeurtenissen met een directe routeringsstrategie, bubblinggebeurtenissen of tunnelingsgebeurtenissen.

Exemplaren van de EventSetter klasse worden meestal gemaakt via Extensible Application Markup Language (XAML), als objectelement binnen een stijl die is gedefinieerd via XAML. Een EventSetter kan ook worden geïnstantieerd vanuit code.

Gebeurtenissetters kunnen niet worden gebruikt in een stijl die is opgenomen in een themaresourcewoordenlijst. Dit komt doordat een themaresourcewoordenlijst tijdens runtime vaak losse binaire XAML-bestanden (BAML) is en geen bereik heeft dat is gedefinieerd waar de bijbehorende code-achter die definieert dat de handlers kunnen bestaan.

Handlers die zijn gekoppeld via gebeurtenissetters, worden aangeroepen na eventuele klasse-handlers voor een gebeurtenis, en ook na eventuele instantie-handlers. Als een klasse-handler of instantie-handler een gebeurtenis markeert die in de argumenten wordt verwerkt, wordt de handler die door een gebeurtenissetter is gedeclareerd, niet aangeroepen, tenzij de gebeurtenissetter specifiek wordt ingesteld HandledEventsTootrue.

Gebeurtenissetters kunnen ook afkomstig zijn van BasedOn stijlen. De gebeurtenissetter-handlers uit de opgegeven BasedOn stijl worden aangeroepen na de handlers in de directe stijl.

Houd er rekening mee dat alleen Style.Setters objecten worden ondersteund EventSetter . Triggers (TriggerBase en afgeleide klassen) bieden geen ondersteuning EventSettervoor .

Zie ook

• Handled
• AddHandler(RoutedEvent, Delegate, Boolean)