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 |