FrameworkContentElement.FocusVisualStyle Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia obiekt, który umożliwia dostosowanie 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

Style

Żądany styl do zastosowania na fokusie. Wartość domyślna zadeklarowana we właściwości zależności jest pustą statyczną Stylewartością . Jednak efektywna wartość w czasie wykonywania jest często (ale nie zawsze) stylem dostarczanym przez obsługę motywów dla kontrolek.

Uwagi

Podczas ustawiania tej właściwości w języku XAML style są prawie zawsze definiowane jako zasób, a nie wbudowane jako element, a ten zasób jest zwykle przywołyyny jako StaticResourceExtension.

Należy pamiętać, że ta właściwość ma wpływ na wygląd wizualizacji, ale nie raportuje tak 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, a tym samym nie powinna zgłaszać żadnych informacji o wizualizacji ani układzie w metadanych.

Koncepcyjnie zachowanie wizualne fokusu stosowanego do kontrolki powinno być spójne od elementu do elementu. 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, 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 dotyczącego fokusu klawiatury. Jeśli zamierzasz zachowanie specyficzne dla elementów, 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 wizualnego koncentracji uwagi. Aby uzyskać więcej informacji na temat intencji projektowej i alternatywnych właściwości fokusuFocusVisualStyle, zobacz Styling for Focus in Controls (Styl dla fokusu w kontrolkach) i FocusVisualStyle (Styl koncentracji uwagi w kontrolkach) i FocusVisualStyle (Styl koncentracji uwagi w kontrolkach).

Użycie atrybutu języka XAML

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

Użycie elementu właściwości języka XAML

Wartości XAML

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

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

Uwaga

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 szablonuBinding lub Binding jest również możliwe, ale nietypowe.

Informacje dotyczące właściwości zależności

Pole identyfikatora	FocusVisualStyleProperty
Właściwości metadanych ustawione na true	Brak