EventSetter Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mewakili setter peristiwa dalam gaya. Setter peristiwa memanggil penanganan aktivitas yang ditentukan sebagai respons terhadap peristiwa.

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

public class EventSetter : System.Windows.SetterBase

type EventSetter = class
    inherit SetterBase

Public Class EventSetter
Inherits SetterBase

Warisan

Object

SetterBase

EventSetter

Contoh

Contoh berikut menetapkan satu EventSetter dalam gaya tingkat halaman.

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

Berikut ini memperlihatkan contoh penanganan aktivitas:

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

Keterangan

Setter peristiwa memanggil penanganan aktivitas yang ditentukan sebagai respons terhadap peristiwa yang dirutekan, yang berlaku untuk semua elemen yang mereferensikan Style daripada mengharuskan Anda melampirkan handler instans ke setiap elemen individual. Hanya Style.Setters mendukung objek EventSetter.

Anda hanya dapat mendeklarasikan setter peristiwa untuk peristiwa yang merupakan peristiwa yang dirutekan. Anda dapat mendeklarasikan setter peristiwa untuk peristiwa yang dirutekan dengan strategi perutean langsung, peristiwa gelembung, atau peristiwa penerowongan.

Instans kelas EventSetter biasanya dibuat melalui Extensible Application Markup Language (XAML), sebagai elemen objek dalam gaya yang ditentukan melalui XAML. EventSetter mungkin juga dibuat dari kode.

Setter peristiwa tidak dapat digunakan dalam gaya yang terkandung dalam kamus sumber daya tema. Ini karena kamus sumber daya tema pada waktu proses sering kali longgar file XAML biner (BAML), dan tidak memiliki cakupan yang ditentukan di mana kode yang menyertainya di belakang yang menentukan handler dapat ada.

Handler yang dilampirkan melalui setter peristiwa dipanggil setelah handler kelas apa pun untuk suatu peristiwa, dan juga setelah handler instans apa pun. Akibatnya, jika handler kelas atau handler instans menandai peristiwa yang ditangani dalam argumennya, maka handler yang dideklarasikan oleh setter peristiwa tidak dipanggil, kecuali setter peristiwa secara khusus mengatur HandledEventsTootrue.

Setter peristiwa mungkin juga berasal dari gaya BasedOn. Handler setter peristiwa dari gaya yang ditentukan sebagai BasedOn akan dipanggil setelah handler pada gaya langsung.

Perhatikan bahwa hanya Style.Setters yang mendukung objek EventSetter. Pemicu (TriggerBase dan kelas turunan) tidak mendukung EventSetter.

Konstruktor

EventSetter()	Menginisialisasi instans baru kelas EventSetter.
EventSetter(RoutedEvent, Delegate)	Menginisialisasi instans baru kelas EventSetter, menggunakan parameter event dan handler yang disediakan.

Properti

Event	Mendapatkan atau mengatur peristiwa rute tertentu yang direspons EventSetter ini.
HandledEventsToo	Mendapatkan atau menetapkan nilai yang menentukan apakah handler yang ditetapkan ke setter masih harus dipanggil, bahkan jika peristiwa ditandai ditangani dalam data peristiwanya.
Handler	Mendapatkan atau mengatur referensi ke handler untuk peristiwa yang dirutekan di setter.
IsSealed	Mendapatkan nilai yang menunjukkan apakah objek ini dalam status tidak dapat diubah. (Diperoleh dari SetterBase)

Metode

CheckSealed()	Memeriksa apakah objek ini bersifat baca-saja dan tidak dapat diubah. (Diperoleh dari SetterBase)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Handled
• AddHandler(RoutedEvent, Delegate, Boolean)