FrameworkElement.Style Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur gaya yang digunakan oleh elemen ini saat dirender.

public:
 property System::Windows::Style ^ Style { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };

public System.Windows.Style Style { get; set; }

member this.Style : System.Windows.Style with get, set

Public Property Style As Style

Nilai Properti

Style

Gaya nondefault yang diterapkan untuk elemen, jika ada. Sebaliknya, null. Default untuk yang dibangun FrameworkElement secara default adalah null.

Contoh

Contoh berikut mendefinisikan gaya dalam kamus sumber daya.

<Page.Resources>

<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>

<Border Style="{StaticResource PageBackground}">

</Border>

Keterangan

Untuk kontrol, gaya saat ini sering disediakan oleh gaya default dari mengontrol tema, atau dari gaya yang umumnya diterapkan ke kontrol jenis tersebut menurut sumber daya di tingkat halaman atau aplikasi (gaya implisit). Properti ini tidak mengatur atau mengembalikan gaya default (tema), tetapi menampilkan gaya implisit atau gaya eksplisit yang bertindak pada elemen . Dalam kasus gaya implisit atau eksplisit, tidak masalah apakah gaya ditentukan sebagai sumber daya atau didefinisikan secara lokal.

Mengatur gaya memiliki beberapa batasan. Anda dapat mengatur ulang seluruh Style properti ke properti baru Style kapan saja, yang akan memaksa rekomposisi tata letak. Namun, segera setelah gaya itu ditempatkan dalam penggunaan oleh elemen yang dimuat, Style harus dianggap disegel. Mencoba membuat perubahan pada properti individu mana pun dari gaya yang digunakan (seperti apa pun dalam kumpulan Setters) menyebabkan pengecualian dilemparkan. Gaya yang didefinisikan dalam markup dianggap digunakan segera setelah dimuat dari kamus sumber daya (untuk sumber daya), atau halaman yang terdapat di dalamnya dimuat (untuk gaya sebaris).

Style adalah properti dependensi dengan prioritas khusus. Gaya yang ditetapkan secara lokal umumnya beroperasi pada prioritas tertinggi dalam sistem properti. Style Jika null pada titik ini, selama memuat sistem properti memeriksa gaya implisit dalam sumber daya lokal atau aplikasi yang menentukan jenis tersebut. Jika gaya masih null setelah langkah ini, gaya bertindak untuk tujuan presentasi umumnya berasal dari gaya default (tema), tetapi gaya default tidak dikembalikan dalam Style nilai properti. Lihat Prioritas Nilai Properti Dependensi atau Gaya dan Templat.

Penggunaan Atribut XAML

<object Style="{resourceExtension styleResourceKey}"/>

Penggunaan Elemen Properti XAML

Nilai XAML

resourceExtension Salah satu hal berikut: , atau . Lihat Sumber Daya XAML.

styleResourceKey Kunci yang mengidentifikasi gaya yang diminta. Kunci mengacu pada sumber daya yang ada dalam ResourceDictionary.

Nota

Sintaks elemen properti secara teknis dimungkinkan, tetapi tidak disarankan untuk sebagian besar skenario gaya. Lihat Gaya dan Templat Sebaris. Referensi pengikatan menggunakan TemplateBinding atau Binding juga dimungkinkan, tetapi jarang.

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	StyleProperty
Properti metadata diatur ke true	AffectsMeasure