EventTrigger Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili pemicu yang menerapkan serangkaian tindakan sebagai respons terhadap peristiwa.
public ref class EventTrigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Actions")]
public class EventTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild
[<System.Windows.Markup.ContentProperty("Actions")>]
type EventTrigger = class
inherit TriggerBase
interface IAddChild
Public Class EventTrigger
Inherits TriggerBase
Implements IAddChild
- Warisan
- Atribut
- Penerapan
Contoh
Contoh ini menunjukkan cara menggunakan pemicu peristiwa dalam gaya untuk menganimasikan MouseEnter peristiwa dan MouseLeave dari FrameworkElement. Dalam contoh ini, Style telah diatur ke TargetTypeRectangle. Oleh karena itu, tidak perlu memenuhi MouseEnter syarat nama peristiwa dan MouseLeave dengan nama kelas.
<Style TargetType="Rectangle">
<Setter Property="Width" Value="50" />
<Setter Property="Height" Value="50" />
<Setter Property="Margin" Value="20" />
<Setter Property="HorizontalAlignment" Value="Left" />
<Style.Triggers>
<EventTrigger RoutedEvent="MouseEnter">
<BeginStoryboard>
<Storyboard>
<DoubleAnimation To="300" Duration="0:0:1.5"
AccelerationRatio="0.10" DecelerationRatio="0.25"
Storyboard.TargetProperty="(Canvas.Width)" />
</Storyboard>
</BeginStoryboard>
</EventTrigger>
<EventTrigger RoutedEvent="MouseLeave">
<BeginStoryboard>
<Storyboard>
<DoubleAnimation Duration="0:0:1.5"
AccelerationRatio="0.10" DecelerationRatio="0.25"
Storyboard.TargetProperty="(Canvas.Width)" />
</Storyboard>
</BeginStoryboard>
</EventTrigger>
</Style.Triggers>
</Style>
Keterangan
Trigger objek memiliki Settersproperti , EnterActions, dan ExitActions yang menerapkan perubahan atau tindakan berdasarkan status properti tertentu, sementara EventTrigger objek memulai sekumpulan Actions ketika peristiwa yang dirutekan tertentu terjadi. Misalnya, Anda mungkin ingin menggunakan EventTrigger untuk memulai sekumpulan animasi ketika penunjuk mouse berada di atas kontrol antarmuka pengguna (UI) tertentu. Tidak seperti Trigger, EventTrigger tidak memiliki konsep penghentian status, sehingga tindakan tidak akan dibatalkan setelah kondisi yang menaikkan peristiwa tidak lagi benar.
Perhatikan bahwa saat menggunakan EventTrigger, Anda perlu memilih peristiwa yang tidak mengganggu perilaku melekat kontrol Anda. Kontrol seperti Button atau TextBox melakukan tindakan tertentu pada peristiwa input pengguna seperti klik mouse dan peristiwa keyboard. Misalnya, jika Anda menata tombol dan mencoba mengatur MouseDown peristiwa sebagai RoutedEvent dari EventTrigger, EventTrigger tidak pernah diterapkan karena peristiwa pertama kali ditangani oleh tombol . Sebagai gantinya PreviewMouseDown , Anda dapat menggunakan peristiwa atau peristiwa lain.
Saat menggunakan pengikatan data, jika Anda menggunakan TargetUpdated peristiwa, Anda harus mengatur NotifyOnTargetUpdated nilai objek Anda Binding agar true peristiwa dinaikkan.
TriggerAction Menambahkan anak ke EventTrigger objek secara implisit menambahkannya ke TriggerActionCollection untuk EventTrigger objek.
Konstruktor
| Nama | Deskripsi |
|---|---|
| EventTrigger() |
Menginisialisasi instans baru dari kelas EventTrigger. |
| EventTrigger(RoutedEvent) |
Menginisialisasi instans EventTrigger baru kelas dengan peristiwa yang ditentukan. |
Properti
| Nama | Deskripsi |
|---|---|
| Actions |
Mendapatkan kumpulan tindakan yang akan diterapkan saat peristiwa terjadi. |
| DependencyObjectType |
DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject) |
| Dispatcher |
Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject) |
| EnterActions |
Mendapatkan kumpulan TriggerAction objek yang akan diterapkan saat objek pemicu menjadi aktif. Properti ini tidak berlaku untuk EventTrigger kelas. (Diperoleh dari TriggerBase) |
| ExitActions |
Mendapatkan kumpulan TriggerAction objek untuk diterapkan saat objek pemicu menjadi tidak aktif. Properti ini tidak berlaku untuk EventTrigger kelas. (Diperoleh dari TriggerBase) |
| IsSealed |
Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject) |
| RoutedEvent |
Mendapatkan atau mengatur RoutedEvent yang akan mengaktifkan pemicu ini. |
| SourceName |
Mendapatkan atau mengatur nama objek dengan peristiwa yang mengaktifkan pemicu ini. Ini hanya digunakan oleh pemicu elemen atau pemicu templat. |
Metode
| Nama | Deskripsi |
|---|---|
| AddChild(Object) |
Menambahkan objek yang ditentukan ke Actions kumpulan pemicu peristiwa saat ini. |
| AddText(String) |
Metode ini tidak didukung dan menghasilkan pengecualian. |
| CheckAccess() |
Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject) |
| ClearValue(DependencyProperty) |
Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject) |
| CoerceValue(DependencyProperty) |
Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject) |
| Equals(Object) |
Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject) |
| GetHashCode() |
Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject) |
| GetLocalValueEnumerator() |
Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| GetValue(DependencyProperty) |
Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject) |
| SetCurrentValue(DependencyProperty, Object) |
Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject) |
| SetValue(DependencyProperty, Object) |
Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject) |
| ShouldSerializeActions() |
Mengembalikan apakah proses serialisasi harus menserialisasikan nilai Actions efektif properti pada instans kelas ini. |
| ShouldSerializeProperty(DependencyProperty) |
Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| VerifyAccess() |
Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject) |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IAddChild.AddChild(Object) |
Menambahkan objek anak. |
| IAddChild.AddText(String) |
Menambahkan konten teks simpul ke objek. |