FrameworkElement.FocusVisualStyle Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property FocusVisualStyle As StyleEigenschaftswert
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 |
