FrameworkElement.FocusVisualStyle Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer Eigenschaft, die die Anpassung von Darstellung, Effekten oder anderen Formateigenschaften ermöglicht, die auf dieses Element angewendet werden, wenn es den Tastaturfokus erhält.

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 angewendet wird, wenn das Element den Fokus erhält. Der in der Abhängigkeitseigenschaft deklarierte Standardwert ist eine leere statische Style. Der tatsächliche Wert zur Laufzeit ist jedoch häufig (aber nicht immer) eine Formatvorlage, die von der Designunterstützung für Steuerelemente bereitgestellt wird.

Hinweise

Diese Eigenschaft wirkt sich auf die visuelle Darstellung aus, meldet AffectsRender jedoch nicht in Metadaten. Dies liegt daran, dass die Visuelle Darstellungsänderung ereignisgesteuert ist und möglicherweise nicht jederzeit gilt und daher in der Regel keine visuellen oder Layoutinformationen in Metadaten melden sollte.

Konzeptionell sollte das visuelle Fokusverhalten, das auf ein Steuerelement angewendet wird, von Steuerelement zu Steuerelement kohärent sein. Die sinnvollste Methode, um Kohärenz zu erzwingen, besteht darin, den visuellen Stil des Fokus nur zu ändern, wenn Sie ein gesamtes Design verfassen. Das Festlegen dieser Eigenschaft auf einzelne Steuerelementstile und nicht als Teil eines Designs ist nicht die beabsichtigte Verwendung dieser Eigenschaft, da dies zu einer verwirrenden Benutzererfahrung in Bezug auf den Tastaturfokus führen kann. Wenn Sie ein steuerelementspezifisches Verhalten beabsichtigen, das absichtlich nicht in einem Design kohärent ist, besteht ein viel besserer Ansatz darin, Trigger in Stilen für einzelne Eingabezustandseigenschaften wie IsFocused oder IsKeyboardFocusWithinzu verwenden, und zwar auf eine Weise, die keine vorhandenen visuellen Fokusstile beeinträchtigt. Weitere Informationen zur Entwurfsabsicht und FocusVisualStyle alternativen Fokuseigenschaften finden Sie unter Formatieren für Den Fokus in Steuerelementen und FocusVisualStyle.

Verwendung von XAML-Attributen

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

Verwendung von XAML-Eigenschaftenelementen

XAML-Werte

resourceExtension
Einer der folgenden: , oder . Weitere Informationen finden Sie unter XAML-Ressourcen.

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

Hinweis

Eigenschaftenelementsyntax ist technisch möglich, wird aber nicht empfohlen. Weitere Informationen finden Sie unter Inlinestile und -vorlagen. Ein Bindungsverweis mithilfe von TemplateBinding oder Binding ist ebenfalls möglich, aber ungewöhnlich.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld FocusVisualStyleProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für:

Weitere Informationen