FrameworkContentElement.FocusVisualStyle Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur objek yang memungkinkan penyesuaian tampilan, efek, atau karakteristik gaya lainnya yang akan berlaku untuk elemen ini saat mengambil fokus keyboard.

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

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

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

Public Property FocusVisualStyle As Style

Nilai Properti

Style

Gaya yang diinginkan untuk diterapkan pada fokus. Nilai default seperti yang dinyatakan dalam properti dependensi adalah statis Stylekosong . Namun, nilai efektif pada waktu proses sering kali (tetapi tidak selalu) gaya seperti yang disediakan oleh dukungan tema untuk kontrol.

Keterangan

Saat mengatur properti ini di XAML, gaya hampir selalu didefinisikan sebagai sumber daya, daripada sebaris sebagai elemen, dan sumber daya tersebut biasanya dirujuk sebagai StaticResourceExtension.

Perhatikan bahwa properti ini memengaruhi tampilan visual tetapi tidak melaporkannya dalam metadata. Ini karena perubahan tampilan visual digerakkan oleh peristiwa dan mungkin tidak berlaku setiap saat, dan dengan demikian umumnya tidak boleh melaporkan informasi visual atau tata letak apa pun dalam metadata.

Secara konseptual, perilaku visual fokus yang diterapkan pada kontrol harus koheren dari elemen ke elemen. Cara paling masuk akal untuk menerapkan koherensi adalah dengan hanya mengubah gaya visual fokus jika Anda menyusun seluruh tema. Mengatur properti ini pada gaya individual dan bukan sebagai bagian dari tema bukanlah penggunaan properti ini yang dimaksudkan, karena dapat menyebabkan pengalaman pengguna yang membingungkan mengenai fokus keyboard. Jika Anda berniat perilaku khusus elemen yang sengaja tidak koheren di seluruh tema, pendekatan yang jauh lebih baik adalah menggunakan pemicu dalam gaya untuk properti status input individu, seperti IsFocused atau IsKeyboardFocusWithin, dan untuk melakukannya dengan cara yang tidak mengganggu gaya visual fokus yang ada secara visual. Untuk informasi selengkapnya tentang niat FocusVisualStyle desain dan properti fokus alternatif, lihat Gaya untuk Fokus dalam Kontrol, dan FocusVisualStyle.

Penggunaan Atribut XAML

<object FocusVisualStyle="{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.

Note

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

Barang	Nilai
Bidang pengidentifikasi	FocusVisualStyleProperty
Properti metadata diatur ke true	Tidak