FrameworkContentElement.FocusVisualStyle Свойство

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Получает или задает объект, позволяющий настройку внешнего вида, эффектов или других характеристик стиля, применяемых к данному элементу, когда он получает фокус клавиатуры.

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. Тем не менее, действительным значением во время выполнения часто (но не всегда) является стиль, представленный поддержкой тем для элементов управления.

Комментарии

При задании этого свойства в XAML стили почти всегда определяются как ресурс, а не как встроенный элемент, и этот ресурс обычно ссылается как на StaticResourceExtension.

Обратите внимание, что это свойство влияет на внешний вид, но не сообщает об этом в метаданных. Это связано с тем, что изменение внешнего вида визуального элемента управляется событиями и может не применяться в любое время, поэтому не следует сообщать о каких-либо визуальных элементах или макете в метаданных.

По сути, визуальное поведение фокуса, применяемого к элементу управления, должно быть согласовано от элемента к элементу. Наиболее разумным способом обеспечения согласованности является изменение визуального стиля фокуса только при создании всей темы. Установка этого свойства для отдельных стилей, а не в рамках темы, не является предполагаемым использованием этого свойства, так как это может привести к запутанности взаимодействия с пользователем в отношении фокуса клавиатуры. Если вы планируете поведение конкретного элемента, которое намеренно не согласовано по теме, гораздо лучше использовать триггеры в стилях для отдельных свойств состояния ввода, таких как IsFocused или IsKeyboardFocusWithin, и сделать это таким образом, чтобы не визуально влиять на существующий визуальный стиль фокуса. Дополнительные сведения о намерении проектирования и альтернативных свойствах FocusVisualStyle фокуса см. в разделе "Стилизация" для фокусировки в элементах управления и FocusVisualStyle.

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

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

Использование элемента свойства XAML

Значения XAML

resourceExtension
Одно из следующих элементов: или . См. сведения о ресурсах XAML.

styleResourceKey
Ключ, определяющий запрашиваемый стиль. Ключ ссылается на существующий ресурс в .ResourceDictionary

Примечание

Синтаксис элемента property технически возможен, но не рекомендуется. См. встроенные стили и шаблоны. Ссылка на привязку с помощью TemplateBinding или Binding также возможна, но редкость.

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

Поле идентификатора	FocusVisualStyleProperty
Metadata properties set to true	Нет