EventSetter Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Reprezentuje element ustawiania zdarzeń w stylu. Programy ustawiające zdarzenia wywołują określone programy obsługi zdarzeń w odpowiedzi na zdarzenia.

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

public class EventSetter : System.Windows.SetterBase

type EventSetter = class
    inherit SetterBase

Public Class EventSetter
Inherits SetterBase

Dziedziczenie

Object

SetterBase

EventSetter

Przykłady

Poniższy przykład ustanawia pojedynczy element EventSetter w stylu na poziomie strony.

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

Poniżej przedstawiono przykładowe programy obsługi zdarzeń:

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

Uwagi

Programy ustawiające zdarzenia wywołują określone programy obsługi zdarzeń w odpowiedzi na zdarzenia kierowane, które mają zastosowanie do wszystkich elementów odwołujących Style się do elementu, zamiast wymagać dołączenia programów obsługi wystąpień do każdego elementu. Obsługują Style.Setters tylko EventSetter obiekty.

Można zadeklarować tylko programy ustawiające zdarzenia dla zdarzeń, które są kierowane zdarzenia. Można zadeklarować zestawy zdarzeń dla zdarzeń kierowanych za pomocą strategii routingu bezpośredniego, zdarzeń bubbling lub zdarzeń tunelowania.

EventSetter Wystąpienia klasy są zwykle tworzone za pomocą języka XAML (Extensible Application Markup Language) jako elementu obiektu zdefiniowanego za pomocą języka XAML. Element EventSetter może być również tworzone z poziomu kodu.

Zestawy zdarzeń nie mogą być używane w stylu zawartym w słowniku zasobów motywu. Jest to spowodowane tym, że słownik zasobów motywu w czasie wykonywania jest często luźne pliki binarne XAML (BAML) i nie ma żadnego zdefiniowanego zakresu, w którym może istnieć towarzyszący kod, który definiuje programy obsługi.

Programy obsługi dołączone za pośrednictwem modułów ustawiających zdarzenia są wywoływane po każdym procedurze obsługi klas dla zdarzenia, a także po wszystkich programach obsługi wystąpień. W związku z tym, jeśli program obsługi klas lub program obsługi wystąpień oznacza zdarzenie obsługiwane w argumentach, program obsługi zadeklarowany przez moduł ustawiania zdarzeń nie jest wywoływany, chyba że program ustawiania zdarzeń specjalnie ustawia HandledEventsTootruewartość .

Zestawy zdarzeń mogą również pochodzić ze BasedOn stylów. Programy obsługi ustawiające zdarzenia z określonego BasedOn stylu będą wywoływane po programach obsługi w stylu natychmiastowym.

Należy pamiętać, że obsługuje Style.Setters tylko EventSetter obiekty. Wyzwalacze (TriggerBase i klasy pochodne) nie obsługują EventSetter.

Konstruktory

Nazwa	Opis
EventSetter()	Inicjuje nowe wystąpienie klasy EventSetter.
EventSetter(RoutedEvent, Delegate)	Inicjuje nowe wystąpienie EventSetter klasy przy użyciu podanych parametrów zdarzenia i procedury obsługi.

Właściwości

Nazwa	Opis
Event	Pobiera lub ustawia określone zdarzenie kierowane, na które odpowiada.EventSetter
HandledEventsToo	Pobiera lub ustawia wartość, która określa, czy program obsługi przypisany do modułu ustawiania powinien być nadal wywoływany, nawet jeśli zdarzenie jest oznaczone jako obsługiwane w danych zdarzenia.
Handler	Pobiera lub ustawia odwołanie do procedury obsługi dla zdarzenia kierowanego w ustawieniu.
IsSealed	Pobiera wartość wskazującą, czy ten obiekt jest w stanie niezmiennym. (Odziedziczone po SetterBase)

Metody

Nazwa	Opis
CheckSealed()	Sprawdza, czy ten obiekt jest tylko do odczytu i nie można go zmienić. (Odziedziczone po SetterBase)

Zobacz też

• Handled
• AddHandler(RoutedEvent, Delegate, Boolean)