Język

FrameworkElement.FocusVisualStyle Właściwość

Definicja

Pobiera lub ustawia właściwość, która umożliwia dostosowywanie wyglądu, efektów lub innych cech stylu, które będą stosowane do tego elementu podczas przechwytywania fokusu klawiatury.

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

Wartość właściwości

Żądany styl do zastosowania na fokusie. Wartość domyślna zadeklarowana we właściwości dependency jest pustą statyczną wartością Style. Jednak efektywna wartość w czasie wykonywania jest często (ale nie zawsze) stylem dostarczonym przez obsługę motywu dla kontrolek.

Uwagi

Ta właściwość ma wpływ na wygląd wizualizacji, ale nie raportuje AffectsRender w metadanych. Wynika to z faktu, że zmiana wyglądu wizualizacji jest oparta na zdarzeniach i może nie być stosowana przez cały czas, dlatego nie powinna ogólnie zgłaszać żadnych informacji o wizualizacji ani układzie w metadanych.

Koncepcyjnie wizualne zachowanie fokusu stosowane do kontrolki powinno być spójne z kontroli do kontroli. Najbardziej rozsądnym sposobem wymuszania spójności jest zmiana stylu wizualizacji fokusu tylko wtedy, gdy komponujesz cały motyw. Ustawienie tej właściwości na poszczególnych stylach kontrolek, a nie w ramach motywu, nie jest zamierzonym użyciem tej właściwości, ponieważ może to prowadzić do mylącego środowiska użytkownika w zakresie koncentracji uwagi na klawiaturze. Jeśli zamierzasz stosować zachowanie specyficzne dla kontrolek, które celowo nie jest spójne w obrębie motywu, znacznie lepszym podejściem jest użycie wyzwalaczy w stylach dla poszczególnych właściwości stanu danych wejściowych, takich jak IsFocused lub IsKeyboardFocusWithin, i w taki sposób, aby nie zakłócać wizualnie żadnego istniejącego stylu wizualizacji fokusu. Aby uzyskać więcej informacji na temat intencji projektu i alternatywnych właściwości fokusu, zobacz FocusVisualStyle

Użycie atrybutu XAML

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

Użytkowanie elementu właściwości XAML

Wartości XAML

resourceExtension Jeden z następujących elementów: , lub . Zobacz Zasoby XAML.

styleResourceKey Klucz identyfikujący żądany styl. Klucz odnosi się do istniejącego zasobu w obiekcie ResourceDictionary.

Note

Składnia elementu właściwości jest technicznie możliwa, ale nie jest zalecana. Zobacz Style i szablony wbudowane. Odwołanie do powiązania przy użyciu metody TemplateBinding lub Binding jest również możliwe, ale nietypowe.

Informacje o właściwości zależności

Przedmiot Wartość
Pole identyfikatora FocusVisualStyleProperty
Właściwości metadanych ustawione na true Żadne

Dotyczy

Zobacz też