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 werden jedoch keine AffectsRender in Metadaten.This property affects visual appearance but does not report AffectsRender in metadata. Dies ist, da die Änderung der visuellen Darstellung ereignisgesteuert ist und möglicherweise nicht immer gilt und aus diesem Grund sollten nicht in der Regel keine Informationen zur Visual oder Layout, in den Metadaten.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.

Grundsätzlich sollte das visuelle Verhalten des Fokus auf ein Steuerelement angewendet kohärente von Steuerelement zu Steuerelement sein.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. Die sinnvollste zum Erzwingen der Kohärenz besteht darin, nur der visuelle Fokusstil ändern, wenn Sie ein vollständiges Design erstellen.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Diese Einstellung für einzelne Steuerelementstile und nicht als Teil eines Designs ist nicht die beabsichtigte Verwendung dieser Eigenschaft, da dies zu einer verwirrenden nutzererfahrung hinsichtlich des Tastaturfokus führen kann.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 steuerelementspezifische Verhalten, die designübergreifend bewusst nicht kohärent ist festlegen möchten, ist viel besser in Stilen für einzelne Eingabezustandseigenschaften wie z. B. Verwenden von Triggern IsFocused oder IsKeyboardFocusWithin, und klicken Sie auf eine Weise dazu, die nicht der Fall ist alle vorhandenen visuellen Fokusstil beeinträchtigen Sie visuell.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 über den Entwurf von FocusVisualStyle und Alternative Fokuseigenschaften finden Sie unter Fokusstile in Steuerelementen und FocusVisualStyle.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
Eine der folgenden:, oder.One of the following: , or . Finden Sie unter XAML-Ressourcen.See XAML Resources.

styleResourceKeystyleResourceKey
Der Schlüssel, der das angeforderte Format identifiziert.The key that identifies the style being requested. Der Schlüssel verweist auf eine vorhandene Ressource in einem ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Hinweis

Eigenschaftenelement-Syntax ist es technisch möglich ist, aber nicht empfehlenswert.Property element syntax is technically possible, but not recommended. Finden Sie unter Inlinestile und-Vorlagen.See Inline Styles and Templates. Ein Bindung mit TemplateBinding oder Binding ist auch möglich, jedoch nicht empfohlen.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field FocusVisualStyleProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch