Compartilhar via


FrameworkContentElement.FocusVisualStyle Propriedade

Definição

Obtém ou define um objeto 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.

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. O valor padrão como declarado na propriedade de dependência é um Style estático vazio. No entanto, o valor efetivo em tempo de execução é normalmente (mas nem sempre) um estilo fornecido pelo suporte de tema para controles.

Comentários

Ao definir essa propriedade em XAML, os estilos são quase sempre definidos como um recurso, em vez de embutidos como um elemento, e esse recurso geralmente é referenciado como um StaticResourceExtension.

Observe que essa propriedade afeta a aparência visual, mas não relata isso nos metadados. Isso ocorre porque a alteração de aparência visual é controlada por eventos e pode não se aplicar em todos os momentos e, portanto, geralmente não deve relatar nenhuma informação visual ou de layout nos metadados.

Conceitualmente, o comportamento visual do foco aplicado a um controle deve ser coerente de elemento para elemento. A maneira mais sensata de impor a coerência é apenas alterar o estilo visual de foco se você estiver redigindo um tema inteiro. Definir essa propriedade em estilos individuais e não como parte de um tema não é o uso pretendido dessa propriedade, pois pode levar a uma experiência confusa do usuário em relação ao foco do teclado. Se você pretende um comportamento específico do elemento 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 fazê-lo de uma maneira que não interfira visualmente com qualquer estilo visual de foco existente. Para obter mais informações sobre a intenção de design e as propriedades de FocusVisualStyle foco alternativas, consulte Estilo de foco em controles e FocusVisualStyle.

Uso do Atributo XAML

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

Uso do elemento propriedade XAML

Valores XAML

resourceExtension
Um dos seguintes: , ou . Consulte Recursos XAML.

styleResourceKey
A chave que identifica o estilo que está sendo solicitado. A chave refere-se a um recurso existente em um ResourceDictionary.

Observação

A sintaxe do elemento property é tecnicamente possível, mas não é recomendada. Consulte Estilos e modelos embutidos. Uma referência de associação usando TemplateBinding ou Binding também é possível, mas incomum.

Informações da propriedade de dependência

Campo Identificador FocusVisualStyleProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a