Trigger Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mewakili pemicu yang menerapkan nilai properti atau melakukan tindakan secara kondisional.

public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Trigger : System.Windows.TriggerBase, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface IAddChild

Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize

Warisan

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Atribut

ContentPropertyAttribute XamlSetTypeConverterAttribute

Penerapan

IAddChild ISupportInitialize

Contoh

Contoh berikut menunjukkan nama Style yang tersedia untuk Button kontrol. Style menentukan Trigger elemen yang mengubah Foreground properti tombol saat IsPressed properti adalah true.

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

Keterangan

WPF mendefinisikan properti yang sesuai dengan tindakan pengguna akhir, seperti IsMouseOver properti yang diatur ke true ketika pengguna mengarahkan kursor ke atas UIElement atau properti yang ContentElementsesuai IsMouseOver dari . Mewakili tindakan pengguna akhir dalam nilai properti, bersama dengan Trigger elemen , memungkinkan gaya WPF untuk mengubah nilai properti berdasarkan tindakan pengguna akhir tersebut, semuanya dari dalam markup.

Properti yang diubah oleh pemicu secara otomatis diatur ulang ke nilai sebelumnya ketika kondisi yang dipicu tidak lagi terpenuhi. Pemicu dioptimalkan untuk status sementara yang diharapkan berubah dan kembali ke status asli, seperti IsPressed aktif Button dan IsSelected aktif ListBoxItem. Yang Property menarik harus merupakan properti dependensi.

Perhatikan bahwa Anda harus menentukan Property properti dan Value pada pemicu Trigger agar bermakna. Jika salah satu atau kedua properti tidak diatur, pengecualian akan dilemparkan.

Properti SettersTrigger objek hanya dapat terdiri dari Setter objek. Setter Menambahkan anak ke Trigger objek secara implisit menambahkannya ke SetterBaseCollection untuk Trigger objek. EventSetter objek tidak didukung; hanya Style.Setters mendukung EventSetter objek.

Ada jenis pemicu lainnya. MultiTrigger memungkinkan Anda menerapkan perubahan berdasarkan status beberapa properti. EventTrigger memungkinkan Anda menerapkan perubahan saat peristiwa terjadi. DataTrigger dan MultiDataTrigger untuk properti terikat data.

Konstruktor

Nama	Deskripsi
Trigger()	Menginisialisasi instans baru dari kelas Trigger.

Properti

Nama	Deskripsi
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)
Property	Mendapatkan atau mengatur properti yang mengembalikan nilai yang dibandingkan dengan Value properti pemicu. Perbandingannya adalah pemeriksaan kesetaraan referensi.
Setters	Mendapatkan kumpulan Setter objek, yang menjelaskan nilai properti yang akan diterapkan saat kondisi yang ditentukan telah terpenuhi.
SourceName	Mendapatkan atau mengatur nama objek dengan properti yang menyebabkan setter terkait diterapkan.
Value	Mendapatkan atau mengatur nilai yang akan dibandingkan dengan nilai properti elemen . Perbandingannya adalah pemeriksaan kesetaraan referensi.

Metode

Nama	Deskripsi
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)
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)
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)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Menangani kasus di mana pengonversi jenis menyediakan nilai untuk properti Trigger objek.
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)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
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.
ISupportInitialize.BeginInit()	Memberi sinyal objek bahwa inisialisasi dimulai.
ISupportInitialize.EndInit()	Memberi sinyal objek bahwa inisialisasi selesai.