Setter.Value Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml

Mendapatkan atau mengatur nilai yang akan diterapkan ke properti yang ditentukan oleh Setter.

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Value();

void Value(IInspectable value);

public object Value { get; set; }

var object = setter.value;
setter.value = object;

Public Property Value As Object

<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

Nilai Properti

Object

Platform::Object

IInspectable

Nilai yang akan diterapkan ke properti yang ditentukan oleh Setter.

Keterangan

Seperti yang Anda lihat dari sintaks XAML, ada berbagai cara untuk menentukan Value untuk Setter di XAML:

• Sebagai atribut, menggunakan nilai string. Nilai string tersebut dapat dikonversi secara implisit ke jenis khusus properti untuk kasus sederhana seperti mengatur nilai numerik, nilai bernama dari enumerasi, atau Pengidentifikasi Sumber Daya Seragam (URI).
• Sebagai objek baru lengkap yang dideklarasikan dalam sintaks elemen objek XAML, dan elemen objek ditumpuk dalam penggunaan elemen properti.
• Sebagai atribut yang memiliki penggunaan ekstensi markup {StaticResource} dalam tanda kutip. Biasanya jenis nilai properti menentukan sintaks mana yang sesuai. Untuk informasi selengkapnya tentang penggunaan XAML, lihat gambaran umum XAML atau panduan sintaks XAML. Anda dapat menggunakan sintaks atribut untuk sebagian besar properti UI XAML, dan properti UI yang secara khusus memerlukan penggunaan elemen properti atau referensi sumber daya kurang umum. Penggunaan ekstensi markup {StaticResource} dapat sesuai bahkan untuk string atau nilai numerik jika nilai tersebut dibagikan oleh lebih dari satu gaya atau properti.

Anda harus menentukan Properti dan Value properti pada Setter. Jika tidak, pengecualian dilemparkan (baik pengecualian penguraian atau kesalahan runtime, tergantung pada apakah Setter dibuat di XAML atau dimodifikasi dalam kode).

Jika Anda mengakses instans Setter menggunakan kode, Anda tidak dapat mengubah nilai properti Setter instans apa pun jika nilai properti IsSealed pada Gaya induk adalah true. Ini juga dilaporkan oleh properti IsSealed pada individu Setter. Sistem mengatur properti ini ke true ketika runtime menerapkan gaya ke elemen UI dan menampilkannya di UI. Mencoba mengubah yang disegel Setter melemparkan kesalahan runtime.

Gaya dan template

Anda bisa menggunakan Setter dalam Gaya untuk menerapkan nilai ke properti dependensi apa pun. Tetapi ini adalah Setter untuk properti Templat dari kelas turunan Kontrol yang merupakan sebagian besar markup XAML dalam khas Style. untuk dengan hampir selalu ditentukan sebagai elemen properti yang berisi elemen objek ControlTemplate.Property="Template"SetterValue

Saat Gaya digunakan untuk menentukan templat kontrol, TargetTypeStyle elemen dan TargetType dari elemen ControlTemplate untuk setter Control.Template-nya harus selalu menggunakan nilai yang sama.

Setter templat menentukan definisi antarmuka pengguna templat dasar untuk instans kontrol tempat templat tersebut diterapkan. Ini juga berisi status visual untuk kontrol, dan definisi UI berbasis status lainnya seperti transisi tema default. Untuk kontrol kompleks seperti ListBox, Gaya templat default dan ControlTemplate di dalamnya dapat memiliki ratusan baris XAML. Untuk informasi selengkapnya tentang peran Style dalam skenario templat kontrol, lihat templat Kontrol XAML.