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 AffectsRender no notifica en los metadatos.This property affects visual appearance but does not report AffectsRender in metadata. Esto se debe a que el cambio de apariencia visual está orientado a eventos y es posible que no se aplique en todo momento y, por lo tanto, no debe notificar normalmente ninguna información de diseño o visual 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 del foco aplicado a un control debe ser coherente desde el control al control.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. La forma más sensata de aplicar la coherencia es cambiar solo el estilo visual de foco si 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. Establecer esta propiedad en estilos de control individuales y no como parte de un tema no es el uso previsto de esta propiedad, ya que puede dar lugar a una experiencia de usuario confusa con respecto al foco del 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 está informando de un comportamiento específico del control que no es coherente deliberadamente a través de un tema, un enfoque mucho mejor es usar desencadenadores en estilos para propiedades de estado de IsFocused entrada IsKeyboardFocusWithinindividuales, como o, y hacerlo de forma que no interfiere visualmente 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 FocusVisualStyle diseño de y las propiedades de foco alternativas, consulte aplicar estilos a los controles y FocusVisualStyle.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 . Vea recursos XAML.See XAML Resources.

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

Nota

La sintaxis del elemento de propiedad es técnicamente posible, pero no se recomienda.Property element syntax is technically possible, but not recommended. Vea estilos y plantillas en línea.See Inline Styles and Templates. También se puede usar una referencia Binding de enlace con TemplateBinding o, pero no es posible.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
Propiedades de metadatos establecidas entrueMetadata properties set to true NingunaNone

Se aplica a

Consulte también: