FrameworkElement.FocusVisualStyle Propiedad

Definición

Obtiene o establece una propiedad que permite personalizar la apariencia, los 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

Estilo deseado que se va a aplicar al foco. El valor predeterminado tal como se declara en la propiedad de dependencia es un estático Stylevacío. Sin embargo, el valor efectivo en tiempo de ejecución suele ser (pero no siempre) un estilo proporcionado por la compatibilidad con temas para los controles.

Comentarios

Esta propiedad afecta a la apariencia visual, pero no informa 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 tiene intención de controlar un comportamiento específico del control que no es coherente deliberadamente en un tema, un enfoque mucho mejor es 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 existente. Para obtener más información sobre la intención de diseño y las propiedades de FocusVisualStyle enfoque alternativos, vea Aplicar estilo al 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

Note

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 de la propiedad dependency

Elemento Value
Campo identificador FocusVisualStyleProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a

Consulte también