Setter.Value Properti

Definisi

Ruang nama:

Windows.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 Nilai 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 antarmuka pengguna 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 Properti dan Nilai pada Setter. Jika tidak, pengecualian dilemparkan (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 apa pun dari instans Setter jika nilai properti IsSealed pada Gaya induk adalah benar. Ini juga dilaporkan oleh properti IsSealed pada Setter individu. Sistem mengatur properti ini ke true ketika runtime menerapkan gaya ke elemen UI dan menampilkannya di UI. Mencoba mengubah Setter yang disegel akan menimbulkan 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 Gaya biasa. Nilai untuk Setter dengan Property="Template" hampir selalu ditentukan sebagai elemen properti yang berisi elemen objek ControlTemplate .

Saat Gaya digunakan untuk menentukan templat kontrol, TargetType elemen Style 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 Gaya dalam skenario templat kontrol, lihat Mulai Cepat: Mengontrol templat.