FrameworkContentElement.FocusVisualStyle 属性

定义

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

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。 但是,运行时的有效值通常是(但并非总是)控件的主题支持所提供的样式。

注解

在 XAML 中设置此属性时,样式几乎总是定义为资源,而不是内联为元素,并且该资源通常引用为 StaticResourceExtension

请注意,此属性会影响视觉外观,但不在元数据中报告。 这是因为视觉外观更改是事件驱动的,可能并非一直适用,因此通常不应在元数据中报告任何视觉对象或布局信息。

从概念上讲,应用于控件的焦点的视觉行为应是一致的,从元素到元素。 强制实施一致性的最合理方法是仅在撰写整个主题时更改焦点视觉样式。 将此属性设置为单个样式而不是主题的一部分不是此属性的预期用途,因为它可能会导致有关键盘焦点的用户体验混乱。 如果打算在主题中故意不一致地执行特定于元素的行为,更好的方法是在样式中使用单个输入状态属性(如 IsFocusedIsKeyboardFocusWithin)的触发器,并采用不会在视觉上干扰任何现有焦点视觉样式的方式执行此操作。 有关设计意向和替代焦点属性的详细信息 FocusVisualStyle ,请参阅 控件中的焦点样式和 FocusVisualStyle

XAML 属性用法

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

XAML 属性元素用法

XAML 值

resourceExtension
以下选项之一:、 或 。 请参阅 XAML 资源

styleResourceKey
标识所请求样式的键。 键引用 中的 ResourceDictionary现有资源。

注意

属性元素语法在技术上是可行的,但不建议这样做。 请参阅 内联样式和模板。 也可以使用 TemplateBindingBinding 的绑定引用,但并不常见。

依赖项属性信息

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

适用于