EventSetter Sınıf

Tanım

Bir stilde olay ayarlayıcısı temsil eder.Represents an event setter in a style. Olay ayarlayıcıları, olaylara yanıt olarak belirtilen olay işleyicilerini çağırır.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
Devralma
EventSetter

Örnekler

Aşağıdaki örnek, EventSetter sayfa düzeyindeki bir stil içinde tek bir oluşturur.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>

Örnek olay işleyicilerini aşağıda gösterilmektedir: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

Açıklamalar

Olay ayarlayıcıları, Style her bir öğeye örnek işleyicileri iliştirmesini gerektirmek yerine, başvuruda bulunan tüm öğeler için uygulanan yönlendirilmiş olaylara yanıt olarak belirtilen olay işleyicilerini çağırır.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. Yalnızca Style.Setters Destek EventSetter nesneleri.Only Style.Setters support EventSetter objects.

Yalnızca yönlendirilmiş olay olan olaylar için olay ayarlayıcıları bildirebilirsiniz.You can only declare event setters for events that are routed events. Doğrudan yönlendirme stratejisi, kabarcıklanma olayları veya tünel olayları ile yönlendirilmiş olaylar için olay ayarlayıcıları bildirebilirsiniz.You can declare event setters for routed events with a direct routing strategy, bubbling events, or tunneling events.

EventSetterSınıfının örnekleri Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) , ile tanımlanan bir stil içindeki nesne öğesi olarak oluşturulur XAMLXAML .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. EventSetterKoddan bir de örnek oluşturulabilir.An EventSetter might also be instantiated from code.

Olay ayarlayıcıları tema kaynak sözlüğünde bulunan bir stilde kullanılamaz.Event setters cannot be used in a style that is contained in a theme resource dictionary. Bunun nedeni, çalışma zamanında bir tema kaynağı sözlüğünün genellikle gevşek dosyalar olması ikili XAML (BAML)binary XAML (BAML) ve işleyicileri tanımlayan arka plan kodunun mevcut olduğu bir kapsama sahip olmaması olabilir.This is because a theme resource dictionary at run time is often loose ikili XAML (BAML)binary XAML (BAML) files, and does not have any scope defined where accompanying code-behind that defines the handlers can exist.

Olay ayarlayıcıları aracılığıyla eklenen işleyiciler, bir olay için herhangi bir sınıf işleyicilerinden sonra ve ayrıca herhangi bir örnek işleyicilerde çağrılır.Handlers attached through event setters are invoked after any class handlers for an event, and also after any instance handlers. Sonuç olarak, bir sınıf işleyicisi veya örnek işleyicisi bağımsız değişkenlerinde işlenen bir olayı işaretlediğinde, olay ayarlayıcısı tarafından tanımlanan işleyici, özel olarak ayarlanmadığı sürece çağrılmaz HandledEventsToo true .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.

Olay ayarlayıcıları, stillerden de gelebilir BasedOn .Event setters may also come from BasedOn styles. Olarak belirtilen stilden olay ayarlayıcısı işleyicileri, BasedOn anında stildeki işleyicilerden sonra çağrılacaktır.The event setter handlers from the style specified as BasedOn will be invoked after the handlers on the immediate style.

Yalnızca Style.Setters nesneleri desteklediğini unutmayın EventSetter .Note that only Style.Setters supports EventSetter objects. Tetikleyiciler ( TriggerBase ve türetilmiş sınıflar) desteklemez EventSetter .Triggers (TriggerBase and derived classes) do not support EventSetter.

Oluşturucular

EventSetter()

EventSetter sınıfının yeni bir örneğini başlatır.Initializes a new instance of the EventSetter class.

EventSetter(RoutedEvent, Delegate)

EventSetterBelirtilen olay ve işleyici parametrelerini kullanarak sınıfının yeni bir örneğini başlatır.Initializes a new instance of the EventSetter class, using the provided event and handler parameters.

Özellikler

Event

Bu yanıt veren özel yönlendirilmiş olayı alır veya ayarlar EventSetter .Gets or sets the particular routed event that this EventSetter responds to.

HandledEventsToo

Olay, olay verilerinde işlenmiş olarak işaretlenmiş olsa bile, ayarlayıcıya atanan işleyicinin hala çağrılması gerekip gerekmediğini belirleyen bir değer alır veya ayarlar.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

Ayarlayıcıdaki yönlendirilmiş olay için bir işleyicinin başvurusunu alır veya ayarlar.Gets or sets the reference to a handler for a routed event in the setter.

IsSealed

Bu nesnenin sabit bir durumda olup olmadığını gösteren bir değer alır.Gets a value that indicates whether this object is in an immutable state.

(Devralındığı yer: SetterBase)

Yöntemler

CheckSealed()

Bu nesnenin salt okunurdur ve değiştirilemez olup olmadığını denetler.Checks whether this object is read-only and cannot be changed.

(Devralındığı yer: SetterBase)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.