FrameworkContentElement.FocusVisualStyle Propiedad

Definición

Obtiene o establece un objeto 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

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

Al establecer esta propiedad en XAML, los estilos casi siempre se definen como un recurso, en lugar de en línea como un elemento, y ese recurso suele hacer referencia a este como .StaticResourceExtension

Tenga en cuenta que esta propiedad afecta a la apariencia visual, pero no lo notifica en los metadatos. Esto se debe a que el cambio de apariencia visual está controlado por eventos y es posible 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 de elemento a elemento. 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 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 pretende un comportamiento específico del elemento que deliberadamente no es coherente en un tema, un enfoque mucho mejor es usar desencadenadores en estilos para propiedades de estado de entrada individuales, como IsFocused o IsKeyboardFocusWithin, y 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 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 Ninguno

Se aplica a