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

Комментарии

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

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

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

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

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

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

Значения XAML

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

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

Note

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

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

Элемент Ценность
Поле идентификатора FocusVisualStyleProperty
Свойства метаданных, равные свойству true None

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