FrameworkContentElement.FocusVisualStyle Свойство

Определение

Получает или задает объект, позволяющий настройку внешнего вида, эффектов или других характеристик стиля, применяемых к данному элементу, когда он получает фокус клавиатуры.Gets or sets an object 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

Значение свойства

Требуемый стиль для применения при получении фокуса.The desired style to apply on focus. Значением по умолчанию, как объявлено в свойстве зависимостей, является пустой статический объект Style.The default value as declared in the dependency property is an empty static Style. Тем не менее, действительным значением во время выполнения часто (но не всегда) является стиль, представленный поддержкой тем для элементов управления.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Комментарии

При задании этого свойства в XAMLXAMLстили практически всегда определяются как ресурс, а не как встроенные в элемент, и этот ресурс обычно упоминается как StaticResourceExtension.When setting this property in XAMLXAML, styles are almost always defined as a resource, rather than inline as an element, and that resource is usually referenced as a StaticResourceExtension.

Обратите внимание, что это свойство влияет на визуальный внешний вид, но не сообщает о них в метаданных.Note that this property affects visual appearance but does not report so in metadata. Это связано с тем, что изменение внешнего вида осуществляется на основе событий и может применяться не всегда, и поэтому не должно сообщать о каких-либо визуальных и макетных сведениях в метаданных.This is because the visual appearance change is event-driven and may not apply at all times, and thus should not generally report any visual or layout information in metadata.

По сути, визуальное поведение фокуса, применяемого к элементу управления, должно быть согласовано от элемента к элементу.Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. Наиболее разумным способом принудительного применения согласованности является изменение визуального стиля фокуса при составлении целой темы.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Задание этого свойства для отдельных стилей, а не как части темы, не является предполагаемым использованием этого свойства, так как оно может привести к путанице в работе пользователя с фокусом клавиатуры.Setting this property on individual 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. Если вы планируете поведение конкретного элемента, которое намеренно не согласовано в теме, гораздо лучшим подходом является использование триггеров в стилях для отдельных свойств состояния ввода, таких как IsFocused или IsKeyboardFocusWithin, а также для этого без визуального представления влияет на любой имеющийся визуальный стиль фокуса.If you are intending element-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. Дополнительные сведения о намерении разработки FocusVisualStyle и альтернативных свойствах фокуса см. в разделе Стилизация фокуса в элементах управления и FocusVisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Использование атрибута XAMLXAML Attribute Usage

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

Использование элемента свойства XAMLXAML Property Element Usage

Значения XAMLXAML Values

ресаурцеекстенсионresourceExtension
Один из следующих элементов: или.One of the following: , or . См. раздел ресурсы XAML.See XAML Resources.

стилересаурцекэйstyleResourceKey
Ключ, определяющий запрашиваемый стиль.The key that identifies the style being requested. Ключ ссылается на существующий ресурс в ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Примечание

Синтаксис элемента свойства технически возможен, но не рекомендуется.Property element syntax is technically possible, but not recommended. См. раздел встроенные стили и шаблоны.See Inline Styles and Templates. Ссылка на привязку с помощью TemplateBinding или Binding также возможна, но не часто.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field FocusVisualStyleProperty
Для свойств метаданных задано значение trueMetadata properties set to true ОтсутствуютNone

Применяется к