FrameworkElement.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

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

注解

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

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

XAML 属性用法

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

XAML 属性元素用法

XAML 值

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

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

备注

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

依赖项属性信息

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

适用于

另请参阅