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

Комментарии

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

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

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

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

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

Значения XAML

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

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

Примечание

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

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

Поле идентификатора	FocusVisualStyleProperty
Для свойств метаданных задано значение true	Нет

См. также раздел

• MoveFocus(TraversalRequest)