FrameworkElement.FocusVisualStyle 属性

参考

定义

命名空间:: System.Windows

程序集:: PresentationFramework.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置一个属性，该属性允许自定义此元素在捕获到键盘焦点时要应用于此元素的外观、效果或其他样式特征。

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

属性值

Style

要应用于焦点的所需样式。该依赖属性中声明的默认值是一个空的静态 Style。但是，运行时的有效值通常是（但并非总是）控件的主题支持所提供的样式。

注解

此属性会影响视觉外观，但不在元数据中报告 AffectsRender 。这是因为视觉外观更改是事件驱动的，不能随时应用，因此不应在元数据中报告任何视觉对象或布局信息。

从概念上讲，应用于控件的焦点的视觉行为应从控件到控件的一致。实施一致性的最明智的方法是，如果你正在撰写整个主题，则仅更改焦点视觉样式。在单个控件样式上设置此属性，而不是作为主题的一部分设置此属性不是此属性的预期用法，因为它可能会导致有关键盘焦点的令人困惑的用户体验。如果你打算在主题中故意不连贯的特定于控件的行为，更好的方法是对单个输入状态属性（例如 IsFocused 或） IsKeyboardFocusWithin使用样式中的触发器，以不直观地干扰任何现有焦点视觉样式的方式执行此操作。有关设计意图 FocusVisualStyle 和替代焦点属性的详细信息，请参阅控件中的焦点样式和 FocusVisualStyle。

XAML 属性用法

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

XAML 属性元素用法

XAML 值

resourceExtension
下列项之一：或。请参阅 XAML 资源。

styleResourceKey
标识所请求样式的键。该键是指在一个 ResourceDictionary. 中存在的资源。

备注

属性元素语法在技术上是可能的，但不建议这样做。请参阅内联样式和模板。使用 TemplateBinding 的 Binding 绑定引用，也可能是罕见的。

依赖项属性信息


标识符字段	FocusVisualStyleProperty
元数据属性设置为 `true`	无

适用于

另请参阅

MoveFocus(TraversalRequest)

通过