FrameworkElement.FocusVisualStyle Propriedade

Definição

Obtém ou define uma propriedade que permite a personalização da aparência, efeitos ou outras características de estilo que se aplicam a esse elemento quando ele captura o foco do 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 da propriedade

O estilo desejado a ser aplicado no foco.The desired style to apply on focus. O valor padrão como declarado na propriedade de dependência é um Style estático vazio.The default value as declared in the dependency property is an empty static Style. No entanto, o valor efetivo em tempo de execução é normalmente (mas nem sempre) um estilo fornecido pelo suporte de tema para controles.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Comentários

Essa propriedade afeta a aparência visual, mas não relata AffectsRender nos metadados.This property affects visual appearance but does not report AffectsRender in metadata. Isso ocorre porque a alteração de aparência visual é controlada por evento e pode não ser aplicada em todos os momentos e, portanto, geralmente não deve relatar nenhuma informação visual ou de layout nos metadados.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.

Conceitualmente, o comportamento visual do foco aplicado a um controle deve ser coerente do controle para o controle.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. A maneira mais sensata de aplicar coerência é alterar apenas o estilo visual de foco se você estiver compondo um tema inteiro.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Definir essa propriedade em estilos de controle individuais e não como parte de um tema não é o uso pretendido dessa propriedade, pois pode levar a uma experiência de usuário confusa em relação ao foco do 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. Se você estiver pretendendo o comportamento específico de controle que é deliberadamente não coerente em um tema, uma abordagem muito melhor é usar gatilhos em estilos para propriedades de estado de entrada individuais, como IsFocused ou IsKeyboardFocusWithin, e fazer isso de forma que não interfira visualmente em qualquer 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 obter mais informações sobre a intenção de design de FocusVisualStyle e propriedades de foco alternativo, consulte estilizando o foco em controles e FocusVisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Uso do Atributo XAMLXAML Attribute Usage

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

Uso do elemento propriedade XAMLXAML Property Element Usage

Valores XAMLXAML Values

resourceExtensionresourceExtension
Um dos seguintes:, ou.One of the following: , or . Consulte recursos XAML.See XAML Resources.

styleResourceKeystyleResourceKey
A chave que identifica o estilo que está sendo solicitado.The key that identifies the style being requested. A chave refere-se a um recurso existente em um ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Observação

A sintaxe do elemento Property é tecnicamente possível, mas não é recomendável.Property element syntax is technically possible, but not recommended. Consulte estilos e modelos embutidos.See Inline Styles and Templates. Uma referência de associação usando TemplateBinding ou Binding também é possível, mas não comum.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field FocusVisualStyleProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a

Veja também