EventSetter Klasa

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

Reprezentuje zestaw zdarzeń w stylu. Zestawy zdarzeń 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 jeden EventSetter element 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

Zestawy zdarzeń 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łączania programów obsługi wystąpień do każdego elementu. Obsługują EventSetter tylko Style.Setters obiekty.

Można zadeklarować tylko zestawy zdarzeń dla zdarzeń, które są kierowane zdarzenia. Możesz zadeklarować zestawy zdarzeń dla zdarzeń kierowanych przy użyciu 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. Można EventSetter również utworzyć wystąpienie kodu.

Nie można używać zestawów zdarzeń 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źnym plikiem binarnym XAML (BAML) i nie ma żadnego zakresu zdefiniowanego, w którym może istnieć towarzyszący kod, który definiuje programy obsługi.

Programy obsługi dołączone za pośrednictwem zestawów zdarzeń 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, procedura obsługi zadeklarowana przez moduł ustawiania zdarzeń nie jest wywoływana, chyba że zestaw zdarzeń w szczególności ustawia HandledEventsToo true.

Zestawy zdarzeń mogą również pochodzić ze BasedOn stylów. Programy obsługi zestawów zdarzeń z określonego BasedOn stylu będą wywoływane po obsłudze w bezpośrednim stylu.

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

Konstruktory

EventSetter()

Inicjuje nowe wystąpienie klasy EventSetter.
EventSetter(RoutedEvent, Delegate)

Inicjuje nowe wystąpienie klasy przy użyciu podanych EventSetter parametrów zdarzenia i procedury obsługi.

Właściwości

Event

Pobiera lub ustawia określone zdarzenie kierowane, na które EventSetter odpowiada.
HandledEventsToo

Pobiera lub ustawia wartość określającą, czy program obsługi przypisany do zestawu 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 zestawie.
IsSealed

Pobiera wartość wskazującą, czy ten obiekt jest w stanie niezmiennym.

(Odziedziczone po SetterBase)

Metody

CheckSealed()

Sprawdza, czy ten obiekt jest tylko do odczytu i nie można go zmienić.

(Odziedziczone po SetterBase)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też