UIElement.HighContrastAdjustment Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define um valor que indica se a estrutura ajusta automaticamente as propriedades visuais do elemento quando os temas de alto contraste estão habilitados.

public:
 property ElementHighContrastAdjustment HighContrastAdjustment { ElementHighContrastAdjustment get(); void set(ElementHighContrastAdjustment value); };

ElementHighContrastAdjustment HighContrastAdjustment();

void HighContrastAdjustment(ElementHighContrastAdjustment value);

public ElementHighContrastAdjustment HighContrastAdjustment { get; set; }

var elementHighContrastAdjustment = uIElement.highContrastAdjustment;
uIElement.highContrastAdjustment = elementHighContrastAdjustment;

Public Property HighContrastAdjustment As ElementHighContrastAdjustment

Valor da propriedade

ElementHighContrastAdjustment

Um valor da enumeração que indica se a estrutura ajusta automaticamente as propriedades visuais do elemento quando os temas de alto contraste estão habilitados. O padrão é Application.

Comentários

O valor da propriedade é herdado. Quando definido como Application o ajuste espelho o que está definido para a propriedade HighContrastAdjustment do aplicativo. Definir a propriedade HighContrastAdjustment do aplicativo como None irá desabilitá-la efetivamente para toda a interface do usuário no aplicativo. Ele pode ser habilitado seletivamente para um UIElement definindo explicitamente o valor como Auto.

Quando definida como Auto, a estrutura aplica automaticamente os seguintes ajustes aos elementos de texto do XAML enquanto um tema de alto contraste está habilitado:

• A cor do primeiro plano no texto é ignorada. O texto é colorido usando a cor de texto de alto contraste do sistema ou a cor desabilitada quando em um controle pai em que IsEnabled = "False".
• Um retângulo opaco é renderizado imediatamente atrás do texto para impor uma taxa de alto contraste.
• Valores não zero para Opacidade são ignorados. O elemento e seus filhos aparecerão como se tivessem uma opacidade de 1,0.

É possível definir HighContrastAdjustment = None em um UIElement e, em seguida, ter HighContrastAdjustment = Auto em um de seus descendentes. No entanto, a estrutura não garante que o descendente será totalmente opaco se uma opacidade for aplicada a qualquer um de seus ancestrais.