Style Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Memungkinkan berbagi properti, sumber daya, dan penanganan aktivitas antara instans jenis.

public ref class Style : System::Windows::Threading::DispatcherObject, System::Windows::Markup::IAddChild, System::Windows::Markup::INameScope, System::Windows::Markup::IQueryAmbient

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.DictionaryKeyProperty("TargetType")]
public class Style : System.Windows.Threading.DispatcherObject, System.Windows.Markup.IAddChild, System.Windows.Markup.INameScope, System.Windows.Markup.IQueryAmbient

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.DictionaryKeyProperty("TargetType")>]
type Style = class
    inherit DispatcherObject
    interface IAddChild
    interface INameScope
    interface IQueryAmbient

Public Class Style
Inherits DispatcherObject
Implements IAddChild, INameScope, IQueryAmbient

Warisan

Object

DispatcherObject

Style

Atribut

LocalizabilityAttribute ContentPropertyAttribute DictionaryKeyPropertyAttribute

Penerapan

IAddChild INameScope IQueryAmbient

Contoh

Contoh berikut menunjukkan deklarasi gaya yang akan memengaruhi Background properti dari Control.

<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>

Untuk menerapkan gaya di atas, lakukan hal berikut:

<Label Content="Yellow Background" Style="{StaticResource Style1}" />

Anda juga dapat menerapkan gaya ke semua elemen dari jenis tertentu dengan menggunakan TargetType properti . Menambahkan jenis target ke gaya berarti Anda tidak lagi harus sepenuhnya memenuhi syarat properti yang Anda atur dengan ClassName.PropertyName sintaks. Contoh berikut menentukan gaya yang akan diterapkan ke setiap TextBlock elemen.

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

Catatan

Banyak kontrol WPF terdiri dari kombinasi kontrol WPF lainnya, sehingga menciptakan gaya yang berlaku untuk semua kontrol jenis dapat berdampak luas. Misalnya, jika Anda membuat gaya yang menargetkan TextBlock kontrol dalam Canvas, gaya diterapkan ke semua TextBlock kontrol di kanvas, bahkan jika TextBlock adalah bagian dari kontrol lain, seperti ListBox.

Untuk informasi tentang cara memperluas atau mewarisi dari gaya yang ditentukan, lihat BasedOn halaman.

Keterangan

Anda dapat mengatur Style pada elemen apa pun yang berasal dari FrameworkElement atau FrameworkContentElement. Gaya paling umum dinyatakan sebagai sumber daya di dalam bagian Resources . Karena gaya adalah sumber daya, gaya mematuhi aturan cakupan yang sama yang berlaku untuk semua sumber daya, jadi di mana Anda menyatakan gaya memengaruhi di mana gaya dapat diterapkan. Jika, misalnya, Anda mendeklarasikan gaya dalam elemen akar file XAML definisi aplikasi Anda, gaya dapat digunakan di mana saja dalam aplikasi Anda. Jika Anda membuat aplikasi navigasi dan mendeklarasikan gaya dalam salah satu file XAML aplikasi, gaya hanya dapat digunakan dalam file XAML tersebut. Untuk informasi selengkapnya tentang aturan cakupan untuk sumber daya, lihat Sumber Daya XAML.

Deklarasi gaya terdiri dari Style objek yang berisi kumpulan satu atau beberapa Setter objek. Masing-masing Setter terdiri dari dan PropertyValue. Properti adalah nama properti elemen tempat gaya diterapkan. Setelah gaya dinyatakan sebagai sumber daya, gaya kemudian dapat direferensikan seperti sumber daya lainnya.

Catatan

Jika ada lebih dari satu setter dalam kumpulan setter dengan nilai properti yang sama Property , setter yang dinyatakan terakhir digunakan. Demikian pula, jika Anda menetapkan nilai untuk properti yang sama dalam gaya dan pada elemen secara langsung, nilai yang ditetapkan pada elemen secara langsung diutamakan.

Model gaya dan templat Windows Presentation Foundation (WPF) memungkinkan pemeliharaan dan berbagi tampilan serta pemisahan presentasi dan logika. Model gaya dan templat mencakup serangkaian fitur yang memungkinkan Anda menyesuaikan UI Anda. Rangkaian fitur ini mencakup Style kelas serta yang berikut:

• Trigger

• EventTrigger dan Storyboard

• ControlTemplate

• DataTemplate

Untuk informasi selengkapnya, lihat Gaya dan Templat.

Konstruktor

Style()	Menginisialisasi instans baru kelas Style.
Style(Type)	Menginisialisasi instans Style baru kelas untuk digunakan pada yang ditentukan Type.
Style(Type, Style)	Menginisialisasi instans Style baru kelas untuk digunakan pada yang ditentukan Type dan berdasarkan Style.

Properti

BasedOn	Mendapatkan atau mengatur gaya yang ditentukan yang merupakan dasar dari gaya saat ini.
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
IsSealed	Mendapatkan nilai yang menunjukkan apakah gaya bersifat baca-saja dan tidak dapat diubah.
Resources	Mendapatkan atau mengatur kumpulan sumber daya yang dapat digunakan dalam cakupan gaya ini.
Setters	Mendapatkan koleksi Setter objek dan EventSetter .
TargetType	Mendapatkan atau mengatur jenis yang dimaksudkan gaya ini.
Triggers	Mendapatkan kumpulan TriggerBase objek yang menerapkan nilai properti berdasarkan kondisi tertentu.

Metode

CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Mengembalikan kode hash untuk ini Style.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RegisterName(String, Object)	Mendaftarkan pasangan nama-objek baru dalam namescope saat ini.
Seal()	Mengunci gaya ini dan semua pabrik dan pemicu sehingga tidak dapat diubah.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
UnregisterName(String)	Menghapus pemetaan objek nama dari namescope.
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Implementasi Antarmuka Eksplisit

IAddChild.AddChild(Object)	Menambahkan objek anak.
IAddChild.AddText(String)	Menambahkan konten teks simpul ke objek.
INameScope.FindName(String)	Mengembalikan objek yang memiliki nama pengidentifikasi yang disediakan.
IQueryAmbient.IsAmbientPropertyAvailable(String)	Kueri apakah properti sekitar tertentu tersedia dalam cakupan saat ini.

Lihat juga

• x:Atribut Kunci
• x:Ketik Ekstensi Markup