FrameworkContentElement.Style Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur gaya yang akan digunakan oleh elemen ini.

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 FrameworkContentElement secara default adalah null.

Contoh

Contoh berikut menetapkan Resources koleksi pada FlowDocument elemen akar lalu mereferensikannya sebagai sumber daya sebagai gaya tertentu untuk Paragraph.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

Keterangan

Gaya saat ini sering disediakan oleh gaya default dari tema, atau dari gaya yang umumnya diterapkan ke objek jenis tersebut menurut sumber daya di tingkat halaman atau aplikasi (gaya implisit). Properti ini tidak mengatur atau mengembalikan gaya default (tema), tetapi mengembalikan gaya implisit atau gaya eksplisit. Dalam kasus gaya implisit atau eksplisit, tidak masalah apakah gaya diakses 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 sebagai sumber daya yang ditentukan yang menentukan jenis tersebut. Jika gaya masih null setelah langkah ini, gaya berasal dari gaya default (tema), tetapi gaya default tidak dikembalikan dalam Style nilai properti. Lihat Prioritas Nilai Properti Dependensi.

Penggunaan Atribut XAML

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

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. 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