FrameworkElement.FocusVisualStyle Propiedad

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.

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

Style

Estilo deseado que se aplicará en el foco. El valor predeterminado declarado en la propiedad de dependencia es un elemento Style vacío estático. 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.

Comentarios

Esta propiedad afecta a la apariencia visual, pero no notifica AffectsRender en los metadatos. Esto se debe a que el cambio de apariencia visual está controlado por eventos y puede que no se aplique en todo momento y, por lo tanto, no debería informar generalmente de ninguna información visual o de diseño en los metadatos.

Conceptualmente, el comportamiento visual del foco aplicado a un control debe ser coherente desde el control hasta el control. La manera más razonable de aplicar la coherencia es cambiar solo el estilo visual de foco si está redactando un tema completo. 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 provocar una experiencia de usuario confusa con respecto al foco del teclado. Si está pensando en un comportamiento específico del control que no es coherente deliberadamente en un tema, un enfoque mucho mejor consiste en usar desencadenadores en estilos para propiedades de estado de entrada individuales, como IsFocused o IsKeyboardFocusWithin, y para hacerlo de una manera que no interfiera visualmente con ningún estilo visual de foco visual. Para obtener más información sobre la intención de diseño de FocusVisualStyle y las propiedades de foco alternativas, vea Aplicar estilo para el foco en controles y FocusVisualStyle.

Uso de atributos XAML

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

Uso de elementos de propiedad XAML

Valores XAML

resourceExtension
Uno de los siguientes: , o . Consulta Recursos XAML.

styleResourceKey
Clave que identifica el estilo que se solicita. La clave hace referencia a un recurso existente en .ResourceDictionary

Nota

La sintaxis del elemento property es técnicamente posible, pero no se recomienda. Consulte Estilos y plantillas insertados. Una referencia de enlace mediante TemplateBinding o Binding también es posible, pero poco común.

Información sobre propiedades de dependencia

Campo identificador FocusVisualStyleProperty
Propiedades de metadatos establecidas en true None

Se aplica a

Consulte también