FrameworkContentElement.FocusVisualStyle Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen eines Objekts, das 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

Style

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

Beim Festlegen dieser Eigenschaft in XAML werden Stile fast immer als Ressource und nicht als Inline als Element definiert, und diese Ressource wird normalerweise als StaticResourceExtensionreferenziert.

Beachten Sie, dass sich diese Eigenschaft auf das visuelle Erscheinungsbild auswirkt, dies jedoch nicht in Metadaten meldet. Dies liegt daran, dass die Visuelle Darstellungsänderung ereignisgesteuert ist und möglicherweise nicht jederzeit gilt und daher im Allgemeinen 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 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 Stile 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 elementspezifisches 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 dies auf eine Weise zu tun, 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