FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle Property

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.Gets or sets a property that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus.

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.The desired style to apply on focus. Der in der Abhängigkeitseigenschaft deklarierte Standardwert ist eine leere statische Style.The default value as declared in the dependency property is an empty static 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.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Hinweise

Diese Eigenschaft wirkt sich auf die visuelle Darstellung aus AffectsRender , meldet aber nicht in den Metadaten.This property affects visual appearance but does not report AffectsRender in metadata. Dies liegt daran, dass die visuelle Darstellung des Erscheinungs Bilds ereignisgesteuert ist und nicht immer angewendet werden kann. Daher sollten in der Regel keine visuellen Informationen und Layoutinformationen in den Metadaten angezeigt werden.This is because the visual appearance change is event-driven and may not apply at all times, and therefore should not generally report any visual or layout information in metadata.

Konzeptionell sollte das visuelle Verhalten von Fokus, das auf ein Steuerelement angewendet wird, von Steuerelement zu Steuerelement kohärent sein.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. Die sinnvollste Methode zum Erzwingen von Kohärenz besteht darin, nur den visuellen Fokus Stil zu ändern, wenn Sie ein ganzes Design erstellen.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Das Festlegen dieser Eigenschaft in einzelnen Steuerelement Formaten und nicht als Teil eines Designs ist nicht die beabsichtigte Verwendung dieser Eigenschaft, da dies möglicherweise zu einer verwirrenden Benutzer Darstellung in Bezug auf den Tastaturfokus führt.Setting this property on individual control styles and not as part of a theme is not the intended usage of this property, because it may lead to a confusing user experience regarding keyboard focus. Wenn Sie ein Steuerelement spezifisches Verhalten haben, das in einem Design absichtlich nicht kohärent ist, ist es viel besser, Trigger in Stilen für einzelne Eingabe Zustands Eigenschaften wie IsFocused oder IsKeyboardFocusWithinzu verwenden, und dies auf eine Weise, die nicht mit vorhandenem visuellen Stil des Fokus visuell stören.If you are intending control-specific behavior that is deliberately not coherent across a theme, a much better approach is to use triggers in styles for individual input state properties, such as IsFocused or IsKeyboardFocusWithin, and to do so in a way that does not visually interfere with any existing focus visual style. Weitere Informationen zu den Entwurfs Absichten FocusVisualStyle und alternativen Fokus Eigenschaften finden Sie unter Formatieren für den Fokus in Steuerelementen und liegt VisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Verwendung von XAML-AttributenXAML Attribute Usage

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

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

XAML-WerteXAML Values

resourceExtensionresourceExtension
Eines der folgenden:, oder.One of the following: , or . Siehe XAML-Ressourcen.See XAML Resources.

styleResourceKeystyleResourceKey
Der Schlüssel, der den angeforderten Stil bezeichnet.The key that identifies the style being requested. Der Schlüssel verweist auf eine vorhandene Ressource in einer ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Hinweis

Die Syntax von Eigenschafts Elementen ist technisch möglich, wird jedoch nicht empfohlen.Property element syntax is technically possible, but not recommended. Weitere Informationen finden Sie unter Inline Stile und Vorlagen.See Inline Styles and Templates. Ein Bindungs Verweis mit TemplateBinding oder Binding ist ebenfalls möglich, aber nicht üblich.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field FocusVisualStyleProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch