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.Gets or sets an object 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

Al establecer esta propiedad en XAMLXAML, los estilos casi siempre se definen como un recurso, en lugar de insertarse como un elemento, y normalmente se hace referencia a ese recurso como StaticResourceExtension.When setting this property in XAMLXAML, styles are almost always defined as a resource, rather than inline as an element, and that resource is usually referenced as a StaticResourceExtension.

Tenga en cuenta que esta propiedad afecta a la apariencia visual, pero no lo notifica en los metadatos.Note that this property affects visual appearance but does not report so 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 en general 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 thus 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 elemento al elemento.Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. 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 individuales y no como parte de un tema no es el uso previsto de esta propiedad, porque puede dar lugar a una experiencia de usuario confusa con respecto al foco del teclado.Setting this property on individual 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 elemento 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 entrada individuales, como IsFocused o IsKeyboardFocusWithiny hacerlo de forma que no sea visualmente interferir con cualquier estilo visual de foco existente.If you are intending element-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 de FocusVisualStyle y propiedades de foco alternativas, vea aplicar estilos para el foco en 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 un ResourceDictionary.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 es posible usar una referencia de enlace con TemplateBinding o Binding, pero no es muy habitual.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 en trueMetadata properties set to true NoneNone

Se aplica a