FrameworkElement.FocusVisualStyle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
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 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
Essa propriedade afeta a aparência visual, mas não relata AffectsRender 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 do controle ao controle. 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 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 confusa do usuário em relação ao foco do teclado. Se você pretende um comportamento específico do 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 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 |
