FrameworkContentElement.FocusVisualStyle Eigenschaft

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

Eigenschaftswert

Die gewünschte Formatvorlage, die auf den Fokus angewendet werden soll. Der Standardwert wie in der Abhängigkeitseigenschaft deklariert ist eine leere statische .Style Der effektive Wert zur Laufzeit ist jedoch häufig (aber nicht immer) eine Formatvorlage, die von der Designunterstützung für Steuerelemente bereitgestellt wird.

Hinweise

Wenn Sie diese Eigenschaft in XAML festlegen, werden Stile fast immer als Ressource und nicht als Inline als Element definiert, und diese Ressource wird in der Regel als eine StaticResourceExtensionRessource referenziert.

Beachten Sie, dass sich diese Eigenschaft auf die visuelle Darstellung auswirkt, dies aber nicht in Metadaten meldet. Dies liegt daran, dass die änderung der visuellen Darstellung ereignisgesteuert ist und nicht immer angewendet wird und daher keine visuellen oder Layoutinformationen in Metadaten melden sollte.

Konzeptionell sollte das visuelle Verhalten des Fokus, das auf ein Steuerelement angewendet wird, von Element zu Element kohärent sein. Die sinnvollste Möglichkeit zum Erzwingen der Kohärenz besteht darin, nur den visuellen Fokusstil zu ändern, wenn Sie ein gesamtes Design erstellen. Das Festlegen dieser Eigenschaft auf einzelne Formatvorlagen und nicht als Teil eines Designs ist nicht die beabsichtigte Verwendung dieser Eigenschaft, da dies zu einer verwirrenden Benutzererfahrung im Hinblick auf den Tastaturfokus führen kann. Wenn Sie elementspezifisches Verhalten beabsichtigen, das bewusst nicht über ein Design hinweg einheitlich ist, besteht ein viel besserer Ansatz darin, Trigger in Formatvorlagen für einzelne Eingabezustandseigenschaften wie IsFocused oder IsKeyboardFocusWithin, und dies auf eine Weise zu verwenden, die keine visuellen Fokusstile beeinträchtigt. Weitere Informationen zur Entwurfsabsicht FocusVisualStyle und alternativen Fokuseigenschaften finden Sie unter "Formatieren für Fokus in Steuerelementen" und "FocusVisualStyle".

Verwendung von XAML-Attributen

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

Verwendung von XAML-Eigenschaftenelementen

XAML-Werte

resourceExtension Eine der folgenden: , oder . Siehe XAML-Ressourcen.

styleResourceKey Der Schlüssel, der die angeforderte Formatvorlage identifiziert. Der Schlüssel bezieht sich auf eine vorhandene Ressource in einer ResourceDictionary.

Informationen zur Abhängigkeitseigenschaft