FrameworkContentElement.FocusVisualStyle Propriedade

Definição

Espaço de Nomes:

System.Windows

Assemblagem:

PresentationFramework.dll

Recebe ou define um objeto que permite a personalização da aparência, efeitos ou outras características de estilo que se aplicam a este elemento quando capta 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 de Propriedade

Style

O estilo desejado para aplicar no foco. O valor padrão declarado na propriedade de dependência é um estático Stylevazio . No entanto, o valor efetivo em tempo de execução é frequentemente (mas nem sempre) um estilo fornecido pelo suporte de temas para controlos.

Observações

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

Note-se que esta propriedade afeta a aparência visual, mas não a reporta nos metadados. Isto deve-se ao facto de a alteração da aparência visual ser orientada por eventos e pode não se aplicar em todos os momentos, e por isso não deve geralmente reportar qualquer informação visual ou de layout nos metadados.

Conceptualmente, o comportamento visual do foco aplicado a um controlo deve ser coerente de elemento para elemento. A forma mais sensata de impor coerência é só mudar o estilo visual de foco se estiveres a compor um tema completo. Definir esta propriedade em estilos individuais e não como parte de um tema não é o uso pretendido desta propriedade, pois pode levar a uma experiência de utilizador confusa relativamente ao foco do teclado. Se pretende um comportamento específico de um elemento que deliberadamente não é coerente ao longo de um tema, uma abordagem muito melhor é usar gatilhos em estilos para propriedades individuais do estado de entrada, como IsFocused ou IsKeyboardFocusWithin, e fazê-lo de uma forma que não interfira visualmente com nenhum estilo visual de foco existente. Para mais informações sobre a intenção de design e FocusVisualStyle propriedades alternativas de foco, consulte Styling for Focus in Controls e FocusVisualStyle.

Uso de atributos XAML

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

Uso do elemento de propriedade XAML

Valores XAML

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

StyleResourceKey A chave que identifica o estilo solicitado. A chave refere-se a um recurso existente num ResourceDictionary.

Note

A sintaxe dos elementos de propriedade é tecnicamente possível, mas não recomendada. Ver Estilos e Modelos Inline. Uma referência de binding usando TemplateBindingBinding também é possível, mas incomum.

Informação de Propriedade de Dependência

Iteme	Value
Campo identificador	FocusVisualStyleProperty
Propriedades dos metadados definidas como true	None