FrameworkContentElement.FocusVisualStyle Propriedade

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, conforme declarado na propriedade de dependência, é um estático Stylevazio. No entanto, o valor efetivo em tempo de execução geralmente é (mas nem sempre) um estilo conforme fornecido pelo suporte ao 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 em metadados. Isso ocorre porque a alteração da aparência visual é controlada por eventos e pode não se aplicar em todos os momentos e, portanto, geralmente não deve relatar informações visuais ou de layout em metadados.

Conceitualmente, o comportamento visual do foco aplicado a um controle deve ser coerente de elemento em 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 Styling for Focus in Controls 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.

Informações da propriedade Dependency