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 anpassung von Darstellung, Effekten oder anderen Stilmerkmalen ermöglicht, die auf dieses Element angewendet werden, wenn der Tastaturfokus erfasst wird.
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
Diese Eigenschaft wirkt sich auf die visuelle Darstellung aus, meldet aber nicht AffectsRender in Metadaten. Dies liegt daran, dass die änderung der visuellen Darstellung ereignisgesteuert ist und nicht jederzeit angewendet wird und daher keine visuellen oder Layoutinformationen in Metadaten melden sollten.
Konzeptionell sollte das auf ein Steuerelement angewendete visuelle Verhalten des Fokus von Steuerelement zu Steuerelement 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 Steuerelementstile und nicht als Teil eines Designs ist nicht die beabsichtigte Verwendung dieser Eigenschaft, da sie zu einer verwirrenden Benutzererfahrung im Hinblick auf den Tastaturfokus führen kann. Wenn Sie steuerelementspezifisches Verhalten beabsichtigen, das absichtlich nicht über ein Design hinweg kohärent ist, besteht ein wesentlich besserer Ansatz darin, Trigger in Formatvorlagen für einzelne Eingabezustandseigenschaften zu verwenden, z IsFocused . B. oder IsKeyboardFocusWithin, und dies in einer Weise, 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.
Note
Eigenschaftselementsyntax ist technisch möglich, wird jedoch nicht empfohlen. Siehe Inlineformatvorlagen und -vorlagen. Ein Bindungsverweis mithilfe von TemplateBinding oder Binding ist auch möglich, aber ungewöhnlich.
Informationen zur Abhängigkeitseigenschaft
| Element | Wert |
|---|---|
| Bezeichnerfeld | FocusVisualStyleProperty |
Auf Metadateneigenschaften festgelegt true |
Nichts |