FrameworkElement.FocusVisualStyle Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia właściwość, która 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, setPublic Property FocusVisualStyle As StyleWartość właściwości
Żą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
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 zgłaszać żadnych informacji o wizualizacji ani układzie w metadanych.
Koncepcyjnie wizualne zachowanie fokusu stosowanego 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 jako część 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 stosować zachowanie specyficzne dla kontrolek, które celowo nie jest spójne w obrębie motywu, znacznie lepszym rozwiązaniem 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ło wizualnego ż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 |