FrameworkContentElement.FocusVisualStyle 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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值。 但是,运行时的有效值通常是(但并非总是)由主题支持为控件提供的样式。
注解
在 XAML 中设置此属性时,样式几乎始终定义为资源,而不是内联为元素,并且该资源通常引用为一个 StaticResourceExtension。
请注意,此属性会影响视觉外观,但不在元数据中报告。 这是因为视觉外观更改是事件驱动的,可能在任何时候都不适用,因此通常不应在元数据中报告任何视觉对象或布局信息。
从概念上讲,应用于控件的焦点的视觉行为应从元素到元素的一致。 实施一致性的最合理方法是,仅当你撰写整个主题时更改焦点视觉样式。 在单个样式上设置此属性而不是作为主题的一部分设置此属性不是此属性的预期用法,因为它可能会导致有关键盘焦点的令人困惑的用户体验。 如果你打算在主题中有意不连贯的特定于元素的行为,更好的方法是对单个输入状态属性(例如 IsFocused 或) IsKeyboardFocusWithin使用样式中的触发器,以不直观地干扰任何现有焦点视觉样式的方式执行此操作。 有关设计意图 FocusVisualStyle 和替代焦点属性的详细信息,请参阅 “控件中的焦点样式”和“FocusVisualStyle”。
XAML 属性用法
<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>
XAML 属性元素用法
XAML 值
resourceExtension 下列项之一:或。 请参阅 XAML 资源。
styleResourceKey 标识所请求样式的键。 键是指 .. 中的 ResourceDictionary现有资源。
注释
属性元素语法在技术上是可能的,但不建议这样做。 请参阅 内联样式和模板。 使用 TemplateBinding 的 Binding 绑定引用也可能是可能的,但并不常见。
Dependency 属性信息
| 项目 | 价值 |
|---|---|
| 标识符字段 | FocusVisualStyleProperty |
元数据属性设置为 true |
None |