FrameworkElement.FocusVisualStyle Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 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, setPublic Property FocusVisualStyle As StyleValor de Propriedade
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
Esta propriedade afeta a aparência visual, mas não é reportada AffectsRender 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 controlo para controlo. 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 de controlo individuais e não como parte de um tema não é o uso pretendido desta função, pois pode levar a uma experiência de utilizador confusa relativamente ao foco do teclado. Se pretende um comportamento específico de controlo 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 |
