FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle FrameworkElement.FocusVisualStyle Property

Definición

Obtiene o establece una propiedad que habilita la personalización de apariencia, efectos u otras características de estilo que se aplicarán a este elemento cuando capture el foco del teclado.Gets or sets a property 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

Valor de propiedad

Estilo deseado que se aplicará en el foco.The desired style to apply on focus. El valor predeterminado declarado en la propiedad de dependencia es un elemento Style vacío estático.The default value as declared in the dependency property is an empty static Style. Sin embargo, el valor efectivo en tiempo de ejecución suele ser (aunque no siempre) un estilo que la compatibilidad de tema proporciona para los controles.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Comentarios

Esta propiedad afecta a la apariencia visual, pero no informa de AffectsRender en metadatos.This property affects visual appearance but does not report AffectsRender in metadata. Esto es porque el cambio de apariencia visual está controlada por eventos y no se puede aplicar en todo momento y, por tanto, no debe notificar generalmente de cualquier información visual o de diseño en los metadatos.This is because the visual appearance change is event-driven and may not apply at all times, and therefore should not generally report any visual or layout information in metadata.

Conceptualmente, el comportamiento visual de foco aplicado a un control debe ser coherente desde un control a otro.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. La manera más conveniente para exigir la coherencia es cambiar sólo el estilo visual de foco si se está creando un tema completo.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Al establecer esta propiedad en estilos de control individuales y no como parte de un tema no es el uso previsto de esta propiedad, porque puede llevar a una experiencia de usuario confusa con respecto al foco de teclado.Setting this property on individual control 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. Si desea un comportamiento específico del control que deliberadamente no sea coherente en un tema, un enfoque mucho mejor es usar desencadenadores en estilos para las propiedades de estado de entrada individuales, como IsFocused o IsKeyboardFocusWithiny hacerlo de manera que no lo hace visualmente, interferir con cualquier estilo visual de foco existente.If you are intending control-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. Para obtener más información sobre la intención de diseño FocusVisualStyle y alternativas centrarse en las propiedades, vea aplicar estilo a controles y FocusVisualStyle foco.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Uso de atributos XAMLXAML Attribute Usage

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

Uso de elementos de propiedad XAMLXAML Property Element Usage

Valores XAMLXAML Values

resourceExtensionresourceExtension
Uno de los siguientes:, o.One of the following: , or . Consulte recursos XAML.See XAML Resources.

styleResourceKeystyleResourceKey
La clave que identifica el estilo que se solicita.The key that identifies the style being requested. La clave hace referencia a un recurso existente en un ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Nota

Sintaxis de elemento de propiedad es técnicamente posible, pero no se recomienda.Property element syntax is technically possible, but not recommended. Consulte plantillas y estilos alineados.See Inline Styles and Templates. Una referencia de enlace mediante TemplateBinding o Binding también es posible, pero es poco común.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field FocusVisualStyleProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NingunaNone

Se aplica a

Consulte también: